@odata2ts/odata2ts 0.18.0

package/README.md

@@ -0,0 +1,129 @@
+[![npm (scoped)](https://img.shields.io/npm/v/@odata2ts/odata2ts?style=for-the-badge)](https://www.npmjs.com/package/@odata2ts/odata2ts)
+
+# OData 2 TS
+
+Generate TypeScript models, query objects and / or complete client services from a given metadata description of an OData service.
+
+## Installation
+
+```
+npm install --save-dev @odata2ts/odata2ts
+
+yarn add --dev @odata2ts/odata2ts
+```
+
+## Prerequisites
+
+First download the metadata description file of your OData service.
+
+You just add `/$metadata` to the base path of the service, e.g. https://services.odata.org/V4/Northwind/Northwind.svc/$metadata.
+<br/>Save the XML in an own file, e.g. `src/odata/northwind.xml`.
+
+## Usage
+
+`odata2ts` is the main command which is called via script in package.json, or directly via npx or yarn:
+```
+ // package.json script
+ scripts: {
+   ...
+   "gen-odata": "npm run odata2ts -s src/odata/northwind.xml -o build/northwind"
+ }
+ // then from command line
+ npm run gen-odata
+```
+```
+// directly from command line via npx or yarn
+yarn odata2ts -s src/odata/northwind.xml -o build/northwind 
+```
+These usage examples highlight the minimal configuration which is required for each OData service:
+- source: the downloaded metadata file
+- output: the output directory for the generated files
+
+### Config file: `odata2ts.config.ts`
+Instead of specifying these or other parameters via the command line you can use a config file written in TypeScript.
+It centralizes all configurations and allows for handling multiple OData services:
+```ts
+import { ConfigFileOptions } from "@odata2ts/odata2ts";
+
+const config: ConfigFileOptions = {
+  services: {
+    northwind: {
+      source: "src/odata/northwind.xml",
+      output: "build/northwind",
+    },
+    trippin: {
+      source: "src/odata/trippin.xml",
+      output: "build/trippin",
+    }
+  }
+}
+export default config;
+```
+With this configuration in place, we can now call `odata2ts` without any options.
+Additionally, individual services can be addressed as arguments:
+```
+yarn odata2ts                      // start generation process for all configured services
+yarn odata2ts northwind            // start generation process for one specific service
+yarn odata2ts northwind trippin    // start generation process for multiple services
+```
+
+## Command Line Options
+Options specified on the command line always win over other configuration possibilities.
+
+Options `source` and `output` are required unless the config file is used 
+containing appropriate service definitions.
+
+
+| Option                     | Shorthand | Required | Default         | Description                                                                                                                                      |
+|----------------------------|-----------|:--------:|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------|
+| --source                   | -s        |   (x)    |                 | Specifies the source file, i.e. metadata description                                                                                             |
+| --output                   | -o        |   (x)    |                 | Specifies the output directory                                                                                                                   |
+| --mode                     | -m        |          | "all"           | Allowed are: all, models, qobjects, service                                                                                                      |
+| --emit-mode                | -e        |          | "js_dts"        | Specify what to emit. ALlowed values: ts, js, dts, js_dts                                                                                        |
+| --prettier                 | -p        |          | false           | Use prettier to pretty print the TS result files; only applies when emitMode = ts                                                                |
+| --tsconfig                 | -t        |          | "tsconfig.json" | When compiling TS to JS, the compilerOptions of the specified file are used; only takes effect, when emitMode != ts                              |
+| --allow-renaming           | -r        |          | false           | Allow renaming of model entities and their props by applying naming strategies like camelCase or PascalCase                                      |
+| --disable-auto-managed-key | -n        |          | false           | odata2ts will automatically decide if a key prop is managed on the server side and therefore not editable; here you can turn off this automatism |
+| --debug                    | -d        |          | false           | Add debug information                                                                                                                            |
+| --service-name             | -name     |          |                 | Overwrites the service name found in OData metadata => controls name of main odata service                                                       |
+
+## Configuration File
+
+Create a file at the root of your project (beside package.json) 
+and call it: `odata2ts.config.ts`.
+
+None of the options are required, so here is just an example: 
+```ts
+import { ConfigFileOptions, EmitModes } from "@odata2ts/odata2ts";
+
+const config: ConfigFileOptions = {
+  debug: true,
+  emitMode: EmitModes.ts,
+  prettier: true,
+  converters: ["@odata2ts/v2-to-v4-converter"],
+  services: {
+    northwind: {
+      source: "src/odata/northwind.xml",
+      output: "build/northwind",
+      serviceName: "StrongWind"
+    }
+  }
+}
+export default config;
+```
+As you can see, enums are provided for `emitMode` and the same goes for the `mode` option.
+
+The usage of converters is documented in the [converter-api](../converter-api).
+
+
+### Default Settings vs Base Settings vs Service Settings 
+The [defaultConfig](src/defaultConfig.ts) lists all default values, which are always used.
+
+All settings except the `services` attribute are **base settings**, which will also be used as default settings,
+i.e. on top of the defaultConfig.
+
+All settings starting from the `services` attribute are only valid for a specific service and only applied
+for its generation run. Service specific settings are applied on top of the base settings.
+
+Additionally, CLI options can be used to override base or service settings.
+

package/lib/FactoryFunctionModel.d.ts

@@ -0,0 +1,13 @@
+import { ODataVersions } from "@odata2ts/odata-core";
+import { SourceFile } from "ts-morph";
+import { DataModel } from "./data-model/DataModel";
+import { Schema } from "./data-model/edmx/ODataEdmxModelBase";
+import { NamingHelper } from "./data-model/NamingHelper";
+import { RunOptions } from "./OptionModel";
+export declare type DigestionOptions = Pick<RunOptions, "converters" | "disableAutoManagedKey" | "propertiesByName">;
+/**
+ * Takes an EdmxSchema plus the run options and creates a DataModel.
+ */
+export declare type DigesterFunction<S extends Schema<any, any>> = (schema: S, options: DigestionOptions, namingHelper: NamingHelper) => Promise<DataModel>;
+export declare type GeneratorFunctionOptions = Pick<RunOptions, "skipEditableModels" | "skipIdModels" | "skipOperations">;
+export declare type EntityBasedGeneratorFunction = (dataModel: DataModel, sourceFile: SourceFile, version: ODataVersions, options: GeneratorFunctionOptions, namingHelper: NamingHelper) => void;

package/lib/FactoryFunctionModel.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=FactoryFunctionModel.js.map

package/lib/FactoryFunctionModel.js.map

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

package/lib/NamingModel.d.ts

@@ -0,0 +1,191 @@
+/**
+ * The available naming strategies.
+ */
+import { PartialDeep } from "type-fest";
+export declare enum NamingStrategies {
+    NONE = "",
+    PASCAL_CASE = "pascalCase",
+    CAMEL_CASE = "camelCase",
+    CONSTANT_CASE = "constantCase",
+    SNAKE_CASE = "snakeCase"
+}
+/**
+ * Based on an existing configuration (for example default settings) the user only specifies what needs
+ * to be changed. Hence, all options are completely optional.
+ */
+export interface OverridableNamingOptions extends PartialDeep<NameSettings> {
+}
+/**
+ * The required and optional name settings for the generator.
+ */
+export interface NameSettings {
+    /**
+     * Because multiple artefacts are generated out of the same entity, some name settings are required in order
+     * to differentiate those artefacts. Out-of-the-box odata2ts provides you with sensible default settings,
+     * so that you only need to override those settings you want to change.
+     *
+     * However, sometimes it makes more sense to start from scratch, so that the defaults don't interfere with
+     * your own configuration. In this scenario this switch should be enabled to only have default values for
+     * the required name settings.
+     */
+    minimalDefaults?: boolean;
+    /**
+     * Generation options for models, i.e. interfaces representing entity or complex types.
+     */
+    models: ModelNamingOptions;
+    /**
+     * Generation options for Query Objects.
+     *
+     * By default, prefix = "Q"
+     */
+    queryObjects: QueryObjectNamingOptions;
+    services: ServiceNamingOptions;
+}
+export interface ModelNamingOptions extends NamingStrategyOption, StandardNamingOptions {
+    /**
+     * All generated models are bundled into one file.
+     * This option specifies the formatting of the file name.
+     */
+    fileName: FileNamingStrategyOption & RequiredNamingOptions;
+    /**
+     * Choose a specific strategy to format property names of models: pascal-case, camel-case, etc.
+     * By default, camel-case.
+     */
+    propNamingStrategy?: NamingStrategies;
+    /**
+     * For each model an editable version is generated which represents the model definition for
+     * create, update and patch actions.
+     *
+     * You can override the naming options here.
+     * By default, prefix = "Editable"
+     */
+    editableModels: EntityDerivedNamingOptions;
+    /**
+     * ID models are generated from entity id parameters.
+     *
+     * You can configure the naming options here.
+     * By default, suffix = "Id"
+     */
+    idModels: EntityDerivedNamingOptions;
+    /**
+     * Operation parameter models are generated from function or action signatures.
+     *
+     * You can configure the naming options here.
+     * By default, suffix = "Params"
+     */
+    operationParamModels: EntityDerivedNamingOptions;
+}
+export interface EntityDerivedNamingOptions extends RequiredNamingOptions {
+    applyModelNaming?: boolean;
+}
+export interface QueryObjectNamingOptions extends NamingStrategyOption, RequiredNamingOptions {
+    /**
+     * All generated models are bundled into one file.
+     * This option specifies the formatting of the file name.
+     */
+    fileName: FileNamingStrategyOption & RequiredNamingOptions;
+    /**
+     * Choose a specific strategy to format property names of query objects: pascal-case, camel-case, etc.
+     * By default, camel-case.
+     */
+    propNamingStrategy?: NamingStrategies;
+    idFunctions: RequiredNamingOptions;
+    operations?: OperationNamingOptions;
+}
+export interface OperationNamingOptions extends StandardNamingOptions {
+    /**
+     * Naming options for actions only.
+     * When this configuration is provided, the parent configuration regarding suffix and prefix is ignored.
+     */
+    action?: StandardNamingOptions;
+    /**
+     * Naming options for functions only.
+     * When this configuration is provided, the parent configuration regarding suffix and prefix is ignored.
+     */
+    function?: StandardNamingOptions;
+}
+export interface NamingStrategyOption {
+    /**
+     * Choose a specific strategy to format names: pascal-case, camel-case, etc.
+     * Defaults to pascal-case.
+     */
+    namingStrategy?: NamingStrategies;
+}
+export interface FileNamingStrategyOption {
+    /**
+     * Choose a specific strategy to format names: pascal-case, camel-case, etc.
+     * Defaults to pascal-case.
+     */
+    namingStrategy?: NamingStrategies;
+}
+export interface StandardNamingOptions {
+    /**
+     * Prefix all names, e.g. "I" => "ITest"
+     */
+    prefix?: string;
+    /**
+     * Suffix all names, e.g. "model" => "TestModel"
+     */
+    suffix?: string;
+}
+export interface RequiredNamingOptions extends Required<StandardNamingOptions> {
+}
+/**
+ * Naming options for generated service classes.
+ * These options affect the main service as well as all services generated for each entity, complex and collection type.
+ *
+ * There exists one specialty about services: The file names are not configurable.
+ * File names are determined by the name of their corresponding classes, so that service file name
+ * and service class name always correspond.
+ *
+ * By default, suffix = Service and namingStrategy = PascalCase
+ */
+export interface ServiceNamingOptions extends NamingStrategyOption, RequiredNamingOptions {
+    /**
+     * Controls the naming options for the main odata service.
+     * By default, the base service naming options are applied.
+     * But since this is the main entry point for users, it can be configured individually here.
+     *
+     * By default, applyServiceNaming = true
+     */
+    main?: NamingStrategyOption & StandardNamingOptions & {
+        applyServiceNaming?: boolean;
+    };
+    /**
+     * Name of the service responsible for entity collections.
+     *
+     * By default, suffix = Collection and applyServiceNaming = true
+     */
+    collection: RequiredNamingOptions & {
+        applyServiceNaming?: boolean;
+    };
+    /**
+     * Naming for factory function for EntityServiceResolvers.
+     *
+     * By default, prefix = create, suffix = ServiceResolver
+     * @example createTestEntityServiceResolver
+     */
+    serviceResolverFunction: NamingStrategyOption & RequiredNamingOptions;
+    /**
+     * Naming for getter method. Another related service is returned.
+     *
+     * By default, prefix = "navTo" and namingStrategy = camelCase
+     */
+    relatedServiceGetter: NamingStrategyOption & RequiredNamingOptions;
+    /**
+     * Operations are functions and actions of the OData service and are represented as methods
+     * of the generated service class. This setting controls the naming of the corresponding
+     * function.
+     *
+     * By default, namingStrategy = camelCase
+     */
+    operations?: NamingStrategyOption & OperationNamingOptions;
+    /**
+     * Naming options for private properties of service classes.
+     */
+    privateProps: NamingStrategyOption & RequiredNamingOptions;
+    /**
+     * Naming options for public properties of service classes.
+     */
+    publicProps?: NamingStrategyOption;
+}

package/lib/NamingModel.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NamingStrategies = void 0;
+var NamingStrategies;
+(function (NamingStrategies) {
+    NamingStrategies["NONE"] = "";
+    NamingStrategies["PASCAL_CASE"] = "pascalCase";
+    NamingStrategies["CAMEL_CASE"] = "camelCase";
+    NamingStrategies["CONSTANT_CASE"] = "constantCase";
+    NamingStrategies["SNAKE_CASE"] = "snakeCase";
+})(NamingStrategies = exports.NamingStrategies || (exports.NamingStrategies = {}));
+//# sourceMappingURL=NamingModel.js.map

package/lib/NamingModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamingModel.js","sourceRoot":"","sources":["../src/NamingModel.ts"],"names":[],"mappings":";;;AAKA,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,6BAAS,CAAA;IACT,8CAA0B,CAAA;IAC1B,4CAAwB,CAAA;IACxB,kDAA8B,CAAA;IAC9B,4CAAwB,CAAA;AAC1B,CAAC,EANW,gBAAgB,GAAhB,wBAAgB,KAAhB,wBAAgB,QAM3B"}

package/lib/OptionModel.d.ts

@@ -0,0 +1,208 @@
+import { TypeConverterConfig } from "@odata2ts/converter-runtime";
+import { NameSettings, OverridableNamingOptions } from "./NamingModel";
+/**
+ * Generation mode, by default "all".
+ */
+export declare enum Modes {
+    models = 0,
+    qobjects = 1,
+    service = 2,
+    all = 3
+}
+/**
+ * What kind of stuff to emit: Either raw TS or TS that has been compiled to JS / DTS.
+ */
+export declare enum EmitModes {
+    ts = "ts",
+    js = "js",
+    dts = "dts",
+    js_dts = "js_dts"
+}
+/**
+ * Config options for CLI.
+ */
+export interface CliOptions {
+    /**
+     * The source file to use. Must be an EDMX compliant XML file.
+     *
+     * If not specified, at least one service must be configured in config file.
+     */
+    source?: string;
+    /**
+     * Specifies the output directory for the generated stuff.
+     *
+     *  If not specified, at least one service must be configured in config file.
+     */
+    output?: string;
+    /**
+     * Only generates the specified services.
+     * Relies on an existing config file where these service names are maintained.
+     */
+    services?: Array<string>;
+    /**
+     * Specifies what to generate:
+     * - {@code Modes.models} will only generate TS interfaces
+     * - {@code Modes.qobjects} will generate functional units used in QueryBuilder and for functions and actions
+     * - {@code Modes.service} will generate one main OData service client and one per each entity
+     * - {@code Modes.all} the same as {@code Modes.service}
+     *
+     * QObjects will also generate models, and generating the service client will also generate models and QObjects.
+     * Defaults to {@code Modes.all}
+     */
+    mode?: Modes;
+    /**
+     * Specifies the type of the output files: TypeScript, JS, DTS only, JS with DTS.
+     * Defaults to {@code EmitModes.js_dts}
+     */
+    emitMode?: EmitModes;
+    /**
+     * Uses prettier with your local configuration to pretty print TypeScript files.
+     * Only applies if mode is set to {@code EmitModes.ts}.
+     */
+    prettier?: boolean;
+    /**
+     * When compiling TypeScript to JS, "tsconfig.json" is used by default to add compilerOptions.
+     * This option allows to specify an alternative file.
+     *
+     * Only takes effect, when mode is set to anything else than {@code EmitModes.ts}.
+     */
+    tsconfig?: string;
+    /**
+     * Verbose debugging information.
+     */
+    debug?: boolean;
+    /**
+     * Overrides the service name found in the source file.
+     *
+     * The service name is the basis for all file names and the name of the main OData client service
+     * that serves as entry point for the user.
+     */
+    serviceName?: string;
+    /**
+     * odata2ts will automatically decide if a key prop is managed on the server side.
+     * If managed, the property will not be editable (create, update, patch).
+     * The following rule applies:
+     * If a property is the only key prop of an entity, then the prop is deemed to be managed;
+     * in ony other case the prop is unmanaged.
+     */
+    disableAutoManagedKey?: boolean;
+    /**
+     * By default, odata2ts doesn't change param, operation, property or model names.
+     * The generated models and their properties are named exactly as advertised by the server.
+     *
+     * By allowing odata2ts to change these names, certain predefined formatting strategies are used:
+     * Model / class names are formatted with PascalCase; property, param, and operation names with camelCase.
+     *
+     * The naming configuration allows to control this and other naming related settings.
+     * Note: Even if renaming is disabled, model prefixing / suffing still applies.
+     */
+    allowRenaming?: boolean;
+}
+/**
+ * Available options for the actual generation run.
+ * Every property is required, except the overriding service name.
+ */
+export interface RunOptions extends Required<Omit<ServiceGenerationOptions, "serviceName">> {
+    serviceName?: string;
+    naming: NameSettings;
+}
+/**
+ * Available options for configuration files, i.e. odata2ts.config.ts.
+ */
+export interface ConfigFileOptions extends Omit<CliOptions, "source" | "output" | "services"> {
+    services?: {
+        [serviceName: string]: ServiceGenerationOptions;
+    };
+    /**
+     * Specify which converters to use by their package name, e.g. "@odata2ts/converter-v2-to-v4".
+     * Each converter knows which data type to map.
+     *
+     * To only use specific converters, the object syntax must be used, where supported converters
+     * must be listed by their ids.
+     */
+    converters?: Array<string | TypeConverterConfig>;
+    /**
+     * For each model an editable version is generated which represents the model definition for
+     * create, update and patch actions.
+     *
+     * You can skip the generation altogether, not generating editable model variants,
+     * if the generation mode is {@code Mode.model} or {@code Mode.qobject}.
+     */
+    skipEditableModels?: boolean;
+    /**
+     * ID models are generated from entity id parameters.
+     * The generation for one entity entails one model interface representing the id parameters and
+     * one QId function which allows to format the parameters for URL usage and to parse parameters
+     * from a URL string.
+     *
+     * You can skip the generation altogether, not generating models and QId objects, if the
+     * generation mode is {@code Mode.model} or {@code Mode.qobject}.
+     */
+    skipIdModels?: boolean;
+    /**
+     * Operations are functions and actions of the OData service.
+     * The generation for one operation entails one parameter model interface
+     * and one QFunction / QAction class.
+     *
+     * You can skip the generation altogether, neither generating model nor query object,
+     * if the generation mode is {@code Mode.model} or {@code Mode.qobject}.
+     */
+    skipOperations?: boolean;
+    /**
+     * The naming options regarding the generated artefacts.
+     */
+    naming?: OverridableNamingOptions;
+}
+/**
+ * Custom generation options which are dependent on a specific odata service.
+ */
+export interface ServiceGenerationOptions extends Required<Pick<CliOptions, "source" | "output">>, Omit<ConfigFileOptions, "services"> {
+    /**
+     * Configure generation process for EntityTypes and ComplexTypes including their properties.
+     */
+    /**
+     * Configure generation process for individual properties based on their name.
+     */
+    propertiesByName?: Array<PropertyGenerationOptions>;
+}
+/**
+ * Configuration options for EntityTypes and ComplexTypes.
+ * This config applies if the name matches the name of an EntityType or ComplexType as it is specified
+ * in the metadata (e.g. in EDMX <EntityType name="Test" ....)
+ */
+export interface EntityGenerationOptions {
+    /**
+     * Name of the EntityType or ComplexType, e.g. "Person".
+     * Must match exactly or can be a regular expression.
+     */
+    name: string | RegExp;
+    /**
+     * Use a different name.
+     * If name is a regular expression, mappedName allows to specify captured groups (via $1, $2, ...).
+     */
+    mappedName?: string;
+    /**
+     * Configuration of individual properties.
+     */
+    properties?: Array<PropertyGenerationOptions>;
+}
+/**
+ * All configuration options for properties of models.
+ */
+export interface PropertyGenerationOptions {
+    /**
+     * Name of the property to match.
+     * Must match exactly or can be a regular expression.
+     */
+    name: string | RegExp;
+    /**
+     * Use a different name.
+     * If name is a regular expression, mappedName allows to specify captured groups (via $1, $2, ...).
+     */
+    mappedName?: string;
+    /**
+     * Managed attributes - i.e. managed by the server - cannot be created or updated.
+     * Hence, they are left out of the editable model versions.
+     */
+    managed?: boolean;
+}

package/lib/OptionModel.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmitModes = exports.Modes = void 0;
+/**
+ * Generation mode, by default "all".
+ */
+var Modes;
+(function (Modes) {
+    Modes[Modes["models"] = 0] = "models";
+    Modes[Modes["qobjects"] = 1] = "qobjects";
+    Modes[Modes["service"] = 2] = "service";
+    Modes[Modes["all"] = 3] = "all";
+})(Modes = exports.Modes || (exports.Modes = {}));
+/**
+ * What kind of stuff to emit: Either raw TS or TS that has been compiled to JS / DTS.
+ */
+var EmitModes;
+(function (EmitModes) {
+    EmitModes["ts"] = "ts";
+    EmitModes["js"] = "js";
+    EmitModes["dts"] = "dts";
+    EmitModes["js_dts"] = "js_dts";
+})(EmitModes = exports.EmitModes || (exports.EmitModes = {}));
+//# sourceMappingURL=OptionModel.js.map

package/lib/OptionModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionModel.js","sourceRoot":"","sources":["../src/OptionModel.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,IAAY,KAKX;AALD,WAAY,KAAK;IACf,qCAAM,CAAA;IACN,yCAAQ,CAAA;IACR,uCAAO,CAAA;IACP,+BAAG,CAAA;AACL,CAAC,EALW,KAAK,GAAL,aAAK,KAAL,aAAK,QAKhB;AAED;;GAEG;AACH,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,sBAAS,CAAA;IACT,sBAAS,CAAA;IACT,wBAAW,CAAA;IACX,8BAAiB,CAAA;AACnB,CAAC,EALW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAKpB"}

package/lib/app.d.ts

@@ -0,0 +1,8 @@
+import { ODataEdmxModelBase } from "./data-model/edmx/ODataEdmxModelBase";
+import { RunOptions } from "./OptionModel";
+/**
+ *
+ * @param metadataJson metadata of a given OData service already parsed as JSON
+ * @param options further options
+ */
+export declare function runApp(metadataJson: ODataEdmxModelBase<any>, options: RunOptions): Promise<void>;

package/lib/app.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runApp = void 0;
+const tslib_1 = require("tslib");
+const odata_core_1 = require("@odata2ts/odata-core");
+const DataModelDigestionV2_1 = require("./data-model/DataModelDigestionV2");
+const DataModelDigestionV4_1 = require("./data-model/DataModelDigestionV4");
+const NamingHelper_1 = require("./data-model/NamingHelper");
+const generator_1 = require("./generator");
+const OptionModel_1 = require("./OptionModel");
+const ProjectManager_1 = require("./project/ProjectManager");
+function isQObjectGen(mode) {
+    return [OptionModel_1.Modes.qobjects, OptionModel_1.Modes.service, OptionModel_1.Modes.all].includes(mode);
+}
+function isServiceGen(mode) {
+    return [OptionModel_1.Modes.service, OptionModel_1.Modes.all].includes(mode);
+}
+/**
+ *
+ * @param metadataJson metadata of a given OData service already parsed as JSON
+ * @param options further options
+ */
+function runApp(metadataJson, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        // determine edmx edmxVersion attribute
+        const edmxVersion = metadataJson["edmx:Edmx"].$.Version;
+        const version = edmxVersion === "1.0" ? odata_core_1.ODataVersions.V2 : odata_core_1.ODataVersions.V4;
+        const dataService = metadataJson["edmx:Edmx"]["edmx:DataServices"][0];
+        // handling multiple schemas => merge them
+        // TODO only necessary for NorthwindModel => other use cases?
+        const schemaRaw = dataService.Schema.reduce((collector, schema) => (Object.assign(Object.assign({}, schema), collector)), {});
+        // encapsulate the whole naming logic
+        const namingHelper = new NamingHelper_1.NamingHelper(options, schemaRaw.$.Namespace, options.serviceName);
+        // parse model information from edmx into something we can really work with
+        // => that stuff is called dataModel!
+        const dataModel = version === odata_core_1.ODataVersions.V2
+            ? yield (0, DataModelDigestionV2_1.digest)(schemaRaw, options, namingHelper)
+            : yield (0, DataModelDigestionV4_1.digest)(schemaRaw, options, namingHelper);
+        // handling the overall generation project
+        const project = yield (0, ProjectManager_1.createProjectManager)(namingHelper.getFileNames(), options.output, options.emitMode, options.prettier, options.tsconfig);
+        // Generate Model Interfaces
+        // supported edmx types: EntityType, ComplexType, EnumType
+        const modelsFile = yield project.createModelFile();
+        (0, generator_1.generateModels)(dataModel, modelsFile, version, options, namingHelper);
+        // Generate Query Objects
+        // supported edmx types: EntityType, ComplexType
+        // supported edmx prop types: primitive types, enum types, primitive collection (incl enum types), entity collection, entity object, complex object
+        if (isQObjectGen(options.mode)) {
+            const qFile = yield project.createQObjectFile();
+            (0, generator_1.generateQueryObjects)(dataModel, qFile, version, options, namingHelper);
+        }
+        // Generate Individual OData-Service
+        if (isServiceGen(options.mode)) {
+            yield project.cleanServiceDir();
+            yield (0, generator_1.generateServices)(dataModel, project, version, namingHelper);
+        }
+        yield project.writeFiles();
+    });
+}
+exports.runApp = runApp;
+//# sourceMappingURL=app.js.map

package/lib/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":";;;;AAAA,qDAAqD;AAErD,4EAAuE;AACvE,4EAAuE;AAIvE,4DAAyD;AACzD,2CAAqF;AACrF,+CAAkD;AAClD,6DAAgE;AAEhE,SAAS,YAAY,CAAC,IAAW;IAC/B,OAAO,CAAC,mBAAK,CAAC,QAAQ,EAAE,mBAAK,CAAC,OAAO,EAAE,mBAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,IAAW;IAC/B,OAAO,CAAC,mBAAK,CAAC,OAAO,EAAE,mBAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAsB,MAAM,CAAC,YAAqC,EAAE,OAAmB;;QACrF,uCAAuC;QACvC,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACxD,MAAM,OAAO,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,0BAAa,CAAC,EAAE,CAAC,CAAC,CAAC,0BAAa,CAAC,EAAE,CAAC;QAE5E,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtE,0CAA0C;QAC1C,6DAA6D;QAC7D,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CACzC,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,iCAClB,MAAM,GACN,SAAS,EACZ,EACF,EAAsB,CACvB,CAAC;QAEF,qCAAqC;QACrC,MAAM,YAAY,GAAG,IAAI,2BAAY,CAAC,OAAO,EAAG,SAAsB,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QACzG,2EAA2E;QAC3E,qCAAqC;QACrC,MAAM,SAAS,GACb,OAAO,KAAK,0BAAa,CAAC,EAAE;YAC1B,CAAC,CAAC,MAAM,IAAA,6BAAQ,EAAC,SAAqB,EAAE,OAAO,EAAE,YAAY,CAAC;YAC9D,CAAC,CAAC,MAAM,IAAA,6BAAQ,EAAC,SAAqB,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QACnE,0CAA0C;QAC1C,MAAM,OAAO,GAAG,MAAM,IAAA,qCAAoB,EACxC,YAAY,CAAC,YAAY,EAAE,EAC3B,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,QAAQ,CACjB,CAAC;QAEF,4BAA4B;QAC5B,0DAA0D;QAC1D,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;QACnD,IAAA,0BAAc,EAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAEtE,yBAAyB;QACzB,gDAAgD;QAChD,mJAAmJ;QACnJ,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAChD,IAAA,gCAAoB,EAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;SACxE;QAED,oCAAoC;QACpC,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAC9B,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;YAChC,MAAM,IAAA,4BAAgB,EAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;SACnE;QAED,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;CAAA;AAtDD,wBAsDC"}