dto2ts 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project are documented here.
+This project follows [Semantic Versioning](https://semver.org/).
+
+## [0.1.1] - 2026-07-02
+
+### Added
+
+- Package metadata: `author`, `repository`, `bugs`, `homepage` (shown on the npm page).
+- npm badges and package link in the README.
+- CI workflow that builds the project on every push and pull request.
+
+## [0.1.0] - 2026-07-02
+
+### Added
+
+- Initial release.
+- Generate TypeScript models (interfaces & enums) from **OpenAPI/Swagger** (file or URL) or
+  **C# source files** (`.cs`).
+- Generate fetch-based CRUD services (`list` / `getById` / `create` / `update` / `patch` / `remove`)
+  per resource.
+- Zero-dependency generated `HttpClient` with `ApiError` and injectable headers/fetch.
+- One file per type following the Angular style guide (`.model.ts` / `.enum.ts` / `.service.ts`)
+  with barrel `index.ts` files.
+- CLI and programmatic API, configurable via `dto2ts.config.json` or flags.

package/README.md

@@ -1,10 +1,33 @@
 # dto2ts
 
+[![npm version](https://img.shields.io/npm/v/dto2ts.svg)](https://www.npmjs.com/package/dto2ts)
+[![npm downloads](https://img.shields.io/npm/dm/dto2ts.svg)](https://www.npmjs.com/package/dto2ts)
+[![CI](https://github.com/serkancakmakk/dto2ts/actions/workflows/ci.yml/badge.svg)](https://github.com/serkancakmakk/dto2ts/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/dto2ts.svg)](./LICENSE)
+
 Generate **TypeScript models** and **fetch-based CRUD services** from your C# API.
 
+📦 **[npmjs.com/package/dto2ts](https://www.npmjs.com/package/dto2ts)**
+
 Point it at your ASP.NET Core backend and get a fully typed, ready-to-use client for your
 frontend — no manual DTO copying, no drift between backend and frontend.
 
+![dto2ts demo](docs/demo.gif)
+
+## Why dto2ts?
+
+There are excellent OpenAPI→TS generators already (NSwag, `openapi-typescript`,
+`swagger-typescript-api`). dto2ts is worth a look when you want two things they don't give you
+out of the box:
+
+- **No running API required.** dto2ts can read your `.cs` DTO/record/enum files **directly** —
+  so you can generate types before the backend is even started, and enums keep their real member
+  names (a common pain point with .NET's default OpenAPI output). Most tools force you through a
+  live spec.
+- **Ready-to-use CRUD services, zero runtime deps.** You don't just get `interface`s — you get a
+  typed `ProductService` with `list / getById / create / update / patch / remove`, built on the
+  built-in `fetch`. Nothing to install, runs in the browser, Node 18+, Angular, React, or Vue.
+
 Two input sources are supported:
 
 - **OpenAPI / Swagger** — a `swagger.json` file or a live URL (e.g. the spec ASP.NET Core
@@ -12,8 +35,16 @@ Two input sources are supported:
 - **C# source files** (`.cs`) — parses your DTO/record/enum definitions directly, no need to
   run the API first.
 
-The generated code has **zero runtime dependencies** — it uses the built-in `fetch`, so it
-runs in the browser, Node 18+, Angular, React, Vue, or anywhere else.
+### Finding your Swagger/OpenAPI URL
+
+If you use the `openapi` source against a live API, the spec URL depends on your ASP.NET Core
+setup:
+
+- **.NET 9+ (built-in OpenAPI)**: `https://localhost:<port>/openapi/v1.json`
+- **Swashbuckle / Swagger UI**: `https://localhost:<port>/swagger/v1/swagger.json`
+
+Open the Swagger UI page in your browser and the JSON link is usually at the top. Not sure it's
+reachable? Use the `csharp` source instead and skip the running API entirely.
 
 ---
 
@@ -48,6 +79,9 @@ npx dto2ts -s openapi -i ./swagger.json -o ./src/api
 npx dto2ts -s csharp -i ../Backend/Dtos -o ./src/api
 ```
 
+> 💡 Want to try it right now? This repo ships sample DTOs under [`examples/csharp`](examples/csharp) —
+> run `npx dto2ts -s csharp -i ./examples/csharp -o ./out` to see exactly what the demo above produces.
+
 ## What gets generated
 
 One file per type, following the Angular style guide (`.model.ts` / `.enum.ts` / `.service.ts`),

package/dist/cli.js

@@ -8,7 +8,7 @@ const program = new commander_1.Command();
 program
     .name("dto2ts")
     .description("C# API (OpenAPI/Swagger veya .cs DTO) kaynaklarından TS model + fetch CRUD service üretir.")
-    .version("0.1.0");
+    .version("0.1.1");
 program
     .command("generate", { isDefault: true })
     .description("Model ve service dosyalarını üret")
@@ -50,6 +50,15 @@ program
         console.log(`  ${modelCount} model, ${serviceCount} service üretildi:`);
         for (const f of files)
             console.log(`    → ${f}`);
+        // OpenAPI + .NET'in default enum serileştirmesinde enum'lar üye adı olmadan
+        // gelir; bu durumda boş enum üretilir. Kullanıcıyı sessizce bırakmayalım.
+        const emptyEnums = api.models.filter((m) => m.kind === "enum" && m.members.length === 0);
+        if (emptyEnums.length > 0 && merged.source === "openapi") {
+            console.warn("");
+            console.warn(`⚠ ${emptyEnums.length} enum üye adı olmadan geldi (${emptyEnums.map((e) => e.name).join(", ")}).`);
+            console.warn("  .NET'in default OpenAPI çıktısı enum'ları düz integer olarak yazar.");
+            console.warn("  Çözüm: '--source csharp' kullan ya da API'nde JsonStringEnumConverter kaydet.");
+        }
     }
     catch (err) {
         console.error(`✖ Hata: ${err instanceof Error ? err.message : String(err)}`);

package/package.json

@@ -1,19 +1,32 @@
 {
   "name": "dto2ts",
-  "version": "0.1.0",
-  "description": "C# API (OpenAPI/Swagger veya .cs DTO) kaynaklarından TypeScript model ve fetch tabanlı CRUD service kodu üreten CLI.",
+  "version": "0.1.1",
+  "description": "Generate TypeScript models & fetch-based CRUD services from your C# API (OpenAPI/Swagger or .cs source).",
   "keywords": [
     "csharp",
     "dotnet",
+    "aspnetcore",
     "openapi",
     "swagger",
     "codegen",
+    "code-generation",
     "typescript",
     "dto",
     "crud",
-    "fetch"
+    "fetch",
+    "angular",
+    "api-client"
   ],
+  "author": "Serkan Çakmak",
   "license": "MIT",
+  "homepage": "https://github.com/serkancakmakk/dto2ts#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/serkancakmakk/dto2ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/serkancakmakk/dto2ts/issues"
+  },
   "type": "commonjs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -22,7 +35,9 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",