rastack 0.0.16 → 0.0.19

package/src/schema-entities.ts

@@ -1,401 +1,401 @@
-import { mkdirSync, writeFileSync } from "fs";
-import { join } from "path";
-import {
-  OperationObject,
-  ParameterObject,
-  PathsObject,
-  RequestBodyObject,
-} from "@ts-stack/openapi-spec";
-import { extractResponseBodySchema } from "./schema/extract-response";
-import { fetchSchema } from "./schema/fetch-schema";
-import { removeNonModelPaths } from "./schema/remove-non-model-paths";
-import { camelToPastel } from "./schema/camel-to-pastel";
-import { generateGetAPIMethod } from "./entity-generation/get-method";
-import { generateUpdateAPIMethod } from "./entity-generation/update-method";
-import {
-  generateFolderImports,
-  generateImportStatements,
-  generateIndexImports,
-  generateKeyImports,
-} from "./entity-generation/imports";
-import { generateUpdateFormMethod } from "./entity-generation/form";
-import { generateDeleteAPIMethod } from "./entity-generation/delete-method";
-import {
-  EntitySyncMeta,
-  generateConfirmedMethod,
-  generateEntityDescriptor,
-  generateSyncDeleteMethod,
-  generateSyncListMethod,
-  generateSyncRecordMethod,
-  generateSyncUpdateMethod,
-} from "./entity-generation/sync-method";
-import { toCamelCase } from "./schema/to-camel-case";
-
-function pathSegments(pathKey: string): string[] {
-  return pathKey.replace(/\/$/, "").split("/");
-}
-
-/**
- * Pre-pass over the OpenAPI paths: collects, per entity, the sync mode
- * (from rastack's `x-rastack-sync` vendor extension), confirmed operations,
- * the list/detail URLs, the row schema, and the list/detail operation ids
- * (used to wire cache invalidation for non-sync entities).
- */
-export function collectEntityMeta(paths: PathsObject): {
-  [indexKey: string]: EntitySyncMeta;
-} {
-  const meta: { [indexKey: string]: EntitySyncMeta } = {};
-
-  Object.keys(paths).forEach((pathKey) => {
-    const appName = pathKey.split("/")[2];
-    const modelName = pathKey.split("/")[4];
-    const indexKey = `${appName}|${modelName}`;
-    if (!meta[indexKey]) {
-      meta[indexKey] = { sync: false, confirmedOperationIds: new Set() };
-    }
-    const entityMeta = meta[indexKey];
-
-    const segments = pathSegments(pathKey);
-    const isListPath = segments.length === 5;
-    const isDetailPath = segments.length === 6 && segments[5].startsWith("{");
-    if (isListPath) {
-      entityMeta.listUrl = pathKey;
-    }
-    if (isDetailPath) {
-      entityMeta.detailUrl = pathKey;
-      entityMeta.detailParam = segments[5].slice(1, -1);
-    }
-
-    Object.keys(paths[pathKey]).forEach((method) => {
-      // @ts-ignore
-      const operation = paths[pathKey][method] as OperationObject;
-      const syncExtension = (operation as any)["x-rastack-sync"];
-      if (syncExtension === "local" || syncExtension === "confirmed") {
-        entityMeta.sync = true;
-      }
-      if ((operation as any)["x-rastack-sync-load"] === "lazy") {
-        entityMeta.lazy = true;
-      }
-      if ((operation as any)["x-rastack-sync-client-ids"] === true) {
-        entityMeta.clientIds = true;
-      }
-      if (syncExtension === "confirmed" && operation.operationId) {
-        entityMeta.confirmedOperationIds.add(operation.operationId as string);
-      }
-
-      const [responseBodySchema, isList] =
-        extractResponseBodySchema(operation);
-      const operationId = (operation.operationId as string) || "";
-      const isPostList =
-        method === "post" &&
-        (operationId.includes("List") || operationId.includes("list"));
-
-      if (method === "get" || isPostList) {
-        if (isList || isPostList) {
-          if (isListPath && !entityMeta.listOperationId) {
-            entityMeta.listOperationId = operationId;
-          }
-        } else if (isDetailPath && !entityMeta.detailOperationId) {
-          entityMeta.detailOperationId = operationId;
-        }
-        if (responseBodySchema && !entityMeta.rowSchema) {
-          entityMeta.rowSchema = `I${responseBodySchema}`;
-        }
-      }
-    });
-  });
-
-  return meta;
-}
-
-export async function generateFolders(
-  entitiesPath: string,
-  paths: PathsObject,
-): Promise<void> {
-  Object.keys(paths).forEach((key) => {
-    const appName = key.split("/")[2];
-    const modelName = key.split("/")[4];
-    const appFolder = join(entitiesPath, appName);
-    const modelFolder = join(appFolder, modelName);
-
-    mkdirSync(appFolder, { recursive: true });
-    mkdirSync(modelFolder, { recursive: true });
-  });
-}
-
-export async function generateFiles(
-  entitiesPath: string,
-  paths: PathsObject,
-): Promise<void> {
-  const uniqueOperationNames: string[] = [];
-  const modelFileImports: { [key: string]: Set<string> } = {};
-  const modelFileData: { [key: string]: string } = {};
-  const keysFileData: { [key: string]: string[] } = {};
-  const modelImportsFileData: { [key: string]: string[] } = {};
-  const formMutationOperations: { [key: string]: any } = {};
-  const entityMeta = collectEntityMeta(paths);
-
-  Object.keys(paths).forEach((pathKey) => {
-    const appName = pathKey.split("/")[2];
-    const modelName = pathKey.split("/")[4];
-
-    const indexKey = `${appName}|${modelName}`;
-    if (!formMutationOperations[indexKey]) {
-      formMutationOperations[indexKey] = {
-        post: {
-          operationId: undefined,
-          schema: undefined,
-        },
-        put: {
-          operationId: undefined,
-          schema: undefined,
-        },
-        patch: {
-          operationId: undefined,
-          schema: undefined,
-        },
-      };
-    }
-    if (!modelImportsFileData[appName]) {
-      modelImportsFileData[appName] = [modelName];
-    } else {
-      if (!modelImportsFileData[appName].includes(modelName)) {
-        modelImportsFileData[appName].push(modelName);
-      }
-    }
-
-    Object.keys(paths[pathKey]).forEach((method) => {
-      // @ts-ignore
-      const methodInformation = paths[pathKey][method] as OperationObject;
-
-      const methodParameters =
-        methodInformation.parameters as ParameterObject[];
-      const pathParameters = methodParameters
-        ? methodParameters
-            .filter((item) => item.required)
-            .filter((item) => item.in === "path")
-            .map((item) => item.name)
-        : [];
-
-      const requestBody = methodInformation.requestBody as RequestBodyObject;
-      // @ts-ignore
-      const requestBodySchema = requestBody?.content?.[
-        "application/json"
-      ]?.schema["$ref"]?.replace("#/components/schemas/", "");
-
-      let [responseBodySchema, isList] =
-        extractResponseBodySchema(methodInformation);
-
-      const requiredParameters = methodParameters
-        ? methodParameters
-            .filter((item) => item.required)
-            .map((item) => item.name)
-        : [];
-
-      const operationId = methodInformation.operationId as string;
-
-      if (!uniqueOperationNames.includes(operationId)) {
-        uniqueOperationNames.push(operationId);
-
-        let apiMethods = "";
-        let importStatements = new Set<string>();
-
-        const isPostListEndpoint =
-          method === "post" &&
-          (operationId.includes("List") || operationId.includes("list"));
-        const isListEndpoint = isList || isPostListEndpoint;
-
-        const meta = entityMeta[indexKey];
-        const isSyncEntity = meta?.sync === true;
-        const isConfirmedOperation =
-          (methodInformation as any)["x-rastack-sync"] === "confirmed" &&
-          method !== "get";
-        const modelCamel = toCamelCase(modelName);
-        const listKeyRef = meta?.listOperationId
-          ? `${modelCamel}QueriesKeys.${meta.listOperationId}`
-          : undefined;
-        const itemKeyRef = meta?.detailOperationId
-          ? `${modelCamel}QueriesKeys.${meta.detailOperationId}`
-          : undefined;
-
-        if (isConfirmedOperation) {
-          [apiMethods, importStatements] = generateConfirmedMethod(
-            pathKey,
-            method,
-            operationId,
-            requestBodySchema ? `I${requestBodySchema}` : undefined,
-            responseBodySchema ? `I${responseBodySchema}` : undefined,
-          );
-
-          formMutationOperations[indexKey] = {
-            ...formMutationOperations[indexKey],
-            [pathKey]: {
-              [method]: {
-                operationId: camelToPastel(operationId),
-                schema: requestBodySchema ? `I${requestBodySchema}` : "",
-              },
-            },
-          };
-        } else if (method === "get" || isPostListEndpoint) {
-          if (isSyncEntity && isListEndpoint) {
-            [apiMethods, importStatements] = generateSyncListMethod(
-              modelName,
-              operationId,
-              meta.rowSchema,
-            );
-          } else if (isSyncEntity && pathKey.includes("{")) {
-            const urlParams =
-              pathKey.match(/{([^}]+)}/g)?.map((param) => param.slice(1, -1)) ||
-              [];
-            [apiMethods, importStatements] = generateSyncRecordMethod(
-              modelName,
-              operationId,
-              meta.rowSchema,
-              pathParameters.length > 0 ? pathParameters : urlParams,
-            );
-          } else {
-            [apiMethods, importStatements] = generateGetAPIMethod(
-              pathKey,
-              modelName,
-              operationId,
-              responseBodySchema ? `I${responseBodySchema}` : undefined,
-              isListEndpoint,
-              pathParameters,
-              requiredParameters,
-              method,
-              requestBodySchema !== undefined ? requestBodySchema : "",
-            );
-          }
-        } else if (
-          method === "post" ||
-          method === "put" ||
-          method === "patch"
-        ) {
-          if (isSyncEntity) {
-            [apiMethods, importStatements] = generateSyncUpdateMethod(
-              pathKey,
-              method,
-              modelName,
-              operationId,
-              requestBodySchema ? `I${requestBodySchema}` : undefined,
-              responseBodySchema ? `I${responseBodySchema}` : undefined,
-              pathParameters,
-            );
-          } else {
-            [apiMethods, importStatements] = generateUpdateAPIMethod(
-              pathKey,
-              method,
-              operationId,
-              requestBodySchema ? `I${requestBodySchema}` : undefined,
-              responseBodySchema ? `I${responseBodySchema}` : undefined,
-              listKeyRef,
-              itemKeyRef,
-            );
-          }
-
-          formMutationOperations[indexKey] = {
-            ...formMutationOperations[indexKey],
-            [pathKey]: {
-              [method]: {
-                operationId: camelToPastel(operationId),
-                schema: requestBodySchema ? `I${requestBodySchema}` : "",
-              },
-            },
-          };
-        } else if (method === "delete") {
-          if (isSyncEntity) {
-            [apiMethods, importStatements] = generateSyncDeleteMethod(
-              pathKey,
-              modelName,
-              operationId,
-            );
-          } else {
-            [apiMethods, importStatements] = generateDeleteAPIMethod(
-              pathKey,
-              operationId,
-              listKeyRef,
-            );
-          }
-        }
-
-        modelFileData[indexKey] = (modelFileData[indexKey] || "") + apiMethods;
-        modelFileImports[indexKey] = new Set([
-          ...(modelFileImports[indexKey] || []),
-          ...importStatements,
-        ]);
-        keysFileData[indexKey] = [
-          ...(keysFileData[indexKey] || []),
-          operationId,
-        ];
-      }
-    });
-  });
-
-  Object.keys(modelFileData).forEach((key) => {
-    const [appName, modelName] = key.split("|");
-    const modelFolder = join(entitiesPath, appName, modelName);
-    const apiFile = join(modelFolder, "api.ts");
-    const indexFile = join(modelFolder, "index.ts");
-    const keyImports = generateKeyImports(modelName, keysFileData[key]);
-
-    const [updateFormMethod, importStatements] = generateUpdateFormMethod(
-      appName,
-      modelName,
-      formMutationOperations[key],
-    );
-    const indexKey = `${appName}|${modelName}`;
-    modelFileImports[indexKey] = new Set([
-      ...(modelFileImports[indexKey] || []),
-      ...importStatements,
-    ]);
-
-    let entityDescriptor = "";
-    if (entityMeta[key]?.sync) {
-      const [descriptorCode, descriptorImports] = generateEntityDescriptor(
-        appName,
-        modelName,
-        entityMeta[key],
-      );
-      entityDescriptor = descriptorCode;
-      modelFileImports[indexKey] = new Set([
-        ...(modelFileImports[indexKey] || []),
-        ...descriptorImports,
-      ]);
-    }
-
-    const importData = generateImportStatements(
-      modelFileImports[key],
-      modelName,
-    );
-
-    const apiFileText = `${importData}\n${keyImports}\n${entityDescriptor}${modelFileData[key]}\n${updateFormMethod}`;
-    const indexImports = generateIndexImports(modelName, keysFileData[key]);
-
-    writeFileSync(apiFile, apiFileText, { flag: "w" });
-    writeFileSync(indexFile, indexImports, { flag: "w" });
-  });
-
-  // create an index file with all the file names per model
-  Object.keys(modelImportsFileData).forEach((key) => {
-    const modelFolder = join(entitiesPath, key);
-    const indexFile = join(modelFolder, "index.ts");
-
-    const indexImports = generateFolderImports(modelImportsFileData[key]);
-    writeFileSync(indexFile, indexImports, { flag: "w" });
-  });
-}
-
-export async function main(url: string, entitiesPath: string): Promise<void> {
-  console.log("Generating Entities");
-  const data = await fetchSchema(url);
-  const filteredPaths = removeNonModelPaths(data.paths);
-  await generateFolders(entitiesPath, filteredPaths);
-  await generateFiles(entitiesPath, filteredPaths);
-}
-
-if (require.main === module) {
-  const args: string[] = process.argv.slice(2);
-  const url = args[0];
-  const entitiesPath = args[1];
-  main(url, entitiesPath);
-}
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import {
+  OperationObject,
+  ParameterObject,
+  PathsObject,
+  RequestBodyObject,
+} from "@ts-stack/openapi-spec";
+import { extractResponseBodySchema } from "./schema/extract-response";
+import { fetchSchema } from "./schema/fetch-schema";
+import { removeNonModelPaths } from "./schema/remove-non-model-paths";
+import { camelToPastel } from "./schema/camel-to-pastel";
+import { generateGetAPIMethod } from "./entity-generation/get-method";
+import { generateUpdateAPIMethod } from "./entity-generation/update-method";
+import {
+  generateFolderImports,
+  generateImportStatements,
+  generateIndexImports,
+  generateKeyImports,
+} from "./entity-generation/imports";
+import { generateUpdateFormMethod } from "./entity-generation/form";
+import { generateDeleteAPIMethod } from "./entity-generation/delete-method";
+import {
+  EntitySyncMeta,
+  generateConfirmedMethod,
+  generateEntityDescriptor,
+  generateSyncDeleteMethod,
+  generateSyncListMethod,
+  generateSyncRecordMethod,
+  generateSyncUpdateMethod,
+} from "./entity-generation/sync-method";
+import { toCamelCase } from "./schema/to-camel-case";
+
+function pathSegments(pathKey: string): string[] {
+  return pathKey.replace(/\/$/, "").split("/");
+}
+
+/**
+ * Pre-pass over the OpenAPI paths: collects, per entity, the sync mode
+ * (from rastack's `x-rastack-sync` vendor extension), confirmed operations,
+ * the list/detail URLs, the row schema, and the list/detail operation ids
+ * (used to wire cache invalidation for non-sync entities).
+ */
+export function collectEntityMeta(paths: PathsObject): {
+  [indexKey: string]: EntitySyncMeta;
+} {
+  const meta: { [indexKey: string]: EntitySyncMeta } = {};
+
+  Object.keys(paths).forEach((pathKey) => {
+    const appName = pathKey.split("/")[2];
+    const modelName = pathKey.split("/")[4];
+    const indexKey = `${appName}|${modelName}`;
+    if (!meta[indexKey]) {
+      meta[indexKey] = { sync: false, confirmedOperationIds: new Set() };
+    }
+    const entityMeta = meta[indexKey];
+
+    const segments = pathSegments(pathKey);
+    const isListPath = segments.length === 5;
+    const isDetailPath = segments.length === 6 && segments[5].startsWith("{");
+    if (isListPath) {
+      entityMeta.listUrl = pathKey;
+    }
+    if (isDetailPath) {
+      entityMeta.detailUrl = pathKey;
+      entityMeta.detailParam = segments[5].slice(1, -1);
+    }
+
+    Object.keys(paths[pathKey]).forEach((method) => {
+      // @ts-ignore
+      const operation = paths[pathKey][method] as OperationObject;
+      const syncExtension = (operation as any)["x-rastack-sync"];
+      if (syncExtension === "local" || syncExtension === "confirmed") {
+        entityMeta.sync = true;
+      }
+      if ((operation as any)["x-rastack-sync-load"] === "lazy") {
+        entityMeta.lazy = true;
+      }
+      if ((operation as any)["x-rastack-sync-client-ids"] === true) {
+        entityMeta.clientIds = true;
+      }
+      if (syncExtension === "confirmed" && operation.operationId) {
+        entityMeta.confirmedOperationIds.add(operation.operationId as string);
+      }
+
+      const [responseBodySchema, isList] =
+        extractResponseBodySchema(operation);
+      const operationId = (operation.operationId as string) || "";
+      const isPostList =
+        method === "post" &&
+        (operationId.includes("List") || operationId.includes("list"));
+
+      if (method === "get" || isPostList) {
+        if (isList || isPostList) {
+          if (isListPath && !entityMeta.listOperationId) {
+            entityMeta.listOperationId = operationId;
+          }
+        } else if (isDetailPath && !entityMeta.detailOperationId) {
+          entityMeta.detailOperationId = operationId;
+        }
+        if (responseBodySchema && !entityMeta.rowSchema) {
+          entityMeta.rowSchema = `I${responseBodySchema}`;
+        }
+      }
+    });
+  });
+
+  return meta;
+}
+
+export async function generateFolders(
+  entitiesPath: string,
+  paths: PathsObject,
+): Promise<void> {
+  Object.keys(paths).forEach((key) => {
+    const appName = key.split("/")[2];
+    const modelName = key.split("/")[4];
+    const appFolder = join(entitiesPath, appName);
+    const modelFolder = join(appFolder, modelName);
+
+    mkdirSync(appFolder, { recursive: true });
+    mkdirSync(modelFolder, { recursive: true });
+  });
+}
+
+export async function generateFiles(
+  entitiesPath: string,
+  paths: PathsObject,
+): Promise<void> {
+  const uniqueOperationNames: string[] = [];
+  const modelFileImports: { [key: string]: Set<string> } = {};
+  const modelFileData: { [key: string]: string } = {};
+  const keysFileData: { [key: string]: string[] } = {};
+  const modelImportsFileData: { [key: string]: string[] } = {};
+  const formMutationOperations: { [key: string]: any } = {};
+  const entityMeta = collectEntityMeta(paths);
+
+  Object.keys(paths).forEach((pathKey) => {
+    const appName = pathKey.split("/")[2];
+    const modelName = pathKey.split("/")[4];
+
+    const indexKey = `${appName}|${modelName}`;
+    if (!formMutationOperations[indexKey]) {
+      formMutationOperations[indexKey] = {
+        post: {
+          operationId: undefined,
+          schema: undefined,
+        },
+        put: {
+          operationId: undefined,
+          schema: undefined,
+        },
+        patch: {
+          operationId: undefined,
+          schema: undefined,
+        },
+      };
+    }
+    if (!modelImportsFileData[appName]) {
+      modelImportsFileData[appName] = [modelName];
+    } else {
+      if (!modelImportsFileData[appName].includes(modelName)) {
+        modelImportsFileData[appName].push(modelName);
+      }
+    }
+
+    Object.keys(paths[pathKey]).forEach((method) => {
+      // @ts-ignore
+      const methodInformation = paths[pathKey][method] as OperationObject;
+
+      const methodParameters =
+        methodInformation.parameters as ParameterObject[];
+      const pathParameters = methodParameters
+        ? methodParameters
+            .filter((item) => item.required)
+            .filter((item) => item.in === "path")
+            .map((item) => item.name)
+        : [];
+
+      const requestBody = methodInformation.requestBody as RequestBodyObject;
+      // @ts-ignore
+      const requestBodySchema = requestBody?.content?.[
+        "application/json"
+      ]?.schema["$ref"]?.replace("#/components/schemas/", "");
+
+      let [responseBodySchema, isList] =
+        extractResponseBodySchema(methodInformation);
+
+      const requiredParameters = methodParameters
+        ? methodParameters
+            .filter((item) => item.required)
+            .map((item) => item.name)
+        : [];
+
+      const operationId = methodInformation.operationId as string;
+
+      if (!uniqueOperationNames.includes(operationId)) {
+        uniqueOperationNames.push(operationId);
+
+        let apiMethods = "";
+        let importStatements = new Set<string>();
+
+        const isPostListEndpoint =
+          method === "post" &&
+          (operationId.includes("List") || operationId.includes("list"));
+        const isListEndpoint = isList || isPostListEndpoint;
+
+        const meta = entityMeta[indexKey];
+        const isSyncEntity = meta?.sync === true;
+        const isConfirmedOperation =
+          (methodInformation as any)["x-rastack-sync"] === "confirmed" &&
+          method !== "get";
+        const modelCamel = toCamelCase(modelName);
+        const listKeyRef = meta?.listOperationId
+          ? `${modelCamel}QueriesKeys.${meta.listOperationId}`
+          : undefined;
+        const itemKeyRef = meta?.detailOperationId
+          ? `${modelCamel}QueriesKeys.${meta.detailOperationId}`
+          : undefined;
+
+        if (isConfirmedOperation) {
+          [apiMethods, importStatements] = generateConfirmedMethod(
+            pathKey,
+            method,
+            operationId,
+            requestBodySchema ? `I${requestBodySchema}` : undefined,
+            responseBodySchema ? `I${responseBodySchema}` : undefined,
+          );
+
+          formMutationOperations[indexKey] = {
+            ...formMutationOperations[indexKey],
+            [pathKey]: {
+              [method]: {
+                operationId: camelToPastel(operationId),
+                schema: requestBodySchema ? `I${requestBodySchema}` : "",
+              },
+            },
+          };
+        } else if (method === "get" || isPostListEndpoint) {
+          if (isSyncEntity && isListEndpoint) {
+            [apiMethods, importStatements] = generateSyncListMethod(
+              modelName,
+              operationId,
+              meta.rowSchema,
+            );
+          } else if (isSyncEntity && pathKey.includes("{")) {
+            const urlParams =
+              pathKey.match(/{([^}]+)}/g)?.map((param) => param.slice(1, -1)) ||
+              [];
+            [apiMethods, importStatements] = generateSyncRecordMethod(
+              modelName,
+              operationId,
+              meta.rowSchema,
+              pathParameters.length > 0 ? pathParameters : urlParams,
+            );
+          } else {
+            [apiMethods, importStatements] = generateGetAPIMethod(
+              pathKey,
+              modelName,
+              operationId,
+              responseBodySchema ? `I${responseBodySchema}` : undefined,
+              isListEndpoint,
+              pathParameters,
+              requiredParameters,
+              method,
+              requestBodySchema !== undefined ? requestBodySchema : "",
+            );
+          }
+        } else if (
+          method === "post" ||
+          method === "put" ||
+          method === "patch"
+        ) {
+          if (isSyncEntity) {
+            [apiMethods, importStatements] = generateSyncUpdateMethod(
+              pathKey,
+              method,
+              modelName,
+              operationId,
+              requestBodySchema ? `I${requestBodySchema}` : undefined,
+              responseBodySchema ? `I${responseBodySchema}` : undefined,
+              pathParameters,
+            );
+          } else {
+            [apiMethods, importStatements] = generateUpdateAPIMethod(
+              pathKey,
+              method,
+              operationId,
+              requestBodySchema ? `I${requestBodySchema}` : undefined,
+              responseBodySchema ? `I${responseBodySchema}` : undefined,
+              listKeyRef,
+              itemKeyRef,
+            );
+          }
+
+          formMutationOperations[indexKey] = {
+            ...formMutationOperations[indexKey],
+            [pathKey]: {
+              [method]: {
+                operationId: camelToPastel(operationId),
+                schema: requestBodySchema ? `I${requestBodySchema}` : "",
+              },
+            },
+          };
+        } else if (method === "delete") {
+          if (isSyncEntity) {
+            [apiMethods, importStatements] = generateSyncDeleteMethod(
+              pathKey,
+              modelName,
+              operationId,
+            );
+          } else {
+            [apiMethods, importStatements] = generateDeleteAPIMethod(
+              pathKey,
+              operationId,
+              listKeyRef,
+            );
+          }
+        }
+
+        modelFileData[indexKey] = (modelFileData[indexKey] || "") + apiMethods;
+        modelFileImports[indexKey] = new Set([
+          ...(modelFileImports[indexKey] || []),
+          ...importStatements,
+        ]);
+        keysFileData[indexKey] = [
+          ...(keysFileData[indexKey] || []),
+          operationId,
+        ];
+      }
+    });
+  });
+
+  Object.keys(modelFileData).forEach((key) => {
+    const [appName, modelName] = key.split("|");
+    const modelFolder = join(entitiesPath, appName, modelName);
+    const apiFile = join(modelFolder, "api.ts");
+    const indexFile = join(modelFolder, "index.ts");
+    const keyImports = generateKeyImports(modelName, keysFileData[key]);
+
+    const [updateFormMethod, importStatements] = generateUpdateFormMethod(
+      appName,
+      modelName,
+      formMutationOperations[key],
+    );
+    const indexKey = `${appName}|${modelName}`;
+    modelFileImports[indexKey] = new Set([
+      ...(modelFileImports[indexKey] || []),
+      ...importStatements,
+    ]);
+
+    let entityDescriptor = "";
+    if (entityMeta[key]?.sync) {
+      const [descriptorCode, descriptorImports] = generateEntityDescriptor(
+        appName,
+        modelName,
+        entityMeta[key],
+      );
+      entityDescriptor = descriptorCode;
+      modelFileImports[indexKey] = new Set([
+        ...(modelFileImports[indexKey] || []),
+        ...descriptorImports,
+      ]);
+    }
+
+    const importData = generateImportStatements(
+      modelFileImports[key],
+      modelName,
+    );
+
+    const apiFileText = `${importData}\n${keyImports}\n${entityDescriptor}${modelFileData[key]}\n${updateFormMethod}`;
+    const indexImports = generateIndexImports(modelName, keysFileData[key]);
+
+    writeFileSync(apiFile, apiFileText, { flag: "w" });
+    writeFileSync(indexFile, indexImports, { flag: "w" });
+  });
+
+  // create an index file with all the file names per model
+  Object.keys(modelImportsFileData).forEach((key) => {
+    const modelFolder = join(entitiesPath, key);
+    const indexFile = join(modelFolder, "index.ts");
+
+    const indexImports = generateFolderImports(modelImportsFileData[key]);
+    writeFileSync(indexFile, indexImports, { flag: "w" });
+  });
+}
+
+export async function main(url: string, entitiesPath: string): Promise<void> {
+  console.log("Generating Entities");
+  const data = await fetchSchema(url);
+  const filteredPaths = removeNonModelPaths(data.paths);
+  await generateFolders(entitiesPath, filteredPaths);
+  await generateFiles(entitiesPath, filteredPaths);
+}
+
+if (require.main === module) {
+  const args: string[] = process.argv.slice(2);
+  const url = args[0];
+  const entitiesPath = args[1];
+  main(url, entitiesPath);
+}