@devup-api/generator 0.1.2 → 0.1.3

package/README.md

@@ -1,8 +1,6 @@
 # @devup-api/generator
 
-devup API Type Generator
-
-Type generation package that generates TypeScript types from schemas.
+TypeScript interface generator from OpenAPI schemas.
 
 ## Installation
 
@@ -10,17 +8,57 @@ Type generation package that generates TypeScript types from schemas.
 npm install @devup-api/generator
 ```
 
+## Exports
+
+- `generateInterface(schema: OpenAPIV3_1.Document, options?: DevupApiTypeGeneratorOptions): string` - Generate TypeScript interface definitions from OpenAPI schema
+- `createUrlMap(schema: OpenAPIV3_1.Document, options?: DevupApiTypeGeneratorOptions): Record<string, UrlMapValue>` - Create URL map from OpenAPI schema
+
 ## Usage
 
-```typescript
-import { generateTypes, generateTypeFromSchema } from '@devup-api/generator';
+### Generate TypeScript Interfaces
+
+```ts
+import { generateInterface } from '@devup-api/generator'
+import { readOpenapiAsync } from '@devup-api/utils'
+
+const schema = await readOpenapiAsync('openapi.json')
+const interfaceCode = generateInterface(schema, {
+  convertCase: 'camel',
+  responseDefaultNonNullable: true
+})
+
+// Write to file
+await writeFile('api.d.ts', interfaceCode)
+```
+
+### Create URL Map
+
+```ts
+import { createUrlMap } from '@devup-api/generator'
+import { readOpenapiAsync } from '@devup-api/utils'
 
-// Generate types
-await generateTypes({
-  outputPath: './types',
-  format: 'typescript',
-});
+const schema = await readOpenapiAsync('openapi.json')
+const urlMap = createUrlMap(schema, {
+  convertCase: 'camel'
+})
 
-// Generate type from schema
-const typeString = generateTypeFromSchema(schema);
+// urlMap will contain entries like:
+// {
+//   'getUsers': { method: 'GET', url: '/users' },
+//   '/users': { method: 'GET', url: '/users' }
+// }
 ```
+
+## Options
+
+```ts
+interface DevupApiTypeGeneratorOptions {
+  convertCase?: 'snake' | 'camel' | 'pascal' | 'maintain'
+  requestDefaultNonNullable?: boolean
+  responseDefaultNonNullable?: boolean
+}
+```
+
+## License
+
+Apache 2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devup-api/generator",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -20,8 +20,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@devup-api/core": "0.1.2",
-    "@devup-api/utils": "0.1.2"
+    "@devup-api/core": "0.1.3",
+    "@devup-api/utils": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^24.10",