api-core-lib 12.0.86 → 12.0.88

package/dist/cli.cjs

@@ -75,6 +75,72 @@ var import_dotenv = __toESM(require("dotenv"), 1);
 var import_swagger_parser = __toESM(require("@apidevtools/swagger-parser"), 1);
 var import_openapi_types = __toESM(require_dist(), 1);
 
+// src/generator/core/_propToZod.ts
+function _propToZod(prop) {
+  let zodChain;
+  const getMsg = (key) => `{ "message": "validation.${key}" }`;
+  switch (prop.type) {
+    case "string":
+      if (prop.enumName) {
+        zodChain = `z.enum(${prop.enumName})`;
+      } else {
+        zodChain = "z.string()";
+        if (prop.isRequired) {
+          zodChain += `.min(1, ${getMsg("string.nonempty")})`;
+        }
+        if (prop.maxLength !== void 0) zodChain += `.max(${prop.maxLength}, ${getMsg("string.max")})`;
+        if (prop.pattern) zodChain += `.regex(/${prop.pattern}/, ${getMsg("string.regex")})`;
+        if (prop.format === "email") zodChain += `.email(${getMsg("string.email")})`;
+        if (prop.format === "url") zodChain += `.url(${getMsg("string.url")})`;
+        if (prop.format === "uuid") zodChain += `.uuid(${getMsg("string.uuid")})`;
+        if (prop.format === "datetime") zodChain += `.datetime(${getMsg("string.datetime")})`;
+      }
+      break;
+    case "integer":
+      zodChain = `z.number().int(${getMsg("number.integer")})`;
+      if (prop.minimum !== void 0) zodChain += `.min(${prop.minimum}, ${getMsg("number.min")})`;
+      if (prop.maximum !== void 0) zodChain += `.max(${prop.maximum}, ${getMsg("number.max")})`;
+      break;
+    case "number":
+      zodChain = `z.number()`;
+      if (prop.minimum !== void 0) zodChain += `.min(${prop.minimum}, ${getMsg("number.min")})`;
+      if (prop.maximum !== void 0) zodChain += `.max(${prop.maximum}, ${getMsg("number.max")})`;
+      break;
+    case "boolean":
+      zodChain = `z.boolean()`;
+      break;
+    case "array":
+      const itemSchema = prop.items ? _propToZod(prop.items) : "z.any()";
+      zodChain = `z.array(${itemSchema})`;
+      if (prop.minItems !== void 0) zodChain += `.min(${prop.minItems}, ${getMsg("array.min")})`;
+      if (prop.maxItems !== void 0) zodChain += `.max(${prop.maxItems}, ${getMsg("array.max")})`;
+      break;
+    case "object":
+      if (prop.properties && prop.properties.length > 0) {
+        const shape = prop.properties.map((p) => `  ${p.name}: ${_propToZod(p)}`).join(",\n");
+        zodChain = `z.object({
+${shape}
+})`;
+      } else {
+        zodChain = "z.record(z.unknown())";
+      }
+      break;
+    default:
+      zodChain = "z.any()";
+      break;
+  }
+  if (prop.description) {
+    zodChain += `.describe(${JSON.stringify(prop.description)})`;
+  }
+  if (!prop.isRequired) {
+    zodChain += ".optional()";
+  }
+  if (prop.isNullable) {
+    zodChain += ".nullable()";
+  }
+  return zodChain;
+}
+
 // src/generator/utils/index.ts
 var getActionName = (opId) => {
   const cleanOpId = opId.replace(/_v\d+$/, "");
@@ -256,25 +322,139 @@ async function generateModuleFiles(module2, allSchemas, allEnums, outputDir) {
   if (!import_fs.default.existsSync(moduleOutputPath)) import_fs.default.mkdirSync(moduleOutputPath, { recursive: true });
   console.log(import_chalk.default.cyan(`
   Generating module: ${import_chalk.default.bold(module2.moduleName)}`));
-  const schemasToImport = [...module2.schemas].sort();
+  const BUILT_IN_TYPES = /* @__PURE__ */ new Set(["string", "number", "boolean", "void", "undefined", "unknown", "any", "Date", "Promise", "QueryOptions", "Record<string, any>", "Record<string, unknown>"]);
+  const schemasToImport = [...module2.schemas].filter((name) => !BUILT_IN_TYPES.has(name)).sort();
   const enumsToImport = [...module2.enums].sort();
-  const indexExports = ["config"];
+  const createdFileExports = ["config"];
+  let configContent = `// This file is auto-generated. Do not edit directly.
+
+import type { ApiModuleConfig, ActionConfigModule } from 'api-core-lib';
+`;
+  if (schemasToImport.length > 0) configContent += `import type { ${schemasToImport.join(", ")} } from './types';
+`;
+  const actionsType = Object.values(module2.actions).map((a) => `  ${a.name}: ActionConfigModule<${a.inputType}, ${a.outputType}>;`).join("\n");
+  const actionsValue = Object.values(module2.actions).map((a) => {
+    const { inputType, outputType, name, ...c } = a;
+    return `    ${name}: ${JSON.stringify(c, null, 2).replace(/\n/g, "\n    ")}`;
+  }).join(",\n");
+  configContent += `
+export const ${module2.moduleName}: ApiModuleConfig<{
+${actionsType}
+}> = {
+  baseEndpoint: '${module2.baseEndpoint}',
+  actions: {
+${actionsValue}
+  },
+};
+`;
+  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, "config.ts"), configContent.trim());
+  console.log(import_chalk.default.gray(`    \u2713 config.ts`));
   if (schemasToImport.length > 0) {
-    if (enumsToImport.length > 0) indexExports.push("enums");
-    indexExports.push("types", "validation", "mocks");
+    if (enumsToImport.length > 0) {
+      let enumsContent = `// This file is auto-generated. Do not edit directly.
+
+`;
+      enumsToImport.forEach((enumName) => {
+        const enumDef = allEnums.get(enumName);
+        if (enumDef) {
+          enumsContent += `export const ${enumName} = ${JSON.stringify(enumDef.values)} as const;
+`;
+          enumsContent += `export type ${enumName} = typeof ${enumName}[number];
+
+`;
+        }
+      });
+      import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, "enums.ts"), enumsContent.trim());
+      console.log(import_chalk.default.gray(`    \u2713 enums.ts`));
+      createdFileExports.push("enums");
+    }
+    let typesContent = `// This file is auto-generated. Do not edit directly.
+
+`;
+    if (enumsToImport.length > 0) typesContent += `import type { ${enumsToImport.join(", ")} } from './enums';
+
+`;
+    schemasToImport.forEach((typeName) => {
+      const parsedSchema = allSchemas.get(typeName);
+      if (parsedSchema) {
+        if (parsedSchema.description) typesContent += `/** ${parsedSchema.description} */
+`;
+        typesContent += `export interface ${typeName} {
+`;
+        parsedSchema.properties.forEach((prop) => {
+          if (prop.description) typesContent += `  /** ${prop.description} */
+`;
+          let propType = prop.enumName || (prop.items ? `${prop.items.type || "any"}[]` : prop.type);
+          if (propType === "integer") propType = "number";
+          if (propType === "object") propType = "Record<string, any>";
+          typesContent += `  ${prop.name}${prop.isRequired ? "" : "?"}: ${propType};
+`;
+        });
+        typesContent += `}
+
+`;
+      }
+    });
+    import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, "types.ts"), typesContent.trim());
+    console.log(import_chalk.default.gray(`    \u2713 types.ts`));
+    createdFileExports.push("types");
+    let validationContent = `// This file is auto-generated. Do not edit directly.
+
+import { z } from 'zod';
+`;
+    if (enumsToImport.length > 0) validationContent += `import { ${enumsToImport.join(", ")} } from './enums';
+`;
+    schemasToImport.forEach((typeName) => {
+      const parsedSchema = allSchemas.get(typeName);
+      if (parsedSchema) {
+        const zodShape = parsedSchema.properties.map((p) => `  ${p.name}: ${_propToZod(p)}`).join(",\n");
+        validationContent += `
+/** Zod schema for {@link ${typeName}}. */
+`;
+        validationContent += `export const ${typeName}Schema = z.object({
+${zodShape}
+});
+
+`;
+        validationContent += `export type ${typeName}Validated = z.infer<typeof ${typeName}Schema>;
+`;
+      }
+    });
+    import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, "validation.ts"), validationContent.trim());
+    console.log(import_chalk.default.gray(`    \u2713 validation.ts`));
+    createdFileExports.push("validation");
+    let mocksContent = `// This file is auto-generated. Do not edit directly.
+import type { ${schemasToImport.join(", ")} } from './types';
+`;
+    if (enumsToImport.length > 0) mocksContent += `import { ${enumsToImport.join(", ")} } from './enums';
+
+`;
+    schemasToImport.forEach((typeName) => {
+      const parsedSchema = allSchemas.get(typeName);
+      if (parsedSchema) {
+        const mockObject = {};
+        parsedSchema.properties.forEach((p) => {
+          mockObject[p.name] = _propToMock(p);
+        });
+        mocksContent += `export const mock${typeName}: ${typeName} = ${JSON.stringify(mockObject, null, 2)};
+
+`;
+      }
+    });
+    import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, "mocks.ts"), mocksContent.trim());
+    console.log(import_chalk.default.gray(`    \u2713 mocks.ts`));
+    createdFileExports.push("mocks");
   }
+  const indexFilePath = import_path.default.join(moduleOutputPath, "index.ts");
   const initialIndexContent = `// This file is auto-generated. Do not edit directly.
 
-` + indexExports.map((e) => `export * from './${e}';`).join("\n");
-  const indexFilePath = import_path.default.join(moduleOutputPath, "index.ts");
+` + createdFileExports.map((e) => `export * from './${e}';`).join("\n");
   import_fs.default.writeFileSync(indexFilePath, initialIndexContent);
   console.log(import_chalk.default.gray(`    \u2713 index.ts (Initial)`));
   const moduleBaseName = module2.moduleName.replace(/Api$/, "");
   const camelCaseModuleName = toCamelCase(moduleBaseName);
   const allPathParams = /* @__PURE__ */ new Set();
-  Object.values(module2.actions).forEach((action) => {
-    action.pathParams.forEach((param) => allPathParams.add(param));
-  });
+  Object.values(module2.actions).forEach((action) => action.pathParams.forEach((param) => allPathParams.add(param)));
   const pathParamsType = allPathParams.size > 0 ? `{ ${[...allPathParams].map((p) => `${p}?: string | number`).join("; ")} }` : "Record<string, never>";
   let endpointsContent = `// This file is auto-generated. Do not edit directly.
 
@@ -337,14 +517,12 @@ import { ${module2.moduleName} } from './config';
 
 type ModulePathParams = ${pathParamsType};
 
-// Options for the custom hook, extending the base options with typed path parameters.
 type ${moduleBaseName}ApiOptions = Omit<UseApiModuleOptions, 'pathParams'> & {
   pathParams?: ModulePathParams;
 };
 
 /**
  * Custom hook for interacting with the ${moduleBaseName} API module.
- * Simplifies API calls by pre-configuring the API client and module.
  */
 export const use${moduleBaseName}Api = (options: ${moduleBaseName}ApiOptions = {}) => {
   return useApiModule<typeof TModuleType['actions']>(apiClient, ${module2.moduleName}, options);
@@ -398,12 +576,37 @@ export const create${moduleBaseName}ServerApi = () => {
     `export * from './${camelCaseModuleName}.endpoints';`,
     `export * from './use${moduleBaseName}';`,
     `export * from './${moduleBaseName}.provider';`,
-    // <-- Note: no .tsx in export
     `export * from './${camelCaseModuleName}.server';`
   ].join("\n");
   import_fs.default.appendFileSync(indexFilePath, newExports);
   console.log(import_chalk.default.gray(`    \u2713 index.ts (Updated with helpers)`));
 }
+function _propToMock(prop) {
+  if (prop.example) return prop.example;
+  if (prop.name.match(/image|avatar|logo|url/i)) return "https://via.placeholder.com/150";
+  if (prop.enum) return prop.enum[0];
+  switch (prop.type) {
+    case "string":
+      if (prop.format === "email") return "test@example.com";
+      if (prop.format === "uuid") return "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11";
+      return `Mock ${toPascalCase(prop.name)}`;
+    case "integer":
+    case "number":
+      return 1;
+    case "boolean":
+      return true;
+    case "array":
+      return prop.items ? [_propToMock(prop.items)] : [];
+    case "object":
+      const mock = {};
+      if (prop.properties) prop.properties.forEach((p) => {
+        mock[p.name] = _propToMock(p);
+      });
+      return mock;
+    default:
+      return null;
+  }
+}
 async function runGenerator(options) {
   console.log(import_chalk.default.cyan.bold("\u{1F680} Starting API Development Platform Generator (Sapphire Edition)..."));
   import_dotenv.default.config({ path: options.envPath });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-core-lib",
-  "version": "12.0.86",
+  "version": "12.0.88",
   "description": "A flexible and powerful API client library for modern web applications.",
   "type": "module",
   "exports": {