@sitecore-jss/sitecore-jss-dev-tools 22.5.0-beta.1 → 22.5.0-beta.10

package/dist/cjs/auth/fetch-bearer-token.js

@@ -0,0 +1,50 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchBearerToken = exports.DEFAULT_SITECORE_AUTH_AUDIENCE = exports.DEFAULT_SITECORE_AUTH_ENDPOINT = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+exports.DEFAULT_SITECORE_AUTH_ENDPOINT = 'https://auth.sitecorecloud.io/oauth/token';
+exports.DEFAULT_SITECORE_AUTH_AUDIENCE = 'https://api.sitecorecloud.io';
+/**
+ * Connects to M2M endpoint and fetches the bearer token
+ * Uses client_id and client_secret from environment variables
+ * @returns {string} bearer token string
+ */
+const fetchBearerToken = () => __awaiter(void 0, void 0, void 0, function* () {
+    const audience = process.env.SITECORE_AUTH_AUDIENCE || exports.DEFAULT_SITECORE_AUTH_AUDIENCE;
+    const m2mEndpoint = process.env.SITECORE_AUTH_ENDPOINT || exports.DEFAULT_SITECORE_AUTH_ENDPOINT;
+    try {
+        // TODO:adjust when M2M endpoint is live
+        const authenticateResponse = yield fetch(m2mEndpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                client_id: process.env.SITECORE_AUTH_CLIENT_ID,
+                client_secret: process.env.SITECORE_AUTH_CLIENT_SECRET,
+                audience: audience,
+                grant_type: 'client_credentials',
+            }),
+        });
+        const jsonResponse = yield authenticateResponse.json();
+        return jsonResponse.access_token;
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('Error authenticating with Sitecore Auth endpoint:', error));
+        console.log(chalk_1.default.yellow('Please ensure your SITECORE_AUTH_CLIENT_ID and SITECORE_AUTH_CLIENT_SECRET environment variables are set correctly.'));
+        return null;
+    }
+});
+exports.fetchBearerToken = fetchBearerToken;

package/dist/cjs/codegen/extract-components.js

@@ -0,0 +1,68 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractComponents = extractComponents;
+const utils_1 = require("./utils");
+const fetch_bearer_token_1 = require("../auth/fetch-bearer-token");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Handler for the extract-component API command
+ * Reads imports from the componentBuilder.ts file and posts the code to the mesh endpoint
+ * @param {ExtractComponentOptions} [args] - The options for code extraction
+ * @returns {Promise<void>} void
+ */
+function extractComponents() {
+    return __awaiter(this, arguments, void 0, function* (args = {}) {
+        if (!validateDeployContext()) {
+            console.log(chalk_1.default.yellow('Skipping code extraction, not in deploy context'));
+            return;
+        }
+        // TODO: add alternative consent procedure when refining later
+        if (!process.env.EXTRACT_CONSENT) {
+            console.log(chalk_1.default.yellow('Skipping code extraction, EXTRACT_CONSENT is not set'));
+            return;
+        }
+        const basePath = process.cwd();
+        try {
+            const bearer = yield (0, fetch_bearer_token_1.fetchBearerToken)();
+            if (!bearer) {
+                console.error(chalk_1.default.red('Failed to get bearer token, aborting code extraction'));
+                return;
+            }
+            const componentPaths = yield (0, utils_1.resolveComponentImportFiles)(basePath, args.componentBuilderPath);
+            const codeDispatches = Array.from(componentPaths, (mapEntry) => (0, utils_1.sendCode)({
+                name: mapEntry[0],
+                path: mapEntry[1],
+                type: utils_1.ExtractedFileType.Component,
+            }, bearer));
+            yield Promise.all(codeDispatches);
+        }
+        catch (error) {
+            console.error(chalk_1.default.red('Error during component extraction:', error));
+        }
+    });
+}
+const validateDeployContext = () => {
+    if (process.env.NETLIFY && process.env.BUILD_ID) {
+        return true;
+    }
+    // workaround, Vercel does not have variables that are only accessible at build time
+    if (process.env.VERCEL && !process.env.VERCEL_REGION) {
+        return true;
+    }
+    if (process.env.SITECORE && process.env.BuildMetadata_BuildId) {
+        return true;
+    }
+    return false;
+};

package/dist/cjs/codegen/utils.js

@@ -0,0 +1,175 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendCode = exports.resolveComponentImportFiles = exports.ExtractedFileType = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const ts = __importStar(require("typescript"));
+const sitecore_jss_1 = require("@sitecore-jss/sitecore-jss");
+// TODO:adjust when mesh endpoint is live
+const meshEndpoint = `${process.env.SITECORE_EDGE_URL ||
+    sitecore_jss_1.constants.SITECORE_EDGE_URL_DEFAULT}/api/v1/mesh`;
+/**
+ * Type of file to be sent to the mesh endpoint
+ */
+var ExtractedFileType;
+(function (ExtractedFileType) {
+    ExtractedFileType["Component"] = "component";
+    ExtractedFileType["Json"] = "json";
+    ExtractedFileType["Package"] = "package.json";
+})(ExtractedFileType || (exports.ExtractedFileType = ExtractedFileType = {}));
+/**
+ * Parses the componentBuilder.ts file and returns a map of component names
+ * and their respective import strings
+ * @param {string} appPath path to the JSS app root
+ * @param {string} componentBuilderPath path to the app's component builder file. Default: 'src/temp/componentBuilder.ts'
+ * @returns map of component names and their respective import strings
+ */
+const resolveComponentImportFiles = (appPath, componentBuilderPath = './src/temp/componentBuilder.ts') => {
+    appPath = path_1.default.isAbsolute(appPath) ? appPath : path_1.default.resolve(process.cwd(), appPath);
+    const tsConfig = ts.readConfigFile(path_1.default.resolve(appPath, 'tsconfig.json'), ts.sys.readFile);
+    if (tsConfig.error) {
+        throw new Error(`Error reading tsconfig.json from JSS app root: ${tsConfig.error.messageText}`);
+    }
+    const tsOptions = Object.assign(Object.assign({}, tsConfig.config.compilerOptions), { baseUrl: appPath });
+    const componentBuilderFullPath = path_1.default.isAbsolute(componentBuilderPath)
+        ? componentBuilderPath
+        : path_1.default.resolve(appPath, componentBuilderPath);
+    // compiler host to process the componentBuilder.ts file and component sources
+    const tsHost = ts.createCompilerHost(tsOptions, true);
+    const builderSourceFile = tsHost.getSourceFile(componentBuilderFullPath, ts.ScriptTarget.Latest, (msg) => {
+        throw new Error(`Failed to parse ${componentBuilderFullPath}: ${msg}`);
+    });
+    if (!builderSourceFile)
+        throw ReferenceError(`Failed to find file ${componentBuilderFullPath}`);
+    // this map matches all raw import strings (i.e. * as component) to import strings
+    const importStringsMap = {};
+    // this map will match component names only to full resolved source file paths
+    const componentImportsMap = new Map();
+    // name of the export from componentBuilder.ts
+    let mapExportName = '';
+    // all map.set() assignments in file
+    const mapAssignments = [];
+    // step 1: get all import statements and map assignments (map.set) from componentBuilder file
+    ts.forEachChild(builderSourceFile, (childNode) => {
+        var _a;
+        // first, all import statements are parsed
+        if (ts.isImportDeclaration(childNode) && childNode.importClause) {
+            // import path is extracted
+            const moduleName = childNode.moduleSpecifier.getText().replace(/['"]/g, '');
+            // unless the import is a nodeJS one, or points to dependency package, resolve full path to the imported source file
+            if (moduleName.startsWith('node:') || moduleName.indexOf('/node_modules') > -1) {
+                return;
+            }
+            const resolvedModule = ts.nodeModuleNameResolver(moduleName, componentBuilderFullPath, tsOptions, tsHost);
+            const resolvedFile = (_a = resolvedModule === null || resolvedModule === void 0 ? void 0 : resolvedModule.resolvedModule) === null || _a === void 0 ? void 0 : _a.resolvedFileName;
+            // module imports paths will be resolved to /node_modules location - we don't support that yet
+            if (resolvedFile && resolvedFile.indexOf('node_modules') === -1) {
+                importStringsMap[childNode.importClause.getText()] = path_1.default.resolve(resolvedFile);
+            }
+        }
+        else if (ts.isExpressionStatement(childNode)) {
+            // parse map assignments (map.set(..)) to get registered components
+            ts.forEachChild(childNode, (expressionNode) => {
+                if (ts.isCallExpression(expressionNode) &&
+                    expressionNode.expression.getText().indexOf('set') !== -1) {
+                    // get map.set assignments
+                    mapAssignments.push(expressionNode);
+                }
+            });
+        }
+        else if (ts.isExportAssignment(childNode)) {
+            // get component map export variable
+            // In case there are multiple assignment statements a file, we need to only pick ones that related to exported map
+            mapExportName = childNode.expression.getText();
+        }
+    });
+    // step 2: parse mapAssignments and retrieve import paths
+    // only for components registered into component map
+    for (const mapAssignment of mapAssignments) {
+        // only consider the map variable that is exported
+        if (mapAssignment.getText().startsWith(mapExportName)) {
+            const componentKey = mapAssignment.arguments[1].getText();
+            const componentImport = Object.keys(importStringsMap).find((importStatement) => {
+                const matcher = new RegExp(`\\b(${componentKey})\\b`);
+                return importStatement.match(matcher) !== null;
+            });
+            if (componentImport) {
+                const componentValue = importStringsMap[componentImport];
+                componentImportsMap.set(componentKey, componentValue);
+            }
+        }
+    }
+    return componentImportsMap;
+};
+exports.resolveComponentImportFiles = resolveComponentImportFiles;
+/**
+ * Sends extracted component code to mesh endpoint
+ * @param {ExcractedFile} file properties of the file to be sent
+ * @param {string} token bearer token for authentication into mesh endpoint
+ */
+const sendCode = (file, token) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!fs_1.default.existsSync(file.path)) {
+        console.error(chalk_1.default.red(`File planned for code extraction not found: ${file.path}`));
+        return;
+    }
+    const code = fs_1.default.readFileSync(file.path);
+    const response = yield fetch(meshEndpoint, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            name: file.name,
+            content: code.toString(),
+            labels: {
+                properties: {
+                    type: file.type,
+                },
+            },
+        }),
+    });
+    if (!response.ok) {
+        console.error(chalk_1.default.red(`Failed to send extracted code from ${file.path}: ${response.statusText}`));
+    }
+    else {
+        console.log(chalk_1.default.green(`Code from ${file.path} extracted and sent to mesh endpoint`));
+    }
+});
+exports.sendCode = sendCode;

package/dist/cjs/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveScJssConfig = exports.createDefaultDisconnectedServer = exports.createDefaultDocumentMiddleware = exports.createDisconnectedDictionaryService = exports.createDisconnectedLayoutService = exports.createDisconnectedAssetMiddleware = exports.packageGenerate = exports.packageDeploy = exports.clean = exports.deploy = exports.mergeFs = exports.verifySetup = exports.userConfigPath = exports.setup = exports.replaceConfigTokens = void 0;
+exports.extractComponents = exports.fetchBearerToken = exports.constants = exports.resolveScJssConfig = exports.createDefaultDisconnectedServer = exports.createDefaultDocumentMiddleware = exports.createDisconnectedDictionaryService = exports.createDisconnectedLayoutService = exports.createDisconnectedAssetMiddleware = exports.packageGenerate = exports.packageDeploy = exports.clean = exports.deploy = exports.mergeFs = exports.verifySetup = exports.userConfigPath = exports.setup = exports.replaceConfigTokens = void 0;
 var jss_config_1 = require("./setup/jss-config");
 Object.defineProperty(exports, "replaceConfigTokens", { enumerable: true, get: function () { return jss_config_1.replaceConfigTokens; } });
 var setup_1 = require("./setup/setup");
@@ -44,6 +44,12 @@ var create_default_disconnected_server_1 = require("./disconnected-server/create
 Object.defineProperty(exports, "createDefaultDisconnectedServer", { enumerable: true, get: function () { return create_default_disconnected_server_1.createDefaultDisconnectedServer; } });
 var resolve_scjssconfig_1 = require("./resolve-scjssconfig");
 Object.defineProperty(exports, "resolveScJssConfig", { enumerable: true, get: function () { return resolve_scjssconfig_1.resolveScJssConfig; } });
+var sitecore_jss_1 = require("@sitecore-jss/sitecore-jss");
+Object.defineProperty(exports, "constants", { enumerable: true, get: function () { return sitecore_jss_1.constants; } });
+var fetch_bearer_token_1 = require("./auth/fetch-bearer-token");
+Object.defineProperty(exports, "fetchBearerToken", { enumerable: true, get: function () { return fetch_bearer_token_1.fetchBearerToken; } });
+var extract_components_1 = require("./codegen/extract-components");
+Object.defineProperty(exports, "extractComponents", { enumerable: true, get: function () { return extract_components_1.extractComponents; } });
 __exportStar(require("./templating"), exports);
 __exportStar(require("./manifest"), exports);
 __exportStar(require("./pipelines"), exports);

package/dist/esm/auth/fetch-bearer-token.js

@@ -0,0 +1,43 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import chalk from 'chalk';
+export const DEFAULT_SITECORE_AUTH_ENDPOINT = 'https://auth.sitecorecloud.io/oauth/token';
+export const DEFAULT_SITECORE_AUTH_AUDIENCE = 'https://api.sitecorecloud.io';
+/**
+ * Connects to M2M endpoint and fetches the bearer token
+ * Uses client_id and client_secret from environment variables
+ * @returns {string} bearer token string
+ */
+export const fetchBearerToken = () => __awaiter(void 0, void 0, void 0, function* () {
+    const audience = process.env.SITECORE_AUTH_AUDIENCE || DEFAULT_SITECORE_AUTH_AUDIENCE;
+    const m2mEndpoint = process.env.SITECORE_AUTH_ENDPOINT || DEFAULT_SITECORE_AUTH_ENDPOINT;
+    try {
+        // TODO:adjust when M2M endpoint is live
+        const authenticateResponse = yield fetch(m2mEndpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                client_id: process.env.SITECORE_AUTH_CLIENT_ID,
+                client_secret: process.env.SITECORE_AUTH_CLIENT_SECRET,
+                audience: audience,
+                grant_type: 'client_credentials',
+            }),
+        });
+        const jsonResponse = yield authenticateResponse.json();
+        return jsonResponse.access_token;
+    }
+    catch (error) {
+        console.error(chalk.red('Error authenticating with Sitecore Auth endpoint:', error));
+        console.log(chalk.yellow('Please ensure your SITECORE_AUTH_CLIENT_ID and SITECORE_AUTH_CLIENT_SECRET environment variables are set correctly.'));
+        return null;
+    }
+});

package/dist/esm/codegen/extract-components.js

@@ -0,0 +1,62 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { ExtractedFileType, resolveComponentImportFiles, sendCode } from './utils';
+import { fetchBearerToken } from '../auth/fetch-bearer-token';
+import chalk from 'chalk';
+/**
+ * Handler for the extract-component API command
+ * Reads imports from the componentBuilder.ts file and posts the code to the mesh endpoint
+ * @param {ExtractComponentOptions} [args] - The options for code extraction
+ * @returns {Promise<void>} void
+ */
+export function extractComponents() {
+    return __awaiter(this, arguments, void 0, function* (args = {}) {
+        if (!validateDeployContext()) {
+            console.log(chalk.yellow('Skipping code extraction, not in deploy context'));
+            return;
+        }
+        // TODO: add alternative consent procedure when refining later
+        if (!process.env.EXTRACT_CONSENT) {
+            console.log(chalk.yellow('Skipping code extraction, EXTRACT_CONSENT is not set'));
+            return;
+        }
+        const basePath = process.cwd();
+        try {
+            const bearer = yield fetchBearerToken();
+            if (!bearer) {
+                console.error(chalk.red('Failed to get bearer token, aborting code extraction'));
+                return;
+            }
+            const componentPaths = yield resolveComponentImportFiles(basePath, args.componentBuilderPath);
+            const codeDispatches = Array.from(componentPaths, (mapEntry) => sendCode({
+                name: mapEntry[0],
+                path: mapEntry[1],
+                type: ExtractedFileType.Component,
+            }, bearer));
+            yield Promise.all(codeDispatches);
+        }
+        catch (error) {
+            console.error(chalk.red('Error during component extraction:', error));
+        }
+    });
+}
+const validateDeployContext = () => {
+    if (process.env.NETLIFY && process.env.BUILD_ID) {
+        return true;
+    }
+    // workaround, Vercel does not have variables that are only accessible at build time
+    if (process.env.VERCEL && !process.env.VERCEL_REGION) {
+        return true;
+    }
+    if (process.env.SITECORE && process.env.BuildMetadata_BuildId) {
+        return true;
+    }
+    return false;
+};

package/dist/esm/codegen/utils.js

@@ -0,0 +1,144 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import chalk from 'chalk';
+import path from 'path';
+import fs from 'fs';
+import * as ts from 'typescript';
+import { constants } from '@sitecore-jss/sitecore-jss';
+// TODO:adjust when mesh endpoint is live
+const meshEndpoint = `${process.env.SITECORE_EDGE_URL ||
+    constants.SITECORE_EDGE_URL_DEFAULT}/api/v1/mesh`;
+/**
+ * Type of file to be sent to the mesh endpoint
+ */
+export var ExtractedFileType;
+(function (ExtractedFileType) {
+    ExtractedFileType["Component"] = "component";
+    ExtractedFileType["Json"] = "json";
+    ExtractedFileType["Package"] = "package.json";
+})(ExtractedFileType || (ExtractedFileType = {}));
+/**
+ * Parses the componentBuilder.ts file and returns a map of component names
+ * and their respective import strings
+ * @param {string} appPath path to the JSS app root
+ * @param {string} componentBuilderPath path to the app's component builder file. Default: 'src/temp/componentBuilder.ts'
+ * @returns map of component names and their respective import strings
+ */
+export const resolveComponentImportFiles = (appPath, componentBuilderPath = './src/temp/componentBuilder.ts') => {
+    appPath = path.isAbsolute(appPath) ? appPath : path.resolve(process.cwd(), appPath);
+    const tsConfig = ts.readConfigFile(path.resolve(appPath, 'tsconfig.json'), ts.sys.readFile);
+    if (tsConfig.error) {
+        throw new Error(`Error reading tsconfig.json from JSS app root: ${tsConfig.error.messageText}`);
+    }
+    const tsOptions = Object.assign(Object.assign({}, tsConfig.config.compilerOptions), { baseUrl: appPath });
+    const componentBuilderFullPath = path.isAbsolute(componentBuilderPath)
+        ? componentBuilderPath
+        : path.resolve(appPath, componentBuilderPath);
+    // compiler host to process the componentBuilder.ts file and component sources
+    const tsHost = ts.createCompilerHost(tsOptions, true);
+    const builderSourceFile = tsHost.getSourceFile(componentBuilderFullPath, ts.ScriptTarget.Latest, (msg) => {
+        throw new Error(`Failed to parse ${componentBuilderFullPath}: ${msg}`);
+    });
+    if (!builderSourceFile)
+        throw ReferenceError(`Failed to find file ${componentBuilderFullPath}`);
+    // this map matches all raw import strings (i.e. * as component) to import strings
+    const importStringsMap = {};
+    // this map will match component names only to full resolved source file paths
+    const componentImportsMap = new Map();
+    // name of the export from componentBuilder.ts
+    let mapExportName = '';
+    // all map.set() assignments in file
+    const mapAssignments = [];
+    // step 1: get all import statements and map assignments (map.set) from componentBuilder file
+    ts.forEachChild(builderSourceFile, (childNode) => {
+        var _a;
+        // first, all import statements are parsed
+        if (ts.isImportDeclaration(childNode) && childNode.importClause) {
+            // import path is extracted
+            const moduleName = childNode.moduleSpecifier.getText().replace(/['"]/g, '');
+            // unless the import is a nodeJS one, or points to dependency package, resolve full path to the imported source file
+            if (moduleName.startsWith('node:') || moduleName.indexOf('/node_modules') > -1) {
+                return;
+            }
+            const resolvedModule = ts.nodeModuleNameResolver(moduleName, componentBuilderFullPath, tsOptions, tsHost);
+            const resolvedFile = (_a = resolvedModule === null || resolvedModule === void 0 ? void 0 : resolvedModule.resolvedModule) === null || _a === void 0 ? void 0 : _a.resolvedFileName;
+            // module imports paths will be resolved to /node_modules location - we don't support that yet
+            if (resolvedFile && resolvedFile.indexOf('node_modules') === -1) {
+                importStringsMap[childNode.importClause.getText()] = path.resolve(resolvedFile);
+            }
+        }
+        else if (ts.isExpressionStatement(childNode)) {
+            // parse map assignments (map.set(..)) to get registered components
+            ts.forEachChild(childNode, (expressionNode) => {
+                if (ts.isCallExpression(expressionNode) &&
+                    expressionNode.expression.getText().indexOf('set') !== -1) {
+                    // get map.set assignments
+                    mapAssignments.push(expressionNode);
+                }
+            });
+        }
+        else if (ts.isExportAssignment(childNode)) {
+            // get component map export variable
+            // In case there are multiple assignment statements a file, we need to only pick ones that related to exported map
+            mapExportName = childNode.expression.getText();
+        }
+    });
+    // step 2: parse mapAssignments and retrieve import paths
+    // only for components registered into component map
+    for (const mapAssignment of mapAssignments) {
+        // only consider the map variable that is exported
+        if (mapAssignment.getText().startsWith(mapExportName)) {
+            const componentKey = mapAssignment.arguments[1].getText();
+            const componentImport = Object.keys(importStringsMap).find((importStatement) => {
+                const matcher = new RegExp(`\\b(${componentKey})\\b`);
+                return importStatement.match(matcher) !== null;
+            });
+            if (componentImport) {
+                const componentValue = importStringsMap[componentImport];
+                componentImportsMap.set(componentKey, componentValue);
+            }
+        }
+    }
+    return componentImportsMap;
+};
+/**
+ * Sends extracted component code to mesh endpoint
+ * @param {ExcractedFile} file properties of the file to be sent
+ * @param {string} token bearer token for authentication into mesh endpoint
+ */
+export const sendCode = (file, token) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!fs.existsSync(file.path)) {
+        console.error(chalk.red(`File planned for code extraction not found: ${file.path}`));
+        return;
+    }
+    const code = fs.readFileSync(file.path);
+    const response = yield fetch(meshEndpoint, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            name: file.name,
+            content: code.toString(),
+            labels: {
+                properties: {
+                    type: file.type,
+                },
+            },
+        }),
+    });
+    if (!response.ok) {
+        console.error(chalk.red(`Failed to send extracted code from ${file.path}: ${response.statusText}`));
+    }
+    else {
+        console.log(chalk.green(`Code from ${file.path} extracted and sent to mesh endpoint`));
+    }
+});

package/dist/esm/index.js

@@ -12,6 +12,9 @@ export { createDisconnectedDictionaryService, } from './disconnected-server/dict
 export { createDefaultDocumentMiddleware, } from './disconnected-server/default-document';
 export { createDefaultDisconnectedServer, } from './disconnected-server/create-default-disconnected-server';
 export { resolveScJssConfig } from './resolve-scjssconfig';
+export { constants } from '@sitecore-jss/sitecore-jss';
+export { fetchBearerToken } from './auth/fetch-bearer-token';
+export { extractComponents } from './codegen/extract-components';
 export * from './templating';
 export * from './manifest';
 export * from './pipelines';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sitecore-jss/sitecore-jss-dev-tools",
-  "version": "22.5.0-beta.1",
+  "version": "22.5.0-beta.10",
   "description": "Utilities to assist in the development and deployment of Sitecore JSS apps.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "@babel/parser": "^7.24.0",
-    "@sitecore-jss/sitecore-jss": "^22.5.0-beta.1",
+    "@sitecore-jss/sitecore-jss": "22.5.0-beta.10",
     "chalk": "^4.1.2",
     "chokidar": "^3.6.0",
     "del": "^6.0.0",
@@ -77,7 +77,7 @@
     "del-cli": "^5.0.0",
     "eslint": "^8.56.0",
     "mocha": "^10.2.0",
-    "nock": "^13.3.0",
+    "nock": "14.0.0-beta.7",
     "nyc": "^15.1.0",
     "sinon": "^15.0.1",
     "ts-node": "^10.9.1",
@@ -85,7 +85,7 @@
     "typescript": "~5.6.3"
   },
   "types": "types/index.d.ts",
-  "gitHead": "e080916b354c36e63f29f01fbcb87688d7f2b4cd",
+  "gitHead": "5219803dfd700b1e2967c02e1b17db07f6f31b45",
   "files": [
     "dist",
     "types",

package/types/auth/fetch-bearer-token.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_SITECORE_AUTH_ENDPOINT = "https://auth.sitecorecloud.io/oauth/token";
+export declare const DEFAULT_SITECORE_AUTH_AUDIENCE = "https://api.sitecorecloud.io";
+/**
+ * Connects to M2M endpoint and fetches the bearer token
+ * Uses client_id and client_secret from environment variables
+ * @returns {string} bearer token string
+ */
+export declare const fetchBearerToken: () => Promise<any>;

package/types/codegen/extract-components.d.ts

@@ -0,0 +1,11 @@
+type ExtractComponentOptions = {
+    componentBuilderPath?: string;
+};
+/**
+ * Handler for the extract-component API command
+ * Reads imports from the componentBuilder.ts file and posts the code to the mesh endpoint
+ * @param {ExtractComponentOptions} [args] - The options for code extraction
+ * @returns {Promise<void>} void
+ */
+export declare function extractComponents(args?: ExtractComponentOptions): Promise<void>;
+export {};

package/types/codegen/utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Description properties for the files sent to the mesh endpoint
+ */
+export type ExtractedFile = {
+    name: string;
+    path: string;
+    type: ExtractedFileType;
+};
+/**
+ * Type of file to be sent to the mesh endpoint
+ */
+export declare enum ExtractedFileType {
+    Component = "component",
+    Json = "json",
+    Package = "package.json"
+}
+/**
+ * Parses the componentBuilder.ts file and returns a map of component names
+ * and their respective import strings
+ * @param {string} appPath path to the JSS app root
+ * @param {string} componentBuilderPath path to the app's component builder file. Default: 'src/temp/componentBuilder.ts'
+ * @returns map of component names and their respective import strings
+ */
+export declare const resolveComponentImportFiles: (appPath: string, componentBuilderPath?: string) => Map<string, string>;
+/**
+ * Sends extracted component code to mesh endpoint
+ * @param {ExcractedFile} file properties of the file to be sent
+ * @param {string} token bearer token for authentication into mesh endpoint
+ */
+export declare const sendCode: (file: ExtractedFile, token: string) => Promise<void>;

package/types/index.d.ts

@@ -14,6 +14,9 @@ export { createDefaultDocumentMiddleware, DefaultDocumentMiddlewareOptions, } fr
 export { createDefaultDisconnectedServer, DisconnectedServerOptions, } from './disconnected-server/create-default-disconnected-server';
 export { ScJssConfig, JssConfiguration, resolveScJssConfig } from './resolve-scjssconfig';
 export { Metadata } from '@sitecore-jss/sitecore-jss/editing';
+export { constants } from '@sitecore-jss/sitecore-jss';
+export { fetchBearerToken } from './auth/fetch-bearer-token';
+export { extractComponents } from './codegen/extract-components';
 export * from './templating';
 export * from './manifest';
 export * from './pipelines';