@sitecoreai-labs/sitecoreai-cli 0.0.4

package/dist/serialization/tasks/package.js

@@ -0,0 +1,171 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPackageInstall = exports.runPackageCreate = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const config_1 = require("../../config");
+const field_filter_1 = require("../field-filter");
+const sitecore_api_1 = require("../sitecore-api");
+const filesystem_store_1 = require("../filesystem-store");
+const yaml_1 = require("../yaml");
+const shared_1 = require("./shared");
+const helpers_1 = require("./helpers");
+const commands_1 = require("../commands");
+const exists = async (value) => {
+    try {
+        await promises_1.default.access(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const runPackageCreate = async (options) => {
+    const logger = (0, shared_1.toLogger)(options);
+    const { root, modules } = await (0, shared_1.loadConfigAndModules)(options);
+    const rawOutput = options.output ?? "sitecore.package";
+    const outputPath = node_path_1.default.resolve(rawOutput.endsWith(".zip") ? rawOutput : `${rawOutput}.zip`);
+    if (await exists(outputPath)) {
+        if (options.overwrite) {
+            await promises_1.default.rm(outputPath, { force: true });
+        }
+        else {
+            throw (0, shared_1.inputError)(`Package ${outputPath} already exists. Use --overwrite to replace it.`);
+        }
+    }
+    const zip = new adm_zip_1.default();
+    const rootConfig = {
+        modules: modules.map((module) => `${module.namespace}/${module.namespace}.module.json`),
+        serialization: { excludedFields: root.serialization.excludedFields },
+    };
+    zip.addFile("sitecoreai.cli.json", Buffer.from(JSON.stringify(rootConfig, null, 2)));
+    for (const module of modules) {
+        const modulePath = `${module.namespace}/${module.namespace}.module.json`;
+        const moduleContent = await promises_1.default.readFile(module.sourceIdentifier);
+        zip.addFile(modulePath, moduleContent);
+    }
+    for (const module of modules) {
+        for (const subtree of module.items.includes) {
+            const files = await (0, fast_glob_1.default)("**/*.yml", {
+                cwd: subtree.physicalPath,
+                absolute: true,
+                onlyFiles: true,
+            });
+            for (const file of files) {
+                const relative = node_path_1.default.relative(node_path_1.default.dirname(module.sourceIdentifier), file);
+                const entryPath = node_path_1.default.posix.join(module.namespace, relative.split(node_path_1.default.sep).join("/"));
+                zip.addFile(entryPath, await promises_1.default.readFile(file));
+            }
+        }
+        const roles = await (0, filesystem_store_1.readRolesFromFilesystem)(root, module);
+        for (const role of roles) {
+            const rolePath = role.serializedItemId ?? "";
+            const relative = node_path_1.default.relative(node_path_1.default.dirname(module.sourceIdentifier), rolePath);
+            const entryPath = node_path_1.default.posix.join(module.namespace, relative.split(node_path_1.default.sep).join("/"));
+            zip.addFile(entryPath, Buffer.from((0, yaml_1.writeRoleYaml)(role)));
+        }
+        const users = await (0, filesystem_store_1.readUsersFromFilesystem)(root, module);
+        for (const user of users) {
+            const userPath = user.serializedItemId ?? "";
+            const relative = node_path_1.default.relative(node_path_1.default.dirname(module.sourceIdentifier), userPath);
+            const entryPath = node_path_1.default.posix.join(module.namespace, relative.split(node_path_1.default.sep).join("/"));
+            zip.addFile(entryPath, Buffer.from((0, yaml_1.writeUserYaml)(user)));
+        }
+    }
+    zip.writeZip(outputPath);
+    if (logger.isJson()) {
+        logger.json({
+            command: "serialization.package.create",
+            outputPath,
+            modules: modules.length,
+        });
+        return;
+    }
+    logger.info(`Created package at ${outputPath}`, "green");
+};
+exports.runPackageCreate = runPackageCreate;
+const runPackageInstall = async (options) => {
+    const logger = (0, shared_1.toLogger)(options);
+    const root = (0, config_1.readRootConfiguration)(options.config ?? process.cwd());
+    const envName = options.environmentName ?? root.defaultEnvironment;
+    const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
+    const summary = {
+        command: "serialization.package.install",
+        environment: envName,
+        package: options.package,
+        whatIf: Boolean(options.whatIf),
+        totalChanges: 0,
+        databases: [],
+    };
+    if (!options.whatIf) {
+        (0, shared_1.ensureAllowWrite)(root, envName);
+    }
+    else if (!logger.isJson()) {
+        logger.info("What if mode is active. No changes will be made.", "yellow");
+    }
+    const zip = new adm_zip_1.default(options.package);
+    const rootEntry = zip.getEntry("sitecoreai.cli.json");
+    if (!rootEntry) {
+        throw (0, shared_1.inputError)("Package did not contain sitecoreai.cli.json index.");
+    }
+    const rootConfig = JSON.parse(rootEntry.getData().toString("utf8"));
+    const moduleConfigs = [];
+    for (const modulePath of rootConfig.modules ?? []) {
+        const entry = zip.getEntry(modulePath);
+        if (!entry) {
+            continue;
+        }
+        const raw = JSON.parse(entry.getData().toString("utf8"));
+        moduleConfigs.push((0, config_1.normalizeModuleConfiguration)(raw, modulePath, root));
+    }
+    const subtreesByDb = (0, shared_1.groupSubtreesByDatabase)(moduleConfigs);
+    const entries = zip.getEntries().filter((entry) => entry.entryName.endsWith(".yml"));
+    for (const [database, subtrees] of subtreesByDb) {
+        const packageItems = [];
+        for (const entry of entries) {
+            const item = (0, yaml_1.readItemYamlFromString)(entry.getData().toString("utf8"));
+            const matches = subtrees.find((subtree) => subtree.includesPath(item.path));
+            if (!matches) {
+                continue;
+            }
+            item.database = item.database ?? database;
+            packageItems.push(item);
+        }
+        const packageMetadata = packageItems.map((item) => ({
+            id: item.id,
+            parentId: item.parentId,
+            templateId: item.templateId,
+            path: item.path,
+            dataSignature: item.dataSignature,
+        }));
+        const destinationMetadata = [];
+        for (const subtree of subtrees) {
+            const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
+            const metadata = await (0, sitecore_api_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, false, { timeoutMs: apiTimeoutMs });
+            destinationMetadata.push(...metadata.filter((item) => subtree.includesPath(item.path)));
+        }
+        const commands = (0, helpers_1.buildCommandsForDatabase)(subtrees, packageMetadata, destinationMetadata, true);
+        const changes = commands.length;
+        summary.totalChanges += changes;
+        summary.databases.push({
+            database,
+            changes,
+            applied: changes > 0 && !options.whatIf,
+        });
+        const sourceDataMap = new Map(packageItems.map((item) => [item.id, item]));
+        const destData = await (0, helpers_1.collectItemData)(envName, root, subtrees, false);
+        const destDataMap = (0, helpers_1.buildItemDataMap)(destData.items);
+        (0, commands_1.enrichCreateCommands)(commands, sourceDataMap);
+        (0, commands_1.enrichUpdateCommands)(commands, sourceDataMap, destDataMap, true);
+        await (0, helpers_1.applySitecoreCommands)(root, envName, database, commands, logger, options.whatIf);
+    }
+    if (logger.isJson()) {
+        logger.json(summary);
+    }
+};
+exports.runPackageInstall = runPackageInstall;

package/dist/serialization/tasks/pull.d.ts

@@ -0,0 +1,3 @@
+import type { SyncOptions } from "./types";
+export declare const runPull: (options: SyncOptions) => Promise<void>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/serialization/tasks/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/serialization/tasks/pull.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAU3C,eAAO,MAAM,OAAO,GAAU,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CA0FhE,CAAC"}

package/dist/serialization/tasks/pull.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPull = void 0;
+const path_provider_1 = require("../path-provider");
+const field_filter_1 = require("../field-filter");
+const sitecore_api_1 = require("../sitecore-api");
+const filesystem_store_1 = require("../filesystem-store");
+const spinner_1 = require("../../shared/spinner");
+const shared_1 = require("./shared");
+const commands_1 = require("../commands");
+const helpers_1 = require("./helpers");
+const roles_1 = require("./roles");
+const users_1 = require("./users");
+const runPull = async (options) => {
+    const logger = (0, shared_1.toLogger)(options);
+    const { root, modules } = await (0, shared_1.loadConfigAndModules)(options);
+    const envName = options.environmentName ?? root.defaultEnvironment;
+    const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
+    const summary = {
+        command: "serialization.pull",
+        environment: envName,
+        whatIf: Boolean(options.whatIf),
+        totalChanges: 0,
+        databases: [],
+    };
+    const subtreesByDb = (0, shared_1.groupSubtreesByDatabase)(modules);
+    for (const [database, subtrees] of subtreesByDb) {
+        const spinner = await (0, spinner_1.startSpinner)(`Pulling ${database} items`);
+        try {
+            const sourceMetadata = [];
+            for (const subtree of subtrees) {
+                const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
+                const metadata = await (0, sitecore_api_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, Boolean(options.useDebugSignatures), { timeoutMs: apiTimeoutMs });
+                sourceMetadata.push(...metadata.filter((item) => subtree.includesPath(item.path)));
+            }
+            const { items: destinationItems, metadata: destinationMetadata } = await (0, filesystem_store_1.loadFilesystemItems)(subtrees);
+            const commands = (0, helpers_1.buildCommandsForDatabase)(subtrees, sourceMetadata, destinationMetadata, false);
+            const changes = commands.length;
+            summary.totalChanges += changes;
+            summary.databases.push({
+                database,
+                changes,
+                applied: changes > 0 && !options.whatIf,
+            });
+            if (changes === 0) {
+                if (!logger.isJson()) {
+                    logger.info(`No changes detected for ${database}.`, "green");
+                }
+                spinner?.succeed();
+                continue;
+            }
+            if (!logger.isJson()) {
+                logger.info(`Discovered ${changes} changes for ${database}.`, "green");
+            }
+            if (options.whatIf) {
+                if (!logger.isJson()) {
+                    logger.info("What if mode is active. No changes will be made.", "yellow");
+                }
+                spinner?.succeed();
+                continue;
+            }
+            const dataMap = (0, helpers_1.buildItemDataMap)((await (0, helpers_1.collectItemData)(envName, root, subtrees, Boolean(options.useDebugSignatures))).items);
+            (0, commands_1.enrichCreateCommands)(commands, dataMap);
+            (0, commands_1.enrichUpdateCommands)(commands, dataMap, (0, helpers_1.buildItemDataMap)(destinationItems), false);
+            const pathProvider = new path_provider_1.FilesystemPathProvider(subtrees);
+            await (0, helpers_1.applyFilesystemCommands)(commands, pathProvider, dataMap, logger);
+            spinner?.succeed();
+        }
+        catch (error) {
+            spinner?.fail();
+            throw error;
+        }
+    }
+    for (const module of modules) {
+        await (0, roles_1.syncRolesPull)(root, module, envName, logger);
+        await (0, users_1.syncUsersPull)(root, module, envName, logger);
+    }
+    if (logger.isJson()) {
+        logger.json(summary);
+    }
+};
+exports.runPull = runPull;

package/dist/serialization/tasks/push.d.ts

@@ -0,0 +1,3 @@
+import type { SyncOptions } from "./types";
+export declare const runPush: (options: SyncOptions) => Promise<void>;
+//# sourceMappingURL=push.d.ts.map

package/dist/serialization/tasks/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/serialization/tasks/push.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAU3C,eAAO,MAAM,OAAO,GAAU,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CA8HhE,CAAC"}

package/dist/serialization/tasks/push.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPush = void 0;
+const field_filter_1 = require("../field-filter");
+const sitecore_api_1 = require("../sitecore-api");
+const filesystem_store_1 = require("../filesystem-store");
+const spinner_1 = require("../../shared/spinner");
+const shared_1 = require("./shared");
+const commands_1 = require("../commands");
+const helpers_1 = require("./helpers");
+const roles_1 = require("./roles");
+const users_1 = require("./users");
+const runPush = async (options) => {
+    const logger = (0, shared_1.toLogger)(options);
+    const { root, modules } = await (0, shared_1.loadConfigAndModules)(options);
+    const envName = options.environmentName ?? root.defaultEnvironment;
+    const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
+    const summary = {
+        command: "serialization.push",
+        environment: envName,
+        whatIf: Boolean(options.whatIf),
+        totalChanges: 0,
+        publishedCount: 0,
+        databases: [],
+    };
+    if (options.allowWrite) {
+        const env = root.environments[envName];
+        if (env) {
+            env.allowWrite = true;
+        }
+    }
+    if (!options.whatIf) {
+        (0, shared_1.ensureAllowWrite)(root, envName);
+    }
+    const subtreesByDb = (0, shared_1.groupSubtreesByDatabase)(modules);
+    for (const [database, subtrees] of subtreesByDb) {
+        const spinner = await (0, spinner_1.startSpinner)(`Pushing ${database} items`);
+        try {
+            const { items: sourceItems, metadata: sourceMetadata } = await (0, filesystem_store_1.loadFilesystemItems)(subtrees);
+            const destinationMetadata = [];
+            for (const subtree of subtrees) {
+                const filter = (0, field_filter_1.createFieldFilterSet)(root.serialization.excludedFields, []);
+                const metadata = await (0, sitecore_api_1.fetchItemMetadata)(root.environments[envName], database, subtree.path.toPathString(), subtree.scope, filter, Boolean(options.useDebugSignatures), { timeoutMs: apiTimeoutMs });
+                destinationMetadata.push(...metadata.filter((item) => subtree.includesPath(item.path)));
+            }
+            const commands = (0, helpers_1.buildCommandsForDatabase)(subtrees, sourceMetadata, destinationMetadata, true);
+            const changes = commands.length;
+            summary.totalChanges += changes;
+            const summaryEntry = {
+                database,
+                changes,
+                applied: changes > 0 && !options.whatIf,
+                published: false,
+            };
+            if (changes === 0) {
+                if (!logger.isJson()) {
+                    logger.info(`No changes detected for ${database}.`, "green");
+                }
+                spinner?.succeed();
+                summary.databases.push(summaryEntry);
+                continue;
+            }
+            if (options.whatIf && !logger.isJson()) {
+                logger.info("What if mode is active. No changes will be made.", "yellow");
+            }
+            const sourceDataMap = (0, helpers_1.buildItemDataMap)(sourceItems);
+            const destData = await (0, helpers_1.collectItemData)(envName, root, subtrees, Boolean(options.useDebugSignatures));
+            const destDataMap = (0, helpers_1.buildItemDataMap)(destData.items);
+            (0, commands_1.enrichCreateCommands)(commands, sourceDataMap);
+            (0, commands_1.enrichUpdateCommands)(commands, sourceDataMap, destDataMap, true);
+            const processedIds = await (0, helpers_1.applySitecoreCommands)(root, envName, database, commands, logger, options.whatIf);
+            if (options.publish && processedIds.length > 0 && !options.whatIf) {
+                const targets = options.targets && options.targets.length > 0 ? options.targets : [undefined];
+                for (const target of targets) {
+                    await (0, sitecore_api_1.publishItems)(root.environments[envName], processedIds, target, {
+                        timeoutMs: apiTimeoutMs,
+                    });
+                }
+                summaryEntry.published = true;
+                summary.publishedCount += processedIds.length;
+                if (!logger.isJson()) {
+                    logger.info("Publishing is finished.", "green");
+                }
+            }
+            spinner?.succeed();
+            summary.databases.push(summaryEntry);
+        }
+        catch (error) {
+            spinner?.fail();
+            throw error;
+        }
+    }
+    for (const module of modules) {
+        await (0, roles_1.syncRolesPush)(root, module, envName, logger);
+        await (0, users_1.syncUsersPush)(root, module, envName, logger);
+    }
+    if (logger.isJson()) {
+        logger.json(summary);
+    }
+};
+exports.runPush = runPush;

package/dist/serialization/tasks/roles.d.ts

@@ -0,0 +1,6 @@
+import { readRootConfiguration, SerializationModuleConfiguration } from "../../config";
+import { Logger } from "../../shared/logger";
+export declare const rolesEqual: (left: string[], right: string[]) => boolean;
+export declare const syncRolesPull: (root: ReturnType<typeof readRootConfiguration>, module: SerializationModuleConfiguration, environmentName: string, logger: Logger) => Promise<void>;
+export declare const syncRolesPush: (root: ReturnType<typeof readRootConfiguration>, module: SerializationModuleConfiguration, environmentName: string, logger: Logger) => Promise<void>;
+//# sourceMappingURL=roles.d.ts.map

package/dist/serialization/tasks/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../../src/serialization/tasks/roles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAYzC,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,EAAE,OAAO,MAAM,EAAE,KAAG,OAO5D,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,UAAU,CAAC,OAAO,qBAAqB,CAAC,EAC9C,QAAQ,gCAAgC,EACxC,iBAAiB,MAAM,EACvB,QAAQ,MAAM,KACb,OAAO,CAAC,IAAI,CA6Bd,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,UAAU,CAAC,OAAO,qBAAqB,CAAC,EAC9C,QAAQ,gCAAgC,EACxC,iBAAiB,MAAM,EACvB,QAAQ,MAAM,KACb,OAAO,CAAC,IAAI,CAsEd,CAAC"}

package/dist/serialization/tasks/roles.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncRolesPush = exports.syncRolesPull = exports.rolesEqual = void 0;
+const sitecore_api_1 = require("../sitecore-api");
+const filesystem_store_1 = require("../filesystem-store");
+const shared_1 = require("./shared");
+const normalizeRoleMembers = (roles) => [...roles].map((role) => role.toLowerCase()).sort();
+const rolesEqual = (left, right) => {
+    const leftSorted = normalizeRoleMembers(left);
+    const rightSorted = normalizeRoleMembers(right);
+    if (leftSorted.length !== rightSorted.length) {
+        return false;
+    }
+    return leftSorted.every((role, idx) => role === rightSorted[idx]);
+};
+exports.rolesEqual = rolesEqual;
+const syncRolesPull = async (root, module, environmentName, logger) => {
+    if (module.roles.length === 0) {
+        return;
+    }
+    const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
+    const predicates = module.roles.map((role) => ({ domain: role.domain, pattern: role.pattern }));
+    const sourceRoles = await (0, sitecore_api_1.fetchRoles)(root.environments[environmentName], predicates, {
+        timeoutMs: apiTimeoutMs,
+    });
+    const destRoles = await (0, filesystem_store_1.readRolesFromFilesystem)(root, module);
+    const destMap = new Map(destRoles.map((role) => [role.roleName.toLowerCase(), role]));
+    for (const role of sourceRoles) {
+        const existing = destMap.get(role.roleName.toLowerCase());
+        if (!existing || !(0, exports.rolesEqual)(existing.memberOfRoles, role.memberOfRoles)) {
+            await (0, filesystem_store_1.writeRoleToFilesystem)(root, module, role);
+        }
+    }
+    if (root.serialization.removeOrphansForRoles) {
+        const sourceNames = new Set(sourceRoles.map((role) => role.roleName.toLowerCase()));
+        for (const dest of destRoles) {
+            if (!sourceNames.has(dest.roleName.toLowerCase())) {
+                await (0, filesystem_store_1.removeRoleFromFilesystem)(dest.serializedItemId);
+            }
+        }
+    }
+    logger.info(`[roles] Synced ${sourceRoles.length} roles`, "green");
+};
+exports.syncRolesPull = syncRolesPull;
+const syncRolesPush = async (root, module, environmentName, logger) => {
+    if (module.roles.length === 0) {
+        return;
+    }
+    const apiTimeoutMs = (0, shared_1.resolveApiTimeoutMs)(root);
+    const predicates = module.roles.map((role) => ({ domain: role.domain, pattern: role.pattern }));
+    const sourceRoles = await (0, filesystem_store_1.readRolesFromFilesystem)(root, module);
+    const destinationRoles = await (0, sitecore_api_1.fetchRoles)(root.environments[environmentName], predicates, {
+        timeoutMs: apiTimeoutMs,
+    });
+    const destMap = new Map(destinationRoles.map((role) => [role.roleName.toLowerCase(), role]));
+    const commands = [];
+    for (const role of sourceRoles) {
+        const dest = destMap.get(role.roleName.toLowerCase());
+        if (!dest) {
+            commands.push({
+                roleData: { roleName: role.roleName, memberOfRoles: [] },
+                roleCommandType: "ADD",
+            });
+        }
+        const destMembers = dest?.memberOfRoles ?? [];
+        for (const member of role.memberOfRoles) {
+            if (!destMembers.some((existing) => existing.toLowerCase() === member.toLowerCase())) {
+                commands.push({
+                    roleData: { roleName: role.roleName, memberOfRoles: [] },
+                    parentRoleData: { roleName: member },
+                    roleCommandType: "ASSIGN",
+                });
+            }
+        }
+        for (const member of destMembers) {
+            if (!role.memberOfRoles.some((existing) => existing.toLowerCase() === member.toLowerCase())) {
+                commands.push({
+                    roleData: { roleName: role.roleName, memberOfRoles: [] },
+                    parentRoleData: { roleName: member },
+                    roleCommandType: "UNASSIGN",
+                });
+            }
+        }
+    }
+    if (root.serialization.removeOrphansForRoles) {
+        const sourceNames = new Set(sourceRoles.map((role) => role.roleName.toLowerCase()));
+        for (const role of destinationRoles) {
+            if (!sourceNames.has(role.roleName.toLowerCase())) {
+                commands.push({
+                    roleData: { roleName: role.roleName, memberOfRoles: [] },
+                    roleCommandType: "REMOVE",
+                });
+            }
+        }
+    }
+    if (commands.length > 0) {
+        await (0, sitecore_api_1.pushRoleCommands)(root.environments[environmentName], commands, {
+            timeoutMs: apiTimeoutMs,
+        });
+    }
+    logger.info(`[roles] Synced ${commands.length} role changes`, "green");
+};
+exports.syncRolesPush = syncRolesPush;

package/dist/serialization/tasks/shared.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Helpers specific to `scai serialization` task runners — config and
+ * module loading, subtree grouping by database, allowWrite check.
+ * Neutral helpers (`toLogger`, `selectMatch`, `confirmDestructive`,
+ * etc.) live in `@/shared/cli-tasks`; deploy-specific helpers
+ * (`getDeployContext`, `extractDeployEnvironmentList`, etc.) live in
+ * `@/deploy/tasks/shared`.
+ */
+import { RootConfiguration, SerializationModuleConfiguration } from "../../config";
+import { FilesystemTreeSpec } from "../tree-spec";
+import type { CommonOptions } from "./types";
+export { toLogger, applyIfDefined, inputError, confirmDestructive, selectMatch, selectFromList, resolveApiTimeoutMs, } from "../../shared/cli-tasks";
+export declare const loadConfigAndModules: (options: CommonOptions) => Promise<{
+    root: RootConfiguration;
+    modules: SerializationModuleConfiguration[];
+}>;
+export declare const groupSubtreesByDatabase: (modules: SerializationModuleConfiguration[]) => Map<string, FilesystemTreeSpec[]>;
+export declare const ensureAllowWrite: (root: RootConfiguration, environmentName: string) => void;
+//# sourceMappingURL=shared.d.ts.map

package/dist/serialization/tasks/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/serialization/tasks/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,iBAAiB,EACjB,gCAAgC,EACjC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,oBAAoB,GAC/B,SAAS,aAAa,KACrB,OAAO,CAAC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,gCAAgC,EAAE,CAAA;CAAE,CAQlF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,SAAS,gCAAgC,EAAE,KAC1C,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAWlC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,iBAAiB,EAAE,iBAAiB,MAAM,KAAG,IAgBnF,CAAC"}

package/dist/serialization/tasks/shared.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Helpers specific to `scai serialization` task runners — config and
+ * module loading, subtree grouping by database, allowWrite check.
+ * Neutral helpers (`toLogger`, `selectMatch`, `confirmDestructive`,
+ * etc.) live in `@/shared/cli-tasks`; deploy-specific helpers
+ * (`getDeployContext`, `extractDeployEnvironmentList`, etc.) live in
+ * `@/deploy/tasks/shared`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureAllowWrite = exports.groupSubtreesByDatabase = exports.loadConfigAndModules = exports.resolveApiTimeoutMs = exports.selectFromList = exports.selectMatch = exports.confirmDestructive = exports.inputError = exports.applyIfDefined = exports.toLogger = void 0;
+const config_1 = require("../../config");
+const errors_1 = require("../../shared/errors");
+// Re-exports preserve the existing barrel surface; new code should
+// import these directly from `@/shared/cli-tasks`.
+var cli_tasks_1 = require("../../shared/cli-tasks");
+Object.defineProperty(exports, "toLogger", { enumerable: true, get: function () { return cli_tasks_1.toLogger; } });
+Object.defineProperty(exports, "applyIfDefined", { enumerable: true, get: function () { return cli_tasks_1.applyIfDefined; } });
+Object.defineProperty(exports, "inputError", { enumerable: true, get: function () { return cli_tasks_1.inputError; } });
+Object.defineProperty(exports, "confirmDestructive", { enumerable: true, get: function () { return cli_tasks_1.confirmDestructive; } });
+Object.defineProperty(exports, "selectMatch", { enumerable: true, get: function () { return cli_tasks_1.selectMatch; } });
+Object.defineProperty(exports, "selectFromList", { enumerable: true, get: function () { return cli_tasks_1.selectFromList; } });
+Object.defineProperty(exports, "resolveApiTimeoutMs", { enumerable: true, get: function () { return cli_tasks_1.resolveApiTimeoutMs; } });
+const loadConfigAndModules = async (options) => {
+    const configPath = options.config ?? process.cwd();
+    const rootFile = (0, config_1.readRootConfigurationFile)(configPath);
+    const envName = options.environmentName ?? rootFile.config.defaultEnvProfile;
+    const root = (0, config_1.readRootConfiguration)(configPath, envName);
+    const modules = await (0, config_1.readSerializationModules)(root, options.include, options.exclude);
+    return { root, modules };
+};
+exports.loadConfigAndModules = loadConfigAndModules;
+const groupSubtreesByDatabase = (modules) => {
+    const map = new Map();
+    for (const module of modules) {
+        for (const subtree of module.items.includes) {
+            if (!map.has(subtree.database)) {
+                map.set(subtree.database, []);
+            }
+            map.get(subtree.database).push(subtree);
+        }
+    }
+    return map;
+};
+exports.groupSubtreesByDatabase = groupSubtreesByDatabase;
+const ensureAllowWrite = (root, environmentName) => {
+    const env = root.environments[environmentName];
+    if (!env?.allowWrite) {
+        const envKey = environmentName
+            .trim()
+            .toUpperCase()
+            .replace(/[^A-Z0-9]+/g, "_")
+            .replace(/^_+|_+$/g, "");
+        throw (0, errors_1.createCliError)(`Environment ${environmentName} is not configured to allow writing data.`, "INPUT_INVALID", {
+            hint: `Set allowWrite in sitecoreai.cli.json, set SITECOREAI_ENV_${envKey}_ALLOW_WRITE=true, or pass --allow-write.`,
+        });
+    }
+};
+exports.ensureAllowWrite = ensureAllowWrite;

package/dist/serialization/tasks/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Option types for `scai serialization` task runners (and the
+ * env-management tasks that share the serialization namespace —
+ * `init`, `login`, `logout`, etc.). Deploy-specific option types
+ * (`Deploy*Options`) live in `@/deploy/tasks/types`.
+ */
+export { CommonOptions } from "../../shared/cli-options";
+import type { CommonOptions } from "../../shared/cli-options";
+export type LogoutOptions = CommonOptions & {
+    environmentName?: string;
+    all?: boolean;
+};
+export type SyncOptions = CommonOptions & {
+    environmentName?: string;
+    whatIf?: boolean;
+    force?: boolean;
+    skipValidation?: boolean;
+    allowWrite?: boolean;
+    publish?: boolean;
+    targets?: string[];
+    useDebugSignatures?: boolean;
+};
+export type DiffOptions = CommonOptions & {
+    source: string;
+    destination: string;
+    push?: boolean;
+    path?: string;
+    sourceDatabase?: string;
+    destinationDatabase?: string;
+};
+export type ExplainOptions = CommonOptions & {
+    path: string;
+    database: string;
+};
+export type WatchOptions = CommonOptions & {
+    environmentName?: string;
+    skipPull?: boolean;
+    allowFileChanges?: boolean;
+};
+export type PackageCreateOptions = CommonOptions & {
+    output: string;
+    overwrite?: boolean;
+};
+export type PackageInstallOptions = CommonOptions & {
+    package: string;
+    environmentName?: string;
+    whatIf?: boolean;
+    publish?: boolean;
+    authority?: string;
+    cm?: string;
+    clientId?: string;
+    clientSecret?: string;
+};
+export type ConnectOptions = CommonOptions & {
+    environmentName?: string;
+    cm?: string;
+    host?: string;
+    ref?: string;
+    allowWrite?: boolean;
+    skipDeployLookup?: boolean;
+    organizationId?: string;
+    tenantId?: string;
+    organization?: string;
+    project?: string;
+    environment?: string;
+    deployToken?: string;
+    clientId?: string;
+    clientSecret?: string;
+    useClientCredentials?: boolean;
+    setDefault?: boolean;
+    wizard?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/serialization/tasks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/serialization/tasks/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/dist/serialization/tasks/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Option types for `scai serialization` task runners (and the
+ * env-management tasks that share the serialization namespace —
+ * `init`, `login`, `logout`, etc.). Deploy-specific option types
+ * (`Deploy*Options`) live in `@/deploy/tasks/types`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });