svelte-reflector 2.0.0 → 2.1.0

package/README.md

@@ -265,6 +265,28 @@ The auto-injected `setQueryGroup([...])` constructor on the generated
 `setQueryGroup` manually from `$reflector/reflector.svelte` if you still
 need batch URL writes.
 
+#### Ephemeral pagination (sidebar / widget)
+
+Sometimes a list lives outside the canonical route — a global sidebar, a
+widget, a paginated combobox in a modal — and should NOT mutate the
+current URL. For those cases, every generated `call()` with query params
+accepts an optional `queryOverride`:
+
+```typescript
+const sidebar = new UserService();
+
+// Current URL stays put. Request goes out with ?page=2&limit=10.
+await sidebar.listAll({
+  queryOverride: { page: "2", limit: "10" },
+});
+```
+
+When `queryOverride` is passed, the method skips `this.querys.bundle()`
+entirely and uses the override as `queryData`. Without it, the method
+reads from `QueryBuilder.value` (the URL) as usual — so you can mix and
+match on a per-call basis. Omit a key to drop it from the request; pass
+`null` to send a literal `null`.
+
 ## Configuration
 
 ### Environment Variables

package/dist/core/generators/CallMethodGenerator.js

@@ -44,7 +44,7 @@ export class CallMethodGenerator {
         const { querys, paths, cookies } = method.analyzers.props;
         const lines = [];
         if (querys.length > 0) {
-            lines.push(`const { ${this.joinNames(querys)} } = this.querys.bundle()`);
+            lines.push(`const { ${this.joinNames(querys)} } = params?.queryOverride ?? this.querys.bundle()`);
         }
         if (paths.length > 0) {
             lines.push(`const { ${this.joinNames(paths)} } = params?.paths ?? this.paths`);

package/dist/core/generators/ModuleCallStrategy.d.ts

@@ -6,4 +6,6 @@ export declare class ModuleCallStrategy implements CallStrategy {
     formStateAccess(method: CallMethodInput): string;
     private buildParamsType;
     private buildPathsBlock;
+    private buildQueryOverrideBlock;
+    private queryOverrideType;
 }

package/dist/core/generators/ModuleCallStrategy.js

@@ -17,27 +17,43 @@ export class ModuleCallStrategy {
     buildParamsType(method) {
         const behaviorType = `Behavior<${method.responseTypeInterface}, ApiErrorResponse>`;
         const pathsBlock = this.buildPathsBlock(method);
-        if (pathsBlock) {
-            return `{
-        behavior?: ${behaviorType};${pathsBlock}
-      }`;
-        }
+        const queryBlock = this.buildQueryOverrideBlock(method);
+        const blocks = [`behavior?: ${behaviorType};`, pathsBlock, queryBlock]
+            .filter((b) => !!b)
+            .join("\n");
         return `{
-      behavior?: ${behaviorType};
+      ${blocks}
     }`;
     }
     buildPathsBlock(method) {
         const paths = method.analyzers.props.paths;
         if (paths.length === 0)
             return undefined;
-        return `
-    paths?: {
+        return `paths?: {
       ${paths
             .map((p) => {
             const type = p.rawType ?? p.type;
             return `${p.name}: ${type}`;
         })
             .join("\n")}
-    }`;
+    };`;
+    }
+    buildQueryOverrideBlock(method) {
+        const querys = method.analyzers.props.querys;
+        if (querys.length === 0)
+            return undefined;
+        const fields = querys
+            .map((q) => `${q.name}?: ${this.queryOverrideType(q)}`)
+            .join("\n");
+        return `queryOverride?: {
+      ${fields}
+    };`;
+    }
+    queryOverrideType(q) {
+        if ("isEnum" in q && q.isEnum)
+            return `${q.type}[]`;
+        if (!("rawType" in q) && !("enumName" in q))
+            return "string[]";
+        return "string | null";
     }
 }

package/dist/runtime/reflector.svelte.ts

@@ -9,9 +9,10 @@ type ValidatorResult = string | null;
 type ValidatorFn<T> = (v: T) => ValidatorResult;
 type BundleResult<T> = T extends { bundle: () => infer R } ? R : T;
 
-export type ApiCallParams<TResponse, TPaths = void> = TPaths extends void
-  ? { behavior?: Behavior<TResponse, ApiErrorResponse> }
-  : { behavior?: Behavior<TResponse, ApiErrorResponse>; paths?: TPaths };
+export type ApiCallParams<TResponse, TPaths = void, TQuery = void> = {
+  behavior?: Behavior<TResponse, ApiErrorResponse>;
+} & (TPaths extends void ? object : { paths?: TPaths }) &
+  (TQuery extends void ? object : { queryOverride?: TQuery });
 
 type PartialBuildedInput<T> = {
   [K in Exclude<keyof T, "bundle">]?: BuildedInput<T[K]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-reflector",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Reflects zod types from openAPI schemas",
   "type": "module",
   "main": "./dist/index.js",