Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
51 commits
Select commit Hold shift + click to select a range
7ef3526
chore: apply the Kind/* labels from the issue templates
MaksymStoianov Sep 24, 2026
8ed10b1
docs(agents): say how an issue is filed, owned and moved across the b…
MaksymStoianov Sep 24, 2026
b0acd30
docs: add README translations (uk, ru, de, fr, es, pt, ja, zh)
MaksymStoianov Nov 3, 2026
a85ebc0
docs: add a README translation consistency check
MaksymStoianov Nov 3, 2026
d9d02ad
docs: point links to the bootgs organisation
MaksymStoianov Nov 3, 2026
6df13e8
refactor!: rename the package to @bootgs/utils
MaksymStoianov Nov 3, 2026
8b44434
fix(sheet): store the schema under bootgs-utils:schema, keep reading …
MaksymStoianov Nov 3, 2026
746401c
Merge pull request #566 from bootgs/docs/readme-i18n
MaksymStoianov Nov 3, 2026
2f7133e
Merge pull request #567 from bootgs/fix/schema-metadata-key
MaksymStoianov Nov 3, 2026
e357d08
Merge pull request #563 from bootgs/chore/issue-template-labels
MaksymStoianov Nov 3, 2026
4ac94e7
fix(build): resolve @bootgs/utils in the docs snippet type-check
MaksymStoianov Nov 3, 2026
d148050
ci: add pull request checks
MaksymStoianov Nov 3, 2026
22e8aa5
ci(release): least-privilege permissions, npm publish and SBOM
MaksymStoianov Nov 3, 2026
8010800
ci(docs): read-only token by default and pinned actions
MaksymStoianov Nov 3, 2026
38951c2
ci: add Dependabot and OpenSSF Scorecard
MaksymStoianov Nov 3, 2026
24da9cf
fix(json): re-quote single-quoted strings correctly in parseJson
MaksymStoianov Nov 3, 2026
4e8ed8e
fix(docs): escape table cells fully and match old links without a regexp
MaksymStoianov Nov 3, 2026
b4f0ea1
fix(package)!: add exports and fully specified ESM specifiers
MaksymStoianov Nov 3, 2026
c6f31e2
build: stop emitting source maps into the package
MaksymStoianov Nov 3, 2026
8137d9f
docs(runtime): list every service-bound function and its OAuth scope
MaksymStoianov Nov 3, 2026
da1c153
docs(changelog): correct the getSlideIndex entries of 2.0.0
MaksymStoianov Nov 3, 2026
b031b9a
docs: add a NOTICE file and ship it in the package
MaksymStoianov Nov 3, 2026
65f9ae1
chore: add SPDX licence identifiers to the sources
MaksymStoianov Nov 3, 2026
d3d6b61
docs(security): rewrite the security policy for @bootgs/utils
MaksymStoianov Nov 3, 2026
aba9fa2
docs(contributing): require a DCO sign-off and check it in CI
MaksymStoianov Nov 3, 2026
3a56440
docs: add governance, maintainers, code owners and support policy
MaksymStoianov Nov 3, 2026
a7a8f8c
docs: adopt the Contributor Covenant 2.1
MaksymStoianov Nov 3, 2026
0bfbefe
docs: add a pull request template, AI and privacy notes, trademarks
MaksymStoianov Nov 3, 2026
6661d32
chore(deps-dev): clear the high-severity advisories
MaksymStoianov Nov 3, 2026
373e6e0
docs: let the README translation check skip right-to-left wrappers
MaksymStoianov Nov 3, 2026
cf5827f
Merge pull request #568 from bootgs/ci/pr-checks-and-hardening
MaksymStoianov Nov 3, 2026
0967657
docs: add README translations (ko, zh-TW, it, pl, tr, nl, id, vi, ar,…
MaksymStoianov Nov 3, 2026
cd481fb
Merge pull request #569 from bootgs/fix/codeql-alerts
MaksymStoianov Nov 3, 2026
bab12f2
Merge remote-tracking branch 'origin/develop' into fix/package-exports
MaksymStoianov Nov 3, 2026
899df94
Merge pull request #570 from bootgs/fix/package-exports
MaksymStoianov Nov 3, 2026
2cd5a8a
Merge pull request #571 from bootgs/docs/governance-legal
MaksymStoianov Nov 3, 2026
72f5062
Merge pull request #572 from bootgs/docs/oauth-scopes
MaksymStoianov Nov 3, 2026
a4cdfb6
Merge pull request #573 from bootgs/chore/dev-deps-security
MaksymStoianov Nov 3, 2026
b0dd27d
Merge pull request #574 from bootgs/docs/changelog-fixes
MaksymStoianov Nov 3, 2026
3b4c3b2
Merge remote-tracking branch 'origin/develop' into docs/readme-more-l…
MaksymStoianov Nov 3, 2026
bf9a5fc
docs: move README translations to docs/readme
MaksymStoianov Nov 3, 2026
3d5c131
ci: check REUSE compliance and show the Scorecard and REUSE badges
MaksymStoianov Nov 17, 2026
60aeb69
Merge pull request #577 from bootgs/ci/reuse-scorecard-badge
MaksymStoianov Nov 17, 2026
a7b61e6
Merge branch 'develop' into docs/readme-more-languages
MaksymStoianov Nov 17, 2026
3432cf0
Merge pull request #576 from bootgs/docs/readme-more-languages
MaksymStoianov Nov 17, 2026
11bc3f0
docs: order the README badges and add CI, CodeQL and npm badges
MaksymStoianov Nov 17, 2026
fd9ce19
ci: CodeQL on develop pull requests and signed release assets
MaksymStoianov Nov 17, 2026
7df8386
Merge pull request #578 from bootgs/docs/badges-order
MaksymStoianov Nov 17, 2026
cb4dab8
Merge pull request #579 from bootgs/ci/codeql-signed-releases
MaksymStoianov Nov 17, 2026
36b17bd
Merge branch 'main' into develop
MaksymStoianov Nov 17, 2026
2ff69d3
Merge pull request #581 from bootgs/chore/sync-main-into-develop
MaksymStoianov Nov 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
4 changes: 4 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Code owners are requested for review on every pull request.
# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners

* @MaksymStoianov
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name: Bug Report
description: Report a bug report to help us improve.
title: "[Bug]: "
labels: [ "bug" ]
labels: [ "Kind/Bug" ]
body:
- type: textarea
id: description
Expand Down
6 changes: 3 additions & 3 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
blank_issues_enabled: false
contact_links:
- name: Documentation
url: https://github.com/MaksymStoianov/apps-script-utils#readme
url: https://github.com/bootgs/utils#readme
about: Read the official documentation.
- name: Roadmap
url: https://github.com/users/MaksymStoianov/projects/2/views/2
about: See what is planned, in progress and done.
- name: Discussions
url: https://github.com/MaksymStoianov/apps-script-utils/discussions
url: https://github.com/bootgs/utils/discussions
about: Ask questions or discuss ideas.
- name: Contributing
url: https://github.com/MaksymStoianov/apps-script-utils/blob/main/CONTRIBUTING.md
url: https://github.com/bootgs/utils/blob/main/CONTRIBUTING.md
about: Learn how to contribute to this project.
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name: Feature Request
description: Suggest an idea for this project.
title: "[Feature]: "
labels: [ "enhancement" ]
labels: [ "Kind/Feature" ]
body:
- type: textarea
id: feature-description
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/update_docs.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name: Documentation Update
description: Report a mistake or suggest an improvement for the documentation.
title: "[Docs]: "
labels: [ "documentation" ]
labels: [ "Kind/Documentation" ]
body:
- type: textarea
id: description
Expand Down
28 changes: 28 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# https://docs.github.com/en/code-security/dependabot/working-with-dependabot/dependabot-options-reference

version: 2

updates:
- package-ecosystem: npm
directory: /
target-branch: develop
schedule:
interval: weekly
open-pull-requests-limit: 10
commit-message:
prefix: "chore(deps)"
prefix-development: "chore(deps-dev)"
groups:
dev-dependencies:
dependency-type: development
update-types:
- minor
- patch

- package-ecosystem: github-actions
directory: /
target-branch: develop
schedule:
interval: weekly
commit-message:
prefix: "ci"
28 changes: 28 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
## Summary

<!-- What does this change do and why? Link the issue it resolves, e.g. "Closes #123". -->

## Type of change

- [ ] `fix` — bug fix (non-breaking)
- [ ] `feat` — new feature (non-breaking)
- [ ] Breaking change (`!` / `BREAKING CHANGE:` footer)
- [ ] `docs` — documentation only
- [ ] `refactor` / `perf` / `test` / `build` / `ci` / `chore`

## Checklist

- [ ] The PR title follows [Conventional Commits](https://www.conventionalcommits.org/).
- [ ] Every commit is signed off (`git commit -s`) under the
[DCO](https://github.com/bootgs/utils/blob/develop/CONTRIBUTING.md#developer-certificate-of-origin).
- [ ] Tests are added or updated and `npm test` passes.
- [ ] `npm run type:check`, `npm run lint` and `npm run format` pass.
- [ ] The generated documentation is up to date (`npm run docs:generate`, then `npm run docs:check` passes).
- [ ] Public API changes are documented (JSDoc, docs, changelog notes in the commit body).
- [ ] No secrets, credentials or personal data are included.
- [ ] AI-assisted commits carry a `Co-Authored-By:` trailer and I have reviewed every line
([Tools and AI Assistance](https://github.com/bootgs/utils/blob/develop/docs/tools-and-ai.md)).

## Notes for reviewers

<!-- Anything that needs special attention, follow-ups, screenshots. -->
86 changes: 86 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
# Pull request and branch checks: types, lint, formatting, tests with coverage, build,
# generated documentation, production dependency audit and production licence allow-list.

name: ci

on:
pull_request:
push:
branches:
- main
- develop

permissions:
contents: read

concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: true

jobs:
checks:
runs-on: ubuntu-latest
timeout-minutes: 15

steps:
- name: checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false

- name: setup-node
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version: 24
cache: npm

- name: install
run: npm ci

- name: type-check
run: npm run type:check

- name: lint
run: npm run lint

- name: format
run: npm run format

- name: test
run: npm run test:cov

- name: build
run: npm run build

# The reference pages are generated from src/; this fails when they are stale.
- name: docs
run: npm run docs:check

- name: readme-translations
run: npm run docs:check-i18n

- name: audit
run: npm audit --omit=dev --audit-level=high

# Production dependencies must use a permissive licence compatible with Apache-2.0.
- name: licences
run: >-
npx --yes license-checker-rseidelsohn@5.0.1
--production
--excludePrivatePackages
--summary
--onlyAllow "Apache-2.0;MIT;BSD-2-Clause;BSD-3-Clause;ISC;0BSD"

# Every file has copyright and licence information (REUSE.toml, LICENSES/).
reuse:
runs-on: ubuntu-latest
timeout-minutes: 5

steps:
- name: checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false

- name: reuse-lint
uses: fsfe/reuse-action@676e2d560c9a403aa252096d99fcab3e1132b0f5 # v6.0.0
51 changes: 51 additions & 0 deletions .github/workflows/codeql.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# CodeQL code scanning on every push and pull request to main and develop.
# Replaces GitHub's default setup, which only analyses pull requests to the default branch.

name: codeql

on:
push:
branches:
- main
- develop
pull_request:
branches:
- main
- develop
schedule:
- cron: "23 3 * * 2"

permissions: {}

jobs:
analyze:
if: github.server_url == 'https://github.com'
runs-on: ubuntu-latest
timeout-minutes: 20
permissions:
actions: read
contents: read
security-events: write
strategy:
fail-fast: false
matrix:
language:
- actions
- javascript-typescript

steps:
- name: checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false

- name: init
uses: github/codeql-action/init@1fc58d04a4d4374f921bdac573c3811c240f9c26 # v4.39.2
with:
languages: ${{ matrix.language }}
build-mode: none

- name: analyze
uses: github/codeql-action/analyze@1fc58d04a4d4374f921bdac573c3811c240f9c26 # v4.39.2
with:
category: /language:${{ matrix.language }}
92 changes: 92 additions & 0 deletions .github/workflows/dco.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
# Developer Certificate of Origin: every commit of a pull request must carry a
# "Signed-off-by: Name <email>" trailer that matches its author (git commit -s).
# See CONTRIBUTING.md → Developer Certificate of Origin.

name: dco

on:
pull_request:

permissions:
contents: read

concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number }}
cancel-in-progress: true

jobs:
sign-off:
runs-on: ubuntu-latest
timeout-minutes: 5

steps:
- name: checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.event.pull_request.head.sha }}
fetch-depth: 0
persist-credentials: false

- name: check
env:
BASE_SHA: ${{ github.event.pull_request.base.sha }}
HEAD_SHA: ${{ github.event.pull_request.head.sha }}
# Skips merge commits and bot authors (Dependabot, GitHub Actions, release-please).
shell: bash
run: |
set -euo pipefail

range="$(git merge-base "$BASE_SHA" "$HEAD_SHA")..$HEAD_SHA"

lower() { printf '%s' "$1" | tr '[:upper:]' '[:lower:]'; }

failed=0
checked=0

while IFS= read -r -d '' record; do
IFS=$'\x1f' read -r sha name email trailers <<<"$record"
[ -n "$sha" ] || continue

case "$email" in
*"[bot]@users.noreply.github.com" | "noreply@github.com" | *"dependabot"* | *"release-please"*)
echo "skip ${sha:0:12} ($name, bot)"
continue
;;
esac
case "$name" in
"dependabot[bot]" | "github-actions[bot]" | "github-actions" | "release-please[bot]")
echo "skip ${sha:0:12} ($name, bot)"
continue
;;
esac

checked=$((checked + 1))
expected="$name <$email>"
found=0
while IFS= read -r line; do
line="${line#"${line%%[![:space:]]*}"}"
line="${line%"${line##*[![:space:]]}"}"
[ -n "$line" ] || continue
if [ "$(lower "$line")" = "$(lower "$expected")" ]; then
found=1
break
fi
done <<<"${trailers//$'\x1e'/$'\n'}"

if [ "$found" -eq 1 ]; then
echo "ok ${sha:0:12} $expected"
else
echo "FAIL ${sha:0:12} missing \"Signed-off-by: $expected\""
failed=$((failed + 1))
fi
done < <(git log --no-merges -z \
--format="%H%x1f%an%x1f%ae%x1f%(trailers:key=Signed-off-by,valueonly,separator=%x1e)" "$range")

echo
if [ "$failed" -gt 0 ]; then
echo "$failed of $checked commit(s) lack a matching Signed-off-by trailer."
echo "Sign off with 'git commit -s'; fix existing commits with 'git rebase --signoff origin/develop'."
echo "See CONTRIBUTING.md → Developer Certificate of Origin."
exit 1
fi
echo "All $checked commit(s) are signed off."
Loading
Loading