@relkit/client 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @relkit/client
+
+Typed RELKIT client helpers, including TanStack Query integration.
+
+See [@relkit/app](https://github.com/rel-kit/relkit) for supported application APIs.

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { ORPCError } from "@orpc/client";
+import type { RouterContract, RouterContractClient } from "@orpc/contract";
+export { ORPCError };
+export interface DefaultContractRegistry {
+}
+export type DefaultContract = DefaultContractRegistry extends {
+    readonly contract: infer Contract extends RouterContract;
+} ? Contract : RouterContract;
+export type ClientHeadersInit = Headers | Readonly<Record<string, string>> | readonly (readonly [string, string])[];
+export type ClientHeaders = ClientHeadersInit | (() => ClientHeadersInit | Promise<ClientHeadersInit>);
+export interface CreateClientOptions {
+    readonly baseUrl: string;
+    readonly headers?: ClientHeaders;
+    readonly credentials?: RequestInit["credentials"];
+    readonly fetch?: typeof globalThis.fetch;
+}
+/**
+ * Creates a typed HTTP client for the generated application contract.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@relkit/client"
+ *
+ * const client = createClient({ baseUrl: "http://127.0.0.1:3000" })
+ * void client
+ * ```
+ * @category Client
+ * @since 0.1.0
+ */
+export declare function createClient<Contract extends RouterContract = DefaultContract>(options: CreateClientOptions): RouterContractClient<Contract>;
+//# 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,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,MAAM,WAAW,uBAAuB;CAAG;AAE3C,MAAM,MAAM,eAAe,GAAG,uBAAuB,SAAS;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,QAAQ,SAAS,cAAc,CAAC;CAC1D,GACG,QAAQ,GACR,cAAc,CAAC;AAEnB,MAAM,MAAM,iBAAiB,GAC3B,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;AACtF,MAAM,MAAM,aAAa,GACvB,iBAAiB,GAAG,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,SAAS,cAAc,GAAG,eAAe,EAC5E,OAAO,EAAE,mBAAmB,GAC3B,oBAAoB,CAAC,QAAQ,CAAC,CAchC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+import { createORPCClient, ORPCError } from "@orpc/client";
+import { RPCLink } from "@orpc/client/fetch";
+export { ORPCError };
+/**
+ * Creates a typed HTTP client for the generated application contract.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@relkit/client"
+ *
+ * const client = createClient({ baseUrl: "http://127.0.0.1:3000" })
+ * void client
+ * ```
+ * @category Client
+ * @since 0.1.0
+ */
+export function createClient(options) {
+    const endpoint = endpointFor(options.baseUrl);
+    const fetcher = options.fetch ?? globalThis.fetch;
+    const link = new RPCLink({
+        origin: endpoint.origin,
+        url: endpoint.pathname,
+        headers: () => resolveHeaders(options.headers),
+        fetch: (url, init) => fetcher(url, {
+            ...init,
+            credentials: options.credentials ?? "include",
+        }),
+    });
+    return createORPCClient(link);
+}
+function endpointFor(baseUrl) {
+    const base = new URL(baseUrl);
+    const root = base.pathname.endsWith("/") ? base : new URL(`${base.pathname}/`, base);
+    return new URL("rpc", root);
+}
+async function resolveHeaders(value) {
+    const resolved = typeof value === "function" ? await value() : value;
+    if (resolved instanceof Headers)
+        return resolved;
+    const headers = new Headers();
+    if (Array.isArray(resolved)) {
+        for (const [name, entry] of resolved)
+            headers.append(name, entry);
+    }
+    else {
+        for (const [name, entry] of Object.entries(resolved ?? {}))
+            headers.set(name, entry);
+    }
+    return headers;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,OAAO,EAAE,SAAS,EAAE,CAAC;AAsBrB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA4B;IAE5B,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,EAAE,QAAQ,CAAC,QAAwB;QACtC,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC;QAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACnB,OAAO,CAAC,GAAG,EAAE;YACX,GAAG,IAAI;YACP,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,SAAS;SAC9C,CAAC;KACL,CAAC,CAAC;IACH,OAAO,gBAAgB,CAAC,IAAI,CAAmC,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,CAAC,CAAC;IACrF,OAAO,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,KAAgC;IAC5D,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACrE,IAAI,QAAQ,YAAY,OAAO;QAAE,OAAO,QAAQ,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,QAAQ;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tanstack-query.d.ts

@@ -0,0 +1,3 @@
+export { createTanstackQueryUtils } from "@orpc/tanstack-query";
+export type { TanstackQueryOperationContext } from "@orpc/tanstack-query";
+//# sourceMappingURL=tanstack-query.d.ts.map

package/dist/tanstack-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-query.d.ts","sourceRoot":"","sources":["../src/tanstack-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/tanstack-query.js

@@ -0,0 +1,2 @@
+export { createTanstackQueryUtils } from "@orpc/tanstack-query";
+//# sourceMappingURL=tanstack-query.js.map

package/dist/tanstack-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-query.js","sourceRoot":"","sources":["../src/tanstack-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@relkit/client",
+  "version": "0.0.0",
+  "description": "Typed RELKIT client helpers, including TanStack Query integration.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rel-kit/relkit.git",
+    "directory": "packages/client"
+  },
+  "homepage": "https://github.com/rel-kit/relkit#readme",
+  "bugs": {
+    "url": "https://github.com/rel-kit/relkit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./tanstack-query": {
+      "types": "./dist/tanstack-query.d.ts",
+      "import": "./dist/tanstack-query.js"
+    }
+  },
+  "dependencies": {
+    "@orpc/client": "2.0.0-beta.31",
+    "@orpc/contract": "2.0.0-beta.31",
+    "@orpc/tanstack-query": "2.0.0-beta.31"
+  },
+  "peerDependencies": {
+    "@tanstack/query-core": ">=5.80.2"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "typecheck": "tsc -b --pretty false"
+  }
+}