@aspruyt/json-config-sync 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anthony
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PR.md

@@ -0,0 +1,14 @@
+## Summary
+
+Automated sync of `{{FILE_NAME}}` configuration file.
+
+## Changes
+
+- {{ACTION}} `{{FILE_NAME}}` in repository root
+
+## Source
+
+Configuration synced using [json-config-sync](https://github.com/anthony-spruyt/json-config-sync).
+
+---
+*This PR was automatically generated by [json-config-sync](https://github.com/anthony-spruyt/json-config-sync)*

package/README.md

@@ -0,0 +1,170 @@
+# json-config-sync
+
+[![CI](https://github.com/anthony-spruyt/json-config-sync/actions/workflows/ci.yml/badge.svg)](https://github.com/anthony-spruyt/json-config-sync/actions/workflows/ci.yml)
+[![Integration Test](https://github.com/anthony-spruyt/json-config-sync/actions/workflows/integration.yml/badge.svg)](https://github.com/anthony-spruyt/json-config-sync/actions/workflows/integration.yml)
+
+A CLI tool that syncs JSON configuration files across multiple Git repositories by creating pull requests.
+
+## Features
+
+- Reads configuration from a YAML file
+- Supports both GitHub and Azure DevOps repositories
+- Creates PRs automatically using `gh` CLI (GitHub) or `az` CLI (Azure DevOps)
+- Continues processing if individual repos fail
+- Supports dry-run mode for testing
+- Progress logging with summary report
+
+## Installation
+
+### From npm
+
+```bash
+npm install -g @aspruyt/json-config-sync
+```
+
+### From Source
+
+```bash
+git clone https://github.com/anthony-spruyt/json-config-sync.git
+cd json-config-sync
+npm install
+npm run build
+```
+
+### Using Dev Container
+
+Open this repository in VS Code with the Dev Containers extension. The container includes all dependencies pre-installed and the project pre-built.
+
+## Prerequisites
+
+### GitHub Authentication
+
+Before using with GitHub repositories, authenticate with the GitHub CLI:
+
+```bash
+gh auth login
+```
+
+### Azure DevOps Authentication
+
+Before using with Azure DevOps repositories, authenticate with the Azure CLI:
+
+```bash
+az login
+az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT
+```
+
+## Usage
+
+```bash
+# Basic usage
+json-config-sync --config ./config.yaml
+
+# Dry run (no changes made)
+json-config-sync --config ./config.yaml --dry-run
+
+# Custom work directory
+json-config-sync --config ./config.yaml --work-dir ./my-temp
+```
+
+### Options
+
+| Option | Alias | Description | Required |
+|--------|-------|-------------|----------|
+| `--config` | `-c` | Path to YAML config file | Yes |
+| `--dry-run` | `-d` | Show what would be done without making changes | No |
+| `--work-dir` | `-w` | Temporary directory for cloning (default: `./tmp`) | No |
+
+## Configuration Format
+
+Create a YAML file with the following structure:
+
+```yaml
+fileName: my.config.json
+repos:
+  - git: git@github.com:example-org/repo1.git
+    json:
+      setting1: value1
+      nested:
+        setting2: value2
+  - git: git@ssh.dev.azure.com:v3/example-org/project/repo2
+    json:
+      setting1: differentValue
+      setting3: value
+```
+
+### Fields
+
+| Field | Description |
+|-------|-------------|
+| `fileName` | The name of the JSON file to create/update in each repo |
+| `repos` | Array of repository configurations |
+| `repos[].git` | Git URL of the repository (SSH or HTTPS) |
+| `repos[].json` | The JSON content to write to the file |
+
+## Supported Git URL Formats
+
+### GitHub
+- SSH: `git@github.com:owner/repo.git`
+- HTTPS: `https://github.com/owner/repo.git`
+
+### Azure DevOps
+- SSH: `git@ssh.dev.azure.com:v3/organization/project/repo`
+- HTTPS: `https://dev.azure.com/organization/project/_git/repo`
+
+## Workflow
+
+For each repository in the config, the tool:
+
+1. Cleans the temporary workspace
+2. Detects if repo is GitHub or Azure DevOps
+3. Clones the repository
+4. Creates/checks out branch `chore/sync-{sanitized-filename}`
+5. Generates the JSON file from config
+6. Checks for changes (skips if no changes)
+7. Commits and pushes changes
+8. Creates a pull request
+
+## Example
+
+Given this config file (`config.yaml`):
+
+```yaml
+fileName: my.config.json
+repos:
+  - git: git@github.com:example-org/my-service.git
+    json:
+      environment: production
+      settings:
+        feature1: true
+        feature2: false
+```
+
+Running:
+
+```bash
+json-config-sync --config ./config.yaml
+```
+
+Will:
+1. Clone `example-org/my-service`
+2. Create branch `chore/sync-my-config`
+3. Write `my.config.json` with the specified content
+4. Create a PR titled "chore: sync my.config.json"
+
+## Development
+
+```bash
+# Run in development mode
+npm run dev -- --config ./fixtures/test-repos-input.yaml --dry-run
+
+# Run tests
+npm test
+
+# Build
+npm run build
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+export interface RepoConfig {
+    git: string;
+    json: Record<string, unknown>;
+}
+export interface Config {
+    fileName: string;
+    repos: RepoConfig[];
+}
+export declare function loadConfig(filePath: string): Config;
+export declare function convertJsonToString(json: Record<string, unknown>): string;

package/dist/config.js

@@ -0,0 +1,25 @@
+import { readFileSync } from 'node:fs';
+import { parse } from 'yaml';
+export function loadConfig(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    const config = parse(content);
+    if (!config.fileName) {
+        throw new Error('Config missing required field: fileName');
+    }
+    if (!config.repos || !Array.isArray(config.repos)) {
+        throw new Error('Config missing required field: repos (must be an array)');
+    }
+    for (let i = 0; i < config.repos.length; i++) {
+        const repo = config.repos[i];
+        if (!repo.git) {
+            throw new Error(`Repo at index ${i} missing required field: git`);
+        }
+        if (!repo.json) {
+            throw new Error(`Repo at index ${i} missing required field: json`);
+        }
+    }
+    return config;
+}
+export function convertJsonToString(json) {
+    return JSON.stringify(json, null, 2);
+}

package/dist/git-ops.d.ts

@@ -0,0 +1,19 @@
+export interface GitOpsOptions {
+    workDir: string;
+    dryRun?: boolean;
+}
+export declare class GitOps {
+    private workDir;
+    private dryRun;
+    constructor(options: GitOpsOptions);
+    private exec;
+    cleanWorkspace(): void;
+    clone(gitUrl: string): void;
+    createBranch(branchName: string): void;
+    writeFile(fileName: string, content: string): void;
+    hasChanges(): boolean;
+    commit(message: string): void;
+    push(branchName: string): void;
+    getDefaultBranch(): string;
+}
+export declare function sanitizeBranchName(fileName: string): string;

package/dist/git-ops.js

@@ -0,0 +1,96 @@
+import { execSync } from 'node:child_process';
+import { rmSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export class GitOps {
+    workDir;
+    dryRun;
+    constructor(options) {
+        this.workDir = options.workDir;
+        this.dryRun = options.dryRun ?? false;
+    }
+    exec(command, cwd) {
+        return execSync(command, {
+            cwd: cwd ?? this.workDir,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    cleanWorkspace() {
+        if (existsSync(this.workDir)) {
+            rmSync(this.workDir, { recursive: true, force: true });
+        }
+        mkdirSync(this.workDir, { recursive: true });
+    }
+    clone(gitUrl) {
+        this.exec(`git clone "${gitUrl}" .`, this.workDir);
+    }
+    createBranch(branchName) {
+        try {
+            // Check if branch exists on remote
+            this.exec(`git fetch origin ${branchName}`, this.workDir);
+            this.exec(`git checkout ${branchName}`, this.workDir);
+        }
+        catch {
+            // Branch doesn't exist, create it
+            this.exec(`git checkout -b ${branchName}`, this.workDir);
+        }
+    }
+    writeFile(fileName, content) {
+        const filePath = join(this.workDir, fileName);
+        writeFileSync(filePath, content + '\n', 'utf-8');
+    }
+    hasChanges() {
+        const status = this.exec('git status --porcelain', this.workDir);
+        return status.length > 0;
+    }
+    commit(message) {
+        if (this.dryRun) {
+            return;
+        }
+        this.exec('git add -A', this.workDir);
+        this.exec(`git commit -m "${message}"`, this.workDir);
+    }
+    push(branchName) {
+        if (this.dryRun) {
+            return;
+        }
+        this.exec(`git push -u origin ${branchName}`, this.workDir);
+    }
+    getDefaultBranch() {
+        try {
+            // Try to get the default branch from remote
+            const remoteInfo = this.exec('git remote show origin', this.workDir);
+            const match = remoteInfo.match(/HEAD branch: (\S+)/);
+            if (match) {
+                return match[1];
+            }
+        }
+        catch {
+            // Fallback methods
+        }
+        // Try common default branch names
+        try {
+            this.exec('git rev-parse --verify origin/main', this.workDir);
+            return 'main';
+        }
+        catch {
+            // Try master
+        }
+        try {
+            this.exec('git rev-parse --verify origin/master', this.workDir);
+            return 'master';
+        }
+        catch {
+            // Default to main
+        }
+        return 'main';
+    }
+}
+export function sanitizeBranchName(fileName) {
+    return fileName
+        .toLowerCase()
+        .replace(/\.[^.]+$/, '') // Remove extension
+        .replace(/[^a-z0-9-]/g, '-') // Replace non-alphanumeric with dashes
+        .replace(/-+/g, '-') // Collapse multiple dashes
+        .replace(/^-|-$/g, ''); // Remove leading/trailing dashes
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { resolve, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { loadConfig, convertJsonToString } from './config.js';
+import { parseGitUrl, getRepoDisplayName } from './repo-detector.js';
+import { GitOps, sanitizeBranchName } from './git-ops.js';
+import { createPR } from './pr-creator.js';
+import { logger } from './logger.js';
+program
+    .name('json-config-sync')
+    .description('Sync JSON configuration files across multiple repositories')
+    .version('1.0.0')
+    .requiredOption('-c, --config <path>', 'Path to YAML config file')
+    .option('-d, --dry-run', 'Show what would be done without making changes')
+    .option('-w, --work-dir <path>', 'Temporary directory for cloning', './tmp')
+    .parse();
+const options = program.opts();
+async function main() {
+    const configPath = resolve(options.config);
+    if (!existsSync(configPath)) {
+        console.error(`Config file not found: ${configPath}`);
+        process.exit(1);
+    }
+    console.log(`Loading config from: ${configPath}`);
+    if (options.dryRun) {
+        console.log('Running in DRY RUN mode - no changes will be made\n');
+    }
+    const config = loadConfig(configPath);
+    const branchName = `chore/sync-${sanitizeBranchName(config.fileName)}`;
+    logger.setTotal(config.repos.length);
+    console.log(`Found ${config.repos.length} repositories to process`);
+    console.log(`Target file: ${config.fileName}`);
+    console.log(`Branch: ${branchName}\n`);
+    for (let i = 0; i < config.repos.length; i++) {
+        const repoConfig = config.repos[i];
+        const current = i + 1;
+        let repoInfo;
+        try {
+            repoInfo = parseGitUrl(repoConfig.git);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(current, repoConfig.git, message);
+            continue;
+        }
+        const repoName = getRepoDisplayName(repoInfo);
+        const workDir = resolve(join(options.workDir ?? './tmp', `repo-${i}`));
+        try {
+            logger.progress(current, repoName, 'Processing...');
+            const gitOps = new GitOps({ workDir, dryRun: options.dryRun });
+            // Step 1: Clean workspace
+            logger.info('Cleaning workspace...');
+            gitOps.cleanWorkspace();
+            // Step 2: Clone repo
+            logger.info('Cloning repository...');
+            gitOps.clone(repoInfo.gitUrl);
+            // Step 3: Get default branch for PR base
+            const baseBranch = gitOps.getDefaultBranch();
+            logger.info(`Default branch: ${baseBranch}`);
+            // Step 4: Create/checkout branch
+            logger.info(`Switching to branch: ${branchName}`);
+            gitOps.createBranch(branchName);
+            // Step 5: Write JSON file
+            logger.info(`Writing ${config.fileName}...`);
+            const jsonContent = convertJsonToString(repoConfig.json);
+            gitOps.writeFile(config.fileName, jsonContent);
+            // Step 6: Check for changes
+            if (!gitOps.hasChanges()) {
+                logger.skip(current, repoName, 'No changes detected');
+                continue;
+            }
+            // Determine if creating or updating
+            const action = existsSync(join(workDir, config.fileName)) ? 'update' : 'create';
+            // Step 7: Commit
+            logger.info('Committing changes...');
+            gitOps.commit(`chore: sync ${config.fileName}`);
+            // Step 8: Push
+            logger.info('Pushing to remote...');
+            gitOps.push(branchName);
+            // Step 9: Create PR
+            logger.info('Creating pull request...');
+            const prResult = await createPR({
+                repoInfo,
+                branchName,
+                baseBranch,
+                fileName: config.fileName,
+                action,
+                workDir,
+                dryRun: options.dryRun,
+            });
+            if (prResult.success) {
+                logger.success(current, repoName, prResult.url ? `PR: ${prResult.url}` : prResult.message);
+            }
+            else {
+                logger.error(current, repoName, prResult.message);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(current, repoName, message);
+        }
+    }
+    logger.summary();
+    if (logger.hasFailures()) {
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/dist/logger.d.ts

@@ -0,0 +1,18 @@
+export interface LoggerStats {
+    total: number;
+    succeeded: number;
+    failed: number;
+    skipped: number;
+}
+export declare class Logger {
+    private stats;
+    setTotal(total: number): void;
+    progress(current: number, repoName: string, message: string): void;
+    info(message: string): void;
+    success(current: number, repoName: string, message: string): void;
+    skip(current: number, repoName: string, reason: string): void;
+    error(current: number, repoName: string, error: string): void;
+    summary(): void;
+    hasFailures(): boolean;
+}
+export declare const logger: Logger;

package/dist/logger.js

@@ -0,0 +1,42 @@
+import chalk from 'chalk';
+export class Logger {
+    stats = {
+        total: 0,
+        succeeded: 0,
+        failed: 0,
+        skipped: 0,
+    };
+    setTotal(total) {
+        this.stats.total = total;
+    }
+    progress(current, repoName, message) {
+        console.log(chalk.blue(`[${current}/${this.stats.total}]`) + ` ${repoName}: ${message}`);
+    }
+    info(message) {
+        console.log(chalk.gray(`    ${message}`));
+    }
+    success(current, repoName, message) {
+        this.stats.succeeded++;
+        console.log(chalk.green(`[${current}/${this.stats.total}] ✓`) + ` ${repoName}: ${message}`);
+    }
+    skip(current, repoName, reason) {
+        this.stats.skipped++;
+        console.log(chalk.yellow(`[${current}/${this.stats.total}] ⊘`) + ` ${repoName}: Skipped - ${reason}`);
+    }
+    error(current, repoName, error) {
+        this.stats.failed++;
+        console.log(chalk.red(`[${current}/${this.stats.total}] ✗`) + ` ${repoName}: ${error}`);
+    }
+    summary() {
+        console.log('');
+        console.log(chalk.bold('Summary:'));
+        console.log(`  Total:     ${this.stats.total}`);
+        console.log(chalk.green(`  Succeeded: ${this.stats.succeeded}`));
+        console.log(chalk.yellow(`  Skipped:   ${this.stats.skipped}`));
+        console.log(chalk.red(`  Failed:    ${this.stats.failed}`));
+    }
+    hasFailures() {
+        return this.stats.failed > 0;
+    }
+}
+export const logger = new Logger();

package/dist/pr-creator.d.ts

@@ -0,0 +1,16 @@
+import { RepoInfo } from './repo-detector.js';
+export interface PROptions {
+    repoInfo: RepoInfo;
+    branchName: string;
+    baseBranch: string;
+    fileName: string;
+    action: 'create' | 'update';
+    workDir: string;
+    dryRun?: boolean;
+}
+export interface PRResult {
+    url?: string;
+    success: boolean;
+    message: string;
+}
+export declare function createPR(options: PROptions): Promise<PRResult>;

package/dist/pr-creator.js

@@ -0,0 +1,139 @@
+import { execSync } from 'node:child_process';
+import { readFileSync, existsSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+function escapeShellArg(arg) {
+    // Use single quotes and escape any single quotes within
+    return `'${arg.replace(/'/g, "'\\''")}'`;
+}
+function loadPRTemplate() {
+    // Try to find PR.md in the project root
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const templatePath = join(__dirname, '..', 'PR.md');
+    if (existsSync(templatePath)) {
+        return readFileSync(templatePath, 'utf-8');
+    }
+    // Fallback template
+    return `## Summary
+Automated sync of \`{{FILE_NAME}}\` configuration file.
+
+## Changes
+- {{ACTION}} \`{{FILE_NAME}}\` in repository root
+
+---
+*This PR was automatically generated by json-config-sync*`;
+}
+function formatPRBody(fileName, action) {
+    const template = loadPRTemplate();
+    const actionText = action === 'create' ? 'Created' : 'Updated';
+    return template
+        .replace(/\{\{FILE_NAME\}\}/g, fileName)
+        .replace(/\{\{ACTION\}\}/g, actionText);
+}
+export async function createPR(options) {
+    const { repoInfo, branchName, baseBranch, fileName, action, workDir, dryRun } = options;
+    const title = `chore: sync ${fileName}`;
+    const body = formatPRBody(fileName, action);
+    if (dryRun) {
+        return {
+            success: true,
+            message: `[DRY RUN] Would create PR: "${title}"`,
+        };
+    }
+    try {
+        if (repoInfo.type === 'github') {
+            return await createGitHubPR({ title, body, branchName, baseBranch, workDir });
+        }
+        else {
+            return await createAzureDevOpsPR({
+                title,
+                body,
+                branchName,
+                baseBranch,
+                repoInfo,
+                workDir
+            });
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            message: `Failed to create PR: ${message}`,
+        };
+    }
+}
+async function createGitHubPR(options) {
+    const { title, body, branchName, baseBranch, workDir } = options;
+    // Check if PR already exists
+    try {
+        const existingPR = execSync(`gh pr list --head ${escapeShellArg(branchName)} --json url --jq '.[0].url'`, { cwd: workDir, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (existingPR) {
+            return {
+                url: existingPR,
+                success: true,
+                message: `PR already exists: ${existingPR}`,
+            };
+        }
+    }
+    catch {
+        // No existing PR, continue to create
+    }
+    // Write body to temp file to avoid shell escaping issues
+    const bodyFile = join(workDir, '.pr-body.md');
+    writeFileSync(bodyFile, body, 'utf-8');
+    try {
+        const result = execSync(`gh pr create --title ${escapeShellArg(title)} --body-file ${escapeShellArg(bodyFile)} --base ${escapeShellArg(baseBranch)} --head ${escapeShellArg(branchName)}`, { cwd: workDir, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        // Extract URL from output
+        const urlMatch = result.match(/https:\/\/github\.com\/[^\s]+/);
+        return {
+            url: urlMatch?.[0] ?? result,
+            success: true,
+            message: 'PR created successfully',
+        };
+    }
+    finally {
+        // Clean up temp file
+        if (existsSync(bodyFile)) {
+            unlinkSync(bodyFile);
+        }
+    }
+}
+async function createAzureDevOpsPR(options) {
+    const { title, body, branchName, baseBranch, repoInfo, workDir } = options;
+    const orgUrl = `https://dev.azure.com/${encodeURIComponent(repoInfo.organization ?? '')}`;
+    // Check if PR already exists
+    try {
+        const existingPRs = execSync(`az repos pr list --repository ${escapeShellArg(repoInfo.repo)} --source-branch ${escapeShellArg(branchName)} --target-branch ${escapeShellArg(baseBranch)} --org ${escapeShellArg(orgUrl)} --project ${escapeShellArg(repoInfo.project ?? '')} --query "[0].pullRequestId" -o tsv`, { cwd: workDir, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (existingPRs) {
+            const prUrl = `https://dev.azure.com/${encodeURIComponent(repoInfo.organization ?? '')}/${encodeURIComponent(repoInfo.project ?? '')}/_git/${encodeURIComponent(repoInfo.repo)}/pullrequest/${existingPRs}`;
+            return {
+                url: prUrl,
+                success: true,
+                message: `PR already exists: ${prUrl}`,
+            };
+        }
+    }
+    catch {
+        // No existing PR, continue to create
+    }
+    // Write description to temp file to avoid shell escaping issues
+    const descFile = join(workDir, '.pr-description.md');
+    writeFileSync(descFile, body, 'utf-8');
+    try {
+        const result = execSync(`az repos pr create --repository ${escapeShellArg(repoInfo.repo)} --source-branch ${escapeShellArg(branchName)} --target-branch ${escapeShellArg(baseBranch)} --title ${escapeShellArg(title)} --description @${escapeShellArg(descFile)} --org ${escapeShellArg(orgUrl)} --project ${escapeShellArg(repoInfo.project ?? '')} --query "pullRequestId" -o tsv`, { cwd: workDir, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        const prUrl = `https://dev.azure.com/${encodeURIComponent(repoInfo.organization ?? '')}/${encodeURIComponent(repoInfo.project ?? '')}/_git/${encodeURIComponent(repoInfo.repo)}/pullrequest/${result}`;
+        return {
+            url: prUrl,
+            success: true,
+            message: 'PR created successfully',
+        };
+    }
+    finally {
+        // Clean up temp file
+        if (existsSync(descFile)) {
+            unlinkSync(descFile);
+        }
+    }
+}

package/dist/repo-detector.d.ts

@@ -0,0 +1,12 @@
+export type RepoType = 'github' | 'azure-devops';
+export interface RepoInfo {
+    type: RepoType;
+    gitUrl: string;
+    owner: string;
+    repo: string;
+    organization?: string;
+    project?: string;
+}
+export declare function detectRepoType(gitUrl: string): RepoType;
+export declare function parseGitUrl(gitUrl: string): RepoInfo;
+export declare function getRepoDisplayName(repoInfo: RepoInfo): string;

package/dist/repo-detector.js

@@ -0,0 +1,75 @@
+export function detectRepoType(gitUrl) {
+    // Use strict pattern matching to prevent URL substring attacks
+    // Check for Azure DevOps SSH format: git@ssh.dev.azure.com:v3/...
+    if (/^git@ssh\.dev\.azure\.com:v3\//.test(gitUrl)) {
+        return 'azure-devops';
+    }
+    // Check for Azure DevOps HTTPS format: https://dev.azure.com/...
+    if (/^https?:\/\/dev\.azure\.com\//.test(gitUrl)) {
+        return 'azure-devops';
+    }
+    return 'github';
+}
+export function parseGitUrl(gitUrl) {
+    const type = detectRepoType(gitUrl);
+    if (type === 'azure-devops') {
+        return parseAzureDevOpsUrl(gitUrl);
+    }
+    return parseGitHubUrl(gitUrl);
+}
+function parseGitHubUrl(gitUrl) {
+    // Handle SSH format: git@github.com:owner/repo.git
+    const sshMatch = gitUrl.match(/git@github\.com:([^/]+)\/([^.]+)(?:\.git)?/);
+    if (sshMatch) {
+        return {
+            type: 'github',
+            gitUrl,
+            owner: sshMatch[1],
+            repo: sshMatch[2],
+        };
+    }
+    // Handle HTTPS format: https://github.com/owner/repo.git
+    const httpsMatch = gitUrl.match(/https?:\/\/github\.com\/([^/]+)\/([^.]+)(?:\.git)?/);
+    if (httpsMatch) {
+        return {
+            type: 'github',
+            gitUrl,
+            owner: httpsMatch[1],
+            repo: httpsMatch[2],
+        };
+    }
+    throw new Error(`Unable to parse GitHub URL: ${gitUrl}`);
+}
+function parseAzureDevOpsUrl(gitUrl) {
+    // Handle SSH format: git@ssh.dev.azure.com:v3/organization/project/repo
+    const sshMatch = gitUrl.match(/git@ssh\.dev\.azure\.com:v3\/([^/]+)\/([^/]+)\/([^.]+)/);
+    if (sshMatch) {
+        return {
+            type: 'azure-devops',
+            gitUrl,
+            owner: sshMatch[1],
+            repo: sshMatch[3],
+            organization: sshMatch[1],
+            project: sshMatch[2],
+        };
+    }
+    // Handle HTTPS format: https://dev.azure.com/organization/project/_git/repo
+    const httpsMatch = gitUrl.match(/https?:\/\/dev\.azure\.com\/([^/]+)\/([^/]+)\/_git\/([^.]+)/);
+    if (httpsMatch) {
+        return {
+            type: 'azure-devops',
+            gitUrl,
+            owner: httpsMatch[1],
+            repo: httpsMatch[3],
+            organization: httpsMatch[1],
+            project: httpsMatch[2],
+        };
+    }
+    throw new Error(`Unable to parse Azure DevOps URL: ${gitUrl}`);
+}
+export function getRepoDisplayName(repoInfo) {
+    if (repoInfo.type === 'azure-devops') {
+        return `${repoInfo.organization}/${repoInfo.project}/${repoInfo.repo}`;
+    }
+    return `${repoInfo.owner}/${repoInfo.repo}`;
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@aspruyt/json-config-sync",
+  "version": "0.1.0",
+  "description": "CLI tool to sync JSON configuration files across multiple repositories",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "json-config-sync": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "PR.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthony-spruyt/json-config-sync.git"
+  },
+  "homepage": "https://github.com/anthony-spruyt/json-config-sync#readme",
+  "bugs": {
+    "url": "https://github.com/anthony-spruyt/json-config-sync/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "node --import tsx --test src/config.test.ts",
+    "test:integration": "npm run build && node --import tsx --test src/integration.test.ts",
+    "prepublishOnly": "npm run build",
+    "release:patch": "npm version patch && git push --follow-tags",
+    "release:minor": "npm version minor && git push --follow-tags",
+    "release:major": "npm version major && git push --follow-tags"
+  },
+  "keywords": [
+    "config",
+    "sync",
+    "json",
+    "yaml",
+    "git",
+    "cli",
+    "github",
+    "azure-devops",
+    "pull-request"
+  ],
+  "author": "Anthony Spruyt",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^14.0.2",
+    "yaml": "^2.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.7",
+    "tsx": "^4.15.0",
+    "typescript": "^5.4.5"
+  }
+}