@spoosh/core 0.2.2 → 0.4.0

package/README.md

@@ -36,7 +36,10 @@ type ApiSchema = {
     $post: Endpoint<{ data: { url: string }; formData: { file: File } }>;
   };
   payments: {
-    $post: Endpoint<{ data: { id: string }; urlEncoded: { amount: number; currency: string } }>;
+    $post: Endpoint<{
+      data: { id: string };
+      urlEncoded: { amount: number; currency: string };
+    }>;
   };
 };
 ```
@@ -65,25 +68,22 @@ const { data: newUser } = await api.users.$post({
   body: { name: "John", email: "john@example.com" },
 });
 
-// GET /api/users/123 (dynamic segment)
-const { data: user } = await api.users[123].$get();
+// GET /api/users/123 (direct usage - simplest)
+const { data: user } = await api.users(123).$get();
 
-// Type-safe dynamic params with function syntax (recommended - params is typed)
-const { data } = await api.users(":userId").$get({
-  params: { userId: "123" },
-});
-
-// Alternative bracket syntaxes (less recommended):
-// api.users[":userId"].$get() - works but no type inference for params
-// api.users[userId].$get() - works with variable, no type inference
-
-// PUT /api/users/123
-const { data: updated } = await api.users[123].$put({
+// PUT /api/users/123 (with variable)
+const userId = 123;
+const { data: updated } = await api.users(userId).$put({
   body: { name: "John Updated" },
 });
 
 // DELETE /api/users/123
-await api.users[123].$delete();
+await api.users(123).$delete();
+
+// Typed params (advanced - when you need explicit param names)
+const { data } = await api.users(":userId").$get({
+  params: { userId: 123 },
+});
 
 // POST with FormData
 const { data: uploaded } = await api.upload.$post({
@@ -124,7 +124,7 @@ const api = createClient<ApiSchema>({ baseUrl: process.env.API_URL! });
 const { data: posts } = await api.posts.$get();
 
 // Auto-generates next: { tags: ['users', 'users/123', 'users/123/posts'] }
-const { data: userPosts } = await api.users[123].posts.$get();
+const { data: userPosts } = await api.users(123).posts.$get();
 ```
 
 This enables automatic cache invalidation with `revalidateTag()` in Next.js.
@@ -176,16 +176,16 @@ const updatedContext = await applyMiddlewares(context, middlewares, "before");
 
 ## Schema Types
 
-| Type                                    | Description                   | Example                                                               |
-| --------------------------------------- | ----------------------------- | --------------------------------------------------------------------- |
-| `Endpoint<{ data }>`                    | Endpoint with data only       | `$get: Endpoint<{ data: User[] }>`                                    |
-| `Endpoint<{ data; body }>`              | Endpoint with JSON body       | `$post: Endpoint<{ data: User; body: CreateUserBody }>`               |
-| `Endpoint<{ data; query }>`             | Endpoint with query params    | `$get: Endpoint<{ data: User[]; query: { page: number } }>`           |
-| `Endpoint<{ data; formData }>`          | Endpoint with multipart form  | `$post: Endpoint<{ data: Result; formData: { file: File } }>`         |
-| `Endpoint<{ data; urlEncoded }>`        | Endpoint with URL-encoded     | `$post: Endpoint<{ data: Result; urlEncoded: { amount: number } }>`   |
-| `Endpoint<{ data; error }>`             | Endpoint with typed error     | `$get: Endpoint<{ data: User; error: ApiError }>`                     |
-| `void`                                  | No response body              | `$delete: void`                                                       |
-| `_`                                     | Dynamic path segment          | `users: { _: { $get: Endpoint<{ data: User }> } }`                    |
+| Type                             | Description                  | Example                                                             |
+| -------------------------------- | ---------------------------- | ------------------------------------------------------------------- |
+| `Endpoint<{ data }>`             | Endpoint with data only      | `$get: Endpoint<{ data: User[] }>`                                  |
+| `Endpoint<{ data; body }>`       | Endpoint with JSON body      | `$post: Endpoint<{ data: User; body: CreateUserBody }>`             |
+| `Endpoint<{ data; query }>`      | Endpoint with query params   | `$get: Endpoint<{ data: User[]; query: { page: number } }>`         |
+| `Endpoint<{ data; formData }>`   | Endpoint with multipart form | `$post: Endpoint<{ data: Result; formData: { file: File } }>`       |
+| `Endpoint<{ data; urlEncoded }>` | Endpoint with URL-encoded    | `$post: Endpoint<{ data: Result; urlEncoded: { amount: number } }>` |
+| `Endpoint<{ data; error }>`      | Endpoint with typed error    | `$get: Endpoint<{ data: User; error: ApiError }>`                   |
+| `void`                           | No response body             | `$delete: void`                                                     |
+| `_`                              | Dynamic path segment         | `users: { _: { $get: Endpoint<{ data: User }> } }`                  |
 
 ## API Reference
 
@@ -209,11 +209,8 @@ import { cachePlugin } from "@spoosh/plugin-cache";
 import { retryPlugin } from "@spoosh/plugin-retry";
 
 const client = new Spoosh<ApiSchema, Error>("/api", {
-  headers: { Authorization: "Bearer token" }
-}).use([
-  cachePlugin({ staleTime: 5000 }),
-  retryPlugin({ retries: 3 })
-]);
+  headers: { Authorization: "Bearer token" },
+}).use([cachePlugin({ staleTime: 5000 }), retryPlugin({ retries: 3 })]);
 
 const { api } = client;
 const { data } = await api.users.$get();
@@ -221,26 +218,25 @@ const { data } = await api.users.$get();
 
 **Constructor Parameters:**
 
-| Parameter        | Type            | Description                             |
-| ---------------- | --------------- | --------------------------------------- |
-| `baseUrl`        | `string`        | Base URL for all API requests           |
-| `defaultOptions` | `RequestInit`   | (Optional) Default fetch options        |
+| Parameter        | Type          | Description                      |
+| ---------------- | ------------- | -------------------------------- |
+| `baseUrl`        | `string`      | Base URL for all API requests    |
+| `defaultOptions` | `RequestInit` | (Optional) Default fetch options |
 
 **Methods:**
 
-| Method | Description |
-| ------ | ----------- |
+| Method          | Description                                                           |
+| --------------- | --------------------------------------------------------------------- |
 | `.use(plugins)` | Add plugins to the client. Returns a new instance with updated types. |
 
 **Properties:**
 
-| Property | Description |
-| -------- | ----------- |
-| `.api` | Type-safe API client for making requests |
-| `.stateManager` | Cache and state management |
-| `.eventEmitter` | Event system for refetch/invalidation |
-| `.pluginExecutor` | Plugin lifecycle management |
-
+| Property          | Description                              |
+| ----------------- | ---------------------------------------- |
+| `.api`            | Type-safe API client for making requests |
+| `.stateManager`   | Cache and state management               |
+| `.eventEmitter`   | Event system for refetch/invalidation    |
+| `.pluginExecutor` | Plugin lifecycle management              |
 
 ## Creating Plugins
 

package/dist/index.d.mts

@@ -787,7 +787,7 @@ type HasMethod<TSchema, TMethod extends SchemaMethod> = TSchema extends {
 } ? true : false;
 type HasRequiredOptions<TSchema, TMethod extends SchemaMethod, TDefaultError = unknown> = [ExtractBody<TSchema, TMethod, TDefaultError>] extends [never] ? [ExtractFormData<TSchema, TMethod, TDefaultError>] extends [never] ? [ExtractUrlEncoded<TSchema, TMethod, TDefaultError>] extends [never] ? false : true : true : true;
 
-type ExtractParamName$1<S extends string> = S extends `:${infer P}` ? P : never;
+type ExtractParamName$1<S> = S extends `:${infer P}` ? P : never;
 type MethodRequestOptions<TSchema, TMethod extends SchemaMethod, TDefaultError, TOptionsMap, TParamNames extends string, TRequired extends boolean> = TRequired extends true ? RequestOptions<ExtractBody<TSchema, TMethod, TDefaultError>, ExtractQuery<TSchema, TMethod, TDefaultError>, ExtractFormData<TSchema, TMethod, TDefaultError>, ExtractUrlEncoded<TSchema, TMethod, TDefaultError>> & ComputeRequestOptions<ExtractMethodOptions<TOptionsMap, TMethod>, TParamNames> : RequestOptions<never, ExtractQuery<TSchema, TMethod, TDefaultError>, never, never> & ComputeRequestOptions<ExtractMethodOptions<TOptionsMap, TMethod>, TParamNames>;
 type MethodFn<TSchema, TMethod extends SchemaMethod, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = HasMethod<TSchema, TMethod> extends true ? HasRequiredOptions<TSchema, TMethod, TDefaultError> extends true ? (options: MethodRequestOptions<TSchema, TMethod, TDefaultError, TOptionsMap, TParamNames, true>) => Promise<SpooshResponse<ExtractData<TSchema, TMethod, TDefaultError>, ExtractError<TSchema, TMethod, TDefaultError>, MethodRequestOptions<TSchema, TMethod, TDefaultError, TOptionsMap, TParamNames, true>, ExtractQuery<TSchema, TMethod, TDefaultError>, ExtractBody<TSchema, TMethod, TDefaultError>, ExtractFormData<TSchema, TMethod, TDefaultError>, ExtractUrlEncoded<TSchema, TMethod, TDefaultError>, TParamNames>> : (options?: MethodRequestOptions<TSchema, TMethod, TDefaultError, TOptionsMap, TParamNames, false>) => Promise<SpooshResponse<ExtractData<TSchema, TMethod, TDefaultError>, ExtractError<TSchema, TMethod, TDefaultError>, MethodRequestOptions<TSchema, TMethod, TDefaultError, TOptionsMap, TParamNames, false>, ExtractQuery<TSchema, TMethod, TDefaultError>, ExtractBody<TSchema, TMethod, TDefaultError>, ExtractFormData<TSchema, TMethod, TDefaultError>, ExtractUrlEncoded<TSchema, TMethod, TDefaultError>, TParamNames>> : never;
 type IsSpecialKey<K> = K extends SchemaMethod | "_" ? true : false;
@@ -801,35 +801,22 @@ type HttpMethods<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamN
     [K in SchemaMethod as K extends keyof TSchema ? K : never]: MethodFn<TSchema, K, TDefaultError, TOptionsMap, TParamNames>;
 };
 type DynamicAccess<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = ExtractDynamicSchema<TSchema> extends never ? object : {
-    [key: string]: SpooshClient<ExtractDynamicSchema<TSchema>, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-    [key: number]: SpooshClient<ExtractDynamicSchema<TSchema>, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
     /**
      * Dynamic path segment with typed param name.
      * Use `:paramName` format to get typed params in the response.
      *
      * @example
      * ```ts
-     * // Typed params: { userId: string | number }
+     * // With number
+     * await api.users(123).$get()
+     *
+     * // With typed params
      * const { data, params } = await api.users(':userId').$get({ params: { userId: 123 } })
      * ```
      */
-    <TKey extends string>(key: TKey): SpooshClient<ExtractDynamicSchema<TSchema>, TDefaultError, TOptionsMap, TParamNames | ExtractParamName$1<TKey>, TRootSchema>;
+    <TKey extends string | number>(key: TKey): SpooshClient<ExtractDynamicSchema<TSchema>, TDefaultError, TOptionsMap, TParamNames | ExtractParamName$1<TKey>, TRootSchema>;
 };
-type DynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames extends string = never, TRootSchema = TSchema> = TSchema extends {
-    _: infer D;
-} ? {
-    /**
-     * Dynamic path segment placeholder for routes like `/posts/:id`.
-     *
-     * @example
-     * ```ts
-     * // Direct client usage
-     * const { data } = await api.posts._.$get({ params: { id: 123 } })
-     * ```
-     */
-    _: SpooshClient<D, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-} : object;
-type SpooshClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = HttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & DynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & DynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & {
+type SpooshClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = HttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & DynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & {
     [K in keyof StaticPathKeys<TSchema> as K extends SchemaMethod ? never : K]: SpooshClient<TSchema[K], TDefaultError, TOptionsMap, TParamNames, TRootSchema>;
 };
 
@@ -852,29 +839,13 @@ type HasMutationMethods<TSchema> = TSchema extends object ? MutationMethod exten
 type QueryHttpMethods<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = {
     [K in QueryMethod as K extends keyof TSchema ? K : never]: MethodFn<TSchema, K, TDefaultError, TOptionsMap, TParamNames>;
 };
-type ExtractParamName<S extends string> = S extends `:${infer P}` ? P : never;
+type ExtractParamName<S> = S extends `:${infer P}` ? P : never;
 type QueryDynamicAccess<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = TSchema extends {
     _: infer D;
 } ? HasQueryMethods<D> extends true ? {
-    [key: string]: QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-    [key: number]: QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-    <TKey extends string>(key: TKey): QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | ExtractParamName<TKey>, TRootSchema>;
+    <TKey extends string | number>(key: TKey): QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | ExtractParamName<TKey>, TRootSchema>;
 } : object : object;
-type QueryDynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames extends string = never, TRootSchema = TSchema> = TSchema extends {
-    _: infer D;
-} ? HasQueryMethods<D> extends true ? {
-    /**
-     * Dynamic path segment placeholder for routes like `/posts/:id`.
-     *
-     * @example
-     * ```ts
-     * useRead((api) => api.posts[123].$get())
-     * useRead((api) => api.posts(':id').$get({ params: { id: 123 } }))
-     * ```
-     */
-    _: QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-} : object : object;
-type QueryOnlyClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = QueryHttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & QueryDynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & QueryDynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & {
+type QueryOnlyClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = QueryHttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & QueryDynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & {
     [K in keyof StaticPathKeys<TSchema> as K extends SchemaMethod ? never : HasQueryMethods<TSchema[K]> extends true ? K : never]: QueryOnlyClient<TSchema[K], TDefaultError, TOptionsMap, TParamNames, TRootSchema>;
 };
 type MutationHttpMethods<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = {
@@ -883,25 +854,9 @@ type MutationHttpMethods<TSchema, TDefaultError = unknown, TOptionsMap = object,
 type MutationDynamicAccess<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = TSchema extends {
     _: infer D;
 } ? HasMutationMethods<D> extends true ? {
-    [key: string]: MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string>;
-    [key: number]: MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string>;
-    <TKey extends string>(key: TKey): MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | ExtractParamName<TKey>>;
-} : object : object;
-type MutationDynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames extends string = never> = TSchema extends {
-    _: infer D;
-} ? HasMutationMethods<D> extends true ? {
-    /**
-     * Dynamic path segment placeholder for routes like `/posts/:id`.
-     *
-     * @example
-     * ```ts
-     * const { trigger } = useWrite((api) => api.posts(':id').$delete)
-     * trigger({ params: { id: 123 } })
-     * ```
-     */
-    _: MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string>;
+    <TKey extends string | number>(key: TKey): MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | ExtractParamName<TKey>>;
 } : object : object;
-type MutationOnlyClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = MutationHttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & MutationDynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames> & MutationDynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames> & {
+type MutationOnlyClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = MutationHttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & MutationDynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames> & {
     [K in keyof StaticPathKeys<TSchema> as K extends SchemaMethod ? never : HasMutationMethods<TSchema[K]> extends true ? K : never]: MutationOnlyClient<TSchema[K], TDefaultError, TOptionsMap, TParamNames>;
 };
 
@@ -948,7 +903,7 @@ type EndpointToMethod<T> = (options?: ExtractEndpointRequestOptions<T>) => Promi
  * trigger({
  *   myCallback: (api) => [
  *     api.posts.$get,           // ✓ Valid
- *     api.users[1].$get,        // ✓ Dynamic segment
+ *     api.users(1).$get,        // ✓ Dynamic segment
  *     api.nonexistent.$get,     // ✗ Type error
  *   ],
  * });
@@ -961,18 +916,7 @@ type QuerySchemaHelper<TSchema> = {
 } & (TSchema extends {
     _: infer D;
 } ? HasQueryMethods<D> extends true ? {
-    /**
-     * Dynamic path segment placeholder for routes like `/posts/:id`.
-     *
-     * @example
-     * ```ts
-     * // In plugin callback - reference the endpoint
-     * myCallback: (api) => api.posts._.$get
-     * ```
-     */
-    _: QuerySchemaHelper<D>;
-    [key: string]: QuerySchemaHelper<D>;
-    [key: number]: QuerySchemaHelper<D>;
+    <TKey extends string | number>(key: TKey): QuerySchemaHelper<D>;
 } : object : object);
 
 type PluginArray = readonly SpooshPlugin<PluginTypeConfig>[];
@@ -1119,7 +1063,7 @@ declare class Spoosh<TSchema = unknown, TError = unknown, TPlugins extends Plugi
      * const { data } = await api.posts.$post({ body: { title: 'Hello' } });
      *
      * // Dynamic path parameters
-     * const { data } = await api.posts[postId].$get();
+     * const { data } = await api.posts(postId).$get();
      * ```
      */
     get api(): SpooshClient<TSchema, TError, CoreRequestOptionsBase>;
@@ -1240,7 +1184,7 @@ type SpooshClientConfig = {
  *
  * // Type-safe API calls
  * const { data } = await api.posts.$get();
- * const { data: post } = await api.posts[123].$get();
+ * const { data: post } = await api.posts(123).$get();
  * ```
  */
 declare function createClient<TSchema, TDefaultError = unknown>(config: SpooshClientConfig): SpooshClient<TSchema, TDefaultError>;
@@ -1313,9 +1257,9 @@ type ProxyHandlerConfig<TOptions = SpooshOptions> = {
  * await api.posts.$get();
  *
  * // Dynamic segments via function call:
- * // api.posts[123].$get() or api.posts('123').$get()
+ * // api.posts(123).$get() or api.posts('123').$get()
  * // Executes: GET /api/posts/123
- * await api.posts[123].$get();
+ * await api.posts(123).$get();
  * ```
  */
 declare function createProxyHandler<TSchema extends object, TOptions = SpooshOptions>(config: ProxyHandlerConfig<TOptions>): TSchema;

package/dist/index.d.ts

@@ -787,7 +787,7 @@ type HasMethod<TSchema, TMethod extends SchemaMethod> = TSchema extends {
 } ? true : false;
 type HasRequiredOptions<TSchema, TMethod extends SchemaMethod, TDefaultError = unknown> = [ExtractBody<TSchema, TMethod, TDefaultError>] extends [never] ? [ExtractFormData<TSchema, TMethod, TDefaultError>] extends [never] ? [ExtractUrlEncoded<TSchema, TMethod, TDefaultError>] extends [never] ? false : true : true : true;
 
-type ExtractParamName$1<S extends string> = S extends `:${infer P}` ? P : never;
+type ExtractParamName$1<S> = S extends `:${infer P}` ? P : never;
 type MethodRequestOptions<TSchema, TMethod extends SchemaMethod, TDefaultError, TOptionsMap, TParamNames extends string, TRequired extends boolean> = TRequired extends true ? RequestOptions<ExtractBody<TSchema, TMethod, TDefaultError>, ExtractQuery<TSchema, TMethod, TDefaultError>, ExtractFormData<TSchema, TMethod, TDefaultError>, ExtractUrlEncoded<TSchema, TMethod, TDefaultError>> & ComputeRequestOptions<ExtractMethodOptions<TOptionsMap, TMethod>, TParamNames> : RequestOptions<never, ExtractQuery<TSchema, TMethod, TDefaultError>, never, never> & ComputeRequestOptions<ExtractMethodOptions<TOptionsMap, TMethod>, TParamNames>;
 type MethodFn<TSchema, TMethod extends SchemaMethod, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = HasMethod<TSchema, TMethod> extends true ? HasRequiredOptions<TSchema, TMethod, TDefaultError> extends true ? (options: MethodRequestOptions<TSchema, TMethod, TDefaultError, TOptionsMap, TParamNames, true>) => Promise<SpooshResponse<ExtractData<TSchema, TMethod, TDefaultError>, ExtractError<TSchema, TMethod, TDefaultError>, MethodRequestOptions<TSchema, TMethod, TDefaultError, TOptionsMap, TParamNames, true>, ExtractQuery<TSchema, TMethod, TDefaultError>, ExtractBody<TSchema, TMethod, TDefaultError>, ExtractFormData<TSchema, TMethod, TDefaultError>, ExtractUrlEncoded<TSchema, TMethod, TDefaultError>, TParamNames>> : (options?: MethodRequestOptions<TSchema, TMethod, TDefaultError, TOptionsMap, TParamNames, false>) => Promise<SpooshResponse<ExtractData<TSchema, TMethod, TDefaultError>, ExtractError<TSchema, TMethod, TDefaultError>, MethodRequestOptions<TSchema, TMethod, TDefaultError, TOptionsMap, TParamNames, false>, ExtractQuery<TSchema, TMethod, TDefaultError>, ExtractBody<TSchema, TMethod, TDefaultError>, ExtractFormData<TSchema, TMethod, TDefaultError>, ExtractUrlEncoded<TSchema, TMethod, TDefaultError>, TParamNames>> : never;
 type IsSpecialKey<K> = K extends SchemaMethod | "_" ? true : false;
@@ -801,35 +801,22 @@ type HttpMethods<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamN
     [K in SchemaMethod as K extends keyof TSchema ? K : never]: MethodFn<TSchema, K, TDefaultError, TOptionsMap, TParamNames>;
 };
 type DynamicAccess<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = ExtractDynamicSchema<TSchema> extends never ? object : {
-    [key: string]: SpooshClient<ExtractDynamicSchema<TSchema>, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-    [key: number]: SpooshClient<ExtractDynamicSchema<TSchema>, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
     /**
      * Dynamic path segment with typed param name.
      * Use `:paramName` format to get typed params in the response.
      *
      * @example
      * ```ts
-     * // Typed params: { userId: string | number }
+     * // With number
+     * await api.users(123).$get()
+     *
+     * // With typed params
      * const { data, params } = await api.users(':userId').$get({ params: { userId: 123 } })
      * ```
      */
-    <TKey extends string>(key: TKey): SpooshClient<ExtractDynamicSchema<TSchema>, TDefaultError, TOptionsMap, TParamNames | ExtractParamName$1<TKey>, TRootSchema>;
+    <TKey extends string | number>(key: TKey): SpooshClient<ExtractDynamicSchema<TSchema>, TDefaultError, TOptionsMap, TParamNames | ExtractParamName$1<TKey>, TRootSchema>;
 };
-type DynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames extends string = never, TRootSchema = TSchema> = TSchema extends {
-    _: infer D;
-} ? {
-    /**
-     * Dynamic path segment placeholder for routes like `/posts/:id`.
-     *
-     * @example
-     * ```ts
-     * // Direct client usage
-     * const { data } = await api.posts._.$get({ params: { id: 123 } })
-     * ```
-     */
-    _: SpooshClient<D, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-} : object;
-type SpooshClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = HttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & DynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & DynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & {
+type SpooshClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = HttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & DynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & {
     [K in keyof StaticPathKeys<TSchema> as K extends SchemaMethod ? never : K]: SpooshClient<TSchema[K], TDefaultError, TOptionsMap, TParamNames, TRootSchema>;
 };
 
@@ -852,29 +839,13 @@ type HasMutationMethods<TSchema> = TSchema extends object ? MutationMethod exten
 type QueryHttpMethods<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = {
     [K in QueryMethod as K extends keyof TSchema ? K : never]: MethodFn<TSchema, K, TDefaultError, TOptionsMap, TParamNames>;
 };
-type ExtractParamName<S extends string> = S extends `:${infer P}` ? P : never;
+type ExtractParamName<S> = S extends `:${infer P}` ? P : never;
 type QueryDynamicAccess<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = TSchema extends {
     _: infer D;
 } ? HasQueryMethods<D> extends true ? {
-    [key: string]: QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-    [key: number]: QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-    <TKey extends string>(key: TKey): QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | ExtractParamName<TKey>, TRootSchema>;
+    <TKey extends string | number>(key: TKey): QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | ExtractParamName<TKey>, TRootSchema>;
 } : object : object;
-type QueryDynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames extends string = never, TRootSchema = TSchema> = TSchema extends {
-    _: infer D;
-} ? HasQueryMethods<D> extends true ? {
-    /**
-     * Dynamic path segment placeholder for routes like `/posts/:id`.
-     *
-     * @example
-     * ```ts
-     * useRead((api) => api.posts[123].$get())
-     * useRead((api) => api.posts(':id').$get({ params: { id: 123 } }))
-     * ```
-     */
-    _: QueryOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string, TRootSchema>;
-} : object : object;
-type QueryOnlyClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = QueryHttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & QueryDynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & QueryDynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & {
+type QueryOnlyClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never, TRootSchema = TSchema> = QueryHttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & QueryDynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames, TRootSchema> & {
     [K in keyof StaticPathKeys<TSchema> as K extends SchemaMethod ? never : HasQueryMethods<TSchema[K]> extends true ? K : never]: QueryOnlyClient<TSchema[K], TDefaultError, TOptionsMap, TParamNames, TRootSchema>;
 };
 type MutationHttpMethods<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = {
@@ -883,25 +854,9 @@ type MutationHttpMethods<TSchema, TDefaultError = unknown, TOptionsMap = object,
 type MutationDynamicAccess<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = TSchema extends {
     _: infer D;
 } ? HasMutationMethods<D> extends true ? {
-    [key: string]: MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string>;
-    [key: number]: MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string>;
-    <TKey extends string>(key: TKey): MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | ExtractParamName<TKey>>;
-} : object : object;
-type MutationDynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames extends string = never> = TSchema extends {
-    _: infer D;
-} ? HasMutationMethods<D> extends true ? {
-    /**
-     * Dynamic path segment placeholder for routes like `/posts/:id`.
-     *
-     * @example
-     * ```ts
-     * const { trigger } = useWrite((api) => api.posts(':id').$delete)
-     * trigger({ params: { id: 123 } })
-     * ```
-     */
-    _: MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | string>;
+    <TKey extends string | number>(key: TKey): MutationOnlyClient<D, TDefaultError, TOptionsMap, TParamNames | ExtractParamName<TKey>>;
 } : object : object;
-type MutationOnlyClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = MutationHttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & MutationDynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames> & MutationDynamicKey<TSchema, TDefaultError, TOptionsMap, TParamNames> & {
+type MutationOnlyClient<TSchema, TDefaultError = unknown, TOptionsMap = object, TParamNames extends string = never> = MutationHttpMethods<TSchema, TDefaultError, TOptionsMap, TParamNames> & MutationDynamicAccess<TSchema, TDefaultError, TOptionsMap, TParamNames> & {
     [K in keyof StaticPathKeys<TSchema> as K extends SchemaMethod ? never : HasMutationMethods<TSchema[K]> extends true ? K : never]: MutationOnlyClient<TSchema[K], TDefaultError, TOptionsMap, TParamNames>;
 };
 
@@ -948,7 +903,7 @@ type EndpointToMethod<T> = (options?: ExtractEndpointRequestOptions<T>) => Promi
  * trigger({
  *   myCallback: (api) => [
  *     api.posts.$get,           // ✓ Valid
- *     api.users[1].$get,        // ✓ Dynamic segment
+ *     api.users(1).$get,        // ✓ Dynamic segment
  *     api.nonexistent.$get,     // ✗ Type error
  *   ],
  * });
@@ -961,18 +916,7 @@ type QuerySchemaHelper<TSchema> = {
 } & (TSchema extends {
     _: infer D;
 } ? HasQueryMethods<D> extends true ? {
-    /**
-     * Dynamic path segment placeholder for routes like `/posts/:id`.
-     *
-     * @example
-     * ```ts
-     * // In plugin callback - reference the endpoint
-     * myCallback: (api) => api.posts._.$get
-     * ```
-     */
-    _: QuerySchemaHelper<D>;
-    [key: string]: QuerySchemaHelper<D>;
-    [key: number]: QuerySchemaHelper<D>;
+    <TKey extends string | number>(key: TKey): QuerySchemaHelper<D>;
 } : object : object);
 
 type PluginArray = readonly SpooshPlugin<PluginTypeConfig>[];
@@ -1119,7 +1063,7 @@ declare class Spoosh<TSchema = unknown, TError = unknown, TPlugins extends Plugi
      * const { data } = await api.posts.$post({ body: { title: 'Hello' } });
      *
      * // Dynamic path parameters
-     * const { data } = await api.posts[postId].$get();
+     * const { data } = await api.posts(postId).$get();
      * ```
      */
     get api(): SpooshClient<TSchema, TError, CoreRequestOptionsBase>;
@@ -1240,7 +1184,7 @@ type SpooshClientConfig = {
  *
  * // Type-safe API calls
  * const { data } = await api.posts.$get();
- * const { data: post } = await api.posts[123].$get();
+ * const { data: post } = await api.posts(123).$get();
  * ```
  */
 declare function createClient<TSchema, TDefaultError = unknown>(config: SpooshClientConfig): SpooshClient<TSchema, TDefaultError>;
@@ -1313,9 +1257,9 @@ type ProxyHandlerConfig<TOptions = SpooshOptions> = {
  * await api.posts.$get();
  *
  * // Dynamic segments via function call:
- * // api.posts[123].$get() or api.posts('123').$get()
+ * // api.posts(123).$get() or api.posts('123').$get()
  * // Executes: GET /api/posts/123
- * await api.posts[123].$get();
+ * await api.posts(123).$get();
  * ```
  */
 declare function createProxyHandler<TSchema extends object, TOptions = SpooshOptions>(config: ProxyHandlerConfig<TOptions>): TSchema;

package/dist/index.js

@@ -476,11 +476,9 @@ function createProxyHandler(config) {
         nextTags
       });
     },
-    // Handles function call syntax for dynamic segments: api.posts("123"), api.users(userId)
-    // Q. Why allow this syntax?
-    // A. To support dynamic type inference in frameworks where property access with variables is not possible.
-    //    Eg. api.posts[":id"].$get() <-- TypeScript sees this as bracket notation with a string literal, can't infer param types
-    //    But api.posts(":id").$get() <-- TypeScript can capture ":id" as a template literal type, enabling params: { id: string } inference
+    // Handles function call syntax for dynamic segments: api.posts(123), api.posts(":id"), api.users(userId)
+    // This is the only way to access dynamic segments in Spoosh.
+    // The function call syntax allows TypeScript to capture the literal type, enabling params: { id: string } inference.
     apply(_target, _thisArg, args) {
       const [segment] = args;
       return createProxyHandler({
@@ -989,7 +987,7 @@ var Spoosh = class _Spoosh {
    * const { data } = await api.posts.$post({ body: { title: 'Hello' } });
    *
    * // Dynamic path parameters
-   * const { data } = await api.posts[postId].$get();
+   * const { data } = await api.posts(postId).$get();
    * ```
    */
   get api() {

package/dist/index.mjs

@@ -421,11 +421,9 @@ function createProxyHandler(config) {
         nextTags
       });
     },
-    // Handles function call syntax for dynamic segments: api.posts("123"), api.users(userId)
-    // Q. Why allow this syntax?
-    // A. To support dynamic type inference in frameworks where property access with variables is not possible.
-    //    Eg. api.posts[":id"].$get() <-- TypeScript sees this as bracket notation with a string literal, can't infer param types
-    //    But api.posts(":id").$get() <-- TypeScript can capture ":id" as a template literal type, enabling params: { id: string } inference
+    // Handles function call syntax for dynamic segments: api.posts(123), api.posts(":id"), api.users(userId)
+    // This is the only way to access dynamic segments in Spoosh.
+    // The function call syntax allows TypeScript to capture the literal type, enabling params: { id: string } inference.
     apply(_target, _thisArg, args) {
       const [segment] = args;
       return createProxyHandler({
@@ -934,7 +932,7 @@ var Spoosh = class _Spoosh {
    * const { data } = await api.posts.$post({ body: { title: 'Hello' } });
    *
    * // Dynamic path parameters
-   * const { data } = await api.posts[postId].$get();
+   * const { data } = await api.posts(postId).$get();
    * ```
    */
   get api() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoosh/core",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "license": "MIT",
   "description": "Type-safe API client with plugin middleware system",
   "keywords": [