fix(gulp-function): correct forFirst execution behavior, improve async error handling, and modernize package metadata

changelog.md

@@ -0,0 +1,199 @@
+# Changelog
+
+## 2026-05-02 - 3.0.8 - fix(gulp-function)
+correct forFirst execution behavior, improve async error handling, and modernize package metadata
+
+- fixes `forFirst` so the callback runs only for the first file instead of every file after the first
+- normalizes thrown values into `Error` instances and propagates async failures through the Gulp stream
+- adds stronger TypeScript typings, updates tests, and refreshes package/configuration metadata for the current toolchain
+
+## 2024-03-10 - 3.0.7 - maintenance
+Release 3.0.7 with repository and configuration maintenance updates.
+
+- Updated package metadata and description
+- Updated TypeScript configuration
+- Updated npm host configuration
+
+## 2024-03-10 - 3.0.6 - core
+Applied a core update fix.
+
+- fix(core): update
+
+## 2023-06-30 - 3.0.5 - maintenance
+Released 3.0.5 with a core fix and organization migration updates.
+
+- fix(core): update
+- Switched to the new organization scheme
+
+## 2020-01-18 - 3.0.4 - core
+Applied a core update fix.
+
+- fix(core): update
+
+## 2020-01-18 - 3.0.3 - core
+Applied a core update fix.
+
+- fix(core): update
+
+## 2020-01-18 - 3.0.2 - core
+Applied a core update fix.
+
+- fix(core): update
+
+## 2018-12-09 - 3.0.1 - core
+Applied a core update fix.
+
+- fix(core): update
+
+## 2018-12-09 - 3.0.0 - npm
+Updated npm package permissions.
+
+- fix(npm): permissions
+
+## 2018-12-09 - 2.2.16 - npm scope
+Introduced a breaking npm scope change.
+
+- BREAKING CHANGE(npm scope): update
+
+## 2018-12-09 - 2.2.15 - license
+Updated licensing metadata.
+
+- Switched from brand name to company name in license information
+
+## 2018-01-29 - 2.2.14 - core
+Released 2.2.14 with standards updates and documentation fixes.
+
+- Updated core to latest gitzone standards
+- Fixed sample code in README
+
+## 2017-04-30 - 2.2.13 to 2.2.11 - maintenance
+Rolled up minor maintenance and documentation updates across these releases.
+
+- Updated CI configuration
+- Updated README
+- Updated project standards
+
+## 2017-04-30 - 2.2.10 to 2.2.6 - mixed
+Delivered a mix of dependency, documentation, and behavior improvements.
+
+- Updated dependencies
+- Updated docs, README, and .gitignore
+- Fixed pipe cleanup behavior
+
+## 2016-11-25 - 2.2.5 to 2.2.1 - core
+Shipped iterative fixes and API improvements in the 2.2.x line.
+
+- Fixed `.forEach` return behavior
+- Added `.forEach`, `.atEnd`, and `.forFirst`
+- Switched to ES6 default import
+- Included testing and documentation improvements as part of the release series
+
+## 2016-10-18 - 2.0.0 - ci
+Updated CI base image for the 2.0.0 release.
+
+- Fixed base image for CI
+
+## 2016-06-11 - 1.3.6 - core
+Added support for modifying the file object.
+
+- Added possibility to modify the file object
+
+## 2016-06-03 - 1.3.5 to 1.3.1 - maintenance
+Bundled dependency, CI, and documentation maintenance updates.
+
+- Updated GitLab CI configuration
+- Switched to npmts-g
+- Updated README and removed Travis
+- Fixed a missing dependency
+- Added GitLab CI
+- Updated dependencies
+
+## 2016-04-07 - 1.3.0 - dependencies
+Adjusted development dependencies.
+
+- Added beautylog back as a dev dependency
+
+## 2016-04-04 - 1.2.5 to 1.2.1 - maintenance
+Bundled package, dependency, and README fixes across patch releases.
+
+- Fixed package.json
+- Updated dependencies
+- Fixed README issues
+
+## 2016-03-26 - 1.2.0 - core
+Delivered functional fixes and dependency cleanup.
+
+- Fixed issue #3
+- Removed beautylog dependency
+- Updated dependencies and coverage badge configuration
+
+## 2016-02-14 - 1.1.1 - core
+Added new callback handling functionality.
+
+- Added `forFirst`
+- Included badge and README updates in this release cycle
+
+## 2016-02-14 - 1.1.0 - dependencies
+Updated promise handling dependency.
+
+- Updated promise
+
+## 2016-02-12 - 1.0.4 - core
+Improved async function handling.
+
+- Now accepts promises as return values of supplied functions
+- Included README updates
+
+## 2016-02-12 - 1.0.3 - configuration
+Added npmts configuration.
+
+- Added `npmts.json`
+
+## 2016-02-02 - 1.0.2 - tests
+Improved test coverage.
+
+- Added better tests and coverage
+
+## 2016-02-01 - 1.0.1 to 1.0.0 - maintenance
+Initial stable release cycle with tooling and dependency updates.
+
+- Updated dependencies
+- Updated Travis configuration
+- Updated npmts
+
+## 2015-11-30 - 0.0.12 to 0.0.8 - maintenance
+Early project setup and package maintenance updates.
+
+- Updated keywords and package metadata
+- Cleaned up project structure
+- Updated dependencies
+
+## 2015-10-26 - 0.0.7 - core
+Added callback support to `atEnd`.
+
+- Added callback to `function() atEnd`
+- Included badge updates
+
+## 2015-10-26 - 0.0.6 to 0.0.4 - tooling
+Established release automation and tooling.
+
+- Added automatic version release through Travis for npm
+
+## 2015-10-25 - 0.0.3 - tests
+Improved early project quality and stability.
+
+- Added tests
+- Included a small fix
+
+## 2015-09-17 - 0.0.2 - core
+Made the package functional and added initial project files.
+
+- Now working
+- Added `.gitignore`
+- Added README
+
+## 2015-09-04 - 0.0.1 - release
+Initial package publication and CI setup.
+
+- Published npm package
+- Added Travis CI