Merge branch 'develop'

 - Introduce flag to disable config file validation during startup (useful for testing)
 - Allow injection of salt file during config load for better security
 - Publish library to GitHub packages
 - Add structured logging support throughout --> use cid::engine::* for debug logs

Author: dem1fo

.github/workflows/publish.yaml

@@ -0,0 +1,42 @@
+name: Publish @wfp/common-identifier-algorithm-shared
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+      - "v*.*.*-*"
+
+permissions:
+  checks: write
+  contents: read
+  packages: write
+  pull-requests: read
+
+jobs:
+  test:
+    uses: "./.github/workflows/test.yaml"
+  publish:
+    runs-on: ubuntu-latest
+    needs:
+      - test
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v4
+      
+      - name: Setup nodeJS
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          registry-url: "https://npm.pkg.github.com"
+          scope: "@wfp"
+      
+      - name: Install dependencies
+        run: npm install
+      
+      - name: Build package
+        run: npm run build
+      
+      - name: Publish to GitHub packages
+        run: npm publish
+        env:
+          NPM_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test.yaml

@@ -1,10 +1,19 @@
 name: RunTests
 on:
   push:
-    branches: ['main', 'develop']
+    branches: 
+      - main
+      - develop
+      - feat/*
   pull_request:
     branches: ['main']
     types: [opened, reopened, edited]
+  workflow_call:
+
+permissions:
+  checks: write
+  contents: read
+  pull-requests: read
 
 jobs:
   RunTestSuite:
@@ -19,7 +28,7 @@ jobs:
       - name: Install NodeJS
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install node packages
         run: npm install

.gitignore

@@ -6,4 +6,5 @@ coverage
 
 /lib
 output/
+**/scratch/**
 scratch.*

.npmrc

@@ -0,0 +1,2 @@
+@wfp:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${NPM_TOKEN}

examples/example_algorithm/_generic_hasher.ts

@@ -14,8 +14,8 @@
 // You should have received a copy of the GNU Affero General Public License
 // along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-import { joinFieldsForHash, cleanValueList, extractAlgoColumnsFromObject, BaseHasher } from 'common-identifier-algorithm-shared';
-import type { Config, Validator, makeHasherFunction } from 'common-identifier-algorithm-shared';
+import { joinFieldsForHash, cleanValueList, extractAlgoColumnsFromObject, BaseHasher } from '../../src';
+import type { Config, Validator, makeHasherFunction } from '../../src';
 
 class GenericHasher extends BaseHasher {
     constructor(config: Config.CoreConfiguration["algorithm"]) {

examples/example_algorithm/config.toml

@@ -1,7 +1,7 @@
 [meta]
 id="ANY"
 version="1.0.0"
-signature="f51f7b694f62d9bb1c6ece9dd8a85790"
+signature="a36d008f81060928709a6704da61bbd6"
 
 [source]
 columns = [
@@ -31,10 +31,6 @@ reference = []
 [algorithm.hash]
 strategy = "SHA256"
 
-[algorithm.salt]
-source = "STRING"
-value = "{{ some_random_salt_value }}"
-
 [destination]
 columns = [
     { name = "Common Identifier", alias = "hashed_id" },

examples/file_based_usage.ts

@@ -13,7 +13,12 @@ const OUTPUT_PATH = join(__dirname, 'output', 'output_10.csv');
 const VALIDATION_ERRORS_PATH = join(__dirname, 'output', 'validation_errors.csv');
 
 // load configuration from file
-const configLoadResult = loadConfig(CONFIG_PATH, ALGORITHM_ID);
+const configLoadResult = loadConfig({
+  configPath: CONFIG_PATH,
+  algorithmId: ALGORITHM_ID,
+  validateConfig: true,
+  embeddedSalt: { source: "STRING", value: "SOME_SALT_VALUE" }
+});
 if (!configLoadResult.success) throw new Error(`ERROR: Unable to load configuration file >> ${configLoadResult.error}`);
 
 // validate the input file against all configured validation rules.

examples/programmatic_usage.ts

@@ -32,7 +32,8 @@ const config: Config.CoreConfiguration = {
   },
   algorithm: {
     hash: { strategy: "SHA256" },
-    salt: { source: "STRING", value: "testSalt" },
+    // NOTE: For procedural use, only salt values with source: "STRING" are permitted
+    salt: { source: "STRING", value: "SOME_VALUE" },
     columns: {
       process: [],
       reference: [],