@researchdatabox/redbox-dev-tools 0.0.1-beta.9950 → 5.0.0-RC1

package/README.md

@@ -31,11 +31,11 @@ npx @researchdatabox/redbox-dev-tools init redbox-hook-my-client
 This will:
 
 - Generate the standard hook archetype in the current directory
-- Create `src/`, `test/`, `support/`, `assets/`, `views/`, and `language-defaults/`
+- Create `src/`, `test/`, `support/`, `assets/`, `views/`, `language-defaults/`, and `support/bootstrap-data/`
 - Create a `package.json` with the shared Redbox dependency contract
-- Generate starter controller, service, form-config, config, Docker, and test files
+- Generate starter controller, service, form-config, config, migration registry, Docker, development, and test files
 
-The standard archetype is based on the current hook structure used for `redbox-hook-jcu`, but stripped back to generic placeholders so a new client hook can start from the same shape without inheriting client-specific logic.
+The standard archetype is based on the current hook structure used for migrated client hooks such as `redbox-hook-jcu` and `redbox-hook-cqu`, but stripped back to generic placeholders so a new client hook can start from the same shape without inheriting client-specific logic.
 
 The archetype is now backed by file-based Handlebars templates under [templates/hook-archetype](templates/hook-archetype), which gives us a clean path for future variants such as branding-heavy hooks, lighter hooks, or alternate TypeScript setups.
 
@@ -102,6 +102,7 @@ module.exports = hook;
 Hooks should declare only:
 
 - `peerDependencies.@researchdatabox/redbox-core`
+- `devDependencies.@researchdatabox/redbox-core`
 - `devDependencies.@researchdatabox/redbox-dev-tools`
 - direct `dependencies` for hook-owned runtime libraries only
 
@@ -142,6 +143,19 @@ Template variants are selected with `--template`:
 npx @researchdatabox/redbox-dev-tools init redbox-hook-my-client --template standard
 ```
 
+The generated project includes a typed migration registry under `src/migrations`, client customisation slots under `support/bootstrap-data`, `assets`, `views`, and `language-defaults`, and Docker-backed local development scripts:
+
+```bash
+npm run dev:run:build
+npm run dev:run
+```
+
+To mount a local `redbox-portal` checkout while migrating a client hook, set `REDBOX_PORTAL_PATH` in `support/development/core-mount.env` and run:
+
+```bash
+npm run dev:run:core
+```
+
 ### `check`
 
 Validate that the current hook package does not directly pin shared Redbox runtime or toolchain dependencies.
@@ -209,6 +223,14 @@ Optional Angular service scaffold:
 npx @researchdatabox/redbox-dev-tools generate form-component my-widget --app form --with-service
 ```
 
+### `sync-translation`
+
+Read translations from API and write to language defaults files.
+
+```bash
+npx @researchdatabox/redbox-dev-tools sync-translation -a "https://example.com" -l ~/redbox-portal/language-defaults
+```
+
 ### `help`
 
 Show CLI help and usage information.

package/bin/wrapper-webpack.js

@@ -1,9 +1,23 @@
 // This file is a helper for dev only. It makes it easier to run webpack when parts of the mono repo are in different stages of being built. Refer to the redbox-core webpack.ts for how the hook runs webpack
 const path = require('path');
 const { createRequire } = require('module');
-const redboxCore = require('@researchdatabox/redbox-core');
 
 const requireFromHere = createRequire(__filename);
+let redboxCore;
+
+const getRedboxCore = () => {
+  if (redboxCore !== undefined) {
+    return redboxCore;
+  }
+
+  try {
+    redboxCore = require('@researchdatabox/redbox-core');
+  } catch (e) {
+    redboxCore = null;
+  }
+
+  return redboxCore;
+};
 
 const ensureTsNode = () => {
   try {
@@ -14,7 +28,7 @@ const ensureTsNode = () => {
   }
 };
 
-let defineWebpackHook = redboxCore.defineWebpackHook || (redboxCore.default && redboxCore.default.defineWebpackHook);
+let defineWebpackHook;
 if (!defineWebpackHook) {
   try {
     defineWebpackHook = require('@researchdatabox/redbox-core/dist/hooks/webpack').defineWebpackHook;
@@ -25,6 +39,10 @@ if (!defineWebpackHook && ensureTsNode()) {
     defineWebpackHook = requireFromHere('@researchdatabox/redbox-core/src/hooks/webpack.ts').defineWebpackHook;
   } catch (e) {}
 }
+if (!defineWebpackHook) {
+  const core = getRedboxCore();
+  defineWebpackHook = core && (core.defineWebpackHook || (core.default && core.default.defineWebpackHook));
+}
 
 // Resolve webpack config: prefer exported `Config.webpack.config`, fall back to repo `config/webpack.js`.
 let webpackConfig = [];
@@ -39,16 +57,6 @@ try {
 } catch (e) {
   // ignore
 }
-if (!webpackConfig || (Array.isArray(webpackConfig) && webpackConfig.length === 0)) {
-  try {
-    const Config = redboxCore.Config || (redboxCore.default && redboxCore.default.Config);
-    if (Config && Config.webpack && Config.webpack.config) {
-      webpackConfig = Config.webpack.config;
-    }
-  } catch (e) {
-    // ignore
-  }
-}
 if (!webpackConfig || (Array.isArray(webpackConfig) && webpackConfig.length === 0)) {
   try {
     const distWebpack = require('@researchdatabox/redbox-core/dist/config/webpack.config');
@@ -63,6 +71,17 @@ if (!webpackConfig || (Array.isArray(webpackConfig) && webpackConfig.length ===
     } catch (e) {}
   }
 }
+if (!webpackConfig || (Array.isArray(webpackConfig) && webpackConfig.length === 0)) {
+  try {
+    const core = getRedboxCore();
+    const Config = core && (core.Config || (core.default && core.default.Config));
+    if (Config && Config.webpack && Config.webpack.config) {
+      webpackConfig = Config.webpack.config;
+    }
+  } catch (e) {
+    // ignore
+  }
+}
 
 sails = {
   config: {

package/dist/cli.js

@@ -42,12 +42,14 @@ const hook_archetype_1 = require("./templates/hook-archetype");
 const form_config_1 = require("./commands/form-config");
 const completion_1 = require("./completion");
 const cli_parsers_1 = require("./cli-parsers");
+const sync_translation_1 = require("./commands/sync-translation");
 const program = new commander_1.Command();
+const packageJson = readPackageJson(path.resolve(__dirname, '..', 'package.json'));
 // List of dependencies that are common in our legacy hooks but should not be in modern hook packages as they are supplied by redbox-core
 const forbiddenHookDeps = ['axios', 'rxjs', 'lodash', 'mocha', 'chai', 'ts-node', 'typescript'];
 const allowedSharedHookDeps = {
     dependencies: new Set(),
-    devDependencies: new Set(['@researchdatabox/redbox-dev-tools']),
+    devDependencies: new Set(['@researchdatabox/redbox-core', '@researchdatabox/redbox-dev-tools']),
     peerDependencies: new Set(['@researchdatabox/redbox-core']),
 };
 function readPackageJson(pkgPath) {
@@ -80,6 +82,7 @@ function migrateHookDependencyContract(pkg) {
         delete nextPkg.peerDependencies[depName];
     }
     nextPkg.peerDependencies['@researchdatabox/redbox-core'] = nextPkg.peerDependencies['@researchdatabox/redbox-core'] ?? '*';
+    nextPkg.devDependencies['@researchdatabox/redbox-core'] = nextPkg.devDependencies['@researchdatabox/redbox-core'] ?? nextPkg.peerDependencies['@researchdatabox/redbox-core'];
     nextPkg.devDependencies['@researchdatabox/redbox-dev-tools'] = nextPkg.devDependencies['@researchdatabox/redbox-dev-tools'] ?? '*';
     return nextPkg;
 }
@@ -104,7 +107,7 @@ function findForbiddenHookDeps(pkg) {
 program
     .name('redbox-dev-tools')
     .description('CLI for ReDBox hook development and code generation')
-    .version('1.0.0')
+    .version(packageJson.version ?? '0.0.0')
     .option('--root <path>', 'ReDBox repo root directory (required for generators)')
     .option('--core-types-root <path>', 'Override core-types package root')
     .option('--angular-root <path>', 'Override angular projects root')
@@ -131,6 +134,7 @@ program
 (0, form_config_1.registerMigrateFigshareConfigCommand)(program);
 (0, form_config_1.registerClientFormConfigCommand)(program);
 (0, form_config_1.registerQuestionTreeDiagramCommand)(program);
+(0, sync_translation_1.registerSyncTranslationCommand)(program);
 program
     .command('init [name]')
     .description('Initialize a new ReDBox hook project from the standard archetype')

package/dist/commands/form-config.js

@@ -267,7 +267,6 @@ function createMigratedFigsharePublishingConfig(brand, figshareApi, figshareApiE
         },
         record: {
             articleIdPath: mapping.recordFigArticleId ?? 'metadata.figshare_article_id',
-            articleUrlPaths: Array.isArray(mapping.recordFigArticleURL) ? mapping.recordFigArticleURL : [mapping.recordFigArticleURL ?? 'metadata.figshare_article_location'],
             dataLocationsPath: mapping.recordDataLocations ?? 'metadata.dataLocations',
             statusPath: 'metadata.figshareStatus',
             errorPath: 'metadata.figshareError',
@@ -280,7 +279,6 @@ function createMigratedFigsharePublishingConfig(brand, figshareApi, figshareApiE
             selectedFlagPath: 'selected'
         },
         authors: {
-            source: 'defaultRedboxContributors',
             uniqueBy: mapping.recordAuthorUniqueBy ?? 'email',
             externalNameField: mapping.recordAuthorExternalName ?? 'text_full_name',
             maxInlineAuthors: 50,
@@ -293,11 +291,10 @@ function createMigratedFigsharePublishingConfig(brand, figshareApi, figshareApiE
             keywords: { kind: 'path', path: 'metadata.finalKeywords', defaultValue: [] },
             funding: { kind: 'path', path: 'metadata.funder' },
             license: { source: { kind: 'path', path: mapping.recordLicensePath ?? 'metadata.license' }, matchBy: 'urlContains', required: true },
-            categories: { source: { kind: 'path', path: mapping.recordCategoryPath ?? 'metadata.forCodes', defaultValue: [] }, mappingStrategy: 'for2020Mapping' },
+            categories: { source: { kind: 'path', path: mapping.recordCategoryPath ?? 'metadata.forCodes', defaultValue: [] } },
             customFields: []
         },
         categories: {
-            strategy: 'for2020Mapping',
             mappingTable: ((figshareForMapping.FORMapping ?? []).map((entry) => ({
                 sourceCode: String(entry.redboxCode ?? entry.sourceCode ?? ''),
                 figshareCategoryId: Number(entry.figshareCategoryId ?? entry.figCode ?? 0)
@@ -307,11 +304,8 @@ function createMigratedFigsharePublishingConfig(brand, figshareApi, figshareApiE
         assets: {
             enableHostedFiles: true,
             enableLinkFiles: true,
-            dedupeStrategy: 'sourceId',
             staging: {
-                tempDir: String(figshareApi.attachmentsFigshareTempDir ?? ''),
-                cleanupPolicy: 'deleteAfterSuccess',
-                diskSpaceThresholdBytes: 1073741824
+                cleanupPolicy: 'deleteAfterSuccess'
             }
         },
         embargo: {
@@ -320,7 +314,6 @@ function createMigratedFigsharePublishingConfig(brand, figshareApi, figshareApiE
             accessRights: {
                 accessRights: { kind: 'path', path: 'metadata.accessRights' },
                 fullEmbargoUntil: { kind: 'path', path: 'metadata.embargoUntil' },
-                fileEmbargoUntil: { kind: 'path', path: 'metadata.embargoUntil' },
                 reason: { kind: 'path', path: 'metadata.embargoReason' }
             }
         },
@@ -329,7 +322,6 @@ function createMigratedFigsharePublishingConfig(brand, figshareApi, figshareApiE
             uploadedFilesCleanupDelay: typeof mapping.scheduleUploadedFilesCleanupJob === 'string' ? mapping.scheduleUploadedFilesCleanupJob : 'in 5 minutes'
         },
         workflow: {
-            transitionRules: [],
             transitionJob: {
                 enabled: String(mapping.figshareScheduledTransitionRecordWorkflowFromArticlePropertiesJob?.enabled ?? 'false') === 'true',
                 namedQuery: String(mapping.figshareScheduledTransitionRecordWorkflowFromArticlePropertiesJob?.namedQuery ?? ''),
@@ -346,7 +338,12 @@ function createMigratedFigsharePublishingConfig(brand, figshareApi, figshareApiE
         },
         writeBack: {
             articleId: 'metadata.figshare_article_id',
-            articleUrls: ['metadata.figshare_article_location'],
+            // The legacy article URL paths are write targets, so they belong to writeBack.
+            articleUrls: Array.isArray(mapping.recordFigArticleURL)
+                ? mapping.recordFigArticleURL
+                : [typeof mapping.recordFigArticleURL === 'string' && mapping.recordFigArticleURL.trim() !== ''
+                        ? mapping.recordFigArticleURL
+                        : 'metadata.figshare_article_location'],
             extraFields: []
         },
         migrationReport: {

package/dist/commands/sync-translation.d.ts

@@ -0,0 +1,23 @@
+import { Command } from "commander";
+declare const contentFormats: readonly ["plain", "html"];
+type ContentFormats = typeof contentFormats[number];
+type MetaEntryKey = string;
+type MetaEntryValue = {
+    category?: string;
+    description?: string;
+    contentFormat?: ContentFormats;
+};
+export type MetaEntries = Record<MetaEntryKey, MetaEntryValue>;
+export type MetaData = {
+    source: string;
+    data: MetaEntries;
+};
+export type TranslationLocaleRaw = {
+    locale: string;
+    source: string;
+    data: Record<string, unknown>;
+};
+export type TranslationEntries = Record<string, string>;
+export type TranslationLocaleEntries = Record<string, TranslationEntries>;
+export declare function registerSyncTranslationCommand(program: Command): void;
+export {};

package/dist/commands/sync-translation.js

@@ -0,0 +1,348 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSyncTranslationCommand = registerSyncTranslationCommand;
+const commander_1 = require("commander");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const contentFormats = ["plain", "html"];
+/**
+ * Use a type predicate to narrow a string to a content format.
+ * @param value The value to check.
+ */
+function isContentFormat(value) {
+    return contentFormats.some(contentFormat => contentFormat === value);
+}
+/**
+ * Build a path from a base path and additional parts.
+ * @param basePath The base path.
+ * @param parts The additional path parts.
+ */
+function buildPath(basePath, ...parts) {
+    if (!basePath.trim()) {
+        throw new Error(`Invalid base path ${basePath}`);
+    }
+    const basePathResolved = node_path_1.default.resolve(basePath);
+    const resolved = node_path_1.default.resolve(...[basePathResolved, ...parts]);
+    // Ensure resolved path is inside basePath
+    if (!resolved.startsWith(basePathResolved + node_path_1.default.sep) && resolved !== basePathResolved) {
+        throw new Error(`Invalid path ${resolved}`);
+    }
+    return resolved;
+}
+/**
+ * Get the last non-empty string.
+ * @param value The strings.
+ */
+function lastNonEmptyString(...value) {
+    for (let index = (value.length - 1); index >= 0; index--) {
+        const item = value[index];
+        if (typeof item === 'string' && item.length > 0) {
+            return item;
+        }
+    }
+    return undefined;
+}
+/**
+ * Read the translation json files.
+ * @param filesPath The path to the top directory containing the meta.json file.
+ */
+async function readTranslationFiles(filesPath) {
+    // Read files
+    const metaPath = buildPath(filesPath, 'meta.json');
+    console.log(`Load translation meta file ${metaPath}`);
+    const metaData = JSON.parse(await promises_1.default.readFile(metaPath, { encoding: 'utf8' }));
+    const localeNames = (await promises_1.default.readdir(filesPath, { withFileTypes: true }))
+        .filter(dirent => dirent.isDirectory())
+        .map(dirent => dirent.name);
+    const localeTranslationData = [];
+    for (const locale of localeNames) {
+        let p;
+        try {
+            p = buildPath(filesPath, locale, 'translation.json');
+            const translationStat = await promises_1.default.stat(p);
+            if (!translationStat.isFile()) {
+                continue;
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+                // Nested folders such as language-defaults/demo are documentation
+                // or sample data, not locale roots.
+                continue;
+            }
+            throw err;
+        }
+        if (!p) {
+            continue;
+        }
+        const data = JSON.parse(await promises_1.default.readFile(p, { encoding: 'utf8' }));
+        console.log(`Load translation locale file ${p}`);
+        localeTranslationData.push({ locale, source: p, data });
+    }
+    return {
+        meta: {
+            source: metaPath,
+            data: metaData,
+        },
+        locales: localeTranslationData,
+    };
+}
+/**
+ * Write updated translation json files.
+ * @param opts The options.
+ * @param opts.meta The meta details.
+ * @param opts.locales The translation locale data.
+ * @param opts.dryRun Whether this is a dry run.
+ * @param opts.writePath The top-level path to write the output.
+ */
+async function writeTranslationFiles(opts) {
+    const metaPath = buildPath(opts?.writePath, 'meta.json');
+    if (opts.dryRun) {
+        console.log(`[dry-run] Not writing updated meta to ${metaPath}`);
+    }
+    else {
+        // Write merged meta back to file
+        console.log(`Writing updated meta to ${metaPath}`);
+        await promises_1.default.mkdir(node_path_1.default.dirname(metaPath), { recursive: true });
+        await promises_1.default.writeFile(metaPath, JSON.stringify(opts.meta, null, 2));
+    }
+    // Write translation files
+    for (const [locale, data] of Object.entries(opts.locales)) {
+        const translationPath = buildPath(opts?.writePath, locale, 'translation.json');
+        if (opts.dryRun) {
+            console.log(`[dry-run] Not writing updated translation data to ${translationPath}`);
+        }
+        else {
+            console.log(`Writing updated translation data to ${translationPath}`);
+            await promises_1.default.mkdir(node_path_1.default.dirname(translationPath), { recursive: true });
+            await promises_1.default.writeFile(translationPath, JSON.stringify(data, null, 2));
+        }
+    }
+}
+/**
+ * Read translation data from ReDBox API.
+ * @param apiBaseUrl The base url for the API calls.
+ */
+async function readTranslationApi(apiBaseUrl) {
+    if (!apiBaseUrl.includes('://')) {
+        throw new Error(`Api base url is not a valid url '${apiBaseUrl}'`);
+    }
+    if (!apiBaseUrl.endsWith('/')) {
+        apiBaseUrl += '/';
+    }
+    const translationUrl = new URL('default/rdmp/locales/__locale__/translation.json', apiBaseUrl);
+    const entriesUrl = new URL('default/rdmp/app/i18n/entries', apiBaseUrl);
+    console.log(`Load translation entries url ${entriesUrl}`);
+    const entriesResponse = await fetch(entriesUrl, { signal: AbortSignal.timeout(5000) });
+    if (!entriesResponse.ok) {
+        throw new Error(`Could not fetch translation entries: status ${entriesResponse.status} body ${await entriesResponse.text()}`);
+    }
+    const entriesData = await entriesResponse.json();
+    const metaData = Object.create(null);
+    const localeTranslationData = [];
+    const localeNames = Array.from(new Set(entriesData.map(e => e.locale).filter(l => typeof l === 'string'))).sort();
+    for (const localeName of localeNames) {
+        if (!localeName || !localeName.trim() || localeName.includes('.') || localeName.includes('/')) {
+            console.warn(`Ignoring invalid locale name '${localeName}'.`);
+            continue;
+        }
+        const translationLocaleUrl = new URL(translationUrl.toString().replace('/__locale__/', `/${encodeURIComponent(localeName)}/`));
+        console.log(`Load translation locale url ${translationLocaleUrl}`);
+        const translationResponse = await fetch(translationLocaleUrl, { signal: AbortSignal.timeout(5000) });
+        if (!translationResponse.ok) {
+            throw new Error(`Could not fetch translation locale: status ${translationResponse.status} body ${await translationResponse.text()}`);
+        }
+        localeTranslationData.push({
+            locale: localeName,
+            source: translationLocaleUrl.toString(),
+            data: await translationResponse.json()
+        });
+    }
+    for (const entryData of entriesData) {
+        if (!entryData.key) {
+            continue;
+        }
+        if (!(entryData.key in metaData)) {
+            metaData[entryData.key] = Object.create(null);
+        }
+        if (entryData.category) {
+            metaData[entryData.key].category = entryData.category;
+        }
+        if (entryData.contentFormat) {
+            metaData[entryData.key].contentFormat = entryData.contentFormat;
+        }
+        if (entryData.description) {
+            metaData[entryData.key].description = entryData.description;
+        }
+    }
+    return {
+        meta: {
+            source: entriesUrl.toString(),
+            data: metaData,
+        },
+        locales: localeTranslationData,
+    };
+}
+/**
+ * Merge two or more meta entries.
+ * @param opts The merge options.
+ * @param opts.key The translation key.
+ * @param opts.value The translation value.
+ * @param opts.items The meta entries.
+ * @param opts.guessContentFormat Whether to guess the content format from the translation value.
+ */
+function mergeMetaItems(opts) {
+    // content format
+    const contentFormatRaw = lastNonEmptyString(...opts.items?.map(i => i?.contentFormat));
+    let contentFormat = isContentFormat(contentFormatRaw) ? contentFormatRaw : undefined;
+    const isHtml = opts.guessContentFormat === true &&
+        opts.value !== undefined &&
+        contentFormat === undefined &&
+        (typeof opts.value === 'string' && (opts.value?.includes('<') &&
+            opts.value?.includes('</') &&
+            opts.value?.includes('>')));
+    if (isHtml) {
+        contentFormat = "html";
+    }
+    // description
+    const description = lastNonEmptyString(...[
+        opts?.key === undefined ? "" : `Translation for ${opts.key}`,
+        ...opts.items?.map(i => i?.description),
+    ]);
+    // category
+    const keySplit = typeof opts.key === 'string' ? opts.key.split(/[_\-:.@]+/).filter(i => !!i) : [];
+    const category = lastNonEmptyString(...[
+        keySplit.length > 0 ? keySplit[0] : undefined,
+        ...opts.items?.map(i => i?.category),
+    ]);
+    const result = Object.create(null);
+    result.category = category;
+    result.description = description;
+    result.contentFormat = contentFormat;
+    return result;
+}
+function registerSyncTranslationCommand(program) {
+    const sourcesCollected = [];
+    program
+        .command('sync-translation')
+        .description('Read translations from API and/or json files, and write to language translation files.')
+        .option('-l, --language-defaults <path>', 'Path to read the language-defaults directory containing locales and meta json files. Can be provided multiple times.', (value, previous) => {
+        previous.push({ type: 'language-defaults', value });
+        return previous;
+    }, sourcesCollected)
+        .option('-a, --api-base <url>', 'Base url for the API to read translation data. Can be provided multiple times.', (value, previous) => {
+        previous.push({ type: 'api-base', value });
+        return previous;
+    }, sourcesCollected)
+        .requiredOption('-o, --output <path>', 'Path to the output directory or file.')
+        .addOption(new commander_1.Option('-f, --format <format>', 'The output format.')
+        .choices(['language-defaults'])
+        .default('language-defaults'))
+        .action(async (options) => {
+        try {
+            const globalOptions = program.opts();
+            const outputPath = options.output;
+            const outputFormat = options.format;
+            const sources = sourcesCollected.splice(0);
+            if (sources.length === 0) {
+                throw new Error(`Must provide at least one of language-defaults path or api-base url.`);
+            }
+            // Get existing translation data
+            const sourceMeta = [];
+            const sourceTranslations = [];
+            // Precedence order: later items overwrite earlier items.
+            // Populate source meta and translations in order provided in command line.
+            for (const { type, value } of sources) {
+                if (type === 'language-defaults') {
+                    const { meta, locales } = await readTranslationFiles(value);
+                    sourceMeta.push(meta);
+                    sourceTranslations.push(...locales);
+                }
+                else if (type === 'api-base') {
+                    const { meta, locales } = await readTranslationApi(value);
+                    sourceMeta.push(meta);
+                    sourceTranslations.push(...locales);
+                }
+                else {
+                    throw new Error(`Unknown source type '${type}'.`);
+                }
+            }
+            // The keys for locales are the source of truth,
+            // so any keys in meta that are not in any locale data will be dropped.
+            const keys = new Set(sourceTranslations.flatMap(i => Object.keys(i.data)));
+            // Cache translations by locale so each source is grouped only once.
+            const sourceTranslationsByLocale = new Map();
+            for (const sourceTranslation of sourceTranslations) {
+                const localeTranslations = sourceTranslationsByLocale.get(sourceTranslation.locale) ?? [];
+                localeTranslations.push(sourceTranslation);
+                sourceTranslationsByLocale.set(sourceTranslation.locale, localeTranslations);
+            }
+            // The unique locale names.
+            const localeNames = Array.from(sourceTranslationsByLocale.keys()).sort();
+            // Gather translation and meta entries.
+            const meta = Object.create(null);
+            const locales = Object.create(null);
+            for (const key of keys) {
+                if (!key) {
+                    continue;
+                }
+                for (const localeName of localeNames) {
+                    if (!localeName) {
+                        continue;
+                    }
+                    if (!(localeName in locales)) {
+                        locales[localeName] = Object.create(null);
+                    }
+                    const localeTranslationData = sourceTranslationsByLocale.get(localeName) ?? [];
+                    // Translation value for a locale key.
+                    const values = localeTranslationData
+                        .map(i => i.data?.[key])
+                        .filter(i => typeof i === 'string')
+                        .filter(i => i?.trim().length > 0);
+                    if (new Set(values).size > 1) {
+                        console.warn(`Translation '${localeName}' key '${key}' has more than one value: ${JSON.stringify(values)}`);
+                    }
+                    const valuesNonString = localeTranslationData
+                        .map(i => i.data?.[key])
+                        .filter(i => typeof i !== 'string' && i !== undefined);
+                    if (valuesNonString.length > 0) {
+                        console.warn(`Translation '${localeName}' key '${key}' has non-string values that were ignored:`, valuesNonString);
+                    }
+                    const value = lastNonEmptyString(...values);
+                    locales[localeName][key] = value ?? "";
+                }
+                // Use the first populated locale in sorted order when inferring meta.
+                const valueForMeta = localeNames
+                    .map(localeName => locales[localeName]?.[key])
+                    .find(value => typeof value === 'string' && value.trim().length > 0);
+                meta[key] = mergeMetaItems({
+                    key,
+                    value: valueForMeta,
+                    items: sourceMeta.map(i => i.data?.[key]),
+                    guessContentFormat: true,
+                }) ?? Object.create(null);
+            }
+            // Write output
+            if (outputFormat === "language-defaults") {
+                await writeTranslationFiles({
+                    meta,
+                    locales,
+                    writePath: outputPath,
+                    dryRun: globalOptions.dryRun,
+                });
+            }
+            else {
+                throw new Error(`Unknown output format '${outputFormat}'`);
+            }
+            console.log(`\n🛠️  Ran sync-translation`);
+            console.log('\n✅ Done!\n');
+        }
+        catch (error) {
+            console.error(`\n❌ Error: `, error);
+            process.exit(1);
+        }
+    });
+}

package/dist/templates/hook-archetype.js

@@ -40,7 +40,8 @@ exports.generateHookArchetype = generateHookArchetype;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const handlebars_1 = __importDefault(require("handlebars"));
-handlebars_1.default.registerHelper('json', (value) => JSON.stringify(value));
+const handlebars = handlebars_1.default.create();
+handlebars.registerHelper('json', (value) => JSON.stringify(value));
 function toPascalCase(value) {
     return value
         .split(/[^A-Za-z0-9]+/)
@@ -74,7 +75,7 @@ function walkTemplateFiles(dir) {
 }
 function renderTemplate(sourcePath, context) {
     const templateSource = fs.readFileSync(sourcePath, 'utf8');
-    const template = handlebars_1.default.compile(templateSource, { noEscape: true });
+    const template = handlebars.compile(templateSource, { noEscape: true });
     return template(context);
 }
 function toOutputRelativePath(templateRoot, filePath) {
@@ -146,7 +147,7 @@ function buildTemplateContext(options) {
         hookShortName,
         hookPascalName,
         description: options.description ?? `ReDBox hook for ${hookPascalName}`,
-        integrationDirName: hookShortName,
+        integrationDirName: `hook-${hookShortName}`,
         redboxCoreVersion: readDependencyPackageVersion(packageRoot, 'redbox-core'),
         redboxDevToolsVersion: readOwnPackageVersion(packageRoot),
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@researchdatabox/redbox-dev-tools",
-  "version": "0.0.1-beta.9950",
+  "version": "5.0.0-RC1",
   "description": "ReDBox customisation dev tools - shared configuration, generators, and migration tooling",
   "type": "commonjs",
   "main": "index.js",
@@ -44,14 +44,14 @@
   },
   "homepage": "https://github.com/redbox-mint/redbox-portal/tree/v4.5.1#readme",
   "dependencies": {
-    "@researchdatabox/redbox-core": "0.0.1-beta.9950",
-    "@researchdatabox/sails-ng-common": "0.0.1-beta.9950",
+    "@researchdatabox/redbox-core": "5.0.0-RC1",
+    "@researchdatabox/sails-ng-common": "5.0.0-RC1",
     "@tsconfig/node24": "24.0.4",
     "@types/chai": "5.2.3",
     "@types/lodash": "4.17.24",
     "@types/mocha": "10.0.10",
     "@types/node": "24.12.4",
-    "axios": "1.16.1",
+    "axios": "1.18.0",
     "chai": "6.2.2",
     "commander": "15.0.0",
     "handlebars": "4.7.9",