orbit-rpc 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -14,30 +14,42 @@ declare function orbitRpc(config?: OrbitRpcConfig): Plugin[];
 //#region src/context.d.ts
 declare const contextStorage: AsyncLocalStorage<Context<any, any, {}>>;
 /**
- * RPC ハンドラ内で Hono Context を取得する。
- *
- * server.ts の関数内から呼ぶと、現在のリクエストに紐づく Hono Context が返る。
- * Cloudflare Workers のバインディング（D1, KV 等）や Cookie へのアクセスに使う。
+ * アプリ側で環境変数の型を登録するためのインターフェース。
  *
- * プロジェクト側で型付きラッパーを作って使う:
  * ```ts
  * // src/lib/context.ts
- * import { getContext } from "orbit-rpc";
- * type Bindings = { DB: D1Database };
- * export const ctx = () => getContext<Bindings>();
+ * declare module "orbit-rpc" {
+ *   interface Register {
+ *     env: { DB: D1Database; ADMIN_PASSWORD: string };
+ *   }
+ * }
  * ```
+ */
+interface Register {}
+/** Register.env が登録済みなら使い、未登録なら Record<string, unknown> にフォールバック */
+type RegisteredEnv = Register extends {
+  env: infer T;
+} ? T : Record<string, unknown>;
+/**
+ * RPC ハンドラ内で Hono Context を取得する。
+ *
+ * server.ts の関数内から呼ぶと、現在のリクエストに紐づく Hono Context が返る。
+ * Cloudflare Workers のバインディング（D1, KV 等）や Cookie へのアクセスに使う。
  *
  * ```ts
- * // routes/articles/server.ts
- * import { ctx } from "../../lib/context";
- * export async function getArticles() {
- *   const c = ctx();
- *   return c.env.DB.prepare("SELECT * FROM articles").all();
+ * // src/lib/context.ts で型を1回宣言すれば:
+ * declare module "orbit-rpc" {
+ *   interface Register { env: { DB: D1Database } }
  * }
+ *
+ * // server.ts では型パラメータ不要で使える:
+ * import { getContext } from "orbit-rpc";
+ * const c = getContext();
+ * c.env.DB // ← 型補完が効く
  * ```
  */
-declare function getContext<E extends Record<string, unknown> = Record<string, unknown>>(): Context<{
+declare function getContext<E extends Record<string, unknown> = RegisteredEnv>(): Context<{
   Bindings: E;
 }>;
 //#endregion
-export { type OrbitRpcConfig, contextStorage, getContext, orbitRpc };
+export { type OrbitRpcConfig, type Register, contextStorage, getContext, orbitRpc };

package/dist/index.mjs

@@ -11,21 +11,16 @@ const contextStorage = new AsyncLocalStorage();
 * server.ts の関数内から呼ぶと、現在のリクエストに紐づく Hono Context が返る。
 * Cloudflare Workers のバインディング（D1, KV 等）や Cookie へのアクセスに使う。
 *
-* プロジェクト側で型付きラッパーを作って使う:
 * ```ts
-* // src/lib/context.ts
-* import { getContext } from "orbit-rpc";
-* type Bindings = { DB: D1Database };
-* export const ctx = () => getContext<Bindings>();
-* ```
-*
-* ```ts
-* // routes/articles/server.ts
-* import { ctx } from "../../lib/context";
-* export async function getArticles() {
-*   const c = ctx();
-*   return c.env.DB.prepare("SELECT * FROM articles").all();
+* // src/lib/context.ts で型を1回宣言すれば:
+* declare module "orbit-rpc" {
+*   interface Register { env: { DB: D1Database } }
 * }
+*
+* // server.ts では型パラメータ不要で使える:
+* import { getContext } from "orbit-rpc";
+* const c = getContext();
+* c.env.DB // ← 型補完が効く
 * ```
 */
 function getContext() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orbit-rpc",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "RPC layer for Orbit — auto-converts server.ts functions to Hono routes",
   "keywords": [
     "fullstack",