Skip to content

Add project constitution and enhance Profiler with namespace support#4

Merged
sebamar88 merged 7 commits intomainfrom
profiler-namespace
Feb 6, 2026
Merged

Add project constitution and enhance Profiler with namespace support#4
sebamar88 merged 7 commits intomainfrom
profiler-namespace

Conversation

@sebamar88
Copy link
Copy Markdown
Owner

Description

Add a project constitution outlining development principles and guidelines. Enhance the Profiler class to support namespace isolation for better measurement organization. Comprehensive tests added for CompressionUtils, CryptoUtils, FormUtils, Logger, and Profiler to ensure functionality and reliability.

Related Issue

Fixes # (no issue referenced)

Type of Change

  • 🐛 Bug fix (non-breaking change which fixes an issue)
  • ✨ New feature (non-breaking change which adds functionality)
  • 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • 📝 Documentation update
  • 🔧 Chore (refactoring, tooling, dependencies)

Changes Made

  • Added project constitution file.
  • Enhanced Profiler class to include namespace support.
  • Added tests for CompressionUtils, CryptoUtils, FormUtils, Logger, and Profiler.

Testing

  • Unit tests added/updated
  • Integration tests added/updated
  • All tests passing
  • Manual testing completed

Coverage

Coverage: XX%

Screenshots

Checklist

  • My code follows the style guidelines of this project
  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published

Breaking Changes

Additional Notes

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📦 Bundle Size Report

Total dist size: 1.4M

View detailed breakdown
4.0K	dist/api-client.d.ts
4.0K	dist/api-client.d.ts.map
4.0K	dist/api-client.js
4.0K	dist/api-client.js.map
68K	dist/cli
4.0K	dist/color-utils.d.ts
4.0K	dist/color-utils.d.ts.map
4.0K	dist/color-utils.js
4.0K	dist/color-utils.js.map
4.0K	dist/date-utils.d.ts
4.0K	dist/date-utils.d.ts.map
4.0K	dist/date-utils.js
4.0K	dist/date-utils.js.map
4.0K	dist/debug.d.ts
4.0K	dist/debug.d.ts.map
4.0K	dist/debug.js
4.0K	dist/debug.js.map
4.0K	dist/env-manager.d.ts
4.0K	dist/env-manager.d.ts.map
4.0K	dist/env-manager.js
4.0K	dist/env-manager.js.map
4.0K	dist/file-upload.d.ts
4.0K	dist/file-upload.d.ts.map
4.0K	dist/file-upload.js
4.0K	dist/file-upload.js.map
4.0K	dist/index.d.ts
4.0K	dist/index.d.ts.map
4.0K	dist/index.js
4.0K	dist/index.js.map
4.0K	dist/logger.d.ts
4.0K	dist/logger.d.ts.map
4.0K	dist/logger.js
4.0K	dist/logger.js.map
4.0K	dist/number-utils.d.ts
4.0K	dist/number-utils.d.ts.map
4.0K	dist/number-utils.js
4.0K	dist/number-utils.js.map
4.0K	dist/profiler.d.ts
4.0K	dist/profiler.d.ts.map
4.0K	dist/profiler.js
4.0K	dist/profiler.js.map
4.0K	dist/response-validator.d.ts
4.0K	dist/response-validator.d.ts.map
4.0K	dist/response-validator.js
4.0K	dist/response-validator.js.map
4.0K	dist/retry-policy.d.ts
4.0K	dist/retry-policy.d.ts.map
4.0K	dist/retry-policy.js
4.0K	dist/retry-policy.js.map
4.0K	dist/storage-utils.d.ts
4.0K	dist/storage-utils.d.ts.map
4.0K	dist/storage-utils.js
4.0K	dist/storage-utils.js.map
4.0K	dist/streaming.d.ts
4.0K	dist/streaming.d.ts.map
4.0K	dist/streaming.js
4.0K	dist/streaming.js.map
4.0K	dist/string-utils.d.ts
4.0K	dist/string-utils.d.ts.map
4.0K	dist/string-utils.js
4.0K	dist/string-utils.js.map
672K	dist/utils/helpers
364K	dist/utils/core
1.1M	dist/utils
4.0K	dist/validator.d.ts
4.0K	dist/validator.d.ts.map
4.0K	dist/validator.js
4.0K	dist/validator.js.map
4.0K	dist/websocket.d.ts
4.0K	dist/websocket.d.ts.map
4.0K	dist/websocket.js
4.0K	dist/websocket.js.map

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📊 Code Coverage Report

Coverage: %

❌ Low coverage - please add more tests

@codecov-commenter
Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📦 Bundle Size Report

Total dist size: 1.4M

View detailed breakdown
4.0K	dist/api-client.d.ts
4.0K	dist/api-client.d.ts.map
4.0K	dist/api-client.js
4.0K	dist/api-client.js.map
68K	dist/cli
4.0K	dist/color-utils.d.ts
4.0K	dist/color-utils.d.ts.map
4.0K	dist/color-utils.js
4.0K	dist/color-utils.js.map
4.0K	dist/date-utils.d.ts
4.0K	dist/date-utils.d.ts.map
4.0K	dist/date-utils.js
4.0K	dist/date-utils.js.map
4.0K	dist/debug.d.ts
4.0K	dist/debug.d.ts.map
4.0K	dist/debug.js
4.0K	dist/debug.js.map
4.0K	dist/env-manager.d.ts
4.0K	dist/env-manager.d.ts.map
4.0K	dist/env-manager.js
4.0K	dist/env-manager.js.map
4.0K	dist/file-upload.d.ts
4.0K	dist/file-upload.d.ts.map
4.0K	dist/file-upload.js
4.0K	dist/file-upload.js.map
4.0K	dist/index.d.ts
4.0K	dist/index.d.ts.map
4.0K	dist/index.js
4.0K	dist/index.js.map
4.0K	dist/logger.d.ts
4.0K	dist/logger.d.ts.map
4.0K	dist/logger.js
4.0K	dist/logger.js.map
4.0K	dist/number-utils.d.ts
4.0K	dist/number-utils.d.ts.map
4.0K	dist/number-utils.js
4.0K	dist/number-utils.js.map
4.0K	dist/profiler.d.ts
4.0K	dist/profiler.d.ts.map
4.0K	dist/profiler.js
4.0K	dist/profiler.js.map
4.0K	dist/response-validator.d.ts
4.0K	dist/response-validator.d.ts.map
4.0K	dist/response-validator.js
4.0K	dist/response-validator.js.map
4.0K	dist/retry-policy.d.ts
4.0K	dist/retry-policy.d.ts.map
4.0K	dist/retry-policy.js
4.0K	dist/retry-policy.js.map
4.0K	dist/storage-utils.d.ts
4.0K	dist/storage-utils.d.ts.map
4.0K	dist/storage-utils.js
4.0K	dist/storage-utils.js.map
4.0K	dist/streaming.d.ts
4.0K	dist/streaming.d.ts.map
4.0K	dist/streaming.js
4.0K	dist/streaming.js.map
4.0K	dist/string-utils.d.ts
4.0K	dist/string-utils.d.ts.map
4.0K	dist/string-utils.js
4.0K	dist/string-utils.js.map
672K	dist/utils/helpers
364K	dist/utils/core
1.1M	dist/utils
4.0K	dist/validator.d.ts
4.0K	dist/validator.d.ts.map
4.0K	dist/validator.js
4.0K	dist/validator.js.map
4.0K	dist/websocket.d.ts
4.0K	dist/websocket.d.ts.map
4.0K	dist/websocket.js
4.0K	dist/websocket.js.map

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📊 Code Coverage Report

Coverage: %

❌ Low coverage - please add more tests

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📦 Bundle Size Report

Total dist size: 1.4M

View detailed breakdown
4.0K	dist/api-client.d.ts
4.0K	dist/api-client.d.ts.map
4.0K	dist/api-client.js
4.0K	dist/api-client.js.map
68K	dist/cli
4.0K	dist/color-utils.d.ts
4.0K	dist/color-utils.d.ts.map
4.0K	dist/color-utils.js
4.0K	dist/color-utils.js.map
4.0K	dist/date-utils.d.ts
4.0K	dist/date-utils.d.ts.map
4.0K	dist/date-utils.js
4.0K	dist/date-utils.js.map
4.0K	dist/debug.d.ts
4.0K	dist/debug.d.ts.map
4.0K	dist/debug.js
4.0K	dist/debug.js.map
4.0K	dist/env-manager.d.ts
4.0K	dist/env-manager.d.ts.map
4.0K	dist/env-manager.js
4.0K	dist/env-manager.js.map
4.0K	dist/file-upload.d.ts
4.0K	dist/file-upload.d.ts.map
4.0K	dist/file-upload.js
4.0K	dist/file-upload.js.map
4.0K	dist/index.d.ts
4.0K	dist/index.d.ts.map
4.0K	dist/index.js
4.0K	dist/index.js.map
4.0K	dist/logger.d.ts
4.0K	dist/logger.d.ts.map
4.0K	dist/logger.js
4.0K	dist/logger.js.map
4.0K	dist/number-utils.d.ts
4.0K	dist/number-utils.d.ts.map
4.0K	dist/number-utils.js
4.0K	dist/number-utils.js.map
4.0K	dist/profiler.d.ts
4.0K	dist/profiler.d.ts.map
4.0K	dist/profiler.js
4.0K	dist/profiler.js.map
4.0K	dist/response-validator.d.ts
4.0K	dist/response-validator.d.ts.map
4.0K	dist/response-validator.js
4.0K	dist/response-validator.js.map
4.0K	dist/retry-policy.d.ts
4.0K	dist/retry-policy.d.ts.map
4.0K	dist/retry-policy.js
4.0K	dist/retry-policy.js.map
4.0K	dist/storage-utils.d.ts
4.0K	dist/storage-utils.d.ts.map
4.0K	dist/storage-utils.js
4.0K	dist/storage-utils.js.map
4.0K	dist/streaming.d.ts
4.0K	dist/streaming.d.ts.map
4.0K	dist/streaming.js
4.0K	dist/streaming.js.map
4.0K	dist/string-utils.d.ts
4.0K	dist/string-utils.d.ts.map
4.0K	dist/string-utils.js
4.0K	dist/string-utils.js.map
672K	dist/utils/helpers
364K	dist/utils/core
1.1M	dist/utils
4.0K	dist/validator.d.ts
4.0K	dist/validator.d.ts.map
4.0K	dist/validator.js
4.0K	dist/validator.js.map
4.0K	dist/websocket.d.ts
4.0K	dist/websocket.d.ts.map
4.0K	dist/websocket.js
4.0K	dist/websocket.js.map

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📊 Code Coverage Report

Coverage: % ❌

Low coverage - please add more tests

View full coverage report

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📊 Code Coverage Report

Coverage: %

❌ Low coverage - please add more tests

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📦 Bundle Size Report

Total dist size: 1.4M

View detailed breakdown
4.0K	dist/api-client.d.ts
4.0K	dist/api-client.d.ts.map
4.0K	dist/api-client.js
4.0K	dist/api-client.js.map
68K	dist/cli
4.0K	dist/color-utils.d.ts
4.0K	dist/color-utils.d.ts.map
4.0K	dist/color-utils.js
4.0K	dist/color-utils.js.map
4.0K	dist/date-utils.d.ts
4.0K	dist/date-utils.d.ts.map
4.0K	dist/date-utils.js
4.0K	dist/date-utils.js.map
4.0K	dist/debug.d.ts
4.0K	dist/debug.d.ts.map
4.0K	dist/debug.js
4.0K	dist/debug.js.map
4.0K	dist/env-manager.d.ts
4.0K	dist/env-manager.d.ts.map
4.0K	dist/env-manager.js
4.0K	dist/env-manager.js.map
4.0K	dist/file-upload.d.ts
4.0K	dist/file-upload.d.ts.map
4.0K	dist/file-upload.js
4.0K	dist/file-upload.js.map
4.0K	dist/index.d.ts
4.0K	dist/index.d.ts.map
4.0K	dist/index.js
4.0K	dist/index.js.map
4.0K	dist/logger.d.ts
4.0K	dist/logger.d.ts.map
4.0K	dist/logger.js
4.0K	dist/logger.js.map
4.0K	dist/number-utils.d.ts
4.0K	dist/number-utils.d.ts.map
4.0K	dist/number-utils.js
4.0K	dist/number-utils.js.map
4.0K	dist/profiler.d.ts
4.0K	dist/profiler.d.ts.map
4.0K	dist/profiler.js
4.0K	dist/profiler.js.map
4.0K	dist/response-validator.d.ts
4.0K	dist/response-validator.d.ts.map
4.0K	dist/response-validator.js
4.0K	dist/response-validator.js.map
4.0K	dist/retry-policy.d.ts
4.0K	dist/retry-policy.d.ts.map
4.0K	dist/retry-policy.js
4.0K	dist/retry-policy.js.map
4.0K	dist/storage-utils.d.ts
4.0K	dist/storage-utils.d.ts.map
4.0K	dist/storage-utils.js
4.0K	dist/storage-utils.js.map
4.0K	dist/streaming.d.ts
4.0K	dist/streaming.d.ts.map
4.0K	dist/streaming.js
4.0K	dist/streaming.js.map
4.0K	dist/string-utils.d.ts
4.0K	dist/string-utils.d.ts.map
4.0K	dist/string-utils.js
4.0K	dist/string-utils.js.map
672K	dist/utils/helpers
364K	dist/utils/core
1.1M	dist/utils
4.0K	dist/validator.d.ts
4.0K	dist/validator.d.ts.map
4.0K	dist/validator.js
4.0K	dist/validator.js.map
4.0K	dist/websocket.d.ts
4.0K	dist/websocket.d.ts.map
4.0K	dist/websocket.js
4.0K	dist/websocket.js.map

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📊 Code Coverage Report

Coverage: 96.12% ✅

Great coverage!

View full coverage report

@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud bot commented Feb 6, 2026

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 6, 2026

📊 Code Coverage Report

Coverage: %

❌ Low coverage - please add more tests

@sebamar88 sebamar88 merged commit d6eaa6c into main Feb 6, 2026
17 checks passed
sebamar88 added a commit that referenced this pull request Mar 29, 2026
- RequestQueue: priority-aware concurrency-limited task queue
  - Three fixed priority lanes: high > normal > low
  - AbortSignal-based cancellation (AddOptions.signal consumer path)
  - onError callback for error isolation without stopping the queue
  - size / running / pending observable state getters
  - flush() waiter pattern (resolves when all tasks settle)

- RequestBatcher: time-window HTTP request deduplication
  - Fixed and sliding window modes
  - maxSize early flush
  - Custom keyFn override
  - Shared result for all same-key callers in a window

- ApiClient integration (transparent, backward-compatible)
  - queue?: RequestQueueOptions (concurrency-limited requests)
  - batch?: BatchOptions (time-window deduplication)
  - Legacy pool option continues to work; queue takes priority

- 47 new tests (673 total, 0 failures)
  - request-queue.test.ts: 15 tests (US1 + US2)
  - request-batcher.test.ts: 15 tests (US3, fake timers)
  - request-queue-api-client.test.ts: 4 tests (US4)
- Coverage: request-queue.ts 100%, request-batcher.ts 97.43%
- Examples: request-queue-example.ts + request-queue-example.js
- Docs: async.mdx + Async-Toolkit.md updated

Closes #4-batching-system
sebamar88 added a commit that referenced this pull request Mar 29, 2026
* feat: add resumable file uploads with chunking support

- Introduced a new feature specification for resumable file uploads, allowing large files to be uploaded in chunks and resumed from the last successful chunk.
- Enhanced `FileUploadHelper` to support chunked uploads with options for chunk size, concurrency, and resuming from a specific chunk.
- Implemented a `PromisePool` utility to manage concurrent asynchronous tasks with configurable concurrency limits and timeout handling.
- Updated `ApiClient` to utilize `PromisePool` for managing concurrent requests, ensuring that the number of simultaneous requests does not exceed specified limits.
- Added comprehensive tests for `PromisePool` functionality, including concurrency limits, error handling, and timeout mechanics.
- Created integration tests for `ApiClient` to verify correct behavior with the new pooling mechanism.

* fix: remove unnecessary whitespace in ApiClient documentation comments

* feat(async): add RequestQueue and RequestBatcher (004-batching-system)

- RequestQueue: priority-aware concurrency-limited task queue
  - Three fixed priority lanes: high > normal > low
  - AbortSignal-based cancellation (AddOptions.signal consumer path)
  - onError callback for error isolation without stopping the queue
  - size / running / pending observable state getters
  - flush() waiter pattern (resolves when all tasks settle)

- RequestBatcher: time-window HTTP request deduplication
  - Fixed and sliding window modes
  - maxSize early flush
  - Custom keyFn override
  - Shared result for all same-key callers in a window

- ApiClient integration (transparent, backward-compatible)
  - queue?: RequestQueueOptions (concurrency-limited requests)
  - batch?: BatchOptions (time-window deduplication)
  - Legacy pool option continues to work; queue takes priority

- 47 new tests (673 total, 0 failures)
  - request-queue.test.ts: 15 tests (US1 + US2)
  - request-batcher.test.ts: 15 tests (US3, fake timers)
  - request-queue-api-client.test.ts: 4 tests (US4)
- Coverage: request-queue.ts 100%, request-batcher.ts 97.43%
- Examples: request-queue-example.ts + request-queue-example.js
- Docs: async.mdx + Async-Toolkit.md updated

Closes #4-batching-system

* chore(specs): mark all 004-batching-system tasks complete [X]

* refactor(plan): update implementation plan template for feature specifications
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants