Record the SHA of the bundled JavaScript etc files

Author: cjbj

package/README.md

@@ -19,12 +19,13 @@ In a clone or copy of the repository:
   related build metadata information files from all `package/Staging`
   directories to the `package/Staging` directory on one machine.
 
-- Run `npm run buildpackage`.  This calls `buildpackage.js` to make the
-  node-oracledb package containing the node-oracledb JavaScript files, the
-  available binaries, and a `package.json` that has `install` and `prune` script
-  targets.  The package will be created in the top level directory.  It can be
-  uploaded to npmjs.com, or to your own local server, and then used as a
-  dependency in your projects.
+- On the machine with all the binaries in `package/Staging`, run `npm run
+  buildpackage`.  This calls `buildpackage.js` to make the node-oracledb
+  package containing the node-oracledb JavaScript files, the available
+  binaries, and a `package.json` that has `install` and `prune` script targets.
+  The package will be created in the top level directory.  It can be uploaded
+  to npmjs.com by maintainers of node-oracledb, or you can upload to your own
+  local server and then use it as a dependency in your projects.
 
 # Package Installation
 

package/buildpackage.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2018, 2022, Oracle and/or its affiliates. */
+/* Copyright (c) 2018, 2023, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -32,8 +32,6 @@
  * USAGE
  *   Run this with 'npm run buildpackage'
  *
- *   It requires Node 8 or later
- *
  *****************************************************************************/
 
 'use strict';
@@ -43,6 +41,15 @@ const execSync = require('child_process').execSync;
 const nodbUtil = require('../lib/util.js');
 const packageJSON = require("../package.json");
 
+const jsStagingInfoFile = nodbUtil.RELEASE_DIR + '/oracledb-' + nodbUtil.PACKAGE_JSON_VERSION + '-js-buildinfo.txt';
+
+let njsGitSha;
+try {
+  njsGitSha = execSync('git --git-dir=./.git rev-parse --verify HEAD').toString().replace(/[\n\r]/, '');
+} catch (err) {
+  njsGitSha = 'unknown NJS SHA';
+}
+
 // Save files that get overwritten
 const origPackageJson = fs.readFileSync('package.json');
 let origNpmignore;
@@ -73,6 +80,9 @@ async function packageUp() {
     fs.mkdirSync(nodbUtil.RELEASE_DIR, { recursive: true, mode: 0o755 });
     await copyDir(nodbUtil.STAGING_DIR, nodbUtil.RELEASE_DIR);
 
+    // Record the SHA of the bundle's non-binary files
+    fs.appendFileSync(jsStagingInfoFile, njsGitSha + "\n");
+
     // Don't include source code etc. in the npm package.  This is
     // done dynamically because .npmignore cannot exclude source code
     // by default otherwise compiling from a GitHub tag or branch