bkper 4.11.2 → 4.11.4

package/README.md

@@ -912,3 +912,13 @@ Bkper.setConfig({
     oauthTokenProvider: async () => getOAuthToken(),
 });
 ```
+
+## Release process (maintainers)
+
+Releases are published by GitHub Actions (Trusted Publisher with OIDC), not from local machines.
+
+-   Add one release label to a PR targeting `main`: `release:patch`, `release:minor`, or `release:major`
+-   Before merge, the PR version bump workflow updates `package.json` on the PR branch to the next version derived from the latest release tag
+-   On each `main` push, the delivery workflow checks the merged PR label, verifies `package.json` already contains the expected next version, publishes to npm, and pushes the new tag
+-   Without a release label, publish is skipped
+-   Dependabot Pi update PRs are automatically labeled `release:patch` and set to GitHub native auto-merge when repo auto-merge and required checks are enabled

package/lib/docs/cli-reference.md

@@ -912,3 +912,13 @@ Bkper.setConfig({
     oauthTokenProvider: async () => getOAuthToken(),
 });
 ```
+
+## Release process (maintainers)
+
+Releases are published by GitHub Actions (Trusted Publisher with OIDC), not from local machines.
+
+-   Add one release label to a PR targeting `main`: `release:patch`, `release:minor`, or `release:major`
+-   Before merge, the PR version bump workflow updates `package.json` on the PR branch to the next version derived from the latest release tag
+-   On each `main` push, the delivery workflow checks the merged PR label, verifies `package.json` already contains the expected next version, publishes to npm, and pushes the new tag
+-   Without a release label, publish is skipped
+-   Dependabot Pi update PRs are automatically labeled `release:patch` and set to GitHub native auto-merge when repo auto-merge and required checks are enabled

package/lib/release/versioning.d.ts

@@ -0,0 +1,5 @@
+export type ReleaseLevel = 'patch' | 'minor' | 'major';
+export declare function normalizeTagVersion(versionOrTag: string): string;
+export declare function bumpVersion(currentVersion: string, level: ReleaseLevel): string;
+export declare function resolveNextVersion(latestTag: string | null, packageVersion: string, level: ReleaseLevel): string;
+//# sourceMappingURL=versioning.d.ts.map

package/lib/release/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/release/versioning.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAIvD,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAqB/E;AAED,wBAAgB,kBAAkB,CAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,YAAY,GACpB,MAAM,CAGR"}

package/lib/release/versioning.js

@@ -0,0 +1,32 @@
+const SEMVER_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
+export function normalizeTagVersion(versionOrTag) {
+    const normalized = versionOrTag.startsWith('v') ? versionOrTag.slice(1) : versionOrTag;
+    if (!SEMVER_PATTERN.test(normalized)) {
+        throw new Error(`Invalid semver version: ${versionOrTag}`);
+    }
+    return normalized;
+}
+export function bumpVersion(currentVersion, level) {
+    const normalized = normalizeTagVersion(currentVersion);
+    const match = normalized.match(SEMVER_PATTERN);
+    if (!match) {
+        throw new Error(`Invalid semver version: ${currentVersion}`);
+    }
+    const [, majorText, minorText, patchText] = match;
+    const major = Number(majorText);
+    const minor = Number(minorText);
+    const patch = Number(patchText);
+    switch (level) {
+        case 'major':
+            return `${major + 1}.0.0`;
+        case 'minor':
+            return `${major}.${minor + 1}.0`;
+        case 'patch':
+            return `${major}.${minor}.${patch + 1}`;
+    }
+}
+export function resolveNextVersion(latestTag, packageVersion, level) {
+    const currentVersion = latestTag ? normalizeTagVersion(latestTag) : normalizeTagVersion(packageVersion);
+    return bumpVersion(currentVersion, level);
+}
+//# sourceMappingURL=versioning.js.map

package/lib/release/versioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../../src/release/versioning.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACpD,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAEvF,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,cAAsB,EAAE,KAAmB;IACnE,MAAM,UAAU,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAE/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,2BAA2B,cAAc,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAEhC,QAAQ,KAAK,EAAE,CAAC;QACZ,KAAK,OAAO;YACR,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC;QAC9B,KAAK,OAAO;YACR,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACrC,KAAK,OAAO;YACR,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAC9B,SAAwB,EACxB,cAAsB,EACtB,KAAmB;IAEnB,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACxG,OAAO,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper",
-    "version": "4.11.2",
+    "version": "4.11.4",
     "description": "Command line client for Bkper",
     "bin": {
         "bkper": "./lib/cli.js"