@harborclient/http 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { HARD_MAX_RESPONSE_SIZE_MB, DEFAULT_PROXY_SETTINGS, DEFAULT_REQUEST_SETTINGS } from './settings.js';
+export type { RequestSettings } from './settings.js';
+export type { ApplyCookieResult, BuildHeadersResult } from './IHeaders.js';
+export type { BuildMultipartResult } from './IBody.js';
+export type { ReadResponseBodyResult } from './IResponseReader.js';
+export type { IBody } from './IBody.js';
+export type { IHeaders } from './IHeaders.js';
+export type { IQueryString } from './IQueryString.js';
+export type { IRequester } from './IRequester.js';
+export type { IResponseReader } from './IResponseReader.js';
+export type { RequesterDeps } from './Requester.js';
+export type { BodyType, FormDataPart, FormDataPartType, HttpMethod, KeyValue, ProxyProtocol, ProxySettings, RedirectHop, SendRequestInput, SendResult, SentRequest } from './types.js';
+export { Body } from './Body.js';
+export { Headers } from './Headers.js';
+export { QueryString } from './QueryString.js';
+export { MAX_REDIRECTS, REDIRECT_STATUSES, Requester } from './Requester.js';
+export { ResponseReader } from './ResponseReader.js';
+export { emptyFormPart, normalizeFormPart, parseFormParts, serializeFormParts } from './formData.js';
+export { emptyUrlEncodedPart, normalizeUrlEncodedPart, parseUrlEncodedParts, serializeUrlEncodedParts } from './urlencoded.js';
+export { hasUnsafeHeaderFieldChars, validateHeaderField, validateHeaders } from './httpHeaders.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,aAAa,EACb,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { HARD_MAX_RESPONSE_SIZE_MB, DEFAULT_PROXY_SETTINGS, DEFAULT_REQUEST_SETTINGS } from './settings.js';
+export { Body } from './Body.js';
+export { Headers } from './Headers.js';
+export { QueryString } from './QueryString.js';
+export { MAX_REDIRECTS, REDIRECT_STATUSES, Requester } from './Requester.js';
+export { ResponseReader } from './ResponseReader.js';
+export { emptyFormPart, normalizeFormPart, parseFormParts, serializeFormParts } from './formData.js';
+export { emptyUrlEncodedPart, normalizeUrlEncodedPart, parseUrlEncodedParts, serializeUrlEncodedParts } from './urlencoded.js';
+export { hasUnsafeHeaderFieldChars, validateHeaderField, validateHeaders } from './httpHeaders.js';

package/dist/logger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lightweight opt-in very-verbose logging for outbound HTTP request details.
+ *
+ * Very-verbose mode is enabled with `-vv` / `--very-verbose` or `HARBOR_VERBOSE=2`.
+ */
+/**
+ * Whether very-verbose logging is active for the lifetime of this process.
+ */
+export declare const isVeryVerbose: boolean;
+/**
+ * Logs outbound HTTP request details only when very-verbose (`-vv`) is enabled.
+ *
+ * Use for method, URL, request headers, and request body. Response headers and
+ * response bodies are never logged through this helper.
+ *
+ * @param args - Values forwarded to `console.log`.
+ */
+export declare function logRequest(...args: unknown[]): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAA6B,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAInD"}

package/dist/logger.js

@@ -0,0 +1,34 @@
+/**
+ * Lightweight opt-in very-verbose logging for outbound HTTP request details.
+ *
+ * Very-verbose mode is enabled with `-vv` / `--very-verbose` or `HARBOR_VERBOSE=2`.
+ */
+/**
+ * Determines whether very-verbose logging should be enabled for this process.
+ *
+ * Reads `process.argv` for `-vv`/`--very-verbose` and `HARBOR_VERBOSE=2`.
+ *
+ * @returns True when very-verbose logging is requested.
+ */
+function detectVeryVerbose() {
+    return (process.argv.includes('-vv') ||
+        process.argv.includes('--very-verbose') ||
+        process.env['HARBOR_VERBOSE'] === '2');
+}
+/**
+ * Whether very-verbose logging is active for the lifetime of this process.
+ */
+export const isVeryVerbose = detectVeryVerbose();
+/**
+ * Logs outbound HTTP request details only when very-verbose (`-vv`) is enabled.
+ *
+ * Use for method, URL, request headers, and request body. Response headers and
+ * response bodies are never logged through this helper.
+ *
+ * @param args - Values forwarded to `console.log`.
+ */
+export function logRequest(...args) {
+    if (isVeryVerbose) {
+        console.log('[request]', ...args);
+    }
+}

package/dist/settings.d.ts

@@ -0,0 +1,42 @@
+import type { ProxySettings } from './types.js';
+/**
+ * Absolute ceiling for the configurable max response size setting (MB).
+ */
+export declare const HARD_MAX_RESPONSE_SIZE_MB = 512;
+/**
+ * Default proxy settings used when request settings are not supplied.
+ */
+export declare const DEFAULT_PROXY_SETTINGS: ProxySettings;
+/**
+ * HTTP execution settings consumed by {@link Requester}.
+ *
+ * A subset of the main app's GeneralSettings — excludes editor, theme, and
+ * global variable fields so the package stays self-contained.
+ */
+export interface RequestSettings {
+    /**
+     * Request timeout in milliseconds; 0 disables the timeout.
+     */
+    requestTimeoutMs: number;
+    /**
+     * Maximum response body size in megabytes; 0 disables the configurable limit.
+     */
+    maxResponseSizeMb: number;
+    /**
+     * When true, TLS certificates are verified for HTTPS requests.
+     */
+    verifySsl: boolean;
+    /**
+     * When true, 3xx responses are followed automatically.
+     */
+    followRedirects: boolean;
+    /**
+     * Global HTTP proxy applied to every outbound request.
+     */
+    proxy: ProxySettings;
+}
+/**
+ * Default request settings matching the main app's general settings defaults.
+ */
+export declare const DEFAULT_REQUEST_SETTINGS: RequestSettings;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAQpC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC"}

package/dist/settings.js

@@ -0,0 +1,26 @@
+/**
+ * Absolute ceiling for the configurable max response size setting (MB).
+ */
+export const HARD_MAX_RESPONSE_SIZE_MB = 512;
+/**
+ * Default proxy settings used when request settings are not supplied.
+ */
+export const DEFAULT_PROXY_SETTINGS = {
+    enabled: false,
+    protocol: 'http',
+    host: '',
+    port: 8080,
+    authEnabled: false,
+    username: '',
+    password: ''
+};
+/**
+ * Default request settings matching the main app's general settings defaults.
+ */
+export const DEFAULT_REQUEST_SETTINGS = {
+    requestTimeoutMs: 30000,
+    maxResponseSizeMb: 50,
+    verifySsl: true,
+    followRedirects: true,
+    proxy: { ...DEFAULT_PROXY_SETTINGS }
+};

package/dist/types.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Supported HTTP request methods.
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * Request body content type.
+ */
+export type BodyType = 'none' | 'json' | 'text' | 'multipart' | 'urlencoded';
+/**
+ * Field type for a multipart/form-data part.
+ */
+export type FormDataPartType = 'text' | 'file';
+/**
+ * A single part in a multipart/form-data body.
+ */
+export interface FormDataPart {
+    /**
+     * Form field name.
+     */
+    key: string;
+    /**
+     * Text value when type is text; ignored for file parts.
+     */
+    value: string;
+    /**
+     * When false, the part is excluded when building the request.
+     */
+    enabled: boolean;
+    /**
+     * Whether this part is a text field or file upload.
+     */
+    type: FormDataPartType;
+    /**
+     * Absolute file paths for file parts; supports one or more files per field.
+     */
+    files: string[];
+}
+/**
+ * A key-value pair with an enable toggle for headers and query params.
+ */
+export interface KeyValue {
+    /**
+     * Header or query parameter name.
+     */
+    key: string;
+    /**
+     * Header or query parameter value.
+     */
+    value: string;
+    /**
+     * When false, the pair is ignored when building the request.
+     */
+    enabled: boolean;
+}
+/**
+ * Proxy protocol used to connect to the proxy server.
+ */
+export type ProxyProtocol = 'http' | 'https';
+/**
+ * Global HTTP proxy configuration applied to every outbound request.
+ */
+export interface ProxySettings {
+    /**
+     * When true, outbound requests are routed through the configured proxy.
+     */
+    enabled: boolean;
+    /**
+     * Protocol used to connect to the proxy server.
+     */
+    protocol: ProxyProtocol;
+    /**
+     * Proxy server hostname or IP address.
+     */
+    host: string;
+    /**
+     * Proxy server port.
+     */
+    port: number;
+    /**
+     * When true, HTTP Basic authentication credentials are sent to the proxy.
+     */
+    authEnabled: boolean;
+    /**
+     * Username for proxy HTTP Basic authentication.
+     */
+    username: string;
+    /**
+     * Password for proxy HTTP Basic authentication.
+     */
+    password: string;
+}
+/**
+ * Input for sending an HTTP request from the renderer.
+ */
+export interface SendRequestInput {
+    /**
+     * HTTP method to use for the request.
+     */
+    method: HttpMethod;
+    /**
+     * Request URL without query parameters.
+     */
+    url: string;
+    /**
+     * Request headers as editable key-value pairs.
+     */
+    headers: KeyValue[];
+    /**
+     * Query parameters as editable key-value pairs.
+     */
+    params: KeyValue[];
+    /**
+     * Raw request body content.
+     */
+    body: string;
+    /**
+     * Content type of the request body.
+     */
+    bodyType: BodyType;
+    /**
+     * Saved collection request id when the send originated from a saved request tab.
+     */
+    sourceRequestId?: number;
+    /**
+     * Display name from the request tab when {@link sourceRequestId} is set.
+     */
+    sourceRequestName?: string;
+}
+/**
+ * Metadata for the HTTP request as sent. Multipart {@link body} is a display
+ * summary of form fields, not the raw wire payload.
+ */
+export interface SentRequest {
+    /**
+     * HTTP method used for the request.
+     */
+    method: HttpMethod;
+    /**
+     * Fully resolved request URL including query parameters.
+     */
+    url: string;
+    /**
+     * Request headers as a flat key-value map.
+     */
+    headers: Record<string, string>;
+    /**
+     * Body content for display. For multipart, a human-readable summary of form
+     * fields and file names — not the raw multipart bytes. For other body types,
+     * the literal string sent on the wire, or empty when none.
+     */
+    body: string;
+    /**
+     * Content type of the request body; used to interpret {@link body}.
+     */
+    bodyType?: BodyType;
+}
+/**
+ * One hop in a redirect chain recorded while following 3xx responses.
+ */
+export interface RedirectHop {
+    /**
+     * Status code of the redirect response (301, 302, 303, 307, or 308).
+     */
+    status: number;
+    /**
+     * Status text of the redirect response.
+     */
+    statusText: string;
+    /**
+     * Absolute URL that was requested for this hop.
+     */
+    url: string;
+    /**
+     * Resolved absolute URL from the Location header.
+     */
+    location: string;
+    /**
+     * HTTP method used for this hop.
+     */
+    method: HttpMethod;
+}
+/**
+ * Result of an HTTP request including timing and size metadata.
+ */
+export interface SendResult {
+    /**
+     * HTTP status code, or 0 when the request failed before a response.
+     */
+    status: number;
+    /**
+     * HTTP status text from the response.
+     */
+    statusText: string;
+    /**
+     * Response headers as a flat key-value map.
+     */
+    headers: Record<string, string>;
+    /**
+     * Response body as text.
+     */
+    body: string;
+    /**
+     * Base64-encoded response body for image responses only; omitted for other content types.
+     */
+    bodyBase64?: string;
+    /**
+     * Round-trip time in milliseconds.
+     */
+    timeMs: number;
+    /**
+     * Response body size in bytes.
+     */
+    sizeBytes: number;
+    /**
+     * Error message when the request failed; omitted on success.
+     */
+    error?: string;
+    /**
+     * Set-Cookie header values from the response; used by the cookie jar.
+     */
+    setCookieHeaders?: string[];
+    /**
+     * The outgoing request as actually sent; omitted on older results.
+     */
+    request?: SentRequest;
+    /**
+     * Ordered redirect hops that were followed; omitted when none.
+     */
+    redirects?: RedirectHop[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/urlencoded.d.ts

@@ -0,0 +1,27 @@
+import type { KeyValue } from './types.js';
+/**
+ * Returns a blank urlencoded row with enabled set to true.
+ */
+export declare function emptyUrlEncodedPart(): KeyValue;
+/**
+ * Coerces a partial or legacy key-value record to the full KeyValue shape.
+ *
+ * @param row - Raw row fields from storage or import.
+ * @returns Normalized key-value row with defaults for missing fields.
+ */
+export declare function normalizeUrlEncodedPart(row: Partial<KeyValue>): KeyValue;
+/**
+ * Parses a serialized urlencoded body string into key-value rows.
+ *
+ * @param body - JSON array stored in the request body field.
+ * @returns Parsed rows, or an empty array when body is empty or invalid.
+ */
+export declare function parseUrlEncodedParts(body: string): KeyValue[];
+/**
+ * Serializes urlencoded rows for storage in the request body field.
+ *
+ * @param rows - Key-value rows to serialize.
+ * @returns JSON string, or an empty string when there are no rows.
+ */
+export declare function serializeUrlEncodedParts(rows: KeyValue[]): string;
+//# sourceMappingURL=urlencoded.d.ts.map

package/dist/urlencoded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlencoded.d.ts","sourceRoot":"","sources":["../src/urlencoded.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAMxE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAe7D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAKjE"}

package/dist/urlencoded.js

@@ -0,0 +1,53 @@
+/**
+ * Returns a blank urlencoded row with enabled set to true.
+ */
+export function emptyUrlEncodedPart() {
+    return { key: '', value: '', enabled: true };
+}
+/**
+ * Coerces a partial or legacy key-value record to the full KeyValue shape.
+ *
+ * @param row - Raw row fields from storage or import.
+ * @returns Normalized key-value row with defaults for missing fields.
+ */
+export function normalizeUrlEncodedPart(row) {
+    return {
+        key: typeof row.key === 'string' ? row.key : '',
+        value: typeof row.value === 'string' ? row.value : '',
+        enabled: row.enabled !== false
+    };
+}
+/**
+ * Parses a serialized urlencoded body string into key-value rows.
+ *
+ * @param body - JSON array stored in the request body field.
+ * @returns Parsed rows, or an empty array when body is empty or invalid.
+ */
+export function parseUrlEncodedParts(body) {
+    const trimmed = body.trim();
+    if (!trimmed) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        return parsed.map((row) => normalizeUrlEncodedPart(row));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Serializes urlencoded rows for storage in the request body field.
+ *
+ * @param rows - Key-value rows to serialize.
+ * @returns JSON string, or an empty string when there are no rows.
+ */
+export function serializeUrlEncodedParts(rows) {
+    if (rows.length === 0) {
+        return '';
+    }
+    return JSON.stringify(rows.map((row) => normalizeUrlEncodedPart(row)));
+}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@harborclient/http",
+  "version": "0.1.1",
+  "description": "HTTP utilities for HarborClient.",
+  "keywords": [
+    "harborclient",
+    "http",
+    "typescript"
+  ],
+  "homepage": "https://github.com/harborclient/http",
+  "bugs": {
+    "url": "https://github.com/harborclient/http/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harborclient/http.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "HarborClient",
+    "email": "contact@harborclient.com"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./formData": {
+      "types": "./dist/formData.d.ts",
+      "import": "./dist/formData.js",
+      "default": "./dist/formData.js"
+    },
+    "./urlencoded": {
+      "types": "./dist/urlencoded.d.ts",
+      "import": "./dist/urlencoded.js",
+      "default": "./dist/urlencoded.js"
+    },
+    "./httpHeaders": {
+      "types": "./dist/httpHeaders.d.ts",
+      "import": "./dist/httpHeaders.js",
+      "default": "./dist/httpHeaders.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
+    "./settings": {
+      "types": "./dist/settings.d.ts",
+      "import": "./dist/settings.js",
+      "default": "./dist/settings.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "undici": "^6.27.0"
+  },
+  "devDependencies": {
+    "concurrently": "^8.2.2",
+    "vitepress": "^1.6.4",
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^26.0.1",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.5",
+    "prettier": "^3.8.4",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.36.0",
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "docs:build": "pnpm docs:build:nav && vitepress build docs",
+    "docs:build:nav": "node scripts/build-docs-nav.mjs && node scripts/assert-docs-slugs.mjs",
+    "docs:preview": "pnpm docs:build && vitepress preview docs",
+    "docs:serve": "pnpm docs:build:nav && concurrently --kill-others --prefixColors=auto -n nav,vp \"node scripts/watch-docs-nav.mjs\" \"vitepress dev docs\"",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint --cache .",
+    "release": "gh workflow run Release --ref main -f release_type=patch",
+    "release:patch": "gh workflow run Release --ref main -f release_type=patch",
+    "release:minor": "gh workflow run Release --ref main -f release_type=minor",
+    "release:major": "gh workflow run Release --ref main -f release_type=major",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}