@callstack/brownfield-cli 1.0.0

package/dist/brownie/generators/swift.js

@@ -0,0 +1,55 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { quicktype, InputData, JSONSchemaInput, FetchingJSONSchemaStore, } from 'quicktype-core';
+import { schemaForTypeScriptSources } from 'quicktype-typescript-input';
+/**
+ * Generates Swift Codable struct from TypeScript schema.
+ */
+export async function generateSwift(options) {
+    const { name, schemaPath, typeName, outputPath } = options;
+    const absoluteSchemaPath = path.resolve(process.cwd(), schemaPath);
+    if (!fs.existsSync(absoluteSchemaPath)) {
+        throw new Error(`Schema file not found: ${absoluteSchemaPath}`);
+    }
+    const schemaData = schemaForTypeScriptSources([absoluteSchemaPath]);
+    if (!schemaData.schema) {
+        throw new Error('Failed to generate schema from TypeScript');
+    }
+    const parsedSchema = JSON.parse(schemaData.schema);
+    const definitions = parsedSchema.definitions;
+    if (!definitions?.[typeName]) {
+        throw new Error(`Type "${typeName}" not found in schema. Available types: ${Object.keys(definitions || {}).join(', ')}`);
+    }
+    parsedSchema.$ref = `#/definitions/${typeName}`;
+    const modifiedSchema = JSON.stringify(parsedSchema);
+    const schemaInput = new JSONSchemaInput(new FetchingJSONSchemaStore());
+    await schemaInput.addSource({
+        name: typeName,
+        schema: modifiedSchema,
+    });
+    const inputData = new InputData();
+    inputData.addInput(schemaInput);
+    const { lines } = await quicktype({
+        inputData,
+        lang: 'swift',
+        rendererOptions: {
+            'access-level': 'public',
+            'mutable-properties': 'true',
+            initializers: 'false',
+            'swift-5-support': 'true',
+            protocol: 'equatable',
+        },
+    });
+    const storeNameExtension = `
+extension ${typeName}: BrownieStoreProtocol {
+  public static let storeName = "${name}"
+}
+`;
+    const swiftOutput = lines.join('\n') + storeNameExtension;
+    const absoluteOutputPath = path.resolve(process.cwd(), outputPath);
+    const outputDir = path.dirname(absoluteOutputPath);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    fs.writeFileSync(absoluteOutputPath, swiftOutput);
+}

package/dist/brownie/index.d.ts

@@ -0,0 +1,7 @@
+import * as Commands from './commands/index.js';
+export type * from './types.js';
+export * from './store-discovery.js';
+export declare const groupName: string;
+export { Commands };
+export default Commands;
+//# sourceMappingURL=index.d.ts.map

package/dist/brownie/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/brownie/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAEhD,mBAAmB,YAAY,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAErC,eAAO,MAAM,SAAS,QAAwJ,CAAC;AAE/K,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,eAAe,QAAQ,CAAC"}

package/dist/brownie/index.js

@@ -0,0 +1,6 @@
+import { styleText } from 'node:util';
+import * as Commands from './commands/index.js';
+export * from './store-discovery.js';
+export const groupName = `${styleText(['bold', 'blueBright'], '@callstack/brownie')}${styleText('whiteBright', ' - Shared state management CLI for React Native Brownfield')}`;
+export { Commands };
+export default Commands;

package/dist/brownie/store-discovery.d.ts

@@ -0,0 +1,10 @@
+export interface DiscoveredStore {
+    name: string;
+    schemaPath: string;
+}
+/**
+ * Discovers all brownie stores by parsing BrownieStores interface
+ * from declare module '@callstack/brownie' blocks.
+ */
+export declare function discoverStores(rootDir?: string): DiscoveredStore[];
+//# sourceMappingURL=store-discovery.d.ts.map

package/dist/brownie/store-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-discovery.d.ts","sourceRoot":"","sources":["../../src/brownie/store-discovery.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AA4DD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,MAAsB,GAC9B,eAAe,EAAE,CAkCnB"}

package/dist/brownie/store-discovery.js

@@ -0,0 +1,75 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { Project } from 'ts-morph';
+/**
+ * Recursively finds all *.brownie.ts files in a directory.
+ */
+function findBrownieFiles(dir, files = []) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === 'node_modules' || entry.name.startsWith('.')) {
+                continue;
+            }
+            findBrownieFiles(fullPath, files);
+        }
+        else if (entry.name.endsWith('.brownie.ts')) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Parses a brownie file and extracts store names from BrownieStores interface.
+ */
+function parseStoresFromFile(project, filePath) {
+    const sourceFile = project.addSourceFileAtPath(filePath);
+    const stores = [];
+    const modules = sourceFile.getModules();
+    for (const mod of modules) {
+        const moduleName = mod.getName();
+        if (moduleName !== "'@callstack/brownie'" &&
+            moduleName !== '"@callstack/brownie"') {
+            continue;
+        }
+        const iface = mod.getInterface('BrownieStores');
+        if (!iface) {
+            continue;
+        }
+        for (const prop of iface.getProperties()) {
+            stores.push({
+                name: prop.getName(),
+                schemaPath: filePath,
+            });
+        }
+    }
+    return stores;
+}
+/**
+ * Discovers all brownie stores by parsing BrownieStores interface
+ * from declare module '@callstack/brownie' blocks.
+ */
+export function discoverStores(rootDir = process.cwd()) {
+    const brownieFiles = findBrownieFiles(rootDir);
+    if (brownieFiles.length === 0) {
+        throw new Error('No brownie store files found. Create a file ending with .brownie.ts ' +
+            '(e.g., MyStore.brownie.ts)');
+    }
+    const project = new Project({ skipAddingFilesFromTsConfig: true });
+    const allStores = [];
+    for (const filePath of brownieFiles) {
+        const stores = parseStoresFromFile(project, filePath);
+        allStores.push(...stores);
+    }
+    if (allStores.length === 0) {
+        throw new Error('No stores found in brownie files. Make sure to declare module ' +
+            "'@callstack/brownie' with BrownieStores interface.");
+    }
+    const names = allStores.map((s) => s.name);
+    const duplicates = names.filter((n, i) => names.indexOf(n) !== i);
+    if (duplicates.length > 0) {
+        throw new Error(`Duplicate store names found: ${[...new Set(duplicates)].join(', ')}`);
+    }
+    return allStores;
+}

package/dist/brownie/types.d.ts

@@ -0,0 +1,2 @@
+export type Platform = 'swift' | 'kotlin';
+//# sourceMappingURL=types.d.ts.map

package/dist/brownie/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/brownie/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC"}

package/dist/brownie/types.js

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { styleText } from 'node:util';
+import { logger } from '@rock-js/tools';
+import { Command } from 'commander';
+import { ExampleUsage } from './shared/index.js';
+import brownfieldCommands, { groupName as brownfieldCommandsGroupName, } from './brownfield/index.js';
+import brownieCommands, { groupName as brownieCommandsGroupName, } from './brownie/index.js';
+const program = new Command();
+program
+    .name(styleText('magenta', 'brownie'))
+    .usage(styleText('yellow', '[options] [command]'))
+    .description(styleText('magentaBright', 'React Native Brownfield CLI - ') +
+    styleText(['magenta', 'bold', 'underline'], 'Brownie'))
+    .version(process.env.npm_package_version ?? '0.0.0');
+program
+    .optionsGroup('Global options:')
+    .option('--verbose', 'enable verbose logging')
+    .hook('preAction', () => {
+    const opts = program.opts();
+    if (opts.verbose) {
+        logger.setVerbose(opts.verbose ?? false);
+    }
+});
+program.configureHelp({
+    styleTitle: (str) => styleText('bold', str),
+    styleCommandText: (str) => styleText('cyan', str),
+    styleArgumentText: (str) => styleText('yellow', str),
+    styleSubcommandText: (str) => styleText('blue', str),
+});
+function registrationHelper(commandsRegistration, groupName) {
+    program.commandsGroup(groupName);
+    const exampleUsageItems = [];
+    Object.values(commandsRegistration).forEach((commandOrExampleUsage) => {
+        if (commandOrExampleUsage instanceof Command) {
+            // command
+            program.addCommand(commandOrExampleUsage);
+        }
+        else if (commandOrExampleUsage instanceof ExampleUsage) {
+            // piece of example usage for the command group
+            exampleUsageItems.push(commandOrExampleUsage);
+        }
+    });
+    if (exampleUsageItems.length) {
+        const longestUsageItemCommandLength = exampleUsageItems.reduce((max, item) => Math.max(max, item.command.length), 0);
+        program.addHelpText('after', `\nExamples:\n${exampleUsageItems.map((item) => `\t ${styleText('dim', item.command.padEnd(longestUsageItemCommandLength))}\t${item.description}`).join('\n')}\n`);
+    }
+}
+registrationHelper(brownfieldCommands, brownfieldCommandsGroupName);
+registrationHelper(brownieCommands, brownieCommandsGroupName);
+program.commandsGroup('Utility commands').helpCommand('help [command]');
+program.parse(process.argv);
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare function runCLI(argv: string[]): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6EA,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAM3C"}

package/dist/index.js

@@ -0,0 +1,55 @@
+import { styleText } from 'node:util';
+import { logger } from '@rock-js/tools';
+import { Command } from 'commander';
+import { ExampleUsage } from './shared/index.js';
+import brownfieldCommands, { groupName as brownfieldCommandsGroupName, } from './brownfield/index.js';
+import brownieCommands, { groupName as brownieCommandsGroupName, } from './brownie/index.js';
+const program = new Command();
+program
+    .name(styleText('magenta', 'brownie'))
+    .usage(styleText('yellow', '[options] [command]'))
+    .description(styleText('magentaBright', 'React Native Brownfield CLI - ') +
+    styleText(['magenta', 'bold', 'underline'], 'Brownie'))
+    .version(process.env.npm_package_version ?? '0.0.0');
+program
+    .optionsGroup('Global options:')
+    .option('--verbose', 'enable verbose logging')
+    .hook('preAction', () => {
+    const opts = program.opts();
+    if (opts.verbose) {
+        logger.setVerbose(opts.verbose ?? false);
+    }
+});
+program.configureHelp({
+    styleTitle: (str) => styleText('bold', str),
+    styleCommandText: (str) => styleText('cyan', str),
+    styleArgumentText: (str) => styleText('yellow', str),
+    styleSubcommandText: (str) => styleText('blue', str),
+});
+function registrationHelper(commandsRegistration, groupName) {
+    program.commandsGroup(groupName);
+    const exampleUsageItems = [];
+    Object.values(commandsRegistration).forEach((commandOrExampleUsage) => {
+        if (commandOrExampleUsage instanceof Command) {
+            // command
+            program.addCommand(commandOrExampleUsage);
+        }
+        else if (commandOrExampleUsage instanceof ExampleUsage) {
+            // piece of example usage for the command group
+            exampleUsageItems.push(commandOrExampleUsage);
+        }
+    });
+    if (exampleUsageItems.length) {
+        const longestUsageItemCommandLength = exampleUsageItems.reduce((max, item) => Math.max(max, item.command.length), 0);
+        program.addHelpText('after', `\nExamples:\n${exampleUsageItems.map((item) => `\t ${styleText('dim', item.command.padEnd(longestUsageItemCommandLength))}\t${item.description}`).join('\n')}\n`);
+    }
+}
+registrationHelper(brownfieldCommands, brownfieldCommandsGroupName);
+registrationHelper(brownieCommands, brownieCommandsGroupName);
+program.commandsGroup('Utility commands').helpCommand('help [command]');
+export function runCLI(argv) {
+    program.parse(argv);
+    if (!argv.slice(2).length) {
+        program.outputHelp();
+    }
+}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runCLI } from './index.js';
+runCLI(process.argv);

package/dist/shared/classes/ExampleUsage.d.ts

@@ -0,0 +1,6 @@
+export declare class ExampleUsage {
+    readonly command: string;
+    readonly description: string;
+    constructor(command: string, description: string);
+}
+//# sourceMappingURL=ExampleUsage.d.ts.map

package/dist/shared/classes/ExampleUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExampleUsage.d.ts","sourceRoot":"","sources":["../../../src/shared/classes/ExampleUsage.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;aAEL,OAAO,EAAE,MAAM;aACf,WAAW,EAAE,MAAM;gBADnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM;CAEtC"}

package/dist/shared/classes/ExampleUsage.js

@@ -0,0 +1,8 @@
+export class ExampleUsage {
+    command;
+    description;
+    constructor(command, description) {
+        this.command = command;
+        this.description = description;
+    }
+}

package/dist/shared/classes/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ExampleUsage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/classes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/classes/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/shared/classes/index.js

@@ -0,0 +1 @@
+export * from './ExampleUsage.js';

package/dist/shared/index.d.ts

@@ -0,0 +1,3 @@
+export * from './utils/index.js';
+export * from './classes/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,2 @@
+export * from './utils/index.js';
+export * from './classes/index.js';

package/dist/shared/utils/cli.d.ts

@@ -0,0 +1,5 @@
+import { type RockCLIOptions } from '@rock-js/tools';
+import type { Command } from 'commander';
+export declare function curryOptions(programCommand: Command, options: RockCLIOptions): Command;
+export declare function actionRunner<T, R>(fn: (...args: T[]) => Promise<R>): (...args: T[]) => Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/shared/utils/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,YAAY,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,WAmB5E;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,IAC1B,GAAG,MAAM,CAAC,EAAE,mBAoBpD"}

package/dist/shared/utils/cli.js

@@ -0,0 +1,36 @@
+import { logger, RockError } from '@rock-js/tools';
+export function curryOptions(programCommand, options) {
+    options.forEach((option) => {
+        if (option.parse) {
+            programCommand = programCommand.option(option.name, option.description, option.parse, option.default);
+        }
+        else {
+            programCommand = programCommand.option(option.name, option.description, option.default);
+        }
+    });
+    return programCommand;
+}
+export function actionRunner(fn) {
+    return async function wrappedCLIAction(...args) {
+        try {
+            await fn(...args);
+        }
+        catch (error) {
+            if (error instanceof RockError) {
+                if (logger.isVerbose()) {
+                    logger.error(error);
+                }
+                else {
+                    logger.error(error.message);
+                    if (error.cause) {
+                        logger.error(`Cause: ${error.cause}`);
+                    }
+                }
+            }
+            else {
+                logger.error(`Unexpected error while running command:`, error);
+            }
+            process.exit(1);
+        }
+    };
+}

package/dist/shared/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/shared/utils/index.js

@@ -0,0 +1 @@
+export * from './cli.js';

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@callstack/brownfield-cli",
+  "version": "1.0.0",
+  "license": "MIT",
+  "author": "Artur Morys-Magiera <artus9033@gmail.com>",
+  "bin": {
+    "brownfield": "./dist/main.js"
+  },
+  "type": "module",
+  "contributors": [
+    "Artur Morys-Magiera <artus9033@gmail.com>",
+    "Oskar Kwasniewski <oskarkwasniewski@icloud.com>"
+  ],
+  "homepage": "https://github.com/callstack/react-native-brownfield",
+  "description": "Brownfield CLI for React Native, gathering all packages of the RN brownfield ecosystem",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./brownfield": {
+      "source": "./src/brownfield/index.ts",
+      "types": "./dist/brownfield/index.d.ts",
+      "default": "./dist/brownfield/index.js"
+    },
+    "./brownie": {
+      "source": "./src/brownie/index.ts",
+      "types": "./dist/brownie/index.d.ts",
+      "default": "./dist/brownie/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "react-native-brownfield",
+    "react native brownfield",
+    "native",
+    "react native integration",
+    "cli",
+    "brownie",
+    "tooling"
+  ],
+  "files": [
+    "src",
+    "dist",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@react-native-community/cli-config": "*",
+    "@react-native-community/cli-config-android": "*"
+  },
+  "dependencies": {
+    "@react-native-community/cli-config": "^20.0.0",
+    "@react-native-community/cli-config-android": "^20.0.0",
+    "@rock-js/platform-android": "^0.12.6",
+    "@rock-js/platform-apple-helpers": "^0.12.6",
+    "@rock-js/plugin-brownfield-android": "^0.12.6",
+    "@rock-js/plugin-brownfield-ios": "^0.12.6",
+    "@rock-js/tools": "^0.12.6",
+    "commander": "^14.0.2",
+    "lodash.clonedeep": "^4.5.0",
+    "ts-morph": "^27.0.2"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@babel/preset-typescript": "^7.28.5",
+    "@react-native-community/cli-types": "^20.0.0",
+    "@react-native/babel-preset": "0.82.1",
+    "@react-native/eslint-config": "0.82.1",
+    "@types/babel__core": "^7.20.5",
+    "@types/babel__preset-env": "^7.10.0",
+    "@types/lodash.clonedeep": "^4.5.9",
+    "@types/node": "^25.0.8",
+    "@vitest/coverage-v8": "^4.0.17",
+    "eslint": "^9.28.0",
+    "globals": "^16.2.0",
+    "nodemon": "^3.1.11",
+    "typescript": "5.9.3",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/brownfield/commands/packageAndroid.ts

@@ -0,0 +1,39 @@
+import { Command } from 'commander';
+
+import {
+  type PackageAarFlags,
+  packageAarOptions,
+} from '@rock-js/platform-android';
+import { packageAarAction } from '@rock-js/plugin-brownfield-android';
+
+import {
+  ExampleUsage,
+  actionRunner,
+  curryOptions,
+} from '../../shared/index.js';
+import { getProjectInfo } from '../utils/index.js';
+
+export const packageAndroidCommand = curryOptions(
+  new Command('package:android').description('Build Android AAR'),
+  packageAarOptions.map((option) =>
+    option.name.startsWith('--variant')
+      ? { ...option, default: 'debug' }
+      : option
+  )
+).action(
+  actionRunner(async (options: PackageAarFlags) => {
+    const { projectRoot, platformConfig } = getProjectInfo('android');
+
+    await packageAarAction({
+      projectRoot,
+      pluginConfig: platformConfig,
+      moduleName: options.moduleName,
+      variant: options.variant,
+    });
+  })
+);
+
+export const packageAndroidExample = new ExampleUsage(
+  'package:android --module-name :BrownfieldLib --variant release',
+  "Build Android AAR for 'BrownfieldLib' module in release variant"
+);