kyro-connect 0.1.4 → 0.1.5

package/README.md

@@ -36,7 +36,13 @@ const api = createClient<AppRouter>({
 
 ### `createClient(options)`
 
-Creates a proxy-based client for your Kyro CMS tRPC endpoint.
+Creates a proxy-based client for your Kyro CMS tRPC endpoint. Each property access builds a procedure path, and calling it triggers the request.
+
+All three calling patterns are supported and interchangeable:
+
+- `api["posts"].find(input)` — direct call
+- `api["posts"].find.query(input)` — explicit query
+- `api["posts"].create.mutate(input)` — explicit mutation (for writes)
 
 ```ts
 const api = createClient<AppRouter>({
@@ -52,12 +58,27 @@ const api = createClient<AppRouter>({
 | `apiKey` | `string` | — | API key for authenticated requests |
 | `fetch` | `typeof globalThis.fetch` | `globalThis.fetch` | Custom fetch implementation |
 
+#### Using environment variables
+
+```ts
+const api = createClient<AppRouter>({
+  url: process.env.KYRO_API_URL!,
+  apiKey: process.env.KYRO_API_KEY!,
+});
+```
+
 #### Query procedures (GET)
 
+All three patterns work:
+
 ```ts
+// Direct call
 const { docs } = await api["posts"].find({ page: 1, limit: 10 });
 // docs: Post[]
 
+// Explicit .query()
+const { docs } = await api["posts"].find.query({ page: 1, limit: 10 });
+
 const post = await api["posts"].findByID({ id: "abc123" });
 // post: Post
 
@@ -70,11 +91,17 @@ const { totalDocs } = await api["posts"].count({
 #### Mutation procedures (POST)
 
 ```ts
+// Direct call (creates/updates/deletes are auto-detected as POST)
 const { doc } = await api["posts"].create({
   data: { title: "Hello", slug: "hello" },
 });
 // doc: Post
 
+// Explicit .mutate()
+const { doc } = await api["posts"].create.mutate({
+  data: { title: "Hello", slug: "hello" },
+});
+
 const { doc } = await api["posts"].update({
   id: "abc",
   data: { title: "Updated" },
@@ -96,6 +123,14 @@ await api["_globals_site-settings"].update({
 });
 ```
 
+#### Collections with hyphens in slug
+
+Use bracket notation:
+
+```ts
+const data = await api["my-collection"].find({ page: 1 });
+```
+
 ---
 
 ## Codegen
@@ -119,21 +154,13 @@ Running codegen produces `kyro.generated.d.ts` containing:
 - **Output types** — typed outputs for every procedure (`PostsFindOutput`, etc.)
 - **AppRouter** — mapped type linking all collection/global procedures to their input/output types
 
-### Slugs with hyphens
-
-Use bracket notation when accessing collections with hyphens in their slug:
-
-```ts
-const data = await api["my-collection"].find({ page: 1 });
-```
-
 ### Without codegen
 
 The client works without types — everything is `any`:
 
 ```ts
 const api = createClient({ url: "...", apiKey: "..." });
-const posts = await api.posts.find({ page: 1 });
+const posts = await api["posts"].find({ page: 1 });
 // posts: any
 ```
 
@@ -143,6 +170,8 @@ const posts = await api.posts.find({ page: 1 });
 
 ### Request format
 
+The client communicates with the Kyro tRPC endpoint. Each procedure call maps to an HTTP request:
+
 | Procedure type | HTTP method | URL | Body |
 |---|---|---|---|
 | `find`, `findByID`, `count` | GET | `/api/trpc/{slug}.{proc}?input={json}` | — |
@@ -169,7 +198,6 @@ try {
   if (err instanceof KyroConnectError) {
     console.error(err.message); // Server error message
     console.error(err.status);  // HTTP status code
-    console.error(err.code);    // tRPC error code
   }
 }
 ```

package/dist/index.d.cts

@@ -3,10 +3,11 @@ interface ClientOptions {
     apiKey?: string;
     fetch?: typeof globalThis.fetch;
 }
-type ProcedureClient<I, O> = {
+interface ProcedureClient<I, O> {
+    (input: I): Promise<O>;
     query: (input: I) => Promise<O>;
     mutate: (input: I) => Promise<O>;
-};
+}
 type RouterClient<T> = {
     [K in keyof T]: T[K] extends {
         input: infer I;

package/dist/index.d.ts

@@ -3,10 +3,11 @@ interface ClientOptions {
     apiKey?: string;
     fetch?: typeof globalThis.fetch;
 }
-type ProcedureClient<I, O> = {
+interface ProcedureClient<I, O> {
+    (input: I): Promise<O>;
     query: (input: I) => Promise<O>;
     mutate: (input: I) => Promise<O>;
-};
+}
 type RouterClient<T> = {
     [K in keyof T]: T[K] extends {
         input: infer I;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kyro-connect",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Universal SDK for Kyro CMS. Type-safe client + codegen for any platform.",
   "type": "module",
   "main": "./dist/index.js",