From daea5d0ceda6687dad969c443011adb3a3f34e33 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 18 Jul 2023 22:16:02 +0000 Subject: [PATCH 1/2] Bump word-wrap from 1.2.3 to 1.2.4 Bumps [word-wrap](https://github.com/jonschlinkert/word-wrap) from 1.2.3 to 1.2.4. - [Release notes](https://github.com/jonschlinkert/word-wrap/releases) - [Commits](https://github.com/jonschlinkert/word-wrap/compare/1.2.3...1.2.4) --- updated-dependencies: - dependency-name: word-wrap dependency-type: indirect ... Signed-off-by: dependabot[bot] --- package-lock.json | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/package-lock.json b/package-lock.json index 9490ca9..450756d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -11775,9 +11775,9 @@ } }, "node_modules/word-wrap": { - "version": "1.2.3", - "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.3.tgz", - "integrity": "sha512-Hz/mrNwitNRh/HUAtM/VT/5VH+ygD6DV7mYKZAtHOrbs8U7lvPS6xf7EJKMF0uW1KJCl0H701g3ZGus+muE5vQ==", + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.4.tgz", + "integrity": "sha512-2V81OA4ugVo5pRo46hAoD2ivUJx8jXmWXfUkY4KFNw0hEptvN0QfH3K4nHiwzGeKl5rFKedV48QVoqYavy4YpA==", "engines": { "node": ">=0.10.0" } @@ -11961,7 +11961,7 @@ }, "packages/gae-js-datastore": { "name": "@mondomob/gae-js-datastore", - "version": "10.0.1", + "version": "10.2.0", "license": "MIT", "dependencies": { "dataloader": "^2.2.2", @@ -11994,7 +11994,7 @@ "@google-cloud/tasks": "3.1.2", "@mondomob/gae-js-bigquery": "2.0.0", "@mondomob/gae-js-core": "7.0.3", - "@mondomob/gae-js-datastore": "10.0.1", + "@mondomob/gae-js-datastore": "10.2.0", "@mondomob/gae-js-storage": "9.0.1", "@mondomob/gae-js-tasks": "11.1.0", "@types/luxon": "3.3.0", From 0fc8d8b8ac807caf50599e637fc044786b618bbb Mon Sep 17 00:00:00 2001 From: Matt Byrne Date: Mon, 11 Dec 2023 16:13:23 +1100 Subject: [PATCH 2/2] Move readme documentation on contributing out of the "product documentation" and back into the "repo readme" --- README.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 55 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 7b23ecc..38548b7 100644 --- a/README.md +++ b/README.md @@ -17,4 +17,58 @@ Simplify building NodeJS applications on Google App Engine (GAE) - [gae-js-google-auth](https://mondo-mob.github.io/gae-js-docs/packages/gae-js-google-auth.html) - [gae-js-firebase-auth](https://mondo-mob.github.io/gae-js-docs/packages/gae-js-firebase-auth.html) - [gae-js-migrations](https://mondo-mob.github.io/gae-js-docs/packages/gae-js-migrations.html) -- [gae-js-search](https://mondo-mob.github.io/gae-js-docs/packages/gae-js-gae-search.html) \ No newline at end of file +- [gae-js-search](https://mondo-mob.github.io/gae-js-docs/packages/gae-js-gae-search.html) + +## Contributing + +This is a mono-repo using npm workspaces. +Publishing is done using Atlassian Changesets (https://github.com/changesets/changesets). +This helps be consistent with versioning and auto-generates changelogs. + +Here's the basic flow: + +1. Create one or more changesets + +- Once you've made your changes, create a changeset. You can create more than one changeset for a single version. + +``` +npx changeset +``` + +- From the cli tool, choose which packages to update and if major/minor/patch update +- Enter summary for changes +- Review and commit files + +2. Update package versions + +- Based on the changeset configuration - this will automatically version the packages. + +``` +npx changeset version +``` + +- Commit changes + +3. Build and publish + +Would be nice if this was done from CI but for now we do this locally. + +- Check you're running a suitable version of node/npm. If not switch and clear out old node_modules. +- Build and publish + +``` +npm run publish-libs +``` + +### Adding new packages + +There's nothing automated to do this. Essentially you just need to add a new package to `/packages` folder but +these steps should save some time: + +- Create new folder in `/packages`. e.g. `/packages/gae-js-new-thing` +- Copy `package.json`, `tsconfig.json`, `tsconfig.prod.json`, `jest.config.json` from one of the existing packages +- Update `package.json` to match desired name, version, dependencies, etc +- Update `tsconfig.json` to match desired project references. +- Create file src/index.ts and export some constant +- Run `npm install` from root folder +- Run `npm run build` from project folder