sequelize-api-query-parser 0.0.0-stage → 0.1.1

package/dist/esm/utils/fields.js

@@ -0,0 +1,68 @@
+const IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const BLOCKED_KEYS = new Set(['__proto__', 'prototype', 'constructor']);
+export const isSafeIdentifier = (value) => IDENTIFIER_PATTERN.test(value) && !BLOCKED_KEYS.has(value);
+export const getModelAttributes = (model) => {
+    try {
+        const attributes = model.getAttributes();
+        return attributes && typeof attributes === 'object' ? attributes : {};
+    }
+    catch {
+        return {};
+    }
+};
+export const getAttributeNames = (model) => Object.keys(getModelAttributes(model)).filter(isSafeIdentifier);
+export const getSqlFieldReference = (rootModel, path, baseAssociationPath = []) => {
+    if (path.length === 0 ||
+        path.some((segment) => !isSafeIdentifier(segment)) ||
+        baseAssociationPath.some((segment) => !isSafeIdentifier(segment))) {
+        return null;
+    }
+    const attribute = path.at(-1);
+    if (!attribute) {
+        return null;
+    }
+    const associationPath = [...baseAssociationPath, ...path.slice(0, -1)];
+    if (associationPath.length === 0) {
+        return isSafeIdentifier(rootModel.name) ? `"${rootModel.name}"."${attribute}"` : null;
+    }
+    const associationAlias = associationPath.join('->');
+    return `"${associationAlias}"."${attribute}"`;
+};
+const normalizeFieldPath = (path) => {
+    const trimmed = path.trim();
+    return trimmed.startsWith('$') && trimmed.endsWith('$') ? trimmed.slice(1, -1) : trimmed;
+};
+export const resolveField = (model, path) => {
+    const segments = normalizeFieldPath(path).split('.');
+    if (segments.length === 0 || segments.some((segment) => !isSafeIdentifier(segment))) {
+        return null;
+    }
+    let currentModel = model;
+    for (const associationName of segments.slice(0, -1)) {
+        const associations = currentModel.associations;
+        if (!associations || !Object.prototype.hasOwnProperty.call(associations, associationName)) {
+            return null;
+        }
+        const target = associations[associationName]?.target;
+        if (!target || typeof target.getAttributes !== 'function') {
+            return null;
+        }
+        currentModel = target;
+    }
+    const attribute = segments.at(-1);
+    if (!attribute) {
+        return null;
+    }
+    const attributes = getModelAttributes(currentModel);
+    if (!Object.prototype.hasOwnProperty.call(attributes, attribute)) {
+        return null;
+    }
+    const typeName = attributes[attribute]?.type?.constructor?.name;
+    return {
+        path: segments,
+        model: currentModel,
+        attribute,
+        typeName: typeof typeName === 'string' ? typeName : undefined,
+    };
+};
+//# sourceMappingURL=fields.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../src/utils/fields.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Model, ModelStatic } from 'sequelize';\n\nconst IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst BLOCKED_KEYS = new Set(['__proto__', 'prototype', 'constructor']);\n\nexport interface ResolvedField {\n  readonly path: string[];\n  readonly model: ModelStatic<Model>;\n  readonly attribute: string;\n  readonly typeName: string | undefined;\n}\n\nexport const isSafeIdentifier = (value: string): boolean =>\n  IDENTIFIER_PATTERN.test(value) && !BLOCKED_KEYS.has(value);\n\nexport const getModelAttributes = (model: ModelStatic<Model>): Record<string, any> => {\n  try {\n    const attributes = model.getAttributes();\n    return attributes && typeof attributes === 'object' ? (attributes as Record<string, any>) : {};\n  } catch {\n    return {};\n  }\n};\n\nexport const getAttributeNames = (model: ModelStatic<Model>): string[] =>\n  Object.keys(getModelAttributes(model)).filter(isSafeIdentifier);\n\nexport const getSqlFieldReference = (\n  rootModel: ModelStatic<Model>,\n  path: readonly string[],\n  baseAssociationPath: readonly string[] = [],\n): string | null => {\n  if (\n    path.length === 0 ||\n    path.some((segment) => !isSafeIdentifier(segment)) ||\n    baseAssociationPath.some((segment) => !isSafeIdentifier(segment))\n  ) {\n    return null;\n  }\n\n  const attribute = path.at(-1);\n  if (!attribute) {\n    return null;\n  }\n\n  const associationPath = [...baseAssociationPath, ...path.slice(0, -1)];\n  if (associationPath.length === 0) {\n    return isSafeIdentifier(rootModel.name) ? `\"${rootModel.name}\".\"${attribute}\"` : null;\n  }\n\n  const associationAlias = associationPath.join('->');\n  return `\"${associationAlias}\".\"${attribute}\"`;\n};\n\nconst normalizeFieldPath = (path: string): string => {\n  const trimmed = path.trim();\n  return trimmed.startsWith('$') && trimmed.endsWith('$') ? trimmed.slice(1, -1) : trimmed;\n};\n\nexport const resolveField = (model: ModelStatic<Model>, path: string): ResolvedField | null => {\n  const segments = normalizeFieldPath(path).split('.');\n  if (segments.length === 0 || segments.some((segment) => !isSafeIdentifier(segment))) {\n    return null;\n  }\n\n  let currentModel = model;\n  for (const associationName of segments.slice(0, -1)) {\n    const associations = currentModel.associations as Record<string, { target?: ModelStatic<Model> }> | undefined;\n    if (!associations || !Object.prototype.hasOwnProperty.call(associations, associationName)) {\n      return null;\n    }\n\n    const target = associations[associationName]?.target;\n    if (!target || typeof target.getAttributes !== 'function') {\n      return null;\n    }\n    currentModel = target;\n  }\n\n  const attribute = segments.at(-1);\n  if (!attribute) {\n    return null;\n  }\n\n  const attributes = getModelAttributes(currentModel);\n  if (!Object.prototype.hasOwnProperty.call(attributes, attribute)) {\n    return null;\n  }\n\n  const typeName = attributes[attribute]?.type?.constructor?.name;\n  return {\n    path: segments,\n    model: currentModel,\n    attribute,\n    typeName: typeof typeName === 'string' ? typeName : undefined,\n  };\n};\n"]}

package/dist/esm/utils/values.js

@@ -0,0 +1,138 @@
+export const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value) && !(value instanceof Date);
+export const parseBoolean = (value, fallback) => {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === 'true') {
+            return true;
+        }
+        if (normalized === 'false') {
+            return false;
+        }
+    }
+    return fallback;
+};
+export const parsePositiveInteger = (value, fallback, maximum) => {
+    const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value.trim()) : Number.NaN;
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return fallback;
+    }
+    return Math.min(Math.floor(parsed), maximum);
+};
+export const isScalarValue = (value) => value === null || ['string', 'number', 'boolean'].includes(typeof value) || value instanceof Date;
+const BIGINT_PATTERN = /^[+-]?\d+$/;
+const DECIMAL_PATTERN = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
+const fromTaggedString = (tag, value) => {
+    switch (tag) {
+        case 'n':
+        case 'f': {
+            if (!value.trim()) {
+                return { valid: false };
+            }
+            const parsed = Number(value);
+            return Number.isFinite(parsed) ? { valid: true, value: parsed } : { valid: false };
+        }
+        case 'b':
+            return value === 'true' || value === 'false' ? { valid: true, value: value === 'true' } : { valid: false };
+        case 'd': {
+            const parsed = new Date(value);
+            return Number.isNaN(parsed.getTime()) ? { valid: false } : { valid: true, value: parsed };
+        }
+        case 's':
+            return { valid: true, value };
+        default:
+            return { valid: false };
+    }
+};
+export const parseTypedValue = (value, typeName) => {
+    if (!isScalarValue(value)) {
+        return { valid: false };
+    }
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? { valid: false } : { valid: true, value };
+    }
+    if (value === null || typeof value !== 'string') {
+        return { valid: true, value };
+    }
+    if (value === '') {
+        return { valid: true, value: null };
+    }
+    const tagged = /^([nfbsd])\|(.*)$/s.exec(value);
+    if (tagged) {
+        return fromTaggedString(tagged[1] ?? '', tagged[2] ?? '');
+    }
+    switch (typeName) {
+        case 'BIGINT': {
+            const normalized = value.trim();
+            return BIGINT_PATTERN.test(normalized)
+                ? { valid: true, value: normalized }
+                : { valid: false };
+        }
+        case 'INTEGER': {
+            const parsed = Number(value);
+            return Number.isInteger(parsed) ? { valid: true, value: parsed } : { valid: false };
+        }
+        case 'DECIMAL': {
+            const normalized = value.trim();
+            return DECIMAL_PATTERN.test(normalized)
+                ? { valid: true, value: normalized }
+                : { valid: false };
+        }
+        case 'FLOAT':
+        case 'DOUBLE':
+        case 'REAL': {
+            const parsed = Number(value);
+            return Number.isFinite(parsed) ? { valid: true, value: parsed } : { valid: false };
+        }
+        case 'BOOLEAN':
+            return value === 'true' || value === 'false' ? { valid: true, value: value === 'true' } : { valid: false };
+        case 'DATE':
+        case 'DATEONLY': {
+            const parsed = new Date(value);
+            return Number.isNaN(parsed.getTime()) ? { valid: false } : { valid: true, value: parsed };
+        }
+        default:
+            return { valid: true, value };
+    }
+};
+export const parseTypedList = (value, typeName) => {
+    let values;
+    if (Array.isArray(value)) {
+        values = value;
+    }
+    else if (typeof value === 'string') {
+        const tagged = /^([nfbsd])\|(.*)$/s.exec(value);
+        values = tagged
+            ? (tagged[2] ?? '').split(',').map((item) => `${tagged[1]}|${item}`)
+            : value.split(',');
+    }
+    else {
+        return { valid: false };
+    }
+    const parsed = values.map((item) => parseTypedValue(item, typeName));
+    return parsed.every((item) => item.valid)
+        ? { valid: true, value: parsed.map((item) => item.value) }
+        : { valid: false };
+};
+export const isValidDateText = (value) => {
+    const normalized = value.trim();
+    if (!normalized) {
+        return false;
+    }
+    return !Number.isNaN(new Date(normalized).getTime());
+};
+export const isValidTimeZone = (value) => {
+    if (typeof value !== 'string' || value.length === 0 || value.length > 100) {
+        return false;
+    }
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: value }).format();
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=values.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/utils/values.ts"],"names":[],"mappings":"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","sourcesContent":["export const isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value) && !(value instanceof Date);\n\nexport const parseBoolean = (value: unknown, fallback?: boolean): boolean | undefined => {\n  if (typeof value === 'boolean') {\n    return value;\n  }\n\n  if (typeof value === 'string') {\n    const normalized = value.trim().toLowerCase();\n    if (normalized === 'true') {\n      return true;\n    }\n    if (normalized === 'false') {\n      return false;\n    }\n  }\n\n  return fallback;\n};\n\nexport const parsePositiveInteger = (value: unknown, fallback: number, maximum: number): number => {\n  const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value.trim()) : Number.NaN;\n\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    return fallback;\n  }\n\n  return Math.min(Math.floor(parsed), maximum);\n};\n\nexport interface ParsedValue {\n  readonly valid: boolean;\n  readonly value?: unknown;\n}\n\nexport const isScalarValue = (value: unknown): value is string | number | boolean | Date | null =>\n  value === null || ['string', 'number', 'boolean'].includes(typeof value) || value instanceof Date;\n\nconst BIGINT_PATTERN = /^[+-]?\\d+$/;\nconst DECIMAL_PATTERN = /^[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:e[+-]?\\d+)?$/i;\n\nconst fromTaggedString = (tag: string, value: string): ParsedValue => {\n  switch (tag) {\n    case 'n':\n    case 'f': {\n      if (!value.trim()) {\n        return { valid: false };\n      }\n      const parsed = Number(value);\n      return Number.isFinite(parsed) ? { valid: true, value: parsed } : { valid: false };\n    }\n    case 'b':\n      return value === 'true' || value === 'false' ? { valid: true, value: value === 'true' } : { valid: false };\n    case 'd': {\n      const parsed = new Date(value);\n      return Number.isNaN(parsed.getTime()) ? { valid: false } : { valid: true, value: parsed };\n    }\n    case 's':\n      return { valid: true, value };\n    default:\n      return { valid: false };\n  }\n};\n\nexport const parseTypedValue = (value: unknown, typeName?: string): ParsedValue => {\n  if (!isScalarValue(value)) {\n    return { valid: false };\n  }\n\n  if (value instanceof Date) {\n    return Number.isNaN(value.getTime()) ? { valid: false } : { valid: true, value };\n  }\n\n  if (value === null || typeof value !== 'string') {\n    return { valid: true, value };\n  }\n\n  if (value === '') {\n    return { valid: true, value: null };\n  }\n\n  const tagged = /^([nfbsd])\\|(.*)$/s.exec(value);\n  if (tagged) {\n    return fromTaggedString(tagged[1] ?? '', tagged[2] ?? '');\n  }\n\n  switch (typeName) {\n    case 'BIGINT': {\n      const normalized = value.trim();\n      return BIGINT_PATTERN.test(normalized)\n        ? { valid: true, value: normalized }\n        : { valid: false };\n    }\n    case 'INTEGER': {\n      const parsed = Number(value);\n      return Number.isInteger(parsed) ? { valid: true, value: parsed } : { valid: false };\n    }\n    case 'DECIMAL': {\n      const normalized = value.trim();\n      return DECIMAL_PATTERN.test(normalized)\n        ? { valid: true, value: normalized }\n        : { valid: false };\n    }\n    case 'FLOAT':\n    case 'DOUBLE':\n    case 'REAL': {\n      const parsed = Number(value);\n      return Number.isFinite(parsed) ? { valid: true, value: parsed } : { valid: false };\n    }\n    case 'BOOLEAN':\n      return value === 'true' || value === 'false' ? { valid: true, value: value === 'true' } : { valid: false };\n    case 'DATE':\n    case 'DATEONLY': {\n      const parsed = new Date(value);\n      return Number.isNaN(parsed.getTime()) ? { valid: false } : { valid: true, value: parsed };\n    }\n    default:\n      return { valid: true, value };\n  }\n};\n\nexport const parseTypedList = (value: unknown, typeName?: string): ParsedValue => {\n  let values: unknown[];\n\n  if (Array.isArray(value)) {\n    values = value;\n  } else if (typeof value === 'string') {\n    const tagged = /^([nfbsd])\\|(.*)$/s.exec(value);\n    values = tagged\n      ? (tagged[2] ?? '').split(',').map((item) => `${tagged[1]}|${item}`)\n      : value.split(',');\n  } else {\n    return { valid: false };\n  }\n\n  const parsed = values.map((item) => parseTypedValue(item, typeName));\n  return parsed.every((item) => item.valid)\n    ? { valid: true, value: parsed.map((item) => item.value) }\n    : { valid: false };\n};\n\nexport const isValidDateText = (value: string): boolean => {\n  const normalized = value.trim();\n  if (!normalized) {\n    return false;\n  }\n\n  return !Number.isNaN(new Date(normalized).getTime());\n};\n\nexport const isValidTimeZone = (value: unknown): value is string => {\n  if (typeof value !== 'string' || value.length === 0 || value.length > 100) {\n    return false;\n  }\n\n  try {\n    new Intl.DateTimeFormat('en-US', { timeZone: value }).format();\n    return true;\n  } catch {\n    return false;\n  }\n};\n"]}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export { QueryParser } from './query-parser.js';
+export type { ColumnDetail, ParsedQuery, QueryParserOptions, QueryParserQuery, QueryParserRequest, } from './types.js';

package/dist/types/parsers/include.d.ts

@@ -0,0 +1,12 @@
+import type { Includeable, Model, ModelStatic } from 'sequelize';
+interface ParseIncludesOptions {
+    readonly input: unknown;
+    readonly model: ModelStatic<Model>;
+    readonly isGroupBy?: boolean;
+    readonly depth?: number;
+    readonly seen?: WeakSet<object>;
+    readonly associationPath?: readonly string[];
+    readonly maxLimit?: number;
+}
+export declare const parseIncludes: ({ input, model, isGroupBy, depth, seen, associationPath, maxLimit, }: ParseIncludesOptions) => Includeable[];
+export {};

package/dist/types/parsers/order.d.ts

@@ -0,0 +1,2 @@
+import type { Model, ModelStatic, Order } from 'sequelize';
+export declare const parseOrder: (model: ModelStatic<Model>, input: unknown) => Order;

package/dist/types/parsers/search.d.ts

@@ -0,0 +1,13 @@
+import type { Model, ModelStatic, WhereOptions } from 'sequelize';
+import type { ColumnDetail } from '../types.js';
+interface ParseSearchOptions {
+    readonly searchText: unknown;
+    readonly searchFields: unknown;
+    readonly checkYesNo?: unknown;
+    readonly timezone?: unknown;
+    readonly model: ModelStatic<Model>;
+    readonly columns?: Readonly<Partial<Record<string, ColumnDetail>>>;
+}
+export declare const parseSearch: ({ searchText, searchFields, checkYesNo, timezone, model, columns, }: ParseSearchOptions) => WhereOptions | null;
+export declare const mergeSearchWhere: (filterWhere: WhereOptions, searchWhere: WhereOptions | null) => WhereOptions;
+export {};

package/dist/types/parsers/select.d.ts

@@ -0,0 +1,2 @@
+import type { Model, ModelStatic } from 'sequelize';
+export declare const parseSelection: (model: ModelStatic<Model>, input: unknown) => string[];

package/dist/types/parsers/where.d.ts

@@ -0,0 +1,13 @@
+import type { Model, ModelStatic, WhereOptions } from 'sequelize';
+import type { ColumnDetail } from '../types.js';
+interface ParseWhereOptions {
+    readonly input: unknown;
+    readonly model: ModelStatic<Model>;
+    readonly columns?: Readonly<Partial<Record<string, ColumnDetail>>>;
+    readonly associationPath?: readonly string[];
+}
+export declare const parseWhere: ({ input, model, columns, associationPath }: ParseWhereOptions) => {
+    where: WhereOptions;
+    whereFields: string[];
+};
+export {};

package/dist/types/query-parser.d.ts

@@ -0,0 +1,7 @@
+import type { Model } from 'sequelize';
+import type { ParsedQuery, QueryParserOptions } from './types.js';
+export declare class QueryParser<M extends Model> {
+    #private;
+    constructor(options: QueryParserOptions<M>);
+    getFullQuery(target?: Record<string, unknown>): ParsedQuery;
+}

package/dist/types/types.d.ts

@@ -0,0 +1,52 @@
+import type { Includeable, Model, ModelStatic, Order, WhereOptions } from 'sequelize';
+export type QueryParserQuery = Record<string, unknown> & {
+    checkYesNo?: unknown;
+    include?: unknown;
+    limit?: unknown;
+    page?: unknown;
+    paranoid?: unknown;
+    q?: unknown;
+    searchFields?: unknown;
+    searchText?: unknown;
+    select?: unknown;
+    sort?: unknown;
+    subQuery?: unknown;
+};
+export interface QueryParserRequest {
+    readonly query?: QueryParserQuery;
+    readonly headers?: Readonly<Record<string, string | readonly string[] | undefined>>;
+}
+export interface ColumnDetail {
+    readonly displayName?: string;
+    readonly fieldName: string;
+    readonly type: string;
+    readonly show?: boolean;
+    readonly custom?: boolean;
+    readonly default?: boolean;
+    readonly width?: number;
+    readonly minWidth?: number;
+    readonly isPinned?: boolean;
+    readonly include?: Readonly<Record<string, unknown>>;
+    readonly searchKeys?: readonly string[];
+    readonly tableName?: string;
+    readonly foreignKey?: string;
+    readonly fieldType?: 'column' | 'association' | 'filter';
+}
+export interface QueryParserOptions<M extends Model = Model> {
+    readonly request: QueryParserRequest;
+    readonly model: ModelStatic<M>;
+    readonly columns?: Readonly<Partial<Record<string, ColumnDetail>>>;
+    readonly isGroupBy?: boolean;
+    readonly maxLimit?: number;
+}
+export type ParsedQuery = Record<string, unknown> & {
+    readonly where: WhereOptions;
+    readonly order: Order;
+    readonly limit: number;
+    readonly offset: number;
+    readonly include: Includeable[];
+    readonly attributes: string[];
+    readonly subQuery: boolean | undefined;
+    readonly paranoid: boolean | undefined;
+    readonly whereFields: string[];
+};

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

@@ -0,0 +1,12 @@
+import type { Model, ModelStatic } from 'sequelize';
+export interface ResolvedField {
+    readonly path: string[];
+    readonly model: ModelStatic<Model>;
+    readonly attribute: string;
+    readonly typeName: string | undefined;
+}
+export declare const isSafeIdentifier: (value: string) => boolean;
+export declare const getModelAttributes: (model: ModelStatic<Model>) => Record<string, any>;
+export declare const getAttributeNames: (model: ModelStatic<Model>) => string[];
+export declare const getSqlFieldReference: (rootModel: ModelStatic<Model>, path: readonly string[], baseAssociationPath?: readonly string[]) => string | null;
+export declare const resolveField: (model: ModelStatic<Model>, path: string) => ResolvedField | null;

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

@@ -0,0 +1,12 @@
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+export declare const parseBoolean: (value: unknown, fallback?: boolean) => boolean | undefined;
+export declare const parsePositiveInteger: (value: unknown, fallback: number, maximum: number) => number;
+export interface ParsedValue {
+    readonly valid: boolean;
+    readonly value?: unknown;
+}
+export declare const isScalarValue: (value: unknown) => value is string | number | boolean | Date | null;
+export declare const parseTypedValue: (value: unknown, typeName?: string) => ParsedValue;
+export declare const parseTypedList: (value: unknown, typeName?: string) => ParsedValue;
+export declare const isValidDateText: (value: string) => boolean;
+export declare const isValidTimeZone: (value: unknown) => value is string;

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "sequelize-api-query-parser",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Safely parse HTTP query parameters into Sequelize query options.",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "node scripts/clean.mjs",
+    "build": "npm run clean && tsc -p tsconfig.build.esm.json && tsc -p tsconfig.build.cjs.json && node scripts/prepare-dist.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src test --max-warnings=0",
+    "smoke": "node scripts/smoke-esm.mjs && node scripts/smoke-cjs.cjs && tsc -p test/consumer/tsconfig.json",
+    "check": "npm run lint && npm run typecheck && npm test && npm run build && npm run smoke",
+    "prepack": "npm run check"
+  },
+  "keywords": [
+    "sequelize",
+    "query-parser",
+    "typescript",
+    "express",
+    "filtering",
+    "pagination"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "sequelize": ">=6.37.8 <7"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.9",
+    "@vitest/coverage-v8": "4.1.11",
+    "eslint": "9.39.5",
+    "globals": "15.15.0",
+    "semver": "7.8.5",
+    "sequelize": "6.37.8",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.69.0",
+    "vitest": "4.1.11"
+  }
+}