@ojiepermana/angular 21.0.0 → 21.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/collection.json +25 -0
- package/fesm2022/ojiepermana-angular-generator-api.mjs +67 -0
- package/fesm2022/ojiepermana-angular-generator-api.mjs.map +1 -0
- package/fesm2022/ojiepermana-angular-layout.mjs +76 -56
- package/fesm2022/ojiepermana-angular-layout.mjs.map +1 -1
- package/fesm2022/ojiepermana-angular.mjs +1 -0
- package/fesm2022/ojiepermana-angular.mjs.map +1 -1
- package/generator/api/README.md +183 -0
- package/generator/api/bin/schematics/init/index.js +88 -0
- package/generator/api/bin/schematics/sdk/index.js +58 -0
- package/generator/api/bin/src/config/loader.js +41 -0
- package/generator/api/bin/src/config/schema.js +56 -0
- package/generator/api/bin/src/emit/client.js +246 -0
- package/generator/api/bin/src/emit/metadata.js +295 -0
- package/generator/api/bin/src/emit/models.js +106 -0
- package/generator/api/bin/src/emit/navigation.js +56 -0
- package/generator/api/bin/src/emit/operations.js +122 -0
- package/generator/api/bin/src/emit/public-api.js +54 -0
- package/generator/api/bin/src/emit/services.js +87 -0
- package/generator/api/bin/src/engine.js +65 -0
- package/generator/api/bin/src/layout/per-domain.js +346 -0
- package/generator/api/bin/src/parser/bundle.js +25 -0
- package/generator/api/bin/src/parser/ir.js +320 -0
- package/generator/api/bin/src/parser/types.js +7 -0
- package/generator/api/bin/src/render/template.js +58 -0
- package/generator/api/bin/src/writer/index.js +69 -0
- package/generator/api/schematics/init/schema.json +19 -0
- package/generator/api/schematics/sdk/schema.json +19 -0
- package/generator/api/sdk.config.example.json +22 -0
- package/generator/guide/README.md +84 -0
- package/generator/guide/bin/schematics/build/index.js +35 -0
- package/generator/guide/bin/schematics/init/index.js +70 -0
- package/generator/guide/bin/src/config/loader.js +50 -0
- package/generator/guide/bin/src/config/schema.js +12 -0
- package/generator/guide/bin/src/engine/component.js +73 -0
- package/generator/guide/bin/src/engine/frontmatter.js +42 -0
- package/generator/guide/bin/src/engine/index.js +42 -0
- package/generator/guide/bin/src/engine/naming.js +39 -0
- package/generator/guide/bin/src/engine/render.js +18 -0
- package/generator/guide/bin/src/engine/routes.js +106 -0
- package/generator/guide/bin/src/engine/walk.js +35 -0
- package/generator/guide/guide.config.example.json +9 -0
- package/generator/guide/schematics/build/schema.json +14 -0
- package/generator/guide/schematics/init/schema.json +19 -0
- package/package.json +10 -3
- package/types/ojiepermana-angular-generator-api.d.ts +85 -0
- package/types/ojiepermana-angular-layout.d.ts +2 -0
|
@@ -0,0 +1,295 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.emitMetadata = emitMetadata;
|
|
4
|
+
const template_1 = require("../render/template");
|
|
5
|
+
/**
|
|
6
|
+
* Emit frontend-friendly metadata:
|
|
7
|
+
* - `metadata-types.ts` shared rule types
|
|
8
|
+
* - `permissions/<tag>.ts` operation rules (per tag) + `index.ts`
|
|
9
|
+
* - `validators/<tag>.ts` schema validation rules (per tag) + `index.ts`
|
|
10
|
+
* - `metadata.ts` aggregate export
|
|
11
|
+
* - `openapi-helpers.ts` small helpers (`getRequiredPermissions`, etc)
|
|
12
|
+
*/
|
|
13
|
+
function emitMetadata(ir, target) {
|
|
14
|
+
const files = [];
|
|
15
|
+
files.push({ path: 'metadata-types.ts', content: (0, template_1.finalize)(metadataTypesFile(target)) });
|
|
16
|
+
const opsByTag = groupOps(ir.operations);
|
|
17
|
+
for (const [tag, ops] of opsByTag) {
|
|
18
|
+
files.push({
|
|
19
|
+
path: `permissions/${(0, template_1.kebabCase)(tag)}.ts`,
|
|
20
|
+
content: (0, template_1.finalize)(permissionFile(tag, ops, target)),
|
|
21
|
+
});
|
|
22
|
+
}
|
|
23
|
+
const permTags = Array.from(opsByTag.keys());
|
|
24
|
+
files.push({
|
|
25
|
+
path: 'permissions/index.ts',
|
|
26
|
+
content: (0, template_1.finalize)(buildAggregateFile(target, permTags, 'ApiOperationRule', 'apiOperationRules', (t) => `${toCamel(t)}OperationRules`)),
|
|
27
|
+
});
|
|
28
|
+
const schemasByPrefix = groupSchemas(ir.schemas);
|
|
29
|
+
for (const [group, schemas] of schemasByPrefix) {
|
|
30
|
+
files.push({
|
|
31
|
+
path: `validators/${(0, template_1.kebabCase)(group)}.ts`,
|
|
32
|
+
content: (0, template_1.finalize)(validatorFile(group, schemas, target)),
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
const valGroups = Array.from(schemasByPrefix.keys());
|
|
36
|
+
files.push({
|
|
37
|
+
path: 'validators/index.ts',
|
|
38
|
+
content: (0, template_1.finalize)(buildAggregateFile(target, valGroups, 'ApiSchemaRule', 'apiValidationSchemas', (g) => `${toCamel(g)}ValidationSchemas`)),
|
|
39
|
+
});
|
|
40
|
+
files.push({ path: 'metadata.ts', content: (0, template_1.finalize)(metadataFile(target)) });
|
|
41
|
+
files.push({ path: 'openapi-helpers.ts', content: (0, template_1.finalize)(helpersFile(target)) });
|
|
42
|
+
return files;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Emit a per-feature `index.ts` that re-exports each per-tag module plus a
|
|
46
|
+
* single aggregated record (`apiOperationRules`, `apiValidationSchemas`).
|
|
47
|
+
*/
|
|
48
|
+
function buildAggregateFile(target, groups, typeName, aggregateName, varNameFor) {
|
|
49
|
+
const reexports = groups.map((g) => `export { ${varNameFor(g)} } from './${(0, template_1.kebabCase)(g)}';`).join('\n');
|
|
50
|
+
const imports = groups.map((g) => `import { ${varNameFor(g)} } from './${(0, template_1.kebabCase)(g)}';`).join('\n');
|
|
51
|
+
const spreads = groups.map((g) => ` ...${varNameFor(g)},`).join('\n');
|
|
52
|
+
return `${target.banner}
|
|
53
|
+
|
|
54
|
+
import type { ${typeName} } from '../metadata-types';
|
|
55
|
+
${imports}
|
|
56
|
+
|
|
57
|
+
${reexports}
|
|
58
|
+
|
|
59
|
+
export const ${aggregateName}: Record<string, ${typeName}> = {
|
|
60
|
+
${spreads}
|
|
61
|
+
};
|
|
62
|
+
`;
|
|
63
|
+
}
|
|
64
|
+
function metadataTypesFile(target) {
|
|
65
|
+
return `${target.banner}
|
|
66
|
+
|
|
67
|
+
export interface ApiFieldRule {
|
|
68
|
+
required?: boolean;
|
|
69
|
+
type?: string;
|
|
70
|
+
format?: string;
|
|
71
|
+
description?: string;
|
|
72
|
+
nullable?: boolean;
|
|
73
|
+
minLength?: number;
|
|
74
|
+
maxLength?: number;
|
|
75
|
+
minimum?: number;
|
|
76
|
+
maximum?: number;
|
|
77
|
+
pattern?: string;
|
|
78
|
+
enumValues?: readonly (string | number)[];
|
|
79
|
+
ref?: string;
|
|
80
|
+
itemsRef?: string;
|
|
81
|
+
itemsType?: string;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export interface ApiSchemaRule {
|
|
85
|
+
required: readonly string[];
|
|
86
|
+
properties: Record<string, ApiFieldRule>;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
export interface ApiOperationRule {
|
|
90
|
+
method: string;
|
|
91
|
+
path: string;
|
|
92
|
+
tags: readonly string[];
|
|
93
|
+
summary?: string;
|
|
94
|
+
description?: string;
|
|
95
|
+
requiredPermissions: readonly string[];
|
|
96
|
+
authorizationNotes: readonly string[];
|
|
97
|
+
securitySchemes: readonly string[];
|
|
98
|
+
pathParams: Record<string, ApiFieldRule>;
|
|
99
|
+
queryParams: Record<string, ApiFieldRule>;
|
|
100
|
+
bodySchema?: string;
|
|
101
|
+
responseSchemas: Record<string, string | undefined>;
|
|
102
|
+
}
|
|
103
|
+
`;
|
|
104
|
+
}
|
|
105
|
+
function permissionFile(tag, ops, target) {
|
|
106
|
+
const entries = ops
|
|
107
|
+
.slice()
|
|
108
|
+
.sort((a, b) => a.operationId.localeCompare(b.operationId))
|
|
109
|
+
.map((op) => renderOperationRule(op));
|
|
110
|
+
return `${target.banner}
|
|
111
|
+
|
|
112
|
+
import type { ApiOperationRule } from '../metadata-types';
|
|
113
|
+
|
|
114
|
+
export const ${toCamel(tag)}OperationRules: Record<string, ApiOperationRule> = {
|
|
115
|
+
${entries.join(',\n')},
|
|
116
|
+
};
|
|
117
|
+
`;
|
|
118
|
+
}
|
|
119
|
+
function renderOperationRule(op) {
|
|
120
|
+
const pathParams = {};
|
|
121
|
+
const queryParams = {};
|
|
122
|
+
for (const p of op.params) {
|
|
123
|
+
const rule = trimRule(p.rule, p.required);
|
|
124
|
+
if (p.in === 'path')
|
|
125
|
+
pathParams[p.name] = rule;
|
|
126
|
+
else if (p.in === 'query')
|
|
127
|
+
queryParams[p.name] = rule;
|
|
128
|
+
}
|
|
129
|
+
const obj = {
|
|
130
|
+
method: op.method.toUpperCase(),
|
|
131
|
+
path: op.path,
|
|
132
|
+
tags: op.tags,
|
|
133
|
+
summary: op.summary,
|
|
134
|
+
description: op.description,
|
|
135
|
+
requiredPermissions: op.requiredPermissions,
|
|
136
|
+
authorizationNotes: op.authorizationNotes,
|
|
137
|
+
securitySchemes: op.securitySchemes,
|
|
138
|
+
pathParams,
|
|
139
|
+
queryParams,
|
|
140
|
+
bodySchema: op.bodySchemaRef,
|
|
141
|
+
responseSchemas: op.responses,
|
|
142
|
+
};
|
|
143
|
+
return ` ${JSON.stringify(op.operationId)}: ${toInlineJson(obj, 2)}`;
|
|
144
|
+
}
|
|
145
|
+
function validatorFile(group, schemas, target) {
|
|
146
|
+
const entries = schemas
|
|
147
|
+
.slice()
|
|
148
|
+
.sort((a, b) => a.name.localeCompare(b.name))
|
|
149
|
+
.map((s) => renderSchemaRule(s));
|
|
150
|
+
return `${target.banner}
|
|
151
|
+
|
|
152
|
+
import type { ApiSchemaRule } from '../metadata-types';
|
|
153
|
+
|
|
154
|
+
export const ${toCamel(group)}ValidationSchemas: Record<string, ApiSchemaRule> = {
|
|
155
|
+
${entries.join(',\n')},
|
|
156
|
+
};
|
|
157
|
+
`;
|
|
158
|
+
}
|
|
159
|
+
function renderSchemaRule(schema) {
|
|
160
|
+
const properties = {};
|
|
161
|
+
for (const [name, rule] of Object.entries(schema.properties)) {
|
|
162
|
+
properties[name] = trimRule(rule, rule.required === true);
|
|
163
|
+
}
|
|
164
|
+
const obj = {
|
|
165
|
+
required: schema.required,
|
|
166
|
+
properties,
|
|
167
|
+
};
|
|
168
|
+
return ` ${JSON.stringify(schema.name)}: ${toInlineJson(obj, 2)}`;
|
|
169
|
+
}
|
|
170
|
+
function metadataFile(target) {
|
|
171
|
+
return `${target.banner}
|
|
172
|
+
|
|
173
|
+
export * from './metadata-types';
|
|
174
|
+
export * from './permissions';
|
|
175
|
+
export * from './validators';
|
|
176
|
+
`;
|
|
177
|
+
}
|
|
178
|
+
function helpersFile(target) {
|
|
179
|
+
return `${target.banner}
|
|
180
|
+
|
|
181
|
+
import { apiOperationRules, apiValidationSchemas } from './metadata';
|
|
182
|
+
import type { ApiFieldRule, ApiOperationRule, ApiSchemaRule } from './metadata-types';
|
|
183
|
+
|
|
184
|
+
export function getSchemaRule(schemaName: string): ApiSchemaRule | undefined {
|
|
185
|
+
return apiValidationSchemas[schemaName];
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
export function getFieldRule(schemaName: string, fieldName: string): ApiFieldRule | undefined {
|
|
189
|
+
return apiValidationSchemas[schemaName]?.properties[fieldName];
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
export function getOperationRule(operationId: string): ApiOperationRule | undefined {
|
|
193
|
+
return apiOperationRules[operationId];
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
export function getRequiredPermissions(operationId: string): readonly string[] {
|
|
197
|
+
return apiOperationRules[operationId]?.requiredPermissions ?? [];
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
export function hasRequiredPermissions(
|
|
201
|
+
operationId: string,
|
|
202
|
+
ownedPermissions: readonly string[],
|
|
203
|
+
): boolean {
|
|
204
|
+
return getRequiredPermissions(operationId).every((p) => ownedPermissions.includes(p));
|
|
205
|
+
}
|
|
206
|
+
`;
|
|
207
|
+
}
|
|
208
|
+
// ---------------------------------------------------------------------------
|
|
209
|
+
// Helpers
|
|
210
|
+
// ---------------------------------------------------------------------------
|
|
211
|
+
function groupOps(operations) {
|
|
212
|
+
const map = new Map();
|
|
213
|
+
for (const op of operations) {
|
|
214
|
+
const bucket = map.get(op.tag) ?? [];
|
|
215
|
+
bucket.push(op);
|
|
216
|
+
map.set(op.tag, bucket);
|
|
217
|
+
}
|
|
218
|
+
return map;
|
|
219
|
+
}
|
|
220
|
+
/**
|
|
221
|
+
* Group schemas for validator output by a common prefix tag. We use a simple
|
|
222
|
+
* heuristic: first PascalCase word of the schema name (e.g. `UserListResponse`
|
|
223
|
+
* → `User`, `AuthTokenResponse` → `Auth`). Keeps file sizes small and mirrors
|
|
224
|
+
* the reference layout.
|
|
225
|
+
*/
|
|
226
|
+
function groupSchemas(schemas) {
|
|
227
|
+
const map = new Map();
|
|
228
|
+
for (const s of schemas) {
|
|
229
|
+
const prefix = detectSchemaGroup(s.name);
|
|
230
|
+
const bucket = map.get(prefix) ?? [];
|
|
231
|
+
bucket.push(s);
|
|
232
|
+
map.set(prefix, bucket);
|
|
233
|
+
}
|
|
234
|
+
return map;
|
|
235
|
+
}
|
|
236
|
+
function detectSchemaGroup(name) {
|
|
237
|
+
const match = name.match(/^([A-Z][a-z]+)/);
|
|
238
|
+
return match ? match[1] : 'Shared';
|
|
239
|
+
}
|
|
240
|
+
function trimRule(rule, required) {
|
|
241
|
+
const out = {};
|
|
242
|
+
if (required)
|
|
243
|
+
out.required = true;
|
|
244
|
+
else
|
|
245
|
+
out.required = false;
|
|
246
|
+
if (rule.type)
|
|
247
|
+
out.type = rule.type;
|
|
248
|
+
if (rule.format)
|
|
249
|
+
out.format = rule.format;
|
|
250
|
+
if (rule.description)
|
|
251
|
+
out.description = rule.description;
|
|
252
|
+
if (rule.nullable)
|
|
253
|
+
out.nullable = true;
|
|
254
|
+
if (typeof rule.minLength === 'number')
|
|
255
|
+
out.minLength = rule.minLength;
|
|
256
|
+
if (typeof rule.maxLength === 'number')
|
|
257
|
+
out.maxLength = rule.maxLength;
|
|
258
|
+
if (typeof rule.minimum === 'number')
|
|
259
|
+
out.minimum = rule.minimum;
|
|
260
|
+
if (typeof rule.maximum === 'number')
|
|
261
|
+
out.maximum = rule.maximum;
|
|
262
|
+
if (rule.pattern)
|
|
263
|
+
out.pattern = rule.pattern;
|
|
264
|
+
if (rule.enumValues && rule.enumValues.length)
|
|
265
|
+
out.enumValues = rule.enumValues;
|
|
266
|
+
if (rule.ref)
|
|
267
|
+
out.ref = rule.ref;
|
|
268
|
+
if (rule.itemsRef)
|
|
269
|
+
out.itemsRef = rule.itemsRef;
|
|
270
|
+
if (rule.itemsType)
|
|
271
|
+
out.itemsType = rule.itemsType;
|
|
272
|
+
return out;
|
|
273
|
+
}
|
|
274
|
+
/** Stable JSON output with stripped `undefined` values. */
|
|
275
|
+
function toInlineJson(value, indent) {
|
|
276
|
+
const pretty = JSON.stringify(value, (_key, val) => (val === undefined ? undefined : val), 2);
|
|
277
|
+
if (!pretty)
|
|
278
|
+
return 'undefined';
|
|
279
|
+
return pretty
|
|
280
|
+
.split('\n')
|
|
281
|
+
.map((line, i) => (i === 0 ? line : ' '.repeat(indent) + line))
|
|
282
|
+
.join('\n');
|
|
283
|
+
}
|
|
284
|
+
function toCamel(input) {
|
|
285
|
+
const parts = String(input)
|
|
286
|
+
.replace(/[^a-zA-Z0-9]+/g, ' ')
|
|
287
|
+
.trim()
|
|
288
|
+
.split(/\s+/)
|
|
289
|
+
.filter(Boolean);
|
|
290
|
+
if (!parts.length)
|
|
291
|
+
return 'shared';
|
|
292
|
+
return parts
|
|
293
|
+
.map((w, i) => (i === 0 ? w[0].toLowerCase() + w.slice(1) : w[0].toUpperCase() + w.slice(1).toLowerCase()))
|
|
294
|
+
.join('');
|
|
295
|
+
}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.emitModels = emitModels;
|
|
4
|
+
exports.renderFieldType = renderFieldType;
|
|
5
|
+
const template_1 = require("../render/template");
|
|
6
|
+
/**
|
|
7
|
+
* Emit one `interface` per schema into `models/<kebab>.ts` — type-only, no
|
|
8
|
+
* runtime footprint.
|
|
9
|
+
*/
|
|
10
|
+
function emitModels(ir, target) {
|
|
11
|
+
const files = [];
|
|
12
|
+
for (const schema of ir.schemas) {
|
|
13
|
+
const fileName = `${(0, template_1.kebabCase)(schema.name)}.ts`;
|
|
14
|
+
files.push({
|
|
15
|
+
path: `models/${fileName}`,
|
|
16
|
+
content: (0, template_1.finalize)(renderModel(schema, ir, target)),
|
|
17
|
+
});
|
|
18
|
+
}
|
|
19
|
+
return files;
|
|
20
|
+
}
|
|
21
|
+
function renderModel(schema, ir, target) {
|
|
22
|
+
const imports = collectModelImports(schema).filter((name) => name !== schema.name);
|
|
23
|
+
const importLines = imports.map((name) => `import type { ${name} } from './${(0, template_1.kebabCase)(name)}';`);
|
|
24
|
+
let body = '';
|
|
25
|
+
if (schema.enumValues) {
|
|
26
|
+
// Primitive enum alias.
|
|
27
|
+
body = `export type ${(0, template_1.pascalCase)(schema.name)} = ${schema.enumValues
|
|
28
|
+
.map((v) => (typeof v === 'string' ? `'${escapeSingle(v)}'` : String(v)))
|
|
29
|
+
.join(' | ')};`;
|
|
30
|
+
}
|
|
31
|
+
else if (schema.arrayItemRef || schema.arrayItemType) {
|
|
32
|
+
const itemType = schema.arrayItemRef ? (0, template_1.pascalCase)(schema.arrayItemRef) : tsPrimitive(schema.arrayItemType);
|
|
33
|
+
body = `export type ${(0, template_1.pascalCase)(schema.name)} = ${itemType}[];`;
|
|
34
|
+
}
|
|
35
|
+
else {
|
|
36
|
+
body = renderInterface(schema);
|
|
37
|
+
}
|
|
38
|
+
return [target.banner, '', ...importLines, importLines.length ? '' : '', body].join('\n');
|
|
39
|
+
}
|
|
40
|
+
function renderInterface(schema) {
|
|
41
|
+
const lines = [];
|
|
42
|
+
lines.push(`export interface ${(0, template_1.pascalCase)(schema.name)} {`);
|
|
43
|
+
for (const [propName, rule] of Object.entries(schema.properties)) {
|
|
44
|
+
const optional = rule.required ? '' : '?';
|
|
45
|
+
const type = renderFieldType(rule);
|
|
46
|
+
const safeName = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(propName) ? propName : `'${propName}'`;
|
|
47
|
+
lines.push(` ${safeName}${optional}: ${type};`);
|
|
48
|
+
}
|
|
49
|
+
lines.push(`}`);
|
|
50
|
+
return lines.join('\n');
|
|
51
|
+
}
|
|
52
|
+
function renderFieldType(rule) {
|
|
53
|
+
let base;
|
|
54
|
+
if (rule.ref) {
|
|
55
|
+
base = (0, template_1.pascalCase)(rule.ref);
|
|
56
|
+
}
|
|
57
|
+
else if (rule.type === 'array') {
|
|
58
|
+
const item = rule.itemsRef
|
|
59
|
+
? (0, template_1.pascalCase)(rule.itemsRef)
|
|
60
|
+
: rule.enumValues
|
|
61
|
+
? rule.enumValues.map((v) => (typeof v === 'string' ? `'${escapeSingle(v)}'` : String(v))).join(' | ')
|
|
62
|
+
: tsPrimitive(rule.itemsType);
|
|
63
|
+
base = rule.enumValues && !rule.itemsRef ? `(${item})[]` : `${item}[]`;
|
|
64
|
+
}
|
|
65
|
+
else if (rule.enumValues && rule.enumValues.length > 0) {
|
|
66
|
+
base = rule.enumValues.map((v) => (typeof v === 'string' ? `'${escapeSingle(v)}'` : String(v))).join(' | ');
|
|
67
|
+
}
|
|
68
|
+
else {
|
|
69
|
+
base = tsPrimitive(rule.type);
|
|
70
|
+
}
|
|
71
|
+
return rule.nullable ? `${base} | null` : base;
|
|
72
|
+
}
|
|
73
|
+
function tsPrimitive(type) {
|
|
74
|
+
switch (type) {
|
|
75
|
+
case 'string':
|
|
76
|
+
return 'string';
|
|
77
|
+
case 'integer':
|
|
78
|
+
case 'number':
|
|
79
|
+
return 'number';
|
|
80
|
+
case 'boolean':
|
|
81
|
+
return 'boolean';
|
|
82
|
+
case 'array':
|
|
83
|
+
return 'unknown[]';
|
|
84
|
+
case 'object':
|
|
85
|
+
return 'Record<string, unknown>';
|
|
86
|
+
case undefined:
|
|
87
|
+
case 'unknown':
|
|
88
|
+
default:
|
|
89
|
+
return 'unknown';
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
function escapeSingle(value) {
|
|
93
|
+
return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
|
|
94
|
+
}
|
|
95
|
+
function collectModelImports(schema) {
|
|
96
|
+
const set = new Set();
|
|
97
|
+
if (schema.arrayItemRef)
|
|
98
|
+
set.add(schema.arrayItemRef);
|
|
99
|
+
for (const rule of Object.values(schema.properties)) {
|
|
100
|
+
if (rule.ref)
|
|
101
|
+
set.add(rule.ref);
|
|
102
|
+
if (rule.itemsRef)
|
|
103
|
+
set.add(rule.itemsRef);
|
|
104
|
+
}
|
|
105
|
+
return [...set].sort();
|
|
106
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.emitNavigation = emitNavigation;
|
|
4
|
+
const template_1 = require("../render/template");
|
|
5
|
+
/**
|
|
6
|
+
* Emit `api.navigation.ts` exporting `NavigationItem[]` data that plugs
|
|
7
|
+
* directly into `NavigationService.registerItems(...)` from
|
|
8
|
+
* `@ojiepermana/angular/navigation`.
|
|
9
|
+
*/
|
|
10
|
+
function emitNavigation(ir, target) {
|
|
11
|
+
return [
|
|
12
|
+
{
|
|
13
|
+
path: 'api.navigation.ts',
|
|
14
|
+
content: (0, template_1.finalize)(renderNavigation(ir.navigation, target)),
|
|
15
|
+
},
|
|
16
|
+
];
|
|
17
|
+
}
|
|
18
|
+
function renderNavigation(nodes, target) {
|
|
19
|
+
return `${target.banner}
|
|
20
|
+
|
|
21
|
+
import type { NavigationItem } from '@ojiepermana/angular/navigation';
|
|
22
|
+
|
|
23
|
+
export const ApiNavigation: NavigationItem[] = ${stringifyNodes(nodes, 0, [])};
|
|
24
|
+
`;
|
|
25
|
+
}
|
|
26
|
+
function stringifyNodes(nodes, depth, lineage) {
|
|
27
|
+
if (!nodes.length)
|
|
28
|
+
return '[]';
|
|
29
|
+
const pad = ' '.repeat(depth + 1);
|
|
30
|
+
const closePad = ' '.repeat(depth);
|
|
31
|
+
return `[\n${nodes
|
|
32
|
+
.map((node) => pad + stringifyNode(node, depth + 1, [...lineage, node.name]))
|
|
33
|
+
.join(',\n')},\n${closePad}]`;
|
|
34
|
+
}
|
|
35
|
+
function stringifyNode(node, depth, lineage) {
|
|
36
|
+
const hasChildren = node.children.length > 0;
|
|
37
|
+
const pad = ' '.repeat(depth + 1);
|
|
38
|
+
const closePad = ' '.repeat(depth);
|
|
39
|
+
const fields = [
|
|
40
|
+
`${pad}id: ${JSON.stringify(lineage.map(template_1.kebabCase).filter(Boolean).join('-'))}`,
|
|
41
|
+
`${pad}title: ${JSON.stringify(node.name)}`,
|
|
42
|
+
`${pad}type: ${JSON.stringify(resolveItemType(lineage.length - 1, hasChildren))}`,
|
|
43
|
+
];
|
|
44
|
+
if (node.description)
|
|
45
|
+
fields.push(`${pad}subtitle: ${JSON.stringify(node.description)}`);
|
|
46
|
+
if (node.xIcon)
|
|
47
|
+
fields.push(`${pad}icon: ${JSON.stringify(node.xIcon)}`);
|
|
48
|
+
if (hasChildren)
|
|
49
|
+
fields.push(`${pad}children: ${stringifyNodes(node.children, depth + 1, lineage)}`);
|
|
50
|
+
return `{\n${fields.join(',\n')},\n${closePad}}`;
|
|
51
|
+
}
|
|
52
|
+
function resolveItemType(depth, hasChildren) {
|
|
53
|
+
if (!hasChildren)
|
|
54
|
+
return 'basic';
|
|
55
|
+
return depth === 0 ? 'group' : 'collapsable';
|
|
56
|
+
}
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.emitOperations = emitOperations;
|
|
4
|
+
const template_1 = require("../render/template");
|
|
5
|
+
const models_1 = require("./models");
|
|
6
|
+
/**
|
|
7
|
+
* Emit one tree-shakeable operation function per operationId at
|
|
8
|
+
* `fn/<tag-kebab>/<operation-kebab>.ts`.
|
|
9
|
+
*
|
|
10
|
+
* Each file exports:
|
|
11
|
+
* - `<operationId>$Params` interface
|
|
12
|
+
* - `<operationId>` function returning `Observable<StrictHttpResponse<R>>`
|
|
13
|
+
* - `<operationId>.PATH` constant
|
|
14
|
+
*/
|
|
15
|
+
function emitOperations(ir, target) {
|
|
16
|
+
return ir.operations.map((op) => ({
|
|
17
|
+
path: `fn/${(0, template_1.kebabCase)(op.tag)}/${(0, template_1.kebabCase)(op.operationId)}.ts`,
|
|
18
|
+
content: (0, template_1.finalize)(renderOperation(op, target)),
|
|
19
|
+
}));
|
|
20
|
+
}
|
|
21
|
+
function renderOperation(op, target) {
|
|
22
|
+
const fnName = (0, template_1.camelCase)(op.operationId);
|
|
23
|
+
const paramsName = `${(0, template_1.pascalCase)(op.operationId)}$Params`;
|
|
24
|
+
const responseType = op.successRef ? (0, template_1.pascalCase)(op.successRef) : 'unknown';
|
|
25
|
+
const paramImports = collectParamImports(op);
|
|
26
|
+
const imports = [
|
|
27
|
+
`import { HttpClient, HttpContext, HttpResponse } from '@angular/common/http';`,
|
|
28
|
+
`import { Observable } from 'rxjs';`,
|
|
29
|
+
`import { filter, map } from 'rxjs/operators';`,
|
|
30
|
+
``,
|
|
31
|
+
`import { RequestBuilder } from '../../request-builder';`,
|
|
32
|
+
`import { StrictHttpResponse } from '../../strict-http-response';`,
|
|
33
|
+
];
|
|
34
|
+
for (const name of paramImports) {
|
|
35
|
+
imports.push(`import type { ${(0, template_1.pascalCase)(name)} } from '../../models/${(0, template_1.kebabCase)(name)}';`);
|
|
36
|
+
}
|
|
37
|
+
const paramsInterface = renderParamsInterface(op, paramsName);
|
|
38
|
+
const hasAnyParams = paramsInterface.hasAnyField;
|
|
39
|
+
const paramsOptional = !paramsInterface.anyRequired;
|
|
40
|
+
const bodyCT = op.bodySchemaRef ? "'application/json'" : '';
|
|
41
|
+
const pathCalls = op.params
|
|
42
|
+
.filter((p) => p.in === 'path')
|
|
43
|
+
.map((p) => ` rb.path('${p.name}', params.${safeProp(p.name)});`);
|
|
44
|
+
const queryCalls = op.params
|
|
45
|
+
.filter((p) => p.in === 'query')
|
|
46
|
+
.map((p) => ` rb.query('${p.name}', params.${safeProp(p.name)});`);
|
|
47
|
+
const headerCalls = op.params
|
|
48
|
+
.filter((p) => p.in === 'header')
|
|
49
|
+
.map((p) => ` rb.header('${p.name}', params.${safeProp(p.name)});`);
|
|
50
|
+
const bodyCall = op.bodySchemaRef ? ` rb.body(params.body, ${bodyCT});` : '';
|
|
51
|
+
const populate = pathCalls.length || queryCalls.length || headerCalls.length || bodyCall
|
|
52
|
+
? ` if (params) {
|
|
53
|
+
${[...pathCalls, ...queryCalls, ...headerCalls, bodyCall].filter(Boolean).join('\n')}
|
|
54
|
+
}`
|
|
55
|
+
: '';
|
|
56
|
+
const paramsArg = hasAnyParams
|
|
57
|
+
? `params${paramsOptional ? '?' : ''}: ${paramsName}`
|
|
58
|
+
: `_params?: Record<string, never>`;
|
|
59
|
+
return `${target.banner}
|
|
60
|
+
|
|
61
|
+
${imports.join('\n')}
|
|
62
|
+
|
|
63
|
+
${paramsInterface.source}
|
|
64
|
+
export function ${fnName}(
|
|
65
|
+
http: HttpClient,
|
|
66
|
+
rootUrl: string,
|
|
67
|
+
${paramsArg},
|
|
68
|
+
context?: HttpContext,
|
|
69
|
+
): Observable<StrictHttpResponse<${responseType}>> {
|
|
70
|
+
const rb = new RequestBuilder(rootUrl, ${fnName}.PATH, '${op.method}');
|
|
71
|
+
${populate}
|
|
72
|
+
return http.request(rb.build({ responseType: 'json', accept: 'application/json', context })).pipe(
|
|
73
|
+
filter((r: unknown): r is HttpResponse<unknown> => r instanceof HttpResponse),
|
|
74
|
+
map((r) => r as StrictHttpResponse<${responseType}>),
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
${fnName}.PATH = '${op.path}';
|
|
79
|
+
`;
|
|
80
|
+
}
|
|
81
|
+
function collectParamImports(op) {
|
|
82
|
+
const set = new Set();
|
|
83
|
+
for (const p of op.params) {
|
|
84
|
+
if (p.rule.ref)
|
|
85
|
+
set.add(p.rule.ref);
|
|
86
|
+
if (p.rule.itemsRef)
|
|
87
|
+
set.add(p.rule.itemsRef);
|
|
88
|
+
}
|
|
89
|
+
if (op.bodySchemaRef)
|
|
90
|
+
set.add(op.bodySchemaRef);
|
|
91
|
+
if (op.successRef)
|
|
92
|
+
set.add(op.successRef);
|
|
93
|
+
return [...set].sort();
|
|
94
|
+
}
|
|
95
|
+
function renderParamsInterface(op, paramsName) {
|
|
96
|
+
const lines = [];
|
|
97
|
+
let anyRequired = false;
|
|
98
|
+
const pushField = (p) => {
|
|
99
|
+
const optional = p.required ? '' : '?';
|
|
100
|
+
if (p.required)
|
|
101
|
+
anyRequired = true;
|
|
102
|
+
const type = (0, models_1.renderFieldType)(p.rule);
|
|
103
|
+
const name = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(p.name) ? p.name : `'${p.name}'`;
|
|
104
|
+
lines.push(` ${name}${optional}: ${type};`);
|
|
105
|
+
};
|
|
106
|
+
for (const p of op.params)
|
|
107
|
+
pushField(p);
|
|
108
|
+
if (op.bodySchemaRef) {
|
|
109
|
+
const optional = op.bodyRequired ? '' : '?';
|
|
110
|
+
if (op.bodyRequired)
|
|
111
|
+
anyRequired = true;
|
|
112
|
+
lines.push(` body${optional}: ${(0, template_1.pascalCase)(op.bodySchemaRef)};`);
|
|
113
|
+
}
|
|
114
|
+
const hasAnyField = lines.length > 0;
|
|
115
|
+
const source = hasAnyField
|
|
116
|
+
? `export interface ${paramsName} {\n${lines.join('\n')}\n}\n`
|
|
117
|
+
: `export type ${paramsName} = Record<string, never>;\n`;
|
|
118
|
+
return { source, hasAnyField, anyRequired };
|
|
119
|
+
}
|
|
120
|
+
function safeProp(name) {
|
|
121
|
+
return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : `['${name}']`;
|
|
122
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.emitPublicApi = emitPublicApi;
|
|
4
|
+
const template_1 = require("../render/template");
|
|
5
|
+
/**
|
|
6
|
+
* Emit `public-api.ts` — the barrel that re-exports every generated artifact
|
|
7
|
+
* based on the resolved feature flags. Mirrors the convention used by the
|
|
8
|
+
* reference output in `old/api/index.ts`.
|
|
9
|
+
*/
|
|
10
|
+
function emitPublicApi(ir, target) {
|
|
11
|
+
const lines = [target.banner, ''];
|
|
12
|
+
if (target.features.client) {
|
|
13
|
+
lines.push(`export { ApiConfiguration, provideApiConfiguration } from './api-configuration';`);
|
|
14
|
+
lines.push(`export { BaseService } from './base-service';`);
|
|
15
|
+
lines.push(`export { RequestBuilder } from './request-builder';`);
|
|
16
|
+
lines.push(`export type { StrictHttpResponse } from './strict-http-response';`);
|
|
17
|
+
lines.push(`export { ${target.clientName} } from './api';`);
|
|
18
|
+
lines.push('');
|
|
19
|
+
}
|
|
20
|
+
if (target.features.models) {
|
|
21
|
+
for (const schema of ir.schemas) {
|
|
22
|
+
lines.push(`export type { ${(0, template_1.pascalCase)(schema.name)} } from './models/${(0, template_1.kebabCase)(schema.name)}';`);
|
|
23
|
+
}
|
|
24
|
+
lines.push('');
|
|
25
|
+
}
|
|
26
|
+
if (target.features.services) {
|
|
27
|
+
const tags = Array.from(new Set(ir.operations.map((o) => o.tag))).sort();
|
|
28
|
+
for (const tag of tags) {
|
|
29
|
+
lines.push(`export { ${(0, template_1.pascalCase)(tag)}Service } from './services/${(0, template_1.kebabCase)(tag)}.service';`);
|
|
30
|
+
}
|
|
31
|
+
lines.push('');
|
|
32
|
+
}
|
|
33
|
+
if (target.features.operations) {
|
|
34
|
+
const sorted = [...ir.operations].sort((a, b) => a.operationId.localeCompare(b.operationId));
|
|
35
|
+
for (const op of sorted) {
|
|
36
|
+
lines.push(renderFnReexport(op));
|
|
37
|
+
}
|
|
38
|
+
lines.push('');
|
|
39
|
+
}
|
|
40
|
+
if (target.features.metadata) {
|
|
41
|
+
lines.push(`export * from './metadata';`);
|
|
42
|
+
lines.push(`export * from './openapi-helpers';`);
|
|
43
|
+
lines.push('');
|
|
44
|
+
}
|
|
45
|
+
if (target.features.navigation) {
|
|
46
|
+
lines.push(`export { ApiNavigation } from './api.navigation';`);
|
|
47
|
+
}
|
|
48
|
+
return [{ path: 'public-api.ts', content: (0, template_1.finalize)(lines.join('\n')) }];
|
|
49
|
+
}
|
|
50
|
+
function renderFnReexport(op) {
|
|
51
|
+
const fnName = (0, template_1.camelCase)(op.operationId);
|
|
52
|
+
const paramsName = `${(0, template_1.pascalCase)(op.operationId)}$Params`;
|
|
53
|
+
return `export { ${fnName}, type ${paramsName} } from './fn/${(0, template_1.kebabCase)(op.tag)}/${(0, template_1.kebabCase)(op.operationId)}';`;
|
|
54
|
+
}
|