@odata-effect/odata-effect-generator 0.1.2 → 0.2.0

package/src/Cli.ts

@@ -39,17 +39,22 @@ const force = Options.boolean("force").pipe(
   Options.withDescription("Overwrite existing files")
 )
 
+const filesOnly = Options.boolean("files-only").pipe(
+  Options.withDefault(false),
+  Options.withDescription("Generate only source files (no package.json, tsconfig, etc.) directly in output-dir")
+)
+
 // ============================================================================
 // Generate Command
 // ============================================================================
 
 const generateCommand = Command.make(
   "generate",
-  { metadataPath, outputDir, serviceName, packageName, force }
+  { metadataPath, outputDir, serviceName, packageName, force, filesOnly }
 ).pipe(
   Command.withDescription("Generate Effect OData client from metadata"),
   Command.withHandler((
-    { force: forceOverwrite, metadataPath: metaPath, outputDir: outDir, packageName: pkgName, serviceName: svcName }
+    { force: forceOverwrite, metadataPath: metaPath, outputDir: outDir, packageName: pkgName, serviceName: svcName, filesOnly: onlyFiles }
   ) =>
     Effect.gen(function*() {
       const fs = yield* FileSystem.FileSystem
@@ -85,6 +90,7 @@ const generateCommand = Command.make(
       const config = {
         outputDir: outDir,
         force: forceOverwrite,
+        filesOnly: onlyFiles,
         ...(svcName._tag === "Some" ? { serviceName: svcName.value } : {}),
         ...(pkgName._tag === "Some" ? { packageName: pkgName.value } : {})
       }

package/src/generator/Generator.ts

@@ -10,6 +10,8 @@ import * as Schema from "effect/Schema"
 import type { DataModel } from "../model/DataModel.js"
 import { generateIndex } from "./IndexGenerator.js"
 import { generateModels } from "./ModelsGenerator.js"
+import { generateNavigations } from "./NavigationGenerator.js"
+import { generateOperations } from "./OperationsGenerator.js"
 import {
   generatePackageJson,
   generateTsconfig,
@@ -34,6 +36,8 @@ export interface GeneratorConfig {
   readonly packageName?: string
   readonly serviceName?: string
   readonly force?: boolean
+  /** Generate only source files directly in outputDir (no package.json, tsconfig, src/ subdirectory) */
+  readonly filesOnly?: boolean
 }
 
 /**
@@ -75,6 +79,10 @@ export const generate = (
     const outputDir = config.outputDir
     const serviceName = config.serviceName ?? dataModel.serviceName
     const packageName = config.packageName ?? `@template/${serviceName.toLowerCase()}-effect`
+    const filesOnly = config.filesOnly ?? false
+
+    // When filesOnly is true, output directly to outputDir; otherwise use outputDir/src
+    const sourceDir = filesOnly ? outputDir : path.join(outputDir, "src")
 
     const packageConfig: PackageConfig = {
       packageName,
@@ -87,32 +95,52 @@ export const generate = (
     // Generate Promise-based service function files
     const promiseServiceResult = generatePromiseServiceFns(dataModel)
 
-    // Generate all files
-    const files: Array<GeneratedFile> = [
-      // Source files
+    // Generate operations file (FunctionImports, Functions, Actions)
+    const operationsResult = generateOperations(dataModel)
+
+    // Generate navigation builders
+    const navigationResult = generateNavigations(dataModel)
+
+    // Generate source files
+    const sourceFiles: Array<GeneratedFile> = [
       {
-        path: path.join(outputDir, "src", "Models.ts"),
+        path: path.join(sourceDir, "Models.ts"),
         content: generateModels(dataModel)
       },
       {
-        path: path.join(outputDir, "src", "QueryModels.ts"),
+        path: path.join(sourceDir, "QueryModels.ts"),
         content: generateQueryModels(dataModel)
       },
       // Individual entity service function files (tree-shakable)
       ...serviceResult.entityServices.map((svc) => ({
-        path: path.join(outputDir, "src", svc.fileName),
+        path: path.join(sourceDir, svc.fileName),
         content: svc.content
       })),
       // Promise-based entity service function files
       ...promiseServiceResult.entityServices.map((svc) => ({
-        path: path.join(outputDir, "src", svc.fileName),
+        path: path.join(sourceDir, svc.fileName),
         content: svc.content
       })),
+      // Operations file (only if there are unbound operations)
+      ...(operationsResult.operationsFile
+        ? [{
+            path: path.join(sourceDir, operationsResult.operationsFile.fileName),
+            content: operationsResult.operationsFile.content
+          }]
+        : []),
+      // Navigation builder files
+      ...navigationResult.navigationFiles.map((nav) => ({
+        path: path.join(sourceDir, nav.fileName),
+        content: nav.content
+      })),
       {
-        path: path.join(outputDir, "src", "index.ts"),
+        path: path.join(sourceDir, "index.ts"),
         content: generateIndex(dataModel)
-      },
-      // Package configuration files
+      }
+    ]
+
+    // Package configuration files (only when not filesOnly)
+    const packageFiles: Array<GeneratedFile> = filesOnly ? [] : [
       {
         path: path.join(outputDir, "package.json"),
         content: generatePackageJson(dataModel, packageConfig)
@@ -139,11 +167,13 @@ export const generate = (
       }
     ]
 
-    // Create output directories
-    yield* fs.makeDirectory(path.join(outputDir, "src"), { recursive: true }).pipe(
+    const files = [...sourceFiles, ...packageFiles]
+
+    // Create output directory
+    yield* fs.makeDirectory(sourceDir, { recursive: true }).pipe(
       Effect.mapError((error) =>
         new GeneratorError({
-          message: `Failed to create output directory: ${outputDir}/src`,
+          message: `Failed to create output directory: ${sourceDir}`,
           cause: error
         })
       )

package/src/generator/IndexGenerator.ts

@@ -12,6 +12,8 @@ import {
   getQueryInterfaceName,
   getServiceClassName
 } from "./NamingHelper.js"
+import { getPathBuildersModuleName } from "./NavigationGenerator.js"
+import { getOperationsModuleName } from "./OperationsGenerator.js"
 import { getPromiseServiceName } from "./ServiceFnPromiseGenerator.js"
 
 /**
@@ -63,84 +65,14 @@ export const generateIndex = (dataModel: DataModel): string => {
     lines.push(`  ${modelExports[i]}${isLast ? "" : ","}`)
   }
 
-  lines.push(`} from "./Models.js"`)
-  lines.push(``)
-
-  // Re-export OData infrastructure
-  const isV4 = dataModel.version === "V4"
-  lines.push(`// Re-export OData infrastructure from @odata-effect/odata-effect`)
-  lines.push(`export {`)
-  lines.push(`  // Errors`)
-  if (!isV4) {
-    lines.push(`  SapErrorDetail,`)
-    lines.push(`  SapErrorResolution,`)
-    lines.push(`  SapApplication,`)
-    lines.push(`  SapInnerError,`)
-    lines.push(`  SapErrorMessage,`)
-    lines.push(`  SapErrorBody,`)
-    lines.push(`  SapErrorResponse,`)
-    lines.push(`  SapError,`)
-  }
-  lines.push(`  ODataError,`)
-  lines.push(`  EntityNotFoundError,`)
-  lines.push(`  ParseError,`)
-  if (isV4) {
-    // V4 exports
-    lines.push(`  // OData V4`)
-    lines.push(`  ODataV4,`)
-    lines.push(`  ODataV4CollectionResponse,`)
-    lines.push(`  ODataV4ValueResponse,`)
-    lines.push(`  ODataV4Annotations,`)
-    lines.push(`  ODataV4ClientConfig,`)
-    lines.push(`  buildEntityPathV4,`)
-    lines.push(`  type ODataV4QueryOptions,`)
-    lines.push(`  type ODataV4RequestOptions,`)
-    lines.push(`  type ODataV4ClientConfigService,`)
-    lines.push(`  type PagedResultV4,`)
-  } else {
-    // V2 exports
-    lines.push(`  // OData V2`)
-    lines.push(`  OData,`)
-    lines.push(`  ODataSingleResponse,`)
-    lines.push(`  ODataCollectionResponse,`)
-    lines.push(`  ODataCollectionResponseWithMeta,`)
-    lines.push(`  ODataValueResponse,`)
-    lines.push(`  EntityMetadata,`)
-    lines.push(`  MediaMetadata,`)
-    lines.push(`  DeferredContent,`)
-    lines.push(`  ODataClientConfig,`)
-    lines.push(`  buildEntityPath,`)
-    lines.push(`  DEFAULT_HEADERS,`)
-    lines.push(`  MERGE_HEADERS,`)
-    lines.push(`  type ODataQueryOptions,`)
-    lines.push(`  type ODataRequestOptions,`)
-    lines.push(`  type ODataClientConfigService,`)
-    lines.push(`  type PagedResult,`)
-  }
-  lines.push(`  // Query Builder`)
-  lines.push(`  FilterExpression,`)
-  lines.push(`  StringPath,`)
-  lines.push(`  NumberPath,`)
-  lines.push(`  BooleanPath,`)
-  lines.push(`  DateTimePath,`)
-  lines.push(`  EntityPath,`)
-  lines.push(`  CollectionPath,`)
-  lines.push(`  QueryBuilder,`)
-  lines.push(`  createQueryPaths,`)
-  lines.push(`  createQueryBuilder,`)
-  lines.push(`  type FieldToPath,`)
-  lines.push(`  type QueryPaths,`)
-  lines.push(`  type SelectableKeys,`)
-  lines.push(`  type ExpandableKeys,`)
-  lines.push(`  type BuiltQuery`)
-  lines.push(`} from "@odata-effect/odata-effect"`)
+  lines.push(`} from "./Models"`)
   lines.push(``)
 
   // Individual Entity Services (tree-shakable module namespace re-exports)
   lines.push(`// Individual Entity Services (tree-shakable)`)
   for (const entitySet of dataModel.entitySets.values()) {
     const serviceClassName = getServiceClassName(entitySet.name)
-    lines.push(`export * as ${serviceClassName} from "./${serviceClassName}.js"`)
+    lines.push(`export * as ${serviceClassName} from "./${serviceClassName}"`)
   }
   lines.push(``)
 
@@ -148,10 +80,25 @@ export const generateIndex = (dataModel: DataModel): string => {
   lines.push(`// Promise-based Entity Services (for non-Effect environments)`)
   for (const entitySet of dataModel.entitySets.values()) {
     const promiseServiceName = getPromiseServiceName(entitySet.name)
-    lines.push(`export * as ${promiseServiceName} from "./${promiseServiceName}.js"`)
+    lines.push(`export * as ${promiseServiceName} from "./${promiseServiceName}"`)
   }
   lines.push(``)
 
+  // Operations (FunctionImports, Functions, Actions) - only if there are unbound operations
+  const hasUnboundOperations = Array.from(dataModel.operations.values()).some((op) => !op.isBound)
+  if (hasUnboundOperations) {
+    lines.push(`// Operations (FunctionImports, Functions, Actions)`)
+    const operationsModuleName = getOperationsModuleName()
+    lines.push(`export * as ${operationsModuleName} from "./${operationsModuleName}"`)
+    lines.push(``)
+  }
+
+  // Path Builders (tree-shakable navigation)
+  lines.push(`// Path Builders (tree-shakable navigation)`)
+  const pathBuildersModuleName = getPathBuildersModuleName()
+  lines.push(`export * from "./${pathBuildersModuleName}"`)
+  lines.push(``)
+
   // Query Models
   lines.push(`// Query Models`)
   lines.push(`export {`)
@@ -183,7 +130,7 @@ export const generateIndex = (dataModel: DataModel): string => {
     lines.push(`  ${queryExports[i]}${isLast ? "" : ","}`)
   }
 
-  lines.push(`} from "./QueryModels.js"`)
+  lines.push(`} from "./QueryModels"`)
 
   return lines.join("\n")
 }

package/src/generator/NamingHelper.ts

@@ -84,10 +84,15 @@ export const getServiceClassName = (entitySetName: string): string => {
   // Remove trailing 's' if present to singularize
   let singular = entitySetName
   if (singular.endsWith("ies")) {
+    // "Categories" -> "Category"
     singular = singular.slice(0, -3) + "y"
-  } else if (singular.endsWith("es") && !singular.endsWith("ses")) {
+  } else if (singular.endsWith("xes") || singular.endsWith("ches") ||
+             singular.endsWith("shes") || singular.endsWith("sses") ||
+             singular.endsWith("zes")) {
+    // "Boxes" -> "Box", "Beaches" -> "Beach", etc.
     singular = singular.slice(0, -2)
   } else if (singular.endsWith("s") && !singular.endsWith("ss")) {
+    // "Products" -> "Product", "Airlines" -> "Airline"
     singular = singular.slice(0, -1)
   }
   return `${toPascalCase(singular)}Service`