@digital-herd/content-hub-cli 1.0.2 → 1.0.4

package/README.md

@@ -8,6 +8,8 @@
 |---------|-------------|
 | `create-component` | Create a new React component from template |
 | `create-script` | Create a new C# script with API auto-fetch |
+| `create-manual-patch` | Create a new manual patch from template |
+| `run-manual-patch` | Run a manual patch on ContentHub |
 | `build` | Build external components for production |
 | `watch` | Watch and serve components with HMR |
 | `publish-script` | Publish scripts to ContentHub environment |
@@ -255,6 +257,56 @@ content-hub-tools <command> [options]
     content-hub-tools sync-scripts -e local
     ```
 
+- **create-manual-patch** — Create a new manual patch from template (interactive)
+
+  This command will interactively prompt you to provide a patch name and create a TypeScript patch file that can be used to run one-off data migrations or fixes.
+
+  Examples:
+
+  - Create a new patch (interactive prompts):
+    ```bash
+    content-hub-tools create-manual-patch
+    ```
+
+  The interactive prompts will guide you through:
+  - **Patch name**: Enter a PascalCase name (e.g., `FixUserIssue`, `MigrateData`)
+  - Only letters are allowed in the name
+  - The name will be automatically converted to PascalCase if needed
+
+  After running, the patch will be created at:
+  ```
+  patches/<PatchName>.patch.ts
+  ```
+
+  The generated patch file will contain:
+  - `PatchParams` interface with ContentHub client
+  - `runPatch<Name>` function ready for implementation
+
+- **run-manual-patch** — Run a manual patch on ContentHub (interactive)
+
+  This command will display all available patches sorted by last modified date (newest first) and execute the selected patch.
+
+  Examples:
+
+  - Run a patch (interactive selection):
+    ```bash
+    content-hub-tools run-manual-patch -e staging
+    ```
+
+  - Run a patch on production:
+    ```bash
+    content-hub-tools run-manual-patch -e production
+    ```
+
+  The interactive prompt will show:
+  - List of all available `.patch.ts` files
+  - Last modified timestamp for each patch
+  - Patches sorted with newest first
+
+  The patch will be executed with:
+  - Access to the ContentHub client via `PatchParams`
+  - Connection to the selected environment
+
 ## Developer notes
 
 - The CLI is implemented with `commander` and TypeScript. Entry point: `src/bin.ts`.

package/lib/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./types/ContentHubConfig.interface.js";
 export * from "./types/ExternalComponentConfig.interface.js";
 export * from "./types/ScriptConfig.interface.js";
+export * from "./types/Patch.interface.js";
+export * from "./modules";

package/lib/index.js

@@ -1 +1 @@
-var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,n){void 0===n&&(n=r);var i=Object.getOwnPropertyDescriptor(t,r);i&&("get"in i?t.__esModule:!i.writable&&!i.configurable)||(i={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,i)}:function(e,t,r,n){e[n=void 0===n?r:n]=t[r]}),__exportStar=this&&this.__exportStar||function(e,t){for(var r in e)"default"===r||Object.prototype.hasOwnProperty.call(t,r)||__createBinding(t,e,r)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./types/ContentHubConfig.interface.js"),exports),__exportStar(require("./types/ExternalComponentConfig.interface.js"),exports),__exportStar(require("./types/ScriptConfig.interface.js"),exports);
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,o){void 0===o&&(o=r);var i=Object.getOwnPropertyDescriptor(t,r);i&&("get"in i?t.__esModule:!i.writable&&!i.configurable)||(i={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,o,i)}:function(e,t,r,o){e[o=void 0===o?r:o]=t[r]}),__exportStar=this&&this.__exportStar||function(e,t){for(var r in e)"default"===r||Object.prototype.hasOwnProperty.call(t,r)||__createBinding(t,e,r)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./types/ContentHubConfig.interface.js"),exports),__exportStar(require("./types/ExternalComponentConfig.interface.js"),exports),__exportStar(require("./types/ScriptConfig.interface.js"),exports),__exportStar(require("./types/Patch.interface.js"),exports),__exportStar(require("./modules"),exports);

package/lib/modules/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./manual-patches";
 declare const _default: {
     commands: import("commander").Command[];
 }[];

package/lib/modules/index.js

@@ -1 +1 @@
-var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});let external_components_1=__importDefault(require("./external-components")),scripts_1=__importDefault(require("./scripts"));exports.default=[external_components_1.default,scripts_1.default];
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,a){void 0===a&&(a=r);var n=Object.getOwnPropertyDescriptor(t,r);n&&("get"in n?t.__esModule:!n.writable&&!n.configurable)||(n={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,a,n)}:function(e,t,r,a){e[a=void 0===a?r:a]=t[r]}),__exportStar=this&&this.__exportStar||function(e,t){for(var r in e)"default"===r||Object.prototype.hasOwnProperty.call(t,r)||__createBinding(t,e,r)},__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});let external_components_1=__importDefault(require("./external-components")),scripts_1=__importDefault(require("./scripts")),manual_patches_1=__importDefault(require("./manual-patches"));__exportStar(require("./manual-patches"),exports),exports.default=[external_components_1.default,scripts_1.default,manual_patches_1.default];

package/lib/modules/manual-patches/commands/createPatchComponent.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const createPatchCommand: Command;

package/lib/modules/manual-patches/commands/createPatchComponent.js

@@ -0,0 +1 @@
+var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.createPatchCommand=void 0;let commander_1=require("commander"),prompts_1=require("@inquirer/prompts"),globalCommandConfig_js_1=require("../../../utils/globalCommandConfig.js"),logger_js_1=__importDefault(require("../../../utils/logger.js")),CreatePatchService_js_1=__importDefault(require("../services/CreatePatchService.js"));exports.createPatchCommand=new commander_1.Command("create-manual-patch").description("Create a new patch from template").action(async e=>{e=(await(0,globalCommandConfig_js_1.globalCommandConfig)(e)).config,e=new CreatePatchService_js_1.default(e);try{var t=(await(0,prompts_1.input)({message:"Enter the patch name (e.g., MyPatch, FixUserIssue):",validate:e=>e&&0!==e.trim().length?!!/^[a-zA-Z]+$/.test(e)||"Patch name must contain only letters":"Patch name is required"})).trim();await e.createPatch(t)}catch(e){e instanceof Error&&logger_js_1.default.error("Failed to create patch: "+e.message),process.exit(1)}});

package/lib/modules/manual-patches/commands/runPatch.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const runPatchCommand: Command;

package/lib/modules/manual-patches/commands/runPatch.js

@@ -0,0 +1 @@
+var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.runPatchCommand=void 0;let commander_1=require("commander"),prompts_1=require("@inquirer/prompts"),globalCommandConfig_js_1=require("../../../utils/globalCommandConfig.js"),logger_js_1=__importDefault(require("../../../utils/logger.js")),RunPatchService_js_1=__importDefault(require("../services/RunPatchService.js"));exports.runPatchCommand=(0,globalCommandConfig_js_1.setGlobalConfig)(new commander_1.Command("run-manual-patch")).description("Run a patch").action(async e=>{var{config:e,environment:a}=await(0,globalCommandConfig_js_1.globalCommandConfig)(e),e=new RunPatchService_js_1.default(e,a);try{var r=e.getAvailablePatches(),o=(0===r.length&&(logger_js_1.default.error("No patches found in the patch directory"),process.exit(1)),await(0,prompts_1.select)({message:"Select a patch to run:",choices:r.map(e=>({name:`${e.name} (modified: ${e.modifiedTime.toLocaleString()})`,value:e.name}))}));await e.runPatch(o)}catch(e){e instanceof Error&&logger_js_1.default.error("Failed to run patch: "+e.message),process.exit(1)}});

package/lib/modules/manual-patches/index.d.ts

@@ -0,0 +1,6 @@
+import PatchService from "./services/PatchService";
+export { PatchService };
+declare const _default: {
+    commands: import("commander").Command[];
+};
+export default _default;

package/lib/modules/manual-patches/index.js

@@ -0,0 +1 @@
+var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.PatchService=void 0;let createPatchComponent_1=require("./commands/createPatchComponent"),runPatch_1=require("./commands/runPatch"),PatchService_1=__importDefault(require("./services/PatchService"));exports.PatchService=PatchService_1.default,exports.default={commands:[createPatchComponent_1.createPatchCommand,runPatch_1.runPatchCommand]};

package/lib/modules/manual-patches/services/CreatePatchService.d.ts

@@ -0,0 +1,10 @@
+import { ContenthubConfig } from "../../../types/ContentHubConfig.interface.js";
+export default class CreatePatchService {
+    private config;
+    private patchDir;
+    constructor(config: ContenthubConfig);
+    /**
+     * Create a new patch file from template
+     */
+    createPatch(patchName: string): Promise<void>;
+}

package/lib/modules/manual-patches/services/CreatePatchService.js

@@ -0,0 +1,12 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,i){void 0===i&&(i=r);var a=Object.getOwnPropertyDescriptor(t,r);a&&("get"in a?t.__esModule:!a.writable&&!a.configurable)||(a={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,i,a)}:function(e,t,r,i){e[i=void 0===i?r:i]=t[r]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t}),__importStar=this&&this.__importStar||(()=>{var a=function(e){return(a=Object.getOwnPropertyNames||function(e){var t,r=[];for(t in e)Object.prototype.hasOwnProperty.call(e,t)&&(r[r.length]=t);return r})(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var r=a(e),i=0;i<r.length;i++)"default"!==r[i]&&__createBinding(t,e,r[i]);return __setModuleDefault(t,e),t}})(),__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});let fs=__importStar(require("fs")),path=__importStar(require("path")),logger_js_1=__importDefault(require("../../../utils/logger.js"));class CreatePatchService{config;patchDir;constructor(e){this.config=e,this.patchDir=path.resolve(process.cwd(),e.patchDir)}async createPatch(e){var e=e.charAt(0).toUpperCase()+e.slice(1),t=e.charAt(0).toLowerCase()+e.slice(1),t=(fs.existsSync(this.patchDir)||fs.mkdirSync(this.patchDir,{recursive:!0}),path.join(this.patchDir,t+".patch.ts"));if(fs.existsSync(t))throw logger_js_1.default.error(`Patch "${e}" already exists`),new Error("Patch already exists");logger_js_1.default.info(`📦 Creating patch "${e}"...`);var r=`import { PatchService } from "@digital-herd/content-hub-cli";
+
+    const patchService = new PatchService();
+
+
+const runPatch${e} = async () => {
+const client = await patchService.getClient();
+  // run patch
+};
+
+export default runPatch${e};
+`;fs.writeFileSync(t,r,"utf-8"),logger_js_1.default.info(`✅ Patch "${e}" created successfully!`),logger_js_1.default.info("📁 Location: "+path.relative(process.cwd(),t))}}exports.default=CreatePatchService;

package/lib/modules/manual-patches/services/PatchService.d.ts

@@ -0,0 +1,14 @@
+import ContenthubService from "@/services/ContenthubService";
+import { ContenthubConfig, ContenthubEnvironment } from "@/types/ContentHubConfig.interface";
+declare class PatchService {
+    private _initialised;
+    runtimeConfig?: {
+        config: ContenthubConfig;
+        environment: ContenthubEnvironment;
+        contenthubService: ContenthubService;
+    };
+    constructor();
+    private init;
+    getClient(): Promise<import("@sitecore/sc-contenthub-webclient-sdk").ContentHubClient>;
+}
+export default PatchService;

package/lib/modules/manual-patches/services/PatchService.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});let globalCommandConfig_1=require("@/utils/globalCommandConfig");class PatchService{_initialised=!1;runtimeConfig;constructor(){}async init(){this._initialised||(this.runtimeConfig=await(0,globalCommandConfig_1.globalCommandConfig)({environent:process.env.ENVIRONMENT}),this._initialised=!0)}async getClient(){return await this.init(),this.runtimeConfig.contenthubService.client}}exports.default=PatchService;

package/lib/modules/manual-patches/services/RunPatchService.d.ts

@@ -0,0 +1,21 @@
+import { ContenthubConfig } from "../../../types/ContentHubConfig.interface.js";
+import { ContenthubEnvironment } from "../../../types/ContentHubConfig.interface.js";
+interface PatchFile {
+    name: string;
+    path: string;
+    modifiedTime: Date;
+}
+export default class RunPatchService {
+    private environment;
+    private patchDir;
+    constructor(config: ContenthubConfig, environment: ContenthubEnvironment);
+    /**
+     * Get all available patch files sorted by last modified (newest first)
+     */
+    getAvailablePatches(): PatchFile[];
+    /**
+     * Execute a specific patch
+     */
+    runPatch(patchName: string): Promise<void>;
+}
+export {};

package/lib/modules/manual-patches/services/RunPatchService.js

@@ -0,0 +1 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,i){void 0===i&&(i=r);var n=Object.getOwnPropertyDescriptor(t,r);n&&("get"in n?t.__esModule:!n.writable&&!n.configurable)||(n={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,i,n)}:function(e,t,r,i){e[i=void 0===i?r:i]=t[r]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t}),__importStar=this&&this.__importStar||(()=>{var n=function(e){return(n=Object.getOwnPropertyNames||function(e){var t,r=[];for(t in e)Object.prototype.hasOwnProperty.call(e,t)&&(r[r.length]=t);return r})(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var r=n(e),i=0;i<r.length;i++)"default"!==r[i]&&__createBinding(t,e,r[i]);return __setModuleDefault(t,e),t}})(),__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});let fs=__importStar(require("fs")),path=__importStar(require("path")),child_process_1=require("child_process"),logger_js_1=__importDefault(require("../../../utils/logger.js"));class RunPatchService{environment;patchDir;constructor(e,t){this.environment=t,this.patchDir=path.resolve(process.cwd(),e.patchDir)}getAvailablePatches(){return fs.existsSync(this.patchDir)?fs.readdirSync(this.patchDir).filter(e=>e.endsWith(".patch.ts")).map(e=>{var t=path.join(this.patchDir,e),r=fs.statSync(t);return{name:e.replace(".patch.ts",""),path:t,modifiedTime:r.mtime}}).sort((e,t)=>t.modifiedTime.getTime()-e.modifiedTime.getTime()):(logger_js_1.default.warn("Patch directory not found: "+this.patchDir),[])}async runPatch(i){let n=path.join(this.patchDir,i+".patch.ts");if(fs.existsSync(n))return logger_js_1.default.info(`🚀 Running patch "${i}"...`),new Promise((t,r)=>{var e=(0,child_process_1.spawn)("npx",["tsx",n],{stdio:["inherit","inherit","inherit"],shell:!0,cwd:process.cwd(),env:{...process.env,ENVIRONMENT:this.environment.name}});e.on("error",e=>{logger_js_1.default.error("Failed to spawn patch process: "+e.message),r(e)}),e.on("exit",e=>{0===e?(logger_js_1.default.info(`✅ Patch "${i}" completed successfully!`),t()):(e=new Error("Patch exited with code "+e),logger_js_1.default.error(`Failed to run patch "${i}": `+e.message),r(e))})});throw logger_js_1.default.error(`Patch "${i}" not found at `+n),new Error("Patch not found")}}exports.default=RunPatchService;

package/lib/modules/patches/commands/createPatchComponent.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const createPatchCommand: Command;

package/lib/modules/patches/commands/createPatchComponent.js

@@ -0,0 +1 @@
+var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.createPatchCommand=void 0;let commander_1=require("commander"),prompts_1=require("@inquirer/prompts"),globalCommandConfig_js_1=require("../../../utils/globalCommandConfig.js"),logger_js_1=__importDefault(require("../../../utils/logger.js")),CreatePatchService_js_1=__importDefault(require("../services/CreatePatchService.js"));exports.createPatchCommand=new commander_1.Command("create-patch").description("Create a new patch from template").action(async e=>{e=(await(0,globalCommandConfig_js_1.globalCommandConfig)(e)).config,e=new CreatePatchService_js_1.default(e);try{var t=(await(0,prompts_1.input)({message:"Enter the patch name (e.g., MyPatch, FixUserIssue):",validate:e=>e&&0!==e.trim().length?!!/^[a-zA-Z]+$/.test(e)||"Patch name must contain only letters":"Patch name is required"})).trim();await e.createPatch(t)}catch(e){e instanceof Error&&logger_js_1.default.error("Failed to create patch: "+e.message),process.exit(1)}});

package/lib/modules/patches/commands/runPatch.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const runPatchCommand: Command;

package/lib/modules/patches/commands/runPatch.js

@@ -0,0 +1 @@
+var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.runPatchCommand=void 0;let commander_1=require("commander"),prompts_1=require("@inquirer/prompts"),globalCommandConfig_js_1=require("../../../utils/globalCommandConfig.js"),logger_js_1=__importDefault(require("../../../utils/logger.js")),RunPatchService_js_1=__importDefault(require("../services/RunPatchService.js"));exports.runPatchCommand=(0,globalCommandConfig_js_1.setGlobalConfig)(new commander_1.Command("run-patch")).description("Run a patch").action(async e=>{var{config:e,contenthubService:a}=await(0,globalCommandConfig_js_1.globalCommandConfig)(e),a=new RunPatchService_js_1.default(a,e);try{var r=a.getAvailablePatches(),t=(0===r.length&&(logger_js_1.default.error("No patches found in the patch directory"),process.exit(1)),await(0,prompts_1.select)({message:"Select a patch to run:",choices:r.map(e=>({name:`${e.name} (modified: ${e.modifiedTime.toLocaleString()})`,value:e.name}))}));await a.runPatch(t)}catch(e){e instanceof Error&&logger_js_1.default.error("Failed to run patch: "+e.message),process.exit(1)}});

package/lib/modules/patches/index.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    commands: import("commander").Command[];
+};
+export default _default;

package/lib/modules/patches/index.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});let createPatchComponent_1=require("./commands/createPatchComponent"),runPatch_1=require("./commands/runPatch");exports.default={commands:[createPatchComponent_1.createPatchCommand,runPatch_1.runPatchCommand]};

package/lib/modules/patches/services/CreatePatchService.d.ts

@@ -0,0 +1,10 @@
+import { ContenthubConfig } from "../../../types/ContentHubConfig.interface.js";
+export default class CreatePatchService {
+    private config;
+    private patchDir;
+    constructor(config: ContenthubConfig);
+    /**
+     * Create a new patch file from template
+     */
+    createPatch(patchName: string): Promise<void>;
+}

package/lib/modules/patches/services/CreatePatchService.js

@@ -0,0 +1,10 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(t,e,r,a){void 0===a&&(a=r);var i=Object.getOwnPropertyDescriptor(e,r);i&&("get"in i?e.__esModule:!i.writable&&!i.configurable)||(i={enumerable:!0,get:function(){return e[r]}}),Object.defineProperty(t,a,i)}:function(t,e,r,a){t[a=void 0===a?r:a]=e[r]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}:function(t,e){t.default=e}),__importStar=this&&this.__importStar||(()=>{var i=function(t){return(i=Object.getOwnPropertyNames||function(t){var e,r=[];for(e in t)Object.prototype.hasOwnProperty.call(t,e)&&(r[r.length]=e);return r})(t)};return function(t){if(t&&t.__esModule)return t;var e={};if(null!=t)for(var r=i(t),a=0;a<r.length;a++)"default"!==r[a]&&__createBinding(e,t,r[a]);return __setModuleDefault(e,t),e}})(),__importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0});let fs=__importStar(require("fs")),path=__importStar(require("path")),logger_js_1=__importDefault(require("../../../utils/logger.js"));class CreatePatchService{config;patchDir;constructor(t){this.config=t,this.patchDir=path.resolve(process.cwd(),t.patchDir)}async createPatch(t){var t=t.charAt(0).toUpperCase()+t.slice(1),e=t.charAt(0).toLowerCase()+t.slice(1),e=(fs.existsSync(this.patchDir)||fs.mkdirSync(this.patchDir,{recursive:!0}),path.join(this.patchDir,e+".patch.ts"));if(fs.existsSync(e))throw logger_js_1.default.error(`Patch "${t}" already exists`),new Error("Patch already exists");logger_js_1.default.info(`📦 Creating patch "${t}"...`);var r=`import { PatchParams } from "@digital-herd/content-hub-cli";
+
+
+
+const runPatch${t} = ({ client }: PatchParams) => {
+  // run patch
+};
+
+export default runPatch${t};
+`;fs.writeFileSync(e,r,"utf-8"),logger_js_1.default.info(`✅ Patch "${t}" created successfully!`),logger_js_1.default.info("📁 Location: "+path.relative(process.cwd(),e))}}exports.default=CreatePatchService;

package/lib/modules/patches/services/RunPatchService.d.ts

@@ -0,0 +1,23 @@
+import { ContenthubConfig } from "../../../types/ContentHubConfig.interface.js";
+import ContenthubService from "../../../services/ContenthubService.js";
+interface PatchFile {
+    name: string;
+    path: string;
+    modifiedTime: Date;
+}
+export default class RunPatchService {
+    private contenthubService;
+    private config;
+    private patchDir;
+    private fileService;
+    constructor(contenthubService: ContenthubService, config: ContenthubConfig);
+    /**
+     * Get all available patch files sorted by last modified (newest first)
+     */
+    getAvailablePatches(): PatchFile[];
+    /**
+     * Execute a specific patch
+     */
+    runPatch(patchName: string): Promise<void>;
+}
+export {};

package/lib/modules/patches/services/RunPatchService.js

@@ -0,0 +1 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,i){void 0===i&&(i=r);var a=Object.getOwnPropertyDescriptor(t,r);a&&("get"in a?t.__esModule:!a.writable&&!a.configurable)||(a={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,i,a)}:function(e,t,r,i){e[i=void 0===i?r:i]=t[r]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t}),__importStar=this&&this.__importStar||(()=>{var a=function(e){return(a=Object.getOwnPropertyNames||function(e){var t,r=[];for(t in e)Object.prototype.hasOwnProperty.call(e,t)&&(r[r.length]=t);return r})(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var r=a(e),i=0;i<r.length;i++)"default"!==r[i]&&__createBinding(t,e,r[i]);return __setModuleDefault(t,e),t}})(),__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});let fs=__importStar(require("fs")),path=__importStar(require("path")),logger_js_1=__importDefault(require("../../../utils/logger.js")),FileService_js_1=__importDefault(require("../../../services/FileService.js"));class RunPatchService{contenthubService;config;patchDir;fileService;constructor(e,t){this.contenthubService=e,this.config=t,this.patchDir=path.resolve(process.cwd(),t.patchDir),this.fileService=new FileService_js_1.default(t)}getAvailablePatches(){return fs.existsSync(this.patchDir)?fs.readdirSync(this.patchDir).filter(e=>e.endsWith(".patch.ts")).map(e=>{var t=path.join(this.patchDir,e),r=fs.statSync(t);return{name:e.replace(".patch.ts",""),path:t,modifiedTime:r.mtime}}).sort((e,t)=>t.modifiedTime.getTime()-e.modifiedTime.getTime()):(logger_js_1.default.warn("Patch directory not found: "+this.patchDir),[])}async runPatch(t){var e=path.join(this.patchDir,t+".patch.ts");if(!fs.existsSync(e))throw logger_js_1.default.error(`Patch "${t}" not found at `+e),new Error("Patch not found");logger_js_1.default.info(`🚀 Running patch "${t}"...`);try{var r=await this.fileService.tsFileImport(e);if("function"!=typeof r)throw new Error(`Patch "${t}" does not export a default function`);await r({client:this.contenthubService.client}),logger_js_1.default.info(`✅ Patch "${t}" completed successfully!`)}catch(e){throw logger_js_1.default.error(`Failed to run patch "${t}":`,e),e}}}exports.default=RunPatchService;

package/lib/services/FileService.d.ts

@@ -12,7 +12,7 @@ declare class FileService {
     getScriptConfig(scriptName: string): string;
     getScriptContent(scriptName: string): string;
     getAbsolutePath(p: string): string;
-    tsFileImport<T = any>(path: string): Promise<T>;
+    tsFileImport<T = any>(filePath: string, tsconfigPath?: string): Promise<T>;
     writeScript(scriptName: string, content: string, config: ActionScriptConfig): Promise<void>;
     prettyFile(filePath: string): Promise<void>;
 }

package/lib/services/FileService.js

@@ -1,4 +1,4 @@
-var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0});let glob_1=require("glob"),path_1=__importDefault(require("path")),prettier_1=__importDefault(require("prettier")),tempDirectory_js_1=require("../config/tempDirectory.js"),api_1=require("tsx/esm/api"),fs_1=require("fs");class FileService{config;constructor(t){this.config=t}getAllComponentPaths(t="*.config.ts"){return(0,glob_1.sync)(this.config.componentDir+"/**/"+t)}getAllComponentNames(t="*.config.ts"){return this.getAllComponentPaths(t).map(t=>{t=t.split("/");return t[t.length-2]})}getDirectoryOfComponent(t){var t=(0,glob_1.sync)(this.config.componentDir+`/**/${t}/*.tsx`)[0];return t?((t=t.split("/")).pop(),t.join("/")):null}getComponentConfig(t){return(0,glob_1.sync)(this.config.componentDir+`/**/${t}/*.config.ts`)[0]}getComponentBuild(t,e=!0){t=(0,glob_1.sync)(tempDirectory_js_1.BUILD_DIRECTORY+`/${t}.js`)[0];return e?t&&this.getAbsolutePath(t):t}getEntryOfComponent(t){return(0,glob_1.sync)(this.config.componentDir+`/**/${t}/*.tsx`)[0]}getScriptConfig(t){return(0,glob_1.sync)(this.config.scriptDir+`/${t}/*.config.ts`)[0]}getScriptContent(t){return(0,glob_1.sync)(this.config.scriptDir+`/${t}/*.cs`)[0]}getAbsolutePath(t){return path_1.default.isAbsolute(t)?t:path_1.default.resolve(process.cwd(),t)}async tsFileImport(t){t=this.getAbsolutePath(t);return(await(0,api_1.tsImport)(t,t)).default}async writeScript(t,e,i){var r=this.config.scriptDir+"/"+t,n=((0,fs_1.existsSync)(r)||(0,fs_1.mkdirSync)(r,{recursive:!0}),r+`/${t}.config.ts`);(0,fs_1.writeFileSync)(n,`
+var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0});let glob_1=require("glob"),path_1=__importDefault(require("path")),prettier_1=__importDefault(require("prettier")),tempDirectory_js_1=require("../config/tempDirectory.js"),api_1=require("tsx/esm/api"),fs_1=require("fs");class FileService{config;constructor(t){this.config=t}getAllComponentPaths(t="*.config.ts"){return(0,glob_1.sync)(this.config.componentDir+"/**/"+t)}getAllComponentNames(t="*.config.ts"){return this.getAllComponentPaths(t).map(t=>{t=t.split("/");return t[t.length-2]})}getDirectoryOfComponent(t){var t=(0,glob_1.sync)(this.config.componentDir+`/**/${t}/*.tsx`)[0];return t?((t=t.split("/")).pop(),t.join("/")):null}getComponentConfig(t){return(0,glob_1.sync)(this.config.componentDir+`/**/${t}/*.config.ts`)[0]}getComponentBuild(t,e=!0){t=(0,glob_1.sync)(tempDirectory_js_1.BUILD_DIRECTORY+`/${t}.js`)[0];return e?t&&this.getAbsolutePath(t):t}getEntryOfComponent(t){return(0,glob_1.sync)(this.config.componentDir+`/**/${t}/*.tsx`)[0]}getScriptConfig(t){return(0,glob_1.sync)(this.config.scriptDir+`/${t}/*.config.ts`)[0]}getScriptContent(t){return(0,glob_1.sync)(this.config.scriptDir+`/${t}/*.cs`)[0]}getAbsolutePath(t){return path_1.default.isAbsolute(t)?t:path_1.default.resolve(process.cwd(),t)}async tsFileImport(t,e){t=this.getAbsolutePath(t),e=e?this.getAbsolutePath(e):void 0;return(await(0,api_1.tsImport)(t,t,{tsconfig:e})).default}async writeScript(t,e,i){var r=this.config.scriptDir+"/"+t,o=((0,fs_1.existsSync)(r)||(0,fs_1.mkdirSync)(r,{recursive:!0}),r+`/${t}.config.ts`);(0,fs_1.writeFileSync)(o,`
       import { type ActionScriptConfig } from "@digital-herd/content-hub-cli";
       export default {
         identifier: "${i.identifier}",
@@ -7,4 +7,4 @@ var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModu
         description: \`${i.description}\`,
         executeAsUser: ${i.executeAsUser?"true":"false"},
       } as ActionScriptConfig;
-    `),await this.prettyFile(n),(0,fs_1.writeFileSync)(r+`/${t}.cs`,e)}async prettyFile(t){var e=await prettier_1.default.format((0,fs_1.readFileSync)(t,"utf8"),{...await prettier_1.default.resolveConfig(t),filepath:t});(0,fs_1.writeFileSync)(t,e)}}exports.default=FileService;
+    `),await this.prettyFile(o),(0,fs_1.writeFileSync)(r+`/${t}.cs`,e)}async prettyFile(t){var e=await prettier_1.default.format((0,fs_1.readFileSync)(t,"utf8"),{...await prettier_1.default.resolveConfig(t),filepath:t});(0,fs_1.writeFileSync)(t,e)}}exports.default=FileService;

package/lib/types/ContentHubConfig.interface.d.ts

@@ -6,6 +6,7 @@ export interface ContenthubEnvironment {
 export interface ContenthubConfig {
     componentDir: string;
     scriptDir: string;
+    patchDir: string;
     port: number;
     templates: {
         externalComponent: string;

package/lib/types/Patch.interface.d.ts

@@ -0,0 +1,4 @@
+import { ContentHubClient } from "@sitecore/sc-contenthub-webclient-sdk";
+export interface PatchParams {
+    client: ContentHubClient;
+}

package/lib/types/Patch.interface.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@digital-herd/content-hub-cli",
   "description": "CLI tools for managing Sitecore Content Hub external components and scripts",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "commonjs",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -26,7 +26,6 @@
     "@inquirer/input": "^5.0.4",
     "@inquirer/prompts": "^8.2.0",
     "@inquirer/select": "^5.0.4",
-    "@sitecore/sc-contenthub-webclient-sdk": "1.2.96",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
     "commander": "^11.0.0",
@@ -44,5 +43,8 @@
     "@types/lodash": "^4.17.23",
     "ts-node": "^10.9.2",
     "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "@sitecore/sc-contenthub-webclient-sdk": "^1.2.96"
   }
 }