refactor: improve type safety with proper type guards and add ESLint

[eli0shin]

Summary

• Add ESLint configuration with eslint-for-ai for improved code quality
• Replace type assertions with proper type guard functions for better type safety
• Refactor internal query compilation logic for cleaner separation of concerns

Changes

ESLint Configuration:

• Added eslint-for-ai package with recommended rules for AI-assisted development
• Configured ESLint to use TypeScript parser and resolver
• Added lint and lint:fix scripts to package.json

Type Safety Improvements:

• Introduced type guard functions: isBaseQuery(), isQueryValue(), and isOperator()
• Replaced type assertions with type guards throughout the codebase
• Changed queryBuilder return type from any to unknown for better type safety

Code Refactoring:

• Extracted internal query compilation logic to compileQueryInternal() helper function
• Updated compileDatadogQuery() to use the new internal helper
• Added ESLint disable comment for the wrapper pattern with explanation
• Improved test types using satisfies instead of explicit type annotations

Test plan

• All existing tests pass
• Type checking passes
• ESLint runs without errors on the codebase

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: fbd411c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
barkql	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

Pull request overview

This PR improves type safety by replacing type assertions with proper type guard functions and adds ESLint configuration for better code quality enforcement in AI-assisted development.

Key changes:

• Introduced type guard functions (isBaseQuery(), isQueryValue(), isOperator()) to replace unsafe type assertions
• Extracted query compilation logic into compileQueryInternal() helper for better separation of concerns
• Changed queryBuilder return type from any to unknown for stricter type checking

Reviewed changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/index.ts	Core refactoring with type guards replacing type assertions, new internal compilation function, and improved type safety with unknown return type
src/index.test-d.ts	Updated type tests to use satisfies operator instead of explicit type annotations for better type inference
package.json	Added ESLint packages and configuration, including eslint-for-ai, TypeScript parser, and resolver
eslint.config.js	New ESLint configuration file using eslint-for-ai recommended rules
bun.lock	Lock file updates for new ESLint-related dependencies
.changeset/smooth-lions-dance.md	Changeset documenting the patch-level changes

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.