gulp-function/changelog.md

# 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