@constantant/openapi-resource-gen 1.1.0

package/README.md

@@ -0,0 +1,230 @@
+# openapi-resource-gen
+
+Nx generator that reads an OpenAPI 3.x spec and emits one `InjectionToken` per
+endpoint, each in its own `.ts` file. The result is a tree-shakeable Angular
+data-access library: only tokens that are actually injected end up in the bundle.
+
+## Concept
+
+Each endpoint becomes a typed `InjectionToken` whose value is a factory function.
+Calling the token's factory function returns an `httpResource` — Angular 22's
+signal-native HTTP wrapper.
+
+```
+OpenAPI spec  →  generator  →  one .token.ts per endpoint
+                                   └─ InjectionToken + typed factory function
+                                   └─ export type Params / Body / Response
+```
+
+All types are derived from the generated `schema.d.ts` (via `openapi-typescript`)
+so there is zero hand-written interface code and no runtime overhead from a
+generated client library.
+
+### Why one file per endpoint?
+
+esbuild performs tree-shaking at the file boundary. A token that is never
+`inject()`-ed is never imported, so the entire file is dropped from the bundle.
+Bundling all endpoints into a single file would prevent this.
+
+### `providedIn: 'none'` vs `'root'`
+
+| Mode | Token has factory? | How to provide |
+|------|--------------------|----------------|
+| `'none'` (default) | No | Call the emitted `provide{Name}()` helper in `app.config.ts` or a route provider |
+| `'root'` | Yes — self-registers | Just `inject()` it anywhere; Angular handles registration |
+
+`'none'` is the default because it lets you inject the same token with different
+`API_BASE_URL` values in different route sub-trees (e.g. staging vs production,
+or different micro-frontends). `'root'` is simpler but prevents per-scope
+base URL overrides.
+
+---
+
+## Running the generator
+
+```bash
+npx nx g openapi-resource-gen:api-resource \
+  --specPath=specs/petstore.yaml \
+  --outputDir=libs/petstore-data-access/src
+```
+
+### Options
+
+| Option | Required | Default | Description |
+|--------|----------|---------|-------------|
+| `specPath` | yes | — | Path to the OpenAPI 3.x YAML or JSON spec file |
+| `outputDir` | yes | — | Output directory relative to the workspace root |
+| `baseUrlToken` | no | `API_BASE_URL` | Name of the base-URL `InjectionToken` emitted alongside the endpoint tokens |
+| `tagFilter` | no | all tags | Comma-separated list of OpenAPI tags to include |
+| `namingConvention` | no | `kebab` | `kebab` → `find-pets-by-status.token.ts`; `camel` → `findPetsByStatus.token.ts` |
+| `providedIn` | no | `none` | `none` or `root` — see table above |
+
+---
+
+## Output structure
+
+```
+{outputDir}/
+  schema.d.ts                    # openapi-typescript output, never edit manually
+  api-base-url.token.ts          # InjectionToken<string> for the API root URL
+  index.ts                       # re-exports all tag barrels + api-base-url.token
+  {tag}/
+    index.ts                     # re-exports all token files in this tag folder
+    {operation-id}.token.ts      # one file per endpoint
+```
+
+Tags map to subfolders; untagged operations go into `default/`.
+
+---
+
+## Generated token anatomy
+
+### GET with query params — `find-pets-by-status.token.ts`
+
+```typescript
+import { InjectionToken, inject, FactoryProvider } from '@angular/core';
+import { httpResource } from '@angular/common/http';
+import type { paths } from '../schema.d';
+import { PETSTORE_BASE_URL } from '../api-base-url.token';
+
+export type FindPetsByStatusParams =
+  paths['/pet/findByStatus']['get']['parameters']['query'];
+
+export type FindPetsByStatusResponse =
+  paths['/pet/findByStatus']['get']['responses']['200']['content']['application/json'];
+
+export const FIND_PETS_BY_STATUS = new InjectionToken<
+  (params?: FindPetsByStatusParams | (() => FindPetsByStatusParams | undefined))
+    => ReturnType<typeof httpResource<FindPetsByStatusResponse>>
+>('FIND_PETS_BY_STATUS');
+
+export function provideFindPetsByStatus(): FactoryProvider {
+  return {
+    provide: FIND_PETS_BY_STATUS,
+    useFactory: () => {
+      const base = inject(PETSTORE_BASE_URL);
+      return (params?) =>
+        httpResource<FindPetsByStatusResponse>(() => ({
+          url: `${base}/pet/findByStatus`,
+          params: (typeof params === 'function' ? params() : params) as ...,
+        }));
+    },
+  };
+}
+```
+
+### GET with path params — `repos-get.token.ts`
+
+Path params (`/repos/{owner}/{repo}`) become required positional arguments on
+the returned function and are interpolated into the URL template:
+
+```typescript
+export const REPOS_GET = new InjectionToken<
+  (owner: string, repo: string) => ReturnType<typeof httpResource<ReposGetResponse>>
+>('REPOS_GET');
+```
+
+### Mutation (POST/PUT/PATCH/DELETE)
+
+The factory returns `(body: BodyType | Signal<BodyType>) => httpResource(...)`.
+The resource config receives `method: 'POST'` and `body` automatically.
+
+---
+
+## Consuming tokens in a component
+
+### 1. Register providers in `app.config.ts`
+
+```typescript
+import { PETSTORE_BASE_URL, provideFindPetsByStatus } from '@angular-openapi-gen/petstore-data-access';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideHttpClient(),
+    { provide: PETSTORE_BASE_URL, useValue: 'https://petstore3.swagger.io/api/v3' },
+    provideFindPetsByStatus(),
+  ],
+};
+```
+
+### 2. Inject and call in a component
+
+```typescript
+@Component({ ... })
+export class PetsPageComponent {
+  private findPetsByStatus = inject(FIND_PETS_BY_STATUS);
+
+  readonly status = signal<'available' | 'pending' | 'sold'>('available');
+
+  // Pass a thunk so httpResource re-fetches whenever status() changes
+  readonly pets = this.findPetsByStatus(() => ({ status: this.status() }));
+}
+```
+
+```html
+@if (pets.isLoading()) { <mat-progress-bar mode="indeterminate" /> }
+@for (pet of pets.value() ?? []; track pet.id) {
+  <p>{{ pet.name }}</p>
+}
+```
+
+### Reactive params (signal-driven re-fetch)
+
+The `params` argument accepts either a plain object or a **thunk**
+`() => ParamsType`. When a thunk is passed it is called inside the
+`httpResource` reactive lambda, so any signal reads inside it register as
+dependencies — the request re-fires automatically when a signal changes.
+
+---
+
+## Exported types
+
+Every token file exports `Params`, `Body`, and `Response` type aliases so
+consumers can derive domain types without duplicating type expressions:
+
+```typescript
+import type { FindPetsByStatusParams } from '@angular-openapi-gen/petstore-data-access';
+
+type PetStatus = FindPetsByStatusParams['status']; // 'available' | 'pending' | 'sold'
+```
+
+---
+
+## Adding a new data-access lib
+
+1. Fetch the spec into `specs/`:
+   ```bash
+   curl -L https://example.com/openapi.yaml -o specs/myapi.yaml
+   ```
+
+2. Run the generator:
+   ```bash
+   npx nx g openapi-resource-gen:api-resource \
+     --specPath=specs/myapi.yaml \
+     --outputDir=libs/myapi-data-access/src
+   ```
+
+3. Create `libs/myapi-data-access/package.json` (or add a path alias to
+   `tsconfig.base.json`) so the lib is importable as
+   `@angular-openapi-gen/myapi-data-access`.
+
+4. Add base URL provider and token providers to `app.config.ts`.
+
+To regenerate after a spec update, re-run the same command — the generator
+overwrites all files in `outputDir`.
+
+---
+
+## Implementation notes
+
+| Step | Tool | Purpose |
+|------|------|---------|
+| Spec loading | `js-yaml` + custom `stripNonSchemaRefs()` | Handle YAML and remove non-spec `$ref` links (markdown, images) that would break parsing |
+| Type generation | `openapi-typescript` CLI | Emit `schema.d.ts` — the single source of truth for all request/response types |
+| Spec dereferencing | `@apidevtools/swagger-parser` | Resolve all `$ref` chains for endpoint extraction |
+| Code generation | `@nx/devkit` `generateFiles()` + inline string building | EJS template for `api-base-url.token.ts`; direct string assembly for token files |
+| Formatting | `@nx/devkit` `formatFiles()` | Runs Prettier over all written files |
+
+Hyphenated path parameter names (e.g. `{enterprise-team}` in the GitHub spec)
+are converted to camelCase in the function signature and the URL template via
+`toCamelCase()` to produce valid JavaScript identifiers.

package/generators.json

@@ -0,0 +1,9 @@
+{
+  "generators": {
+    "api-resource": {
+      "factory": "./src/generators/api-resource/generator",
+      "schema": "./src/generators/api-resource/schema.json",
+      "description": "Generate InjectionToken-based API resource files from an OpenAPI 3.x spec"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@constantant/openapi-resource-gen",
+  "version": "1.1.0",
+  "description": "Nx generator: one InjectionToken per OpenAPI endpoint — tree-shakeable Angular data-access libs via httpResource",
+  "license": "MIT",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "generators": "./generators.json",
+  "keywords": [
+    "nx",
+    "nx-plugin",
+    "angular",
+    "openapi",
+    "generator",
+    "httpResource",
+    "InjectionToken",
+    "tree-shaking"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@nx/devkit": ">=22.0.0",
+    "nx": ">=22.0.0"
+  },
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^12.1.0",
+    "js-yaml": "^4.2.0",
+    "openapi-typescript": "^6.7.6",
+    "openapi-types": "^12.1.3",
+    "tslib": "^2.3.0"
+  },
+  "type": "commonjs"
+}

package/src/generators/api-resource/endpoint-model.d.ts

@@ -0,0 +1,14 @@
+export interface EndpointModel {
+    tag: string;
+    operationId: string;
+    method: string;
+    apiPath: string;
+    pathParams: string[];
+    tokenName: string;
+    fileName: string;
+    hasQueryParams: boolean;
+    hasBody: boolean;
+    hasResponse: boolean;
+    responseStatus: string | null;
+    bodyContentType: string | null;
+}

package/src/generators/api-resource/endpoint-model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=endpoint-model.js.map

package/src/generators/api-resource/endpoint-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-model.js","sourceRoot":"","sources":["../../../../../../tools/openapi-resource-gen/src/generators/api-resource/endpoint-model.ts"],"names":[],"mappings":""}

package/src/generators/api-resource/files/api-base-url.token.ts__tmpl__

@@ -0,0 +1,6 @@
+import { InjectionToken } from '@angular/core';
+
+export const <%= baseUrlToken %> = new InjectionToken<string>(
+  '<%= baseUrlToken %>',
+  { providedIn: 'root', factory: () => '' }
+);

package/src/generators/api-resource/generator.d.ts

@@ -0,0 +1,11 @@
+import { Tree } from '@nx/devkit';
+export interface ApiResourceGeneratorSchema {
+    specPath: string;
+    outputDir: string;
+    baseUrlToken?: string;
+    tagFilter?: string;
+    namingConvention?: 'camel' | 'kebab';
+    providedIn?: 'root' | 'none';
+}
+export declare function apiResourceGenerator(tree: Tree, options: ApiResourceGeneratorSchema): Promise<void>;
+export default apiResourceGenerator;

package/src/generators/api-resource/generator.js

@@ -0,0 +1,143 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiResourceGenerator = apiResourceGenerator;
+const devkit_1 = require("@nx/devkit");
+const fs = __importStar(require("fs"));
+const jsYaml = __importStar(require("js-yaml"));
+// openapi-typescript ships as ESM-only; use the bundled CJS build so this
+// CommonJS generator can call it without a dynamic import().
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const openapiTS = require('openapi-typescript/dist/index.cjs');
+const path = __importStar(require("path"));
+const swagger_parser_1 = __importDefault(require("@apidevtools/swagger-parser"));
+const parse_spec_1 = require("./parse-spec");
+const render_token_1 = require("./render-token");
+/** Replace $ref values that point to non-YAML/JSON files with {} so
+ *  swagger-parser doesn't try to load markdown or other binary assets. */
+function stripNonSchemaRefs(obj) {
+    if (Array.isArray(obj))
+        return obj.map(stripNonSchemaRefs);
+    if (obj && typeof obj === 'object') {
+        const record = obj;
+        if ('$ref' in record && typeof record['$ref'] === 'string') {
+            const ref = record['$ref'];
+            if (!ref.startsWith('#') && !/\.(json|ya?ml)(#.*)?$/i.test(ref)) {
+                return {};
+            }
+        }
+        const result = {};
+        for (const [key, value] of Object.entries(record)) {
+            result[key] = stripNonSchemaRefs(value);
+        }
+        return result;
+    }
+    return obj;
+}
+async function apiResourceGenerator(tree, options) {
+    const { specPath, outputDir, baseUrlToken = 'API_BASE_URL', tagFilter, namingConvention = 'kebab', providedIn = 'none', } = options;
+    const allowedTags = tagFilter
+        ? tagFilter
+            .split(',')
+            .map((t) => t.trim())
+            .filter(Boolean)
+        : null;
+    // 1. Parse spec with js-yaml, strip any $refs pointing to non-spec files
+    //    (e.g. x-topics.$ref: ./docs/getting-started.md in the travel spec).
+    //    Write the cleaned spec next to the original so relative file $refs
+    //    within the spec still resolve when swagger-parser dereferences.
+    const absoluteSpecPath = path.resolve(specPath);
+    const rawParsed = jsYaml.load(fs.readFileSync(absoluteSpecPath, 'utf-8'));
+    const cleanedParsed = stripNonSchemaRefs(rawParsed);
+    const tmpClean = path
+        .join(path.dirname(absoluteSpecPath), `_tmp_oas_${Date.now()}.json`)
+        .replace(/\\/g, '/');
+    try {
+        fs.writeFileSync(tmpClean, JSON.stringify(cleanedParsed));
+        // 2. Emit schema.d.ts via openapi-typescript programmatic API, using the
+        //    cleaned spec (not the dereferenced result — dereferenced Stripe has
+        //    circular refs; openapi-typescript resolves $refs itself).
+        const schemaDts = await openapiTS(tmpClean);
+        tree.write((0, devkit_1.joinPathFragments)(outputDir, 'schema.d.ts'), schemaDts);
+        // 3. Dereference for endpoint extraction (may produce circular objects —
+        //    that's fine because we only iterate over it, never serialize it).
+        const api = (await swagger_parser_1.default.dereference(tmpClean));
+        // 4. Emit api-base-url.token.ts from the EJS template in files/
+        (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files'), outputDir, {
+            baseUrlToken,
+            tmpl: '',
+        });
+        // 5. Build EndpointModels from the already-dereferenced API
+        const endpoints = (0, parse_spec_1.buildEndpoints)(api, allowedTags, namingConvention);
+        // 6. Group by tag
+        const byTag = new Map();
+        for (const ep of endpoints) {
+            if (!byTag.has(ep.tag))
+                byTag.set(ep.tag, []);
+            byTag.get(ep.tag).push(ep);
+        }
+        // 7. One token file per endpoint + per-tag barrel index
+        for (const [tag, tagEndpoints] of byTag) {
+            const tagDir = (0, devkit_1.joinPathFragments)(outputDir, tag);
+            for (const ep of tagEndpoints) {
+                tree.write((0, devkit_1.joinPathFragments)(tagDir, `${ep.fileName}.token.ts`), (0, render_token_1.renderTokenFile)(ep, baseUrlToken, providedIn));
+            }
+            const tagBarrel = tagEndpoints
+                .map((ep) => `export * from './${ep.fileName}.token';`)
+                .join('\n') + '\n';
+            tree.write((0, devkit_1.joinPathFragments)(tagDir, 'index.ts'), tagBarrel);
+        }
+        // 8. Root barrel index (includes api-base-url token for app.config.ts providers)
+        const rootBarrel = `export * from './api-base-url.token';\n` +
+            [...byTag.keys()]
+                .map((tag) => `export * from './${tag}';`)
+                .join('\n') + '\n';
+        tree.write((0, devkit_1.joinPathFragments)(outputDir, 'index.ts'), rootBarrel);
+    }
+    finally {
+        try {
+            fs.unlinkSync(tmpClean);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+exports.default = apiResourceGenerator;
+//# sourceMappingURL=generator.js.map

package/src/generators/api-resource/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../tools/openapi-resource-gen/src/generators/api-resource/generator.ts"],"names":[],"mappings":"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"}

package/src/generators/api-resource/parse-spec.d.ts

@@ -0,0 +1,7 @@
+import { OpenAPIV3 } from 'openapi-types';
+import type { EndpointModel } from './endpoint-model';
+export declare function toScreamingSnake(str: string): string;
+export declare function toKebabCase(str: string): string;
+export declare function buildEndpoints(api: OpenAPIV3.Document, allowedTags: string[] | null, namingConvention: 'camel' | 'kebab'): EndpointModel[];
+/** Convenience wrapper that dereferences the spec before building endpoints. */
+export declare function parseSpec(specPath: string, allowedTags: string[] | null, namingConvention: 'camel' | 'kebab'): Promise<EndpointModel[]>;

package/src/generators/api-resource/parse-spec.js

@@ -0,0 +1,107 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toScreamingSnake = toScreamingSnake;
+exports.toKebabCase = toKebabCase;
+exports.buildEndpoints = buildEndpoints;
+exports.parseSpec = parseSpec;
+const swagger_parser_1 = __importDefault(require("@apidevtools/swagger-parser"));
+const openapi_types_1 = require("openapi-types");
+const HTTP_METHODS = [
+    openapi_types_1.OpenAPIV3.HttpMethods.GET,
+    openapi_types_1.OpenAPIV3.HttpMethods.POST,
+    openapi_types_1.OpenAPIV3.HttpMethods.PUT,
+    openapi_types_1.OpenAPIV3.HttpMethods.PATCH,
+    openapi_types_1.OpenAPIV3.HttpMethods.DELETE,
+];
+function toScreamingSnake(str) {
+    return str
+        .replace(/\//g, '_')
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/[-\s.]+/g, '_')
+        .toUpperCase()
+        .replace(/_+/g, '_')
+        .replace(/^_|_$/g, '');
+}
+function toKebabCase(str) {
+    return str
+        .replace(/\//g, '-')
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[_\s.]+/g, '-')
+        .toLowerCase()
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function buildEndpoints(api, allowedTags, namingConvention) {
+    const endpoints = [];
+    for (const [apiPath, pathItem] of Object.entries(api.paths ?? {})) {
+        if (!pathItem)
+            continue;
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const tag = operation.tags?.[0] ?? 'default';
+            if (allowedTags && !allowedTags.includes(tag))
+                continue;
+            const rawId = operation.operationId ??
+                `${method}_${apiPath.replace(/\W+/g, '_').replace(/^_|_$/g, '')}`;
+            const fileName = namingConvention === 'kebab' ? toKebabCase(rawId) : rawId;
+            const tokenName = toScreamingSnake(rawId);
+            const allParams = [
+                ...(pathItem.parameters ?? []),
+                ...(operation.parameters ?? []),
+            ];
+            const pathParams = allParams
+                .filter((p) => p.in === 'path')
+                .map((p) => p.name);
+            const hasQueryParams = allParams.some((p) => p.in === 'query');
+            const requestBody = operation.requestBody;
+            const bodyContent = requestBody?.content ?? {};
+            const BODY_CONTENT_TYPES = [
+                'application/json',
+                'application/x-www-form-urlencoded',
+                'multipart/form-data',
+            ];
+            const bodyContentType = BODY_CONTENT_TYPES.find((ct) => bodyContent[ct]) ??
+                Object.keys(bodyContent)[0] ??
+                null;
+            const hasBody = bodyContentType !== null;
+            const rawStatus = operation.responses?.['200']
+                ? '200'
+                : operation.responses?.['201']
+                    ? '201'
+                    : null;
+            // Only treat the response as typed JSON when the response actually has
+            // application/json content (not PDF, octet-stream, etc.)
+            const responseObj = rawStatus
+                ? operation.responses?.[rawStatus]
+                : null;
+            const responseStatus = responseObj?.content?.['application/json'] ? rawStatus : null;
+            const hasResponse = responseStatus !== null;
+            endpoints.push({
+                tag: toKebabCase(tag),
+                operationId: rawId,
+                method,
+                apiPath,
+                pathParams,
+                tokenName,
+                fileName,
+                hasQueryParams,
+                hasBody,
+                hasResponse,
+                responseStatus,
+                bodyContentType,
+            });
+        }
+    }
+    return endpoints;
+}
+/** Convenience wrapper that dereferences the spec before building endpoints. */
+async function parseSpec(specPath, allowedTags, namingConvention) {
+    const api = (await swagger_parser_1.default.dereference(specPath));
+    return buildEndpoints(api, allowedTags, namingConvention);
+}
+//# sourceMappingURL=parse-spec.js.map

package/src/generators/api-resource/parse-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-spec.js","sourceRoot":"","sources":["../../../../../../tools/openapi-resource-gen/src/generators/api-resource/parse-spec.ts"],"names":[],"mappings":"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"}

package/src/generators/api-resource/render-token.d.ts

@@ -0,0 +1,2 @@
+import type { EndpointModel } from './endpoint-model';
+export declare function renderTokenFile(ep: EndpointModel, baseUrlToken: string, providedIn?: 'root' | 'none'): string;

package/src/generators/api-resource/render-token.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTokenFile = renderTokenFile;
+function toPascalCase(str) {
+    return str
+        .replace(/\//g, '-')
+        .split(/[-_\s]+/)
+        .filter(Boolean)
+        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+        .join('');
+}
+function toCamelCase(str) {
+    const parts = str.split(/[-_]+/).filter(Boolean);
+    return parts[0] + parts.slice(1).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join('');
+}
+function renderTokenFile(ep, baseUrlToken, providedIn = 'none') {
+    const pascal = toPascalCase(ep.operationId);
+    const urlTemplate = ep.apiPath.replace(/\{([\w-]+)\}/g, (_, p) => `\${${toCamelCase(p)}}`);
+    const isGet = ep.method === 'get';
+    const { responseStatus } = ep;
+    const lines = [];
+    // Imports
+    const coreImports = ['InjectionToken', 'inject'];
+    if (!isGet && ep.hasBody)
+        coreImports.push('Signal');
+    if (providedIn === 'none')
+        coreImports.push('FactoryProvider');
+    lines.push(`import { ${coreImports.join(', ')} } from '@angular/core';`);
+    lines.push(`import { httpResource } from '@angular/common/http';`);
+    lines.push(`import type { paths } from '../schema.d';`);
+    lines.push(`import { ${baseUrlToken} } from '../api-base-url.token';`);
+    lines.push('');
+    // Exported type aliases sourced directly from the generated paths type.
+    // NonNullable<> guards optional requestBody fields that are typed as T | undefined.
+    if (isGet && ep.hasQueryParams) {
+        lines.push(`export type ${pascal}Params =`, `  paths['${ep.apiPath}']['${ep.method}']['parameters']['query'];`, '');
+    }
+    if (!isGet && ep.hasBody && ep.bodyContentType) {
+        lines.push(`export type ${pascal}Body =`, `  NonNullable<paths['${ep.apiPath}']['${ep.method}']['requestBody']>['content']['${ep.bodyContentType}'];`, '');
+    }
+    if (responseStatus) {
+        lines.push(`export type ${pascal}Response =`, `  paths['${ep.apiPath}']['${ep.method}']['responses']['${responseStatus}']['content']['application/json'];`, '');
+    }
+    const responseT = responseStatus ? `${pascal}Response` : 'unknown';
+    const fnArgs = buildFnArgs(ep, pascal, isGet);
+    lines.push(`export const ${ep.tokenName} = new InjectionToken<`, `  (${fnArgs}) => ReturnType<typeof httpResource<${responseT}>>`, `>('${ep.tokenName}'${providedIn === 'root' ? `, {` : ')'}`);
+    if (providedIn === 'root') {
+        lines.push(`  providedIn: 'root',`, `  factory: () => {`, `    const base = inject(${baseUrlToken});`, `    return (${fnArgs}) =>`, `      httpResource<${responseT}>(() => ({`, `        url: \`\${base}${urlTemplate}\`,`);
+        appendResourceOptions(lines, ep, isGet, '        ');
+        lines.push(`      }));`, `  },`, `});`, '');
+    }
+    else {
+        // providedIn: 'none' — token has no factory; provide via the helper below
+        lines.push('');
+        lines.push(`export function provide${pascal}(): FactoryProvider {`, `  return {`, `    provide: ${ep.tokenName},`, `    useFactory: () => {`, `      const base = inject(${baseUrlToken});`, `      return (${fnArgs}) =>`, `        httpResource<${responseT}>(() => ({`, `          url: \`\${base}${urlTemplate}\`,`);
+        appendResourceOptions(lines, ep, isGet, '          ');
+        lines.push(`        }));`, `    },`, `  };`, `}`, '');
+    }
+    return lines.join('\n');
+}
+function appendResourceOptions(lines, ep, isGet, indent) {
+    if (!isGet) {
+        lines.push(`${indent}method: '${ep.method.toUpperCase()}',`);
+    }
+    if (isGet && ep.hasQueryParams) {
+        lines.push(`${indent}params: (typeof params === 'function' ? params() : params) as unknown as Record<string, string | number | boolean | readonly (string | number | boolean)[]>,`);
+    }
+    if (!isGet && ep.hasBody) {
+        lines.push(`${indent}body,`);
+    }
+}
+function buildFnArgs(ep, pascal, isGet) {
+    const args = ep.pathParams.map((p) => `${toCamelCase(p)}: string`);
+    if (isGet && ep.hasQueryParams)
+        args.push(`params?: ${pascal}Params | (() => ${pascal}Params | undefined)`);
+    if (!isGet && ep.hasBody)
+        args.push(`body: ${pascal}Body | Signal<${pascal}Body>`);
+    return args.join(', ');
+}
+//# sourceMappingURL=render-token.js.map

package/src/generators/api-resource/render-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-token.js","sourceRoot":"","sources":["../../../../../../tools/openapi-resource-gen/src/generators/api-resource/render-token.ts"],"names":[],"mappings":"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"}

package/src/generators/api-resource/schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "ApiResource",
+  "title": "Generate API resource tokens from an OpenAPI spec",
+  "type": "object",
+  "properties": {
+    "specPath": {
+      "type": "string",
+      "description": "Path to the OpenAPI 3.x YAML or JSON spec file",
+      "$default": { "$source": "argv", "index": 0 }
+    },
+    "outputDir": {
+      "type": "string",
+      "description": "Output directory for generated files (relative to workspace root)"
+    },
+    "baseUrlToken": {
+      "type": "string",
+      "description": "Name of the InjectionToken holding the API base URL",
+      "default": "API_BASE_URL"
+    },
+    "tagFilter": {
+      "type": "string",
+      "description": "Comma-separated list of OpenAPI tags to include (empty = all tags)"
+    },
+    "namingConvention": {
+      "type": "string",
+      "enum": ["camel", "kebab"],
+      "default": "kebab",
+      "description": "File naming convention: kebab-case filenames with SCREAMING_SNAKE token names"
+    },
+    "providedIn": {
+      "type": "string",
+      "enum": ["root", "none"],
+      "default": "none",
+      "description": "none: token has no factory; a provide{Name}() helper is exported for explicit scoped provision. root: token self-registers at root (tree-shakeable singleton, no multi-context support)"
+    }
+  },
+  "required": ["specPath", "outputDir"]
+}

package/src/index.d.ts

@@ -0,0 +1,3 @@
+export { apiResourceGenerator as default } from './generators/api-resource/generator';
+export { apiResourceGenerator } from './generators/api-resource/generator';
+export type { ApiResourceGeneratorSchema } from './generators/api-resource/generator';

package/src/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiResourceGenerator = exports.default = void 0;
+var generator_1 = require("./generators/api-resource/generator");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return generator_1.apiResourceGenerator; } });
+var generator_2 = require("./generators/api-resource/generator");
+Object.defineProperty(exports, "apiResourceGenerator", { enumerable: true, get: function () { return generator_2.apiResourceGenerator; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../tools/openapi-resource-gen/src/index.ts"],"names":[],"mappings":";;;AAAA,iEAAsF;AAA7E,oGAAA,oBAAoB,OAAW;AACxC,iEAA2E;AAAlE,iHAAA,oBAAoB,OAAA"}