typedapi-client-helpers 0.3.3 → 0.3.5

package/dist/esm/utils/buildQuery.js

@@ -1,12 +1,12 @@
 /**
- * Builds a typed query object from filter form values, pagination, and sorting.
+ * Builds a typed query object from filter form values without adding pagination or sorting.
  *
  * Empty filter values are ignored.
  * List filters are converted item by item.
  * `OptionValue` lists send their `value` fields instead of the display names.
  */
-export function buildQuery(filters, page = 1, pageSize = 100, sortBy = null, sortDirection) {
-    const query = filters.reduce((queryResult, filter) => {
+export function buildFilterQuery(filters) {
+    return filters.reduce((queryResult, filter) => {
         const { filterName, filterNameMax, type, value, maxValue, isAList } = filter;
         if (isEmptyValue(value) && isEmptyValue(maxValue)) {
             return queryResult;
@@ -28,11 +28,22 @@ export function buildQuery(filters, page = 1, pageSize = 100, sortBy = null, sor
         if (filterNameMax && !isEmptyValue(maxValue)) {
             const convertedMaxValue = convertType(type, maxValue);
             if (convertedMaxValue !== null) {
-                queryResult[filterNameMax] = convertedMaxValue;
+                queryResult[filterNameMax] =
+                    convertedMaxValue;
             }
         }
         return queryResult;
     }, {});
+}
+/**
+ * Builds a typed query object from filter form values, pagination, and sorting.
+ *
+ * Empty filter values are ignored.
+ * List filters are converted item by item.
+ * `OptionValue` lists send their `value` fields instead of the display names.
+ */
+export function buildQuery(filters, page = 1, pageSize = 100, sortBy = null, sortDirection) {
+    const query = buildFilterQuery(filters);
     query.pageNumber = page;
     if (pageSize > 0) {
         query.pageSize = pageSize;

package/dist/esm/utils/buildQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildQuery.js","sourceRoot":"","sources":["../../../src/utils/buildQuery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"buildQuery.js","sourceRoot":"","sources":["../../../src/utils/buildQuery.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/buildQuery.d.ts

@@ -5,6 +5,14 @@ import { FilterFormValues } from "../interfaces/Filter";
  * APIs often expose sort direction as either a string enum or numeric enum, so both are supported.
  */
 export type SortDirection = number | string;
+/**
+ * Builds a typed query object from filter form values without adding pagination or sorting.
+ *
+ * Empty filter values are ignored.
+ * List filters are converted item by item.
+ * `OptionValue` lists send their `value` fields instead of the display names.
+ */
+export declare function buildFilterQuery<TQuery>(filters: FilterFormValues<TQuery>[]): Partial<TQuery>;
 /**
  * Builds a typed query object from filter form values, pagination, and sorting.
  *

package/dist/types/utils/buildQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildQuery.d.ts","sourceRoot":"","sources":["../../../src/utils/buildQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EACpD,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,EACnC,IAAI,SAAI,EACR,QAAQ,SAAM,EACd,MAAM,GAAE,MAAM,UAAU,GAAG,IAAW,EACtC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,MAAM,CAAC,CAwDjB"}
+{"version":3,"file":"buildQuery.d.ts","sourceRoot":"","sources":["../../../src/utils/buildQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAClC,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EACpD,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,EACnC,IAAI,SAAI,EACR,QAAQ,SAAM,EACd,MAAM,GAAE,MAAM,UAAU,GAAG,IAAW,EACtC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typedapi-client-helpers",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Reusable typed OpenAPI client helpers.",
   "license": "MIT",
   "keywords": [

package/scripts/openapi-generator/index.mjs

@@ -19,7 +19,7 @@ export async function generateApi(options) {
   const source = fs.readFileSync(inputPath, "utf8");
   const openApi = JSON.parse(source);
 
-  validateOpenApiDocument(openApi, { supportedContractVersion: 1 });
+  validateOpenApiDocument(openApi, { supportedContractVersion: 2 });
   const operations = collectOperations(openApi, {
     generateMissingOperationIds: Boolean(options.generateMissingOperationIds),
     methodNameStyle: options.methodNameStyle ?? "operationId",

package/scripts/openapi-generator/method-template.mjs

@@ -9,22 +9,38 @@ function createImport(names, from, typeOnly = false) {
   const cleanNames = unique(names).sort((a, b) => a.localeCompare(b));
   if (cleanNames.length === 0) return "";
   const keyword = typeOnly ? "import type" : "import";
-  if (cleanNames.length <= 3) return `${keyword} { ${cleanNames.join(", ")} } from ${JSON.stringify(from)};`;
+  if (cleanNames.length <= 3)
+    return `${keyword} { ${cleanNames.join(", ")} } from ${JSON.stringify(from)};`;
   return `${keyword} {\n${cleanNames.map((name) => `  ${name},`).join("\n")}\n} from ${JSON.stringify(from)};`;
 }
 
 function isPrimitiveType(type) {
-  return /^(void|any|unknown|string|number|boolean|Blob|File|Record<)/.test(type);
+  return /^(void|any|unknown|string|number|boolean|Blob|File|Record<)/.test(
+    type,
+  );
 }
 
 function extractTopLevelTypeNames(type) {
-  const withoutLiterals = String(type ?? "").replace(/"(?:\\.|[^"])*"|'(?:\\.|[^'])*'/g, "");
+  const withoutLiterals = String(type ?? "").replace(
+    /"(?:\\.|[^"])*"|'(?:\\.|[^'])*'/g,
+    "",
+  );
   const matches = withoutLiterals.match(/\b[A-Z][A-Za-z0-9_]*\b/g) ?? [];
   return matches.filter(
-    (name) => ![
-      "Array", "Record", "Promise", "HttpResponse", "Blob", "File", "ApiResult",
-      "RequestParams", "FormData", "ApiClientError", "ApiHttpError",
-    ].includes(name),
+    (name) =>
+      ![
+        "Array",
+        "Record",
+        "Promise",
+        "HttpResponse",
+        "Blob",
+        "File",
+        "ApiResult",
+        "RequestParams",
+        "FormData",
+        "ApiClientError",
+        "ApiHttpError",
+      ].includes(name),
   );
 }
 
@@ -38,10 +54,11 @@ function parameterValueExpression(sourceExpression, parameter) {
 
 function parameterObjectExpression(sourceExpression, parameters) {
   const properties = parameters.map(
-    (parameter) => `${JSON.stringify(parameter.name)}: ${parameterValueExpression(
-      sourceExpression,
-      parameter,
-    )}`,
+    (parameter) =>
+      `${JSON.stringify(parameter.name)}: ${parameterValueExpression(
+        sourceExpression,
+        parameter,
+      )}`,
   );
   return properties.length <= 2
     ? `{ ${properties.join(", ")} }`
@@ -73,7 +90,9 @@ function pathExpression(routePath, pathParams, inputName = "input") {
   if (parts.length === 0) return JSON.stringify(routePath);
 
   return parts
-    .map((part) => /^"/.test(part) ? part.slice(1, -1).replace(/`/g, "\\`") : `\${${part}}`)
+    .map((part) =>
+      /^"/.test(part) ? part.slice(1, -1).replace(/`/g, "\\`") : `\${${part}}`,
+    )
     .join("")
     .replace(/^/, "`")
     .replace(/$/, "`");
@@ -83,22 +102,31 @@ function requestFormat(responseContentType, responseType) {
   if (responseType === "void" || !responseContentType) return undefined;
   if (responseContentType.includes("json")) return "json";
   if (responseContentType.startsWith("text/")) return "text";
-  if (responseContentType === "application/octet-stream" || responseType === "Blob") return "blob";
+  if (
+    responseContentType === "application/octet-stream" ||
+    responseType === "Blob"
+  )
+    return "blob";
   return undefined;
 }
 
 function contentTypeEnum(contentType) {
   switch (contentType) {
-    case "application/json": return "ContentType.Json";
-    case "application/vnd.api+json": return "ContentType.JsonApi";
-    case "multipart/form-data": return "ContentType.FormData";
-    case "application/x-www-form-urlencoded": return "ContentType.UrlEncoded";
-    case "text/plain": return "ContentType.Text";
-    default: return contentType?.includes("json") ? "ContentType.Json" : undefined;
+    case "application/json":
+      return "ContentType.Json";
+    case "application/vnd.api+json":
+      return "ContentType.JsonApi";
+    case "multipart/form-data":
+      return "ContentType.FormData";
+    case "application/x-www-form-urlencoded":
+      return "ContentType.UrlEncoded";
+    case "text/plain":
+      return "ContentType.Text";
+    default:
+      return contentType?.includes("json") ? "ContentType.Json" : undefined;
   }
 }
 
-
 function requestItems(operationInfo, operationTypes, options = {}) {
   const inputName = options.inputName ?? "input";
   const items = [
@@ -114,7 +142,11 @@ function requestItems(operationInfo, operationTypes, options = {}) {
   if (options.queryValueName) {
     items.push(`query: ${options.queryValueName}`);
   } else if (operationTypes.hasQueryParams) {
-    if (!operationTypes.hasPathParams && !operationTypes.hasHeaderParams && !operationTypes.hasCookieParams) {
+    if (
+      !operationTypes.hasPathParams &&
+      !operationTypes.hasHeaderParams &&
+      !operationTypes.hasCookieParams
+    ) {
       items.push(`query: ${inputName}`);
     } else {
       items.push(
@@ -145,9 +177,13 @@ function requestItems(operationInfo, operationTypes, options = {}) {
         inputName,
         operationTypes.parametersByLocation.cookie,
       );
-      const cookieCondition = operationTypes.parametersByLocation.cookie
-        .map((parameter) => `${parameterValueExpression(inputName, parameter)} !== undefined`)
-        .join(" || ") || "false";
+      const cookieCondition =
+        operationTypes.parametersByLocation.cookie
+          .map(
+            (parameter) =>
+              `${parameterValueExpression(inputName, parameter)} !== undefined`,
+          )
+          .join(" || ") || "false";
       headerSources.push(
         `${cookieCondition} ? { Cookie: toCookieHeader(${cookiesExpression}) } : undefined`,
       );
@@ -157,7 +193,10 @@ function requestItems(operationInfo, operationTypes, options = {}) {
 
   const type = contentTypeEnum(operationTypes.contentType);
   if (type) items.push(`type: ${type}`);
-  const format = requestFormat(operationTypes.responseContentType, operationTypes.responseType);
+  const format = requestFormat(
+    operationTypes.responseContentType,
+    operationTypes.responseType,
+  );
   if (format) items.push(`format: ${JSON.stringify(format)}`);
   return items;
 }
@@ -193,14 +232,33 @@ function promiseType(operationTypes) {
 }
 
 function isPaginated(operationTypes) {
-  return Boolean(operationTypes.paginationMetadata) ||
+  return (
+    Boolean(operationTypes.paginationMetadata) ||
     /(?:Api)?Pagination(?:Sort)?Response\b|Paged(?:Response|Result)?\b|Paginated(?:Response|Result)?\b/.test(
       operationTypes.responseType,
-    );
+    )
+  );
+}
+
+function isFilterForm(operationTypes) {
+  return Boolean(operationTypes.filterFormMetadata);
+}
+
+function isPureQueryMethod(operationTypes) {
+  return (
+    operationTypes.hasQueryParams &&
+    !operationTypes.hasPathParams &&
+    !operationTypes.bodyType &&
+    !operationTypes.hasHeaderParams &&
+    !operationTypes.hasCookieParams
+  );
 }
 
 function methodDescription(operationInfo, operationTypes) {
-  const description = operationInfo.operation.description || operationInfo.operation.summary || "No description";
+  const description =
+    operationInfo.operation.description ||
+    operationInfo.operation.summary ||
+    "No description";
   const tags = (operationInfo.operation.tags ?? []).join(", ");
   return `/**\n * ${description.replace(/\n/g, "\n * ")}\n *\n * @tags ${tags}\n * @name ${operationTypes.methodNameSource}\n * @request ${operationInfo.method}:${operationInfo.routePath}\n */`;
 }
@@ -214,7 +272,9 @@ function createRequestCall(operationInfo, operationTypes, options = {}) {
 
 function createPaginatedMethod(operationInfo, operationTypes, defaultHandlers) {
   const queryTypeName = operationTypes.parameterTypeNames.query;
-  const requestCall = createRequestCall(operationInfo, operationTypes, { queryValueName: "builtQuery" });
+  const requestCall = createRequestCall(operationInfo, operationTypes, {
+    queryValueName: "builtQuery",
+  });
   return `${methodDescription(operationInfo, operationTypes)}
 export async function ${operationTypes.methodName}(
   filters: FilterFormValues<${queryTypeName}>[] = [],
@@ -237,13 +297,47 @@ export async function ${operationTypes.methodName}(
 }`;
 }
 
+function createFilterFormMethod(
+  operationInfo,
+  operationTypes,
+  defaultHandlers,
+) {
+  const queryTypeName = operationTypes.parameterTypeNames.query;
+  const queryPropertyOptional = operationTypes.allParametersOptional ? "?" : "";
+  const filterFormDefault = operationTypes.allParametersOptional ? " = {}" : "";
+  const requestCall = createRequestCall(operationInfo, operationTypes, {
+    queryValueName: "builtQuery",
+  });
+
+  return `${methodDescription(operationInfo, operationTypes)}
+export async function ${operationTypes.methodName}(
+  filterForm: {
+    query${queryPropertyOptional}: ${queryTypeName};
+    filters?: FilterFormValues<${queryTypeName}>[];
+  }${filterFormDefault},
+  options: ${optionsType(operationTypes)} = {},
+): ${promiseType(operationTypes)} {
+  const { onSuccess, onError, params = {} } = options;
+  const builtQuery = {
+    ...(filterForm.query ?? {}),
+    ...buildFilterQuery<${queryTypeName}>(filterForm.filters ?? []),
+  };
+
+  return handleApiResponse<${operationTypes.responseType}, ${operationTypes.errorType}>(
+    () => ${requestCall},
+    ${callbackOptions(operationTypes, defaultHandlers)},
+  );
+}`;
+}
+
 function regularParameterArgumentName(operationTypes) {
   if (operationTypes.hasPathParams) return "pathParams";
   if (
     operationTypes.hasQueryParams &&
     !operationTypes.hasHeaderParams &&
     !operationTypes.hasCookieParams
-  ) return "query";
+  )
+    return "query";
   return "requestParams";
 }
 
@@ -254,7 +348,8 @@ function createRegularMethod(operationInfo, operationTypes, defaultHandlers) {
     : undefined;
 
   if (operationTypes.paramsTypeName) {
-    const canOmitParams = operationTypes.allParametersOptional && !operationTypes.bodyType;
+    const canOmitParams =
+      operationTypes.allParametersOptional && !operationTypes.bodyType;
     args.push(
       `${parameterArgumentName}: ${operationTypes.paramsTypeName}${canOmitParams ? " = {}" : ""}`,
     );
@@ -285,15 +380,26 @@ export async function ${operationTypes.methodName}(
 
 function createMethod(operationInfo, operationTypes, defaultHandlers, options) {
   if (
-    operationTypes.hasQueryParams &&
-    !operationTypes.hasPathParams &&
-    !operationTypes.bodyType &&
-    !operationTypes.hasHeaderParams &&
-    !operationTypes.hasCookieParams &&
+    isPureQueryMethod(operationTypes) &&
     options.useFilterFormValues !== false &&
     isPaginated(operationTypes)
   ) {
-    return createPaginatedMethod(operationInfo, operationTypes, defaultHandlers);
+    return createPaginatedMethod(
+      operationInfo,
+      operationTypes,
+      defaultHandlers,
+    );
+  }
+  if (
+    isPureQueryMethod(operationTypes) &&
+    options.useFilterFormValues !== false &&
+    isFilterForm(operationTypes)
+  ) {
+    return createFilterFormMethod(
+      operationInfo,
+      operationTypes,
+      defaultHandlers,
+    );
   }
   return createRegularMethod(operationInfo, operationTypes, defaultHandlers);
 }
@@ -311,28 +417,43 @@ export function controllerNameForOperation(operationInfo, options = {}) {
   return pascalCase(parts[1] ?? parts[0] ?? "Default", "Default");
 }
 
-export function generateMethodFile(openApi, controllerName, operations, options = {}) {
+export function generateMethodFile(
+  openApi,
+  controllerName,
+  operations,
+  options = {},
+) {
   const dataContractImports = [];
   const helperTypeImports = ["ApiResult", "ApiMethodOptions"];
   const helperValueImports = ["handleApiResponse"];
   const methods = [];
   let needsContentType = false;
   let needsPaginationTypes = false;
-  let needsHeaderHelpers = false;
+  let needsFilterFormTypes = false;
+  let needsHeaderParams = false;
+  let needsCookieParams = false;
 
   for (const operationInfo of operations) {
     const operationTypes = getOperationTypes(openApi, operationInfo, options);
 
-    for (const typeName of Object.values(operationTypes.parameterTypeNames)) dataContractImports.push(typeName);
-    if (operationTypes.paramsTypeName) dataContractImports.push(operationTypes.paramsTypeName);
+    for (const typeName of Object.values(operationTypes.parameterTypeNames))
+      dataContractImports.push(typeName);
+    if (operationTypes.paramsTypeName)
+      dataContractImports.push(operationTypes.paramsTypeName);
     if (operationTypes.bodyType && !isPrimitiveType(operationTypes.bodyType)) {
-      dataContractImports.push(...extractTopLevelTypeNames(operationTypes.bodyType));
+      dataContractImports.push(
+        ...extractTopLevelTypeNames(operationTypes.bodyType),
+      );
     }
     if (!isPrimitiveType(operationTypes.responseType)) {
-      dataContractImports.push(...extractTopLevelTypeNames(operationTypes.responseType));
+      dataContractImports.push(
+        ...extractTopLevelTypeNames(operationTypes.responseType),
+      );
     }
     if (!isPrimitiveType(operationTypes.errorType)) {
-      dataContractImports.push(...extractTopLevelTypeNames(operationTypes.errorType));
+      dataContractImports.push(
+        ...extractTopLevelTypeNames(operationTypes.errorType),
+      );
     }
     if (operationTypes.usesHttpErrorFallback) {
       helperTypeImports.push("ApiHttpError");
@@ -340,36 +461,78 @@ export function generateMethodFile(openApi, controllerName, operations, options
     }
 
     if (contentTypeEnum(operationTypes.contentType)) needsContentType = true;
-    if (operationTypes.hasHeaderParams || operationTypes.hasCookieParams) needsHeaderHelpers = true;
+    if (operationTypes.hasHeaderParams) needsHeaderParams = true;
+    if (operationTypes.hasCookieParams) needsCookieParams = true;
     if (
-      operationTypes.hasQueryParams &&
-      !operationTypes.hasPathParams && !operationTypes.bodyType &&
-      !operationTypes.hasHeaderParams && !operationTypes.hasCookieParams &&
-      options.useFilterFormValues !== false && isPaginated(operationTypes)
+      isPureQueryMethod(operationTypes) &&
+      options.useFilterFormValues !== false &&
+      isPaginated(operationTypes)
     ) {
       needsPaginationTypes = true;
+    } else if (
+      isPureQueryMethod(operationTypes) &&
+      options.useFilterFormValues !== false &&
+      isFilterForm(operationTypes)
+    ) {
+      needsFilterFormTypes = true;
     }
 
-    methods.push(createMethod(operationInfo, operationTypes, options.defaultHandlers, options));
+    methods.push(
+      createMethod(
+        operationInfo,
+        operationTypes,
+        options.defaultHandlers,
+        options,
+      ),
+    );
   }
 
-  if (needsHeaderHelpers) helperValueImports.push("mergeHeaders", "toCookieHeader", "toRequestHeaders");
+  if (needsHeaderParams || needsCookieParams)
+    helperValueImports.push("mergeHeaders");
+  if (needsHeaderParams) helperValueImports.push("toRequestHeaders");
+  if (needsCookieParams) helperValueImports.push("toCookieHeader");
   if (needsPaginationTypes) {
     helperValueImports.push("buildQuery");
     helperTypeImports.push(
-      "ExtractDataIfPaginated", "FilterFormValues", "SortableKeys", "SortDirection", "UnwrapArray",
+      "ExtractDataIfPaginated",
+      "FilterFormValues",
+      "SortableKeys",
+      "SortDirection",
+      "UnwrapArray",
     );
   }
+  if (needsFilterFormTypes) {
+    helperValueImports.push("buildFilterQuery");
+    helperTypeImports.push("FilterFormValues");
+  }
 
   const useTypeOnlyImports = options.useTypeOnlyImports !== false;
   const defaultHandlers = options.defaultHandlers;
   const imports = [
     generatedFileHeader(),
-    createImport(["request", ...(needsContentType ? ["ContentType"] : [])], "../generated/http-client"),
-    createImport(["RequestParams"], "../generated/http-client", useTypeOnlyImports),
-    createImport(dataContractImports, "../generated/data-contracts", useTypeOnlyImports),
-    createImport(helperValueImports, options.runtimePackageName ?? "typedapi-client-helpers"),
-    createImport(helperTypeImports, options.runtimePackageName ?? "typedapi-client-helpers", useTypeOnlyImports),
+    createImport(
+      ["request", ...(needsContentType ? ["ContentType"] : [])],
+      "../generated/http-client",
+    ),
+    createImport(
+      ["RequestParams"],
+      "../generated/http-client",
+      useTypeOnlyImports,
+    ),
+    createImport(
+      dataContractImports,
+      "../generated/data-contracts",
+      useTypeOnlyImports,
+    ),
+    createImport(
+      helperValueImports,
+      options.runtimePackageName ?? "typedapi-client-helpers",
+    ),
+    createImport(
+      helperTypeImports,
+      options.runtimePackageName ?? "typedapi-client-helpers",
+      useTypeOnlyImports,
+    ),
     defaultHandlers
       ? `import { ${defaultHandlers.success} as typedApiDefaultSuccessHandler, ${defaultHandlers.error} as typedApiDefaultErrorHandler, ${defaultHandlers.errorMessage} as typedApiDefaultErrorMessage } from ${JSON.stringify(defaultHandlers.path)};`
       : "",