@alphatique/hono-fetch 0.0.0-stage → 1.0.5

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Alphatique
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+import { Schema } from "hono";
+import { HonoBase } from "hono/hono-base";
+import { Endpoint, ExtractSchema } from "hono/types";
+import "hono/utils/headers";
+//#region src/config.d.ts
+interface HonoFetchConfig {
+  baseUrl: string;
+  onError?: (err: unknown) => any;
+}
+//#endregion
+//#region src/types.d.ts
+type Method = 'get' | 'post' | 'put' | 'delete' | 'patch';
+type ExtractPath<S extends Schema, M extends Method> = { [P in keyof S]: P extends string ? InferEndpoint<S, M, P> extends Endpoint ? P : never : never; }[keyof S];
+type InferEndpoint<S extends Schema, M extends Method, P extends keyof S> = S[P][`$${M}`];
+type InferInput<S extends Schema, M extends Method, P extends keyof S> = InferEndpoint<S, M, P>['input'];
+type InferOutput<S extends Schema, M extends Method, P extends keyof S> = InferEndpoint<S, M, P>['output'];
+type InferError<C extends HonoFetchConfig> = C['onError'] extends ((err: unknown) => infer E) ? Awaited<E> : never;
+//#endregion
+//#region src/index.d.ts
+export declare class HonoFetch<S extends Schema, C extends HonoFetchConfig> {
+  private config;
+  constructor(config: C);
+  private fetch;
+  get<P extends ExtractPath<S, 'get'>>(path: P, args: InferInput<S, 'get', P>): Promise<InferOutput<S, "get", P> | InferError<C>>;
+  post<P extends ExtractPath<S, 'post'>>(path: P, args: InferInput<S, 'post', P>): Promise<InferError<C> | InferOutput<S, "post", P>>;
+  put<P extends ExtractPath<S, 'put'>>(path: P, args: InferInput<S, 'put', P>): Promise<InferError<C> | InferOutput<S, "put", P>>;
+  delete<P extends ExtractPath<S, 'delete'>>(path: P, args: InferInput<S, 'delete', P>): Promise<InferError<C> | InferOutput<S, "delete", P>>;
+  patch<P extends ExtractPath<S, 'patch'>>(path: P, args: InferInput<S, 'patch', P>): Promise<InferError<C> | InferOutput<S, "patch", P>>;
+}
+type InferSchema<T extends HonoBase<any, any, any>> = T extends HonoBase<any, any, any> ? ExtractSchema<T> : never;
+export declare function honoFetch<T extends HonoBase<any, any, any>, C extends HonoFetchConfig = HonoFetchConfig>(config: C): HonoFetch<InferSchema<T>, C>;
+//#endregion
+export {};

package/dist/index.mjs

@@ -0,0 +1,107 @@
+//#region src/url.ts
+const PARAM_SEGMENT = /\/:([^/{}?]+)(\{[^/]*\})?(\?)?(?=\/|$)/g;
+/**
+* baseUrl、hono の route（schema の key）、param、query から送信先の URL を作る。
+* package の entry からは export しない。
+*
+* 不変条件:
+* - 戻り値の origin は、常に new URL(baseUrl).origin と一致する。
+* - 1 つの param は、encodeURIComponent した 1 つの path segment にだけ入る。
+* - `:name` は名前が完全に一致した場合にだけ置換する。`:id` は `:idx` に一致しない。
+* - `:name?` の値が undefined か空文字なら、その segment を取り除く。
+* - query は、undefined の値と配列内の undefined を送らない。配列は同じ key で append する。
+* - baseUrl の path は、これまでどおり使わない（route は baseUrl の origin からの絶対 path として解決する）。
+*
+* エラー（同期の TypeError）:
+* - baseUrl が URL として不正
+* - 必須の param が無い、または空文字
+* - param の値が "." または ".."（encode しても dot segment として正規化されるため）
+* - param の値が対になっていない surrogate を含む（encodeURIComponent が URIError を投げるため）
+* - 組み立てた URL の origin が baseUrl と異なる（多重の防御。上の規則が正しければ起きない）
+*
+* 対象外: route 中の `*` ワイルドカード
+*/
+function buildUrl(baseUrl, route, input = {}) {
+	const base = new URL(baseUrl);
+	const param = input.param ?? {};
+	const path = route.replace(PARAM_SEGMENT, (_match, name, _pattern, optional) => {
+		const value = Object.hasOwn(param, name) ? param[name] : void 0;
+		if (value === void 0 || value === "") {
+			if (optional) return "";
+			throw new TypeError(`hono-fetch: path param "${name}" is required for ${route}`);
+		}
+		if (value === "." || value === "..") throw new TypeError(`hono-fetch: path param "${name}" must not be "." or ".."`);
+		try {
+			return "/" + encodeURIComponent(value);
+		} catch (err) {
+			throw new TypeError(`hono-fetch: path param "${name}" is not a well-formed string`, { cause: err });
+		}
+	});
+	const url = new URL(path === "" ? "/" : path, base);
+	for (const [k, v] of Object.entries(input.query ?? {})) {
+		if (v === void 0) continue;
+		if (Array.isArray(v)) {
+			for (const v2 of v) if (v2 !== void 0) url.searchParams.append(k, v2);
+		} else url.searchParams.set(k, v);
+	}
+	if (url.origin !== base.origin) throw new TypeError(`hono-fetch: built URL left the origin of baseUrl: ${url.href}`);
+	return url;
+}
+//#endregion
+//#region src/index.ts
+var HonoFetch = class {
+	config;
+	constructor(config) {
+		this.config = config;
+	}
+	async fetch(method, path, args) {
+		const url = buildUrl(this.config.baseUrl, path, args);
+		let contentType = null;
+		let body = null;
+		if (args.json) {
+			contentType = "application/json";
+			body = JSON.stringify(args.json);
+		}
+		if (args.form) {
+			const form = new FormData();
+			for (const [k, v] of Object.entries(args.form)) {
+				if (v === void 0) continue;
+				if (Array.isArray(v)) for (const v2 of v) form.append(k, v2);
+				else form.set(k, v);
+			}
+			body = form;
+		}
+		const headers = new Headers(args.header);
+		if (contentType) headers.set("Content-Type", contentType);
+		try {
+			return await (await fetch(url, {
+				method: method.toUpperCase(),
+				headers,
+				body
+			})).json();
+		} catch (err) {
+			if (this.config.onError) return this.config.onError(err);
+			throw err;
+		}
+	}
+	get(path, args) {
+		return this.fetch("get", path, args);
+	}
+	post(path, args) {
+		return this.fetch("post", path, args);
+	}
+	put(path, args) {
+		return this.fetch("put", path, args);
+	}
+	delete(path, args) {
+		return this.fetch("delete", path, args);
+	}
+	patch(path, args) {
+		return this.fetch("patch", path, args);
+	}
+};
+function honoFetch(config) {
+	return new HonoFetch(config);
+}
+//#endregion
+export { HonoFetch, honoFetch };

package/package.json

@@ -1,6 +1,37 @@
 {
-  "name": "@alphatique/hono-fetch",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@alphatique/hono-fetch",
+	"version": "1.0.5",
+	"license": "ISC",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/alphatique/hono-fetch.git"
+	},
+	"files": [
+		"dist"
+	],
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.mts",
+			"default": "./dist/index.mjs"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"prepare": "vp config --no-agent",
+		"build": "vp pack",
+		"test": "vp test"
+	},
+	"devDependencies": {
+		"hono": "^4.12.10",
+		"typescript": "^5.9.3",
+		"vite": "catalog:",
+		"vite-plus": "catalog:"
+	},
+	"peerDependencies": {
+		"hono": "^4.12.10"
+	},
+	"packageManager": "pnpm@12.11.2"
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.