genoc 0.1.3 → 0.3.0

package/dist/utils/proxy.js

@@ -0,0 +1,81 @@
+const SUPPORTED_PROXY_PROTOCOLS = new Set(['http:', 'https:']);
+/** Security: never echo credentials — user:pass@ becomes ***@ in any echoed value. */
+function redactCredentials(proxyUrl) {
+    try {
+        const url = new URL(proxyUrl);
+        if (url.username || url.password) {
+            url.username = '***';
+            url.password = '';
+        }
+        return url.toString();
+    }
+    catch {
+        return proxyUrl;
+    }
+}
+const MAX_CAUSE_DEPTH = 5;
+/**
+ * undici's fetch() nests the meaningful error up to 3 levels deep via `cause`
+ * (e.g. "fetch failed" → "Request was cancelled." → "Proxy response (502) !== 200...").
+ * Flatten the chain so the deepest message (proxy status, ECONNREFUSED, ...) is user-visible.
+ */
+function describeFetchError(err) {
+    const messages = [];
+    let current = err;
+    for (let depth = 0; depth <= MAX_CAUSE_DEPTH && current instanceof Error; depth++) {
+        if (!messages.includes(current.message)) {
+            messages.push(current.message);
+        }
+        current = current.cause;
+    }
+    return messages.join(': ');
+}
+export function assertValidProxyUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid proxy URL "${redactCredentials(url)}": only http:// and https:// proxies are supported`);
+    }
+    if (!SUPPORTED_PROXY_PROTOCOLS.has(parsed.protocol)) {
+        throw new Error(`Invalid proxy URL "${redactCredentials(url)}": only http:// and https:// proxies are supported (got scheme "${parsed.protocol.replace(/:$/, '')}:")`);
+    }
+}
+export function hasProxyEnv() {
+    return Boolean(process.env.HTTP_PROXY ||
+        process.env.http_proxy ||
+        process.env.HTTPS_PROXY ||
+        process.env.https_proxy);
+}
+export async function fetchSpec(url, opts) {
+    if (opts?.proxy) {
+        assertValidProxyUrl(opts.proxy);
+        const redacted = redactCredentials(opts.proxy);
+        try {
+            const { fetch: undiciFetch, ProxyAgent } = await import('undici');
+            return (await undiciFetch(url, {
+                dispatcher: new ProxyAgent(opts.proxy),
+            }));
+        }
+        catch (err) {
+            throw new Error(`Failed to fetch spec from URL via proxy ${redacted}: ${describeFetchError(err)}`, {
+                cause: err,
+            });
+        }
+    }
+    if (hasProxyEnv()) {
+        try {
+            const { fetch: undiciFetch, EnvHttpProxyAgent } = await import('undici');
+            return (await undiciFetch(url, {
+                dispatcher: new EnvHttpProxyAgent(),
+            }));
+        }
+        catch (err) {
+            throw new Error(`Failed to fetch spec from URL via proxy env: ${describeFetchError(err)}`, {
+                cause: err,
+            });
+        }
+    }
+    return fetch(url);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genoc",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Generate typed HTTP clients from OpenAPI 3.0 / 3.1 specifications",
   "keywords": [
     "client",
@@ -28,6 +28,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./runtime": {
+      "import": "./dist/runtime/index.js",
+      "types": "./dist/runtime/index.d.ts"
     }
   },
   "scripts": {
@@ -39,11 +43,12 @@
     "format": "oxfmt --write",
     "format:check": "oxfmt --check",
     "changeset": "changeset",
-    "version-packages": "changeset version",
+    "version-packages": "changeset version && oxfmt --write",
     "release": "bun run build && changeset publish"
   },
   "dependencies": {
     "@stricli/core": "^1.2.6",
+    "undici": "^6.13.0",
     "yaml": "^2.8.4"
   },
   "devDependencies": {

package/dist/generator/error-types.d.ts

@@ -1,23 +0,0 @@
-import type { AnalyzedOperation } from '../analyzer/path-analyzer.js';
-export declare class ApiError<TStatus extends number, TData> extends Error {
-    readonly status: TStatus;
-    readonly data: TData;
-    constructor(status: TStatus, data: TData, message: string);
-}
-export declare class DefaultApiError<TData> extends Error {
-    readonly status: number;
-    readonly data: TData;
-    constructor(status: number, data: TData, message: string);
-}
-/**
- * Generate error types for a set of analyzed operations.
- *
- * Produces:
- * 1. `ApiError<TStatus, TData>` class
- * 2. `UnspecifiedApiError` class (extends ApiError, for status codes not in spec)
- * 3. Per-operation error union types (e.g. `GetApiV1ProductsErrors`)
- * 4. Per-operation per-status error type aliases (e.g. `GetApiV1ProductsError400`)
- * 5. `DefaultErrorBody` type for `default` responses
- * 6. Catch-all `UnspecifiedApiError` in error unions for unexpected status codes
- */
-export declare function generateErrorTypes(operations: AnalyzedOperation[]): string;

package/dist/generator/error-types.js

@@ -1,87 +0,0 @@
-export class ApiError extends Error {
-    status;
-    data;
-    constructor(status, data, message) {
-        super(message);
-        this.status = status;
-        this.data = data;
-        this.name = 'ApiError';
-    }
-}
-export class DefaultApiError extends Error {
-    status;
-    data;
-    constructor(status, data, message) {
-        super(message);
-        this.status = status;
-        this.data = data;
-        this.name = 'DefaultApiError';
-    }
-}
-/**
- * Generate error types for a set of analyzed operations.
- *
- * Produces:
- * 1. `ApiError<TStatus, TData>` class
- * 2. `UnspecifiedApiError` class (extends ApiError, for status codes not in spec)
- * 3. Per-operation error union types (e.g. `GetApiV1ProductsErrors`)
- * 4. Per-operation per-status error type aliases (e.g. `GetApiV1ProductsError400`)
- * 5. `DefaultErrorBody` type for `default` responses
- * 6. Catch-all `UnspecifiedApiError` in error unions for unexpected status codes
- */
-export function generateErrorTypes(operations) {
-    const lines = [];
-    lines.push(`export class ApiError<TStatus extends number, TData> extends Error {
-  constructor(
-    public readonly status: TStatus,
-    public readonly data: TData,
-    message: string,
-  ) {
-    super(message);
-    this.name = "ApiError";
-  }
-}`);
-    lines.push('');
-    lines.push(`export class UnspecifiedApiError extends ApiError<number, unknown> {
-  constructor(
-    status: number,
-    data: unknown,
-    message: string,
-  ) {
-    super(status, data, message);
-    this.name = "UnspecifiedApiError";
-  }
-}`);
-    lines.push('');
-    let needsDefaultErrorBody = false;
-    for (const op of operations) {
-        const errorResponses = op.responses.filter((r) => !r.isSuccess && r.statusCode !== 'default');
-        const defaultResponse = op.responses.find((r) => !r.isSuccess && r.statusCode === 'default');
-        if (errorResponses.length === 0 && !defaultResponse) {
-            continue;
-        }
-        const methodName = op.methodName;
-        const errorTypeName = (status) => `${methodName}Error${status}`;
-        lines.push('');
-        for (const err of errorResponses) {
-            const tsType = err.tsType || 'unknown';
-            lines.push(`export type ${errorTypeName(err.statusCode)} = ${tsType};`);
-        }
-        const unionParts = [];
-        for (const err of errorResponses) {
-            const status = Number(err.statusCode);
-            unionParts.push(`ApiError<${status}, ${errorTypeName(err.statusCode)}>`);
-        }
-        if (defaultResponse) {
-            needsDefaultErrorBody = true;
-            unionParts.push(`ApiError<number, DefaultErrorBody>`);
-        }
-        unionParts.push(`UnspecifiedApiError`);
-        lines.push(`export type ${methodName}Errors = ${unionParts.join('\n  | ')};`);
-    }
-    if (needsDefaultErrorBody) {
-        lines.push('');
-        lines.push('export type DefaultErrorBody = unknown;');
-    }
-    return lines.join('\n');
-}