index.js

/**
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 *
 * @flow strict
 * @format
 */

'use strict';
import type {NativeModulePropertyShape} from '../../../CodegenSchema';
import type {SchemaType} from '../../../CodegenSchema';
import type {MethodSerializationOutput} from './serializeMethod';

const {createAliasResolver, getModules} = require('../Utils');
const {serializeStruct} = require('./header/serializeStruct');
const {EventEmitterHeaderTemplate} = require('./serializeEventEmitter');
const {serializeMethod} = require('./serializeMethod');
const {serializeModuleSource} = require('./source/serializeModule');
const {StructCollector} = require('./StructCollector');

type FilesOutput = Map<string, string>;

const SwiftCompatibleDeclarationTemplate = ({
  hasteModuleName,
  protocolMethods,
}: $ReadOnly<{
  hasteModuleName: string,
  protocolMethods: string,
}>) => `
@protocol ${hasteModuleName}Spec <RCTBridgeModule, RCTSwiftTurboModule>

${protocolMethods}

@end
`

const ModuleDeclarationTemplate = ({
  hasteModuleName,
  structDeclarations,
  eventEmitters,
  protocolMethods,
}: Readonly<{
  hasteModuleName: string,
  structDeclarations: string,
  eventEmitters: string,
  protocolMethods: string,
}>) => `${structDeclarations}
@protocol ${hasteModuleName}Spec <RCTBridgeModule, RCTTurboModule>

${protocolMethods}

@end

@interface ${hasteModuleName}SpecBase : NSObject {
@protected
facebook::react::EventEmitterCallback _eventEmitterCallback;
}
- (void)setEventEmitterCallback:(EventEmitterCallbackWrapper *)eventEmitterCallbackWrapper;

${eventEmitters}
@end

namespace facebook::react {
  /**
   * ObjC++ class for module '${hasteModuleName}'
   */
  class JSI_EXPORT ${hasteModuleName}SpecJSI : public ObjCTurboModule {
  public:
    ${hasteModuleName}SpecJSI(const ObjCTurboModule::InitParams &params);
  };
} // namespace facebook::react`;

const SwiftCompatibleHeaderFileTemplate = ({
  headerFileName,
  moduleDeclarations,
  assumeNonnull,
}: $ReadOnly<{
  headerFileName: string,
  moduleDeclarations: string,
  assumeNonnull: boolean,
}>) => {
  const headerFileNameWithNoExt = headerFileName
    .replace(/\.h$/, '')
    .replace(/-/, '');

  return (
    `/**
 * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
 *
 * Do not edit this file as changes may cause incorrect behavior and will be lost
 * once the code is regenerated.
 *
 * ${'@'}generated by codegen project: GenerateModuleObjCpp
 *
 * We create an umbrella header (and corresponding implementation) here since
 * Cxx compilation in BUCK has a limitation: source-code producing genrule()s
 * must have a single output. More files => more genrule()s => slower builds.
 */

// Avoid multiple includes of ${headerFileNameWithNoExt} symbols
#ifndef ${headerFileNameWithNoExt}_H
#define ${headerFileNameWithNoExt}_H

#import <Foundation/Foundation.h>
#import <React/RCTBridgeModule.h>
#import <ReactCommon/RCTSwiftTurboModule.h>

` +
    (assumeNonnull ? '\nNS_ASSUME_NONNULL_BEGIN\n' : '') +
    moduleDeclarations +
    '\n' +
    (assumeNonnull ? '\nNS_ASSUME_NONNULL_END\n' : '\n') +
    `#endif // ${headerFileNameWithNoExt}_H` +
    '\n'
  );
};

const HeaderFileTemplate = ({
  headerFileName,
  moduleDeclarations,
  structInlineMethods,
  assumeNonnull,
}: Readonly<{
  headerFileName: string,
  moduleDeclarations: string,
  structInlineMethods: string,
  assumeNonnull: boolean,
}>) => {
  const headerFileNameWithNoExt = headerFileName.replace(/\.h$/, '');

  return (
    `/**
 * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
 *
 * Do not edit this file as changes may cause incorrect behavior and will be lost
 * once the code is regenerated.
 *
 * ${'@'}generated by codegen project: GenerateModuleObjCpp
 *
 * We create an umbrella header (and corresponding implementation) here since
 * Cxx compilation in BUCK has a limitation: source-code producing genrule()s
 * must have a single output. More files => more genrule()s => slower builds.
 */

#ifndef __cplusplus
#error This file must be compiled as Obj-C++. If you are importing it, you must change your file extension to .mm.
#endif

// Avoid multiple includes of ${headerFileNameWithNoExt} symbols
#ifndef ${headerFileNameWithNoExt}_H
#define ${headerFileNameWithNoExt}_H

#import <Foundation/Foundation.h>
#import <RCTRequired/RCTRequired.h>
#import <RCTTypeSafety/RCTConvertHelpers.h>
#import <RCTTypeSafety/RCTTypedModuleConstants.h>
#import <React/RCTBridgeModule.h>
#import <React/RCTCxxConvert.h>
#import <React/RCTManagedPointer.h>
#import <ReactCommon/RCTTurboModule.h>
#import <optional>
#import <vector>

` +
    (assumeNonnull ? '\nNS_ASSUME_NONNULL_BEGIN\n' : '') +
    moduleDeclarations +
    '\n' +
    structInlineMethods +
    (assumeNonnull ? '\nNS_ASSUME_NONNULL_END\n' : '\n') +
    `#endif // ${headerFileNameWithNoExt}_H` +
    '\n'
  );
};

const SourceFileTemplate = ({
  headerFileName,
  moduleImplementations,
}: Readonly<{
  headerFileName: string,
  moduleImplementations: string,
}>) => `/**
 * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
 *
 * Do not edit this file as changes may cause incorrect behavior and will be lost
 * once the code is regenerated.
 *
 * ${'@'}generated by codegen project: GenerateModuleObjCpp
 *
 * We create an umbrella header (and corresponding implementation) here since
 * Cxx compilation in BUCK has a limitation: source-code producing genrule()s
 * must have a single output. More files => more genrule()s => slower builds.
 */

#import "${headerFileName}"

${moduleImplementations}
`;

module.exports = {
  generate(
    libraryName: string,
    schema: SchemaType,
    packageName?: string,
    assumeNonnull: boolean,
    headerPrefix?: string,
  ): FilesOutput {
    const nativeModules = getModules(schema);

    const moduleDeclarations: Array<string> = [];
    const swiftCompatibleModulesDeclarations: Array<string> = [];
    const structInlineMethods: Array<string> = [];
    const moduleImplementations: Array<string> = [];

    const hasteModuleNames: Array<string> = Object.keys(nativeModules).sort();
    for (const hasteModuleName of hasteModuleNames) {
      const {aliasMap, excludedPlatforms, spec} =
        nativeModules[hasteModuleName];
      if (excludedPlatforms != null && excludedPlatforms.includes('iOS')) {
        continue;
      }
      const resolveAlias = createAliasResolver(aliasMap);
      const structCollector = new StructCollector();

      const methodSerializations: Array<MethodSerializationOutput> = [];
      const serializeProperty = (property: NativeModulePropertyShape) => {
        methodSerializations.push(
          ...serializeMethod(
            hasteModuleName,
            property,
            structCollector,
            resolveAlias,
          ),
        );
      };

      /**
       * Note: As we serialize NativeModule methods, we insert structs into
       * StructCollector, as we encounter them.
       */
      spec.methods
        .filter(property => property.name !== 'getConstants')
        .forEach(serializeProperty);
      spec.methods
        .filter(property => property.name === 'getConstants')
        .forEach(serializeProperty);

      const generatedStructs = structCollector.getAllStructs();
      const structStrs = [];
      const methodStrs = [];

      for (const struct of generatedStructs) {
        const {methods, declaration} = serializeStruct(hasteModuleName, struct);
        structStrs.push(declaration);
        methodStrs.push(methods);
      }

      moduleDeclarations.push(
        ModuleDeclarationTemplate({
          hasteModuleName: hasteModuleName,
          structDeclarations: structStrs.join('\n'),
          eventEmitters: spec.eventEmitters
            .map(eventEmitter => EventEmitterHeaderTemplate(eventEmitter))
            .join('\n'),
          protocolMethods: methodSerializations
            .map(({protocolMethod}) => protocolMethod)
            .join('\n'),
        }),
      );

      swiftCompatibleModulesDeclarations.push(
        SwiftCompatibleDeclarationTemplate({
          hasteModuleName: hasteModuleName,
          protocolMethods: methodSerializations
            .map(({protocolMethod}) => protocolMethod)
            .join('\n'),
        }),
      );

      structInlineMethods.push(methodStrs.join('\n'));

      moduleImplementations.push(
        serializeModuleSource(
          hasteModuleName,
          generatedStructs,
          hasteModuleName,
          spec.eventEmitters,
          methodSerializations.filter(
            ({selector}) => selector !== '@selector(constantsToExport)',
          ),
        ),
      );
    }

    const headerFileName = `${libraryName}.h`;
    const headerFile = HeaderFileTemplate({
      headerFileName,
      moduleDeclarations: moduleDeclarations.join('\n'),
      structInlineMethods: structInlineMethods.join('\n'),
      assumeNonnull,
    });

    const swiftCompatibleHeaderFileName = `${libraryName}-Swift.h`;
    const swiftHeaderFile = SwiftCompatibleHeaderFileTemplate({
      headerFileName: swiftCompatibleHeaderFileName,
      moduleDeclarations: swiftCompatibleModulesDeclarations.join('\n'),
      assumeNonnull,
    });

    const sourceFileName = `${libraryName}-generated.mm`;
    const sourceFile = SourceFileTemplate({
      headerFileName,
      moduleImplementations: moduleImplementations.join('\n'),
    });

    return new Map([
      [headerFileName, headerFile],
      [swiftCompatibleHeaderFileName, swiftHeaderFile],
      [sourceFileName, sourceFile],
    ]);
  },
};