@contrail/flexplm 1.6.1-alpha.75cfe7f → 1.7.0-alpha.71b4d30

package/lib/cli/commands/{create.d.ts → config-file/create.d.ts}

@@ -1,5 +1,4 @@
 export declare class CreateCommand {
-    private prompt;
     private findTemplate;
     run(): Promise<void>;
 }

package/lib/cli/commands/config-file/create.js

@@ -0,0 +1,61 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateCommand = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const prompts_1 = require("../shared/prompts");
+const TEMPLATE_FILENAME = 'config-template.json.template';
+const PLACEHOLDER = '<ORG_NAME>';
+class CreateCommand {
+    findTemplate() {
+        const candidates = [
+            path.join(__dirname, '..', '..', 'template', TEMPLATE_FILENAME),
+            path.join(__dirname, '..', '..', '..', '..', 'src', 'cli', 'template', TEMPLATE_FILENAME),
+        ];
+        for (const candidate of candidates) {
+            if (fs.existsSync(candidate)) {
+                return candidate;
+            }
+        }
+        throw new Error(`Could not locate ${TEMPLATE_FILENAME}. Tried:\n  ${candidates.join('\n  ')}`);
+    }
+    async run() {
+        const orgName = (await (0, prompts_1.prompt)('orgName: ')).trim();
+        if (!orgName) {
+            throw new Error('orgName is required');
+        }
+        const templatePath = this.findTemplate();
+        const templateBody = fs.readFileSync(templatePath, 'utf8');
+        const rendered = templateBody.split(PLACEHOLDER).join(orgName);
+        const outPath = path.resolve(process.cwd(), `${orgName}-config.json`);
+        if (fs.existsSync(outPath)) {
+            throw new Error(`Refusing to overwrite existing file: ${outPath}`);
+        }
+        fs.writeFileSync(outPath, rendered, 'utf8');
+        console.log(`Created ${outPath}`);
+    }
+}
+exports.CreateCommand = CreateCommand;

package/lib/cli/commands/config-file/create.spec.js

@@ -0,0 +1,74 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+let nextAnswer = '';
+jest.mock('readline', () => ({
+    createInterface: () => ({
+        question: (_q, cb) => cb(nextAnswer),
+        close: () => { },
+    }),
+}));
+const create_1 = require("./create");
+describe('runCreate (config-file)', () => {
+    let tempDir;
+    let originalCwd;
+    let logSpy;
+    beforeEach(() => {
+        originalCwd = process.cwd();
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'flexplm-config-create-'));
+        process.chdir(tempDir);
+        logSpy = jest.spyOn(console, 'log').mockImplementation(() => { });
+        nextAnswer = '';
+    });
+    afterEach(() => {
+        logSpy.mockRestore();
+        process.chdir(originalCwd);
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('writes <orgName>-config.json with the placeholder replaced and valid JSON envelope', async () => {
+        nextAnswer = 'acme';
+        await new create_1.CreateCommand().run();
+        const outPath = path.join(tempDir, 'acme-config.json');
+        expect(fs.existsSync(outPath)).toBe(true);
+        const parsed = JSON.parse(fs.readFileSync(outPath, 'utf8'));
+        expect(parsed.orgName).toEqual('acme');
+        expect(parsed.appIdentifier).toEqual('@vibeiq/flexplm-connector');
+        expect(parsed.config).toEqual({});
+    });
+    it('throws when orgName is empty', async () => {
+        nextAnswer = '   ';
+        await expect(new create_1.CreateCommand().run()).rejects.toThrow(/orgName is required/);
+    });
+    it('refuses to overwrite an existing file', async () => {
+        const existing = path.join(tempDir, 'acme-config.json');
+        fs.writeFileSync(existing, 'do not clobber', 'utf8');
+        nextAnswer = 'acme';
+        await expect(new create_1.CreateCommand().run()).rejects.toThrow(/Refusing to overwrite/);
+        expect(fs.readFileSync(existing, 'utf8')).toEqual('do not clobber');
+    });
+});

package/lib/cli/commands/config-file/index.d.ts

@@ -0,0 +1,2 @@
+export declare const CONFIG_FILE_USAGE = "Usage: flexplm config-file <command> [args]\n\nCommands:\n  create                    Scaffold a new <orgName>-config.json file in the current directory\n  upload  <path.json> [opts] Upload the inner \"config\" payload of a config JSON file to VibeIQ\n\nUpload options:\n  -m <message>              Git commit message (prompted if omitted)\n  -b <branch>               Create a new git branch before committing\n  --skip-git                Skip the post-upload git commit (default: commit)\n  --update-config           Patch the app-org appConfig.configFile with the uploaded file ID without needing to paste into the admin console\n\nEnvironment (upload):\n  CONTRAIL_CLI_EMAIL        VibeIQ user email\n  CONTRAIL_CLI_PASSWORD     VibeIQ user password\n";
+export declare function runConfigFile(subcommand: string | undefined, rest: string[]): Promise<void>;

package/lib/cli/commands/config-file/index.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runConfigFile = exports.CONFIG_FILE_USAGE = void 0;
+const create_1 = require("./create");
+const upload_1 = require("./upload");
+exports.CONFIG_FILE_USAGE = `Usage: flexplm config-file <command> [args]
+
+Commands:
+  create                    Scaffold a new <orgName>-config.json file in the current directory
+  upload  <path.json> [opts] Upload the inner "config" payload of a config JSON file to VibeIQ
+
+Upload options:
+  -m <message>              Git commit message (prompted if omitted)
+  -b <branch>               Create a new git branch before committing
+  --skip-git                Skip the post-upload git commit (default: commit)
+  --update-config           Patch the app-org appConfig.configFile with the uploaded file ID without needing to paste into the admin console
+
+Environment (upload):
+  CONTRAIL_CLI_EMAIL        VibeIQ user email
+  CONTRAIL_CLI_PASSWORD     VibeIQ user password
+`;
+async function runConfigFile(subcommand, rest) {
+    switch (subcommand) {
+        case 'create':
+            await new create_1.CreateCommand().run();
+            return;
+        case 'upload':
+            if (!rest[0]) {
+                console.error('config-file upload: missing <path.json> argument');
+                console.error(exports.CONFIG_FILE_USAGE);
+                process.exit(1);
+            }
+            await new upload_1.UploadCommand().run(rest);
+            return;
+        case undefined:
+        case '-h':
+        case '--help':
+        case 'help':
+            console.log(exports.CONFIG_FILE_USAGE);
+            return;
+        default:
+            console.error(`Unknown config-file subcommand: ${subcommand}`);
+            console.error(exports.CONFIG_FILE_USAGE);
+            process.exit(1);
+    }
+}
+exports.runConfigFile = runConfigFile;

package/lib/cli/commands/config-file/upload.d.ts

@@ -0,0 +1,8 @@
+export declare function parseConfigEnvelope(jsonAbsPath: string, raw: string): {
+    orgName: string;
+    appIdentifier: string;
+    config: Record<string, unknown>;
+};
+export declare class UploadCommand {
+    run(args: string[]): Promise<void>;
+}

package/lib/cli/commands/config-file/upload.js

@@ -0,0 +1,84 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadCommand = exports.parseConfigEnvelope = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const upload_base_1 = require("../shared/upload-base");
+function parseConfigEnvelope(jsonAbsPath, raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse JSON in ${jsonAbsPath}: ${err && err.message ? err.message : err}`);
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Config file must be a JSON object: ${jsonAbsPath}`);
+    }
+    const envelope = parsed;
+    const orgName = envelope.orgName;
+    if (typeof orgName !== 'string' || !orgName) {
+        throw new Error(`Config file is missing string "orgName": ${jsonAbsPath}`);
+    }
+    const appIdentifier = envelope.appIdentifier;
+    if (typeof appIdentifier !== 'string' || !appIdentifier) {
+        throw new Error(`Config file is missing string "appIdentifier": ${jsonAbsPath}`);
+    }
+    const config = envelope.config;
+    if (!config || typeof config !== 'object' || Array.isArray(config)) {
+        throw new Error(`Config file is missing object "config": ${jsonAbsPath}`);
+    }
+    return {
+        orgName,
+        appIdentifier,
+        config: config,
+    };
+}
+exports.parseConfigEnvelope = parseConfigEnvelope;
+const configStrategy = {
+    topicLabel: 'config-file',
+    sourceExtension: '.json',
+    async prepare(jsonAbsPath) {
+        const raw = fs.readFileSync(jsonAbsPath, 'utf8');
+        const { orgName, appIdentifier, config } = parseConfigEnvelope(jsonAbsPath, raw);
+        const uploadBuffer = Buffer.from(JSON.stringify(config, null, 2), 'utf8');
+        return {
+            orgName,
+            appIdentifier,
+            uploadBuffer,
+            uploadFileName: path.basename(jsonAbsPath),
+            uploadContentType: 'application/json',
+            configPropertyName: 'configFile',
+            filesToCommit: [jsonAbsPath],
+        };
+    },
+};
+class UploadCommand {
+    async run(args) {
+        await (0, upload_base_1.runUpload)(configStrategy, args);
+    }
+}
+exports.UploadCommand = UploadCommand;

package/lib/cli/commands/config-file/upload.spec.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock('@contrail/sdk', () => ({
+    Entities: jest.fn(),
+    Files: jest.fn(),
+    login: jest.fn(),
+}));
+const upload_1 = require("./upload");
+describe('parseConfigEnvelope', () => {
+    const file = '/tmp/sample-config.json';
+    it('parses a well-formed envelope', () => {
+        const raw = JSON.stringify({
+            orgName: 'acme',
+            appIdentifier: '@vibeiq/flexplm-connector',
+            config: { LCSMaterial: { processAsItem: true } },
+        });
+        const result = (0, upload_1.parseConfigEnvelope)(file, raw);
+        expect(result).toEqual({
+            orgName: 'acme',
+            appIdentifier: '@vibeiq/flexplm-connector',
+            config: { LCSMaterial: { processAsItem: true } },
+        });
+    });
+    it('throws on invalid JSON', () => {
+        expect(() => (0, upload_1.parseConfigEnvelope)(file, '{not valid json')).toThrow(/Failed to parse JSON/);
+    });
+    it('throws when the top-level value is not an object', () => {
+        expect(() => (0, upload_1.parseConfigEnvelope)(file, '[]')).toThrow(/must be a JSON object/);
+        expect(() => (0, upload_1.parseConfigEnvelope)(file, '"hello"')).toThrow(/must be a JSON object/);
+    });
+    it('throws when orgName is missing', () => {
+        const raw = JSON.stringify({ appIdentifier: '@vibeiq/flexplm-connector', config: {} });
+        expect(() => (0, upload_1.parseConfigEnvelope)(file, raw)).toThrow(/missing string "orgName"/);
+    });
+    it('throws when orgName is empty', () => {
+        const raw = JSON.stringify({ orgName: '', appIdentifier: '@vibeiq/flexplm-connector', config: {} });
+        expect(() => (0, upload_1.parseConfigEnvelope)(file, raw)).toThrow(/missing string "orgName"/);
+    });
+    it('throws when appIdentifier is missing', () => {
+        const raw = JSON.stringify({ orgName: 'acme', config: {} });
+        expect(() => (0, upload_1.parseConfigEnvelope)(file, raw)).toThrow(/missing string "appIdentifier"/);
+    });
+    it('throws when config is missing', () => {
+        const raw = JSON.stringify({ orgName: 'acme', appIdentifier: '@vibeiq/flexplm-connector' });
+        expect(() => (0, upload_1.parseConfigEnvelope)(file, raw)).toThrow(/missing object "config"/);
+    });
+    it('throws when config is not an object', () => {
+        const raw = JSON.stringify({ orgName: 'acme', appIdentifier: '@vibeiq/flexplm-connector', config: [] });
+        expect(() => (0, upload_1.parseConfigEnvelope)(file, raw)).toThrow(/missing object "config"/);
+    });
+});

package/lib/cli/commands/mapping-file/create.d.ts

@@ -0,0 +1,4 @@
+export declare class CreateCommand {
+    private findTemplate;
+    run(): Promise<void>;
+}

package/lib/cli/commands/{create.js → mapping-file/create.js}

@@ -26,30 +26,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateCommand = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const readline = __importStar(require("readline"));
+const prompts_1 = require("../shared/prompts");
 const TEMPLATE_FILENAME = 'mapping-template.ts.template';
 const PLACEHOLDER = '<ORG_NAME>';
 class CreateCommand {
-    prompt(question) {
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        const onSigint = () => {
-            rl.close();
-            process.stdout.write('\n');
-            process.exit(130);
-        };
-        process.once('SIGINT', onSigint);
-        return new Promise((resolve) => {
-            rl.question(question, (answer) => {
-                process.removeListener('SIGINT', onSigint);
-                rl.close();
-                resolve(answer);
-            });
-        });
-    }
     findTemplate() {
         const candidates = [
-            path.join(__dirname, '..', 'template', TEMPLATE_FILENAME),
-            path.join(__dirname, '..', '..', '..', 'src', 'cli', 'template', TEMPLATE_FILENAME),
+            path.join(__dirname, '..', '..', 'template', TEMPLATE_FILENAME),
+            path.join(__dirname, '..', '..', '..', '..', 'src', 'cli', 'template', TEMPLATE_FILENAME),
         ];
         for (const candidate of candidates) {
             if (fs.existsSync(candidate)) {
@@ -59,7 +43,7 @@ class CreateCommand {
         throw new Error(`Could not locate ${TEMPLATE_FILENAME}. Tried:\n  ${candidates.join('\n  ')}`);
     }
     async run() {
-        const orgName = (await this.prompt('orgName: ')).trim();
+        const orgName = (await (0, prompts_1.prompt)('orgName: ')).trim();
         if (!orgName) {
             throw new Error('orgName is required');
         }

package/lib/cli/commands/mapping-file/create.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/cli/commands/{create.spec.js → mapping-file/create.spec.js}

@@ -34,7 +34,7 @@ jest.mock('readline', () => ({
     }),
 }));
 const create_1 = require("./create");
-describe('runCreate', () => {
+describe('runCreate (mapping-file)', () => {
     let tempDir;
     let originalCwd;
     let logSpy;

package/lib/cli/commands/mapping-file/index.d.ts

@@ -0,0 +1,2 @@
+export declare const MAPPING_FILE_USAGE = "Usage: flexplm mapping-file <command> [args]\n\nCommands:\n  create                  Scaffold a new mapping .ts file in the current directory\n  compile <path.ts>       Transpile a mapping .ts file to .js alongside it\n  upload  <path.ts> [opts] Compile a mapping .ts file and upload the resulting .js to VibeIQ\n\nUpload options:\n  -m <message>            Git commit message (prompted if omitted)\n  -b <branch>             Create a new git branch before committing\n  --skip-git              Skip the post-upload git commit (default: commit)\n  --update-config         Patch the app-org appConfig.transformMapFile with the uploaded file ID without needing to paste into the admin console\n\nEnvironment (upload):\n  CONTRAIL_CLI_EMAIL      VibeIQ user email\n  CONTRAIL_CLI_PASSWORD   VibeIQ user password\n";
+export declare function runMappingFile(subcommand: string | undefined, rest: string[]): Promise<void>;

package/lib/cli/commands/mapping-file/index.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMappingFile = exports.MAPPING_FILE_USAGE = void 0;
+const create_1 = require("./create");
+const compile_1 = require("./compile");
+const upload_1 = require("./upload");
+exports.MAPPING_FILE_USAGE = `Usage: flexplm mapping-file <command> [args]
+
+Commands:
+  create                  Scaffold a new mapping .ts file in the current directory
+  compile <path.ts>       Transpile a mapping .ts file to .js alongside it
+  upload  <path.ts> [opts] Compile a mapping .ts file and upload the resulting .js to VibeIQ
+
+Upload options:
+  -m <message>            Git commit message (prompted if omitted)
+  -b <branch>             Create a new git branch before committing
+  --skip-git              Skip the post-upload git commit (default: commit)
+  --update-config         Patch the app-org appConfig.transformMapFile with the uploaded file ID without needing to paste into the admin console
+
+Environment (upload):
+  CONTRAIL_CLI_EMAIL      VibeIQ user email
+  CONTRAIL_CLI_PASSWORD   VibeIQ user password
+`;
+async function runMappingFile(subcommand, rest) {
+    switch (subcommand) {
+        case 'create':
+            await new create_1.CreateCommand().run();
+            return;
+        case 'compile':
+            if (!rest[0]) {
+                console.error('mapping-file compile: missing <path.ts> argument');
+                console.error(exports.MAPPING_FILE_USAGE);
+                process.exit(1);
+            }
+            await new compile_1.CompileCommand().run(rest[0]);
+            return;
+        case 'upload':
+            if (!rest[0]) {
+                console.error('mapping-file upload: missing <path.ts> argument');
+                console.error(exports.MAPPING_FILE_USAGE);
+                process.exit(1);
+            }
+            await new upload_1.UploadCommand().run(rest);
+            return;
+        case undefined:
+        case '-h':
+        case '--help':
+        case 'help':
+            console.log(exports.MAPPING_FILE_USAGE);
+            return;
+        default:
+            console.error(`Unknown mapping-file subcommand: ${subcommand}`);
+            console.error(exports.MAPPING_FILE_USAGE);
+            process.exit(1);
+    }
+}
+exports.runMappingFile = runMappingFile;

package/lib/cli/commands/mapping-file/upload.d.ts

@@ -0,0 +1,3 @@
+export declare class UploadCommand {
+    run(args: string[]): Promise<void>;
+}

package/lib/cli/commands/mapping-file/upload.js

@@ -0,0 +1,70 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadCommand = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const upload_base_1 = require("../shared/upload-base");
+const compile_1 = require("./compile");
+const mappingStrategy = {
+    topicLabel: 'mapping-file',
+    sourceExtension: '.ts',
+    async prepare(tsAbsPath) {
+        await new compile_1.CompileCommand().run(tsAbsPath);
+        const jsAbsPath = tsAbsPath.replace(/\.ts$/, '.js');
+        if (!fs.existsSync(jsAbsPath)) {
+            throw new Error(`Compiled file not found: ${jsAbsPath}`);
+        }
+        delete require.cache[jsAbsPath];
+        const loaded = require(jsAbsPath);
+        const mapping = loaded && loaded.mapping;
+        if (!mapping || !mapping.orgInfo) {
+            throw new Error(`Mapping file is missing "mapping.orgInfo" export: ${jsAbsPath}`);
+        }
+        const { orgName, appIdentifier } = mapping.orgInfo;
+        if (!orgName) {
+            throw new Error(`Mapping file is missing "mapping.orgInfo.orgName": ${jsAbsPath}`);
+        }
+        if (!appIdentifier) {
+            throw new Error(`Mapping file is missing "mapping.orgInfo.appIdentifier": ${jsAbsPath}`);
+        }
+        const uploadBuffer = fs.readFileSync(jsAbsPath);
+        return {
+            orgName,
+            appIdentifier,
+            uploadBuffer,
+            uploadFileName: path.basename(jsAbsPath),
+            uploadContentType: 'application/javascript',
+            configPropertyName: 'transformMapFile',
+            filesToCommit: [tsAbsPath, jsAbsPath],
+        };
+    },
+};
+class UploadCommand {
+    async run(args) {
+        await (0, upload_base_1.runUpload)(mappingStrategy, args);
+    }
+}
+exports.UploadCommand = UploadCommand;

package/lib/cli/commands/shared/git.d.ts

@@ -0,0 +1,6 @@
+export declare function buildCommitMessage(userMessage: string, fileId: string): string;
+export interface CommitOptions {
+    message?: string;
+    branch?: string;
+}
+export declare function commitFiles(absPaths: string[], fileId: string, options: CommitOptions): Promise<void>;

package/lib/cli/commands/shared/git.js

@@ -0,0 +1,100 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commitFiles = exports.buildCommitMessage = void 0;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const prompts_1 = require("./prompts");
+function buildCommitMessage(userMessage, fileId) {
+    const lines = userMessage.split(/\r?\n/);
+    lines[0] = `${lines[0]} [fileId: ${fileId}]`;
+    return lines.join('\n');
+}
+exports.buildCommitMessage = buildCommitMessage;
+function runGit(args, cwd) {
+    return (0, child_process_1.execFileSync)('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+}
+function tryRunGit(args, cwd) {
+    try {
+        const stdout = runGit(args, cwd);
+        return { ok: true, stdout, stderr: '' };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            stdout: err && err.stdout ? err.stdout.toString() : '',
+            stderr: err && err.stderr ? err.stderr.toString() : (err && err.message) || '',
+        };
+    }
+}
+async function commitFiles(absPaths, fileId, options) {
+    const repoDir = path.dirname(absPaths[0]);
+    const relPaths = absPaths.map((p) => path.basename(p));
+    const versionCheck = tryRunGit(['--version'], repoDir);
+    if (!versionCheck.ok) {
+        console.log('git command not available; skipping git commit.');
+        return;
+    }
+    const insideRepo = tryRunGit(['rev-parse', '--is-inside-work-tree'], repoDir);
+    if (!insideRepo.ok || insideRepo.stdout.trim() !== 'true') {
+        console.log(`Not inside a git working tree (${repoDir}); skipping git commit.`);
+        return;
+    }
+    for (const relPath of relPaths) {
+        const tracked = tryRunGit(['ls-files', '--error-unmatch', relPath], repoDir);
+        if (!tracked.ok) {
+            const answer = (await (0, prompts_1.prompt)(`File is not tracked by git: ${relPath}\nAdd it to git? (Y/n): `)).toLowerCase();
+            if (answer === 'n' || answer === 'no') {
+                console.log('Nothing was done in git.');
+                return;
+            }
+        }
+    }
+    if (options.branch) {
+        const branchResult = tryRunGit(['checkout', '-b', options.branch], repoDir);
+        if (!branchResult.ok) {
+            throw new Error(`Failed to create branch "${options.branch}": ${branchResult.stderr.trim()}`);
+        }
+        console.log(`Created and switched to branch "${options.branch}"`);
+    }
+    let message = options.message;
+    if (!message) {
+        message = await (0, prompts_1.prompt)('Commit message: ');
+        if (!message) {
+            throw new Error('A commit message is required');
+        }
+    }
+    const finalMessage = buildCommitMessage(message, fileId);
+    const addResult = tryRunGit(['add', '--', ...relPaths], repoDir);
+    if (!addResult.ok) {
+        throw new Error(`git add failed: ${addResult.stderr.trim()}`);
+    }
+    const commitResult = tryRunGit(['commit', '-m', finalMessage, '--', ...relPaths], repoDir);
+    if (!commitResult.ok) {
+        throw new Error(`git commit failed: ${commitResult.stderr.trim() || commitResult.stdout.trim()}`);
+    }
+    console.log(commitResult.stdout.trim());
+}
+exports.commitFiles = commitFiles;

package/lib/cli/commands/shared/prompts.d.ts

@@ -0,0 +1,2 @@
+export declare function prompt(question: string): Promise<string>;
+export declare function promptHidden(question: string): Promise<string>;