mushroom-cli 1.2.0-alpha.2 → 1.2.0-alpha.20
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/README.md +273 -111
- package/dist/check-update.js +6 -0
- package/dist/common.js +273 -0
- package/dist/config.js +394 -0
- package/dist/docs/bootstrap-theme.min.css +6 -0
- package/dist/docs/bootstrap.min.css +6 -0
- package/dist/docs/bootstrap.min.js +7 -0
- package/{docs → dist/docs}/doc-mt.js +103 -1
- package/{docs → dist/docs}/docs.html +83 -22
- package/dist/docs/docs.v2.html +5097 -0
- package/dist/docs/docs.v2.js +1907 -0
- package/dist/docs/jquery.min.js +4 -0
- package/dist/gen/gen-api-docs-v1.js +110 -0
- package/dist/gen/gen-api-docs.js +306 -0
- package/{gen → dist/gen}/gen-csharp.js +1246 -1414
- package/{gen → dist/gen}/gen-db-docs.js +204 -222
- package/{gen → dist/gen}/gen-js-driver-tarball.js +81 -101
- package/{gen → dist/gen}/gen-js-driver.js +116 -133
- package/dist/gen/gen-ts-driver.js +596 -0
- package/{gen.js → dist/gen.js} +109 -120
- package/{help.js → dist/help.js} +53 -55
- package/dist/init/init-json.js +92 -0
- package/dist/init/init-netcore.js +30 -0
- package/dist/init.js +23 -0
- package/dist/master-file/master-file.js +185 -0
- package/dist/merge.js +70 -0
- package/dist/mr.js +77 -0
- package/dist/types.js +1 -0
- package/dist/update/tsCode.js +82 -0
- package/dist/update.js +20 -0
- package/package.json +64 -27
- package/check-update.js +0 -9
- package/common.js +0 -236
- package/config.js +0 -445
- package/gen/gen-api-docs.js +0 -125
- package/gen/gen-ts-driver.js +0 -460
- package/init/init-json.js +0 -106
- package/init/init-netcore.js +0 -32
- package/init.js +0 -28
- package/master-file/master-file.js +0 -234
- package/merge.js +0 -84
- package/mr.js +0 -82
- package/update/tsCode.js +0 -20
- package/update.js +0 -24
- /package/{docs → dist/docs}/mt-dom-1.0.js +0 -0
- /package/{docs → dist/docs}/mt.extension.js +0 -0
|
@@ -0,0 +1,596 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import * as common from '../common.js';
|
|
3
|
+
function isAllowCache(actions, defaultValue) {
|
|
4
|
+
let result = defaultValue;
|
|
5
|
+
for (let i = 0; i < actions.length; i++) {
|
|
6
|
+
const action = actions[i];
|
|
7
|
+
if (!action ||
|
|
8
|
+
!action.cache ||
|
|
9
|
+
!action.cache.client ||
|
|
10
|
+
!action.cache.client.policy ||
|
|
11
|
+
action.cache.client.policy === 'unset')
|
|
12
|
+
continue;
|
|
13
|
+
if (action.cache.client.policy === 'disabled')
|
|
14
|
+
return false;
|
|
15
|
+
if (action.cache.client.policy === 'allow' || action.cache.client.policy === 'required')
|
|
16
|
+
result = true;
|
|
17
|
+
}
|
|
18
|
+
return result;
|
|
19
|
+
}
|
|
20
|
+
function toVietnameseNonTongue(str) {
|
|
21
|
+
const signText = 'ăâđêôơưàảãạáằẳẵặắầẩẫậấèẻẽẹéềểễệếìỉĩịíòỏõọóồổỗộốờởỡợớùủũụúừửữựứỳỷỹỵýĂÂĐÐÊÔƠƯÀẢÃẠÁẰẲẴẶẮẦẨẪẬẤÈẺẼẸÉỀỂỄỆẾÌỈĨỊÍÒỎÕỌÓỒỔỖỘỐỜỞỠỢỚÙỦŨỤÚỪỬỮỰỨỲỶỸỴÝ';
|
|
22
|
+
const unsignedText = 'aadeoouaaaaaaaaaaaaaaaeeeeeeeeeeiiiiiooooooooooooooouuuuuuuuuuyyyyyAADDEOOUAAAAAAAAAAAAAAAEEEEEEEEEEIIIIIOOOOOOOOOOOOOOOUUUUUUUUUUYYYYY';
|
|
23
|
+
let returnValue = '';
|
|
24
|
+
for (let i = 0; i < str.length; i++) {
|
|
25
|
+
const index = signText.indexOf(str.charAt(i));
|
|
26
|
+
returnValue += index !== -1 ? unsignedText.charAt(index) : str.charAt(i);
|
|
27
|
+
}
|
|
28
|
+
return returnValue;
|
|
29
|
+
}
|
|
30
|
+
function toTypeScriptClassName(str) {
|
|
31
|
+
if (!str)
|
|
32
|
+
return '_';
|
|
33
|
+
const name = toVietnameseNonTongue(str).replace(/\W/g, '_');
|
|
34
|
+
const c = name.charAt(0);
|
|
35
|
+
return ('0' <= c && c <= '9' ? '_' : '') + c.toUpperCase() + name.substring(1);
|
|
36
|
+
}
|
|
37
|
+
function getCSharpTypeFromMushroomType(type) {
|
|
38
|
+
switch (type) {
|
|
39
|
+
case 'string':
|
|
40
|
+
return 'string';
|
|
41
|
+
case 'boolean':
|
|
42
|
+
return 'boolean';
|
|
43
|
+
case 'integer':
|
|
44
|
+
case 'long':
|
|
45
|
+
case 'double':
|
|
46
|
+
return 'number';
|
|
47
|
+
case 'datetime':
|
|
48
|
+
return 'ISODateValue';
|
|
49
|
+
case 'IdRef':
|
|
50
|
+
case 'AutoId':
|
|
51
|
+
return 'IdValue';
|
|
52
|
+
default:
|
|
53
|
+
return 'any';
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
function generateDescription(description, ident = ' ') {
|
|
57
|
+
if (!description)
|
|
58
|
+
return '';
|
|
59
|
+
return `${ident}/**\n${ident} * ${description
|
|
60
|
+
.replace(/\r/g, '')
|
|
61
|
+
.split('\n')
|
|
62
|
+
.map((line) => (line.includes('*/') ? line.replace(/\*\//g, '* /') : line))
|
|
63
|
+
.join('\n' + ident + ' * ')}\n${ident} */\n`;
|
|
64
|
+
}
|
|
65
|
+
function generateTypescriptClass(objectDefination, className, options) {
|
|
66
|
+
let childrenCode = '';
|
|
67
|
+
let code = `export interface ${className} {\n`;
|
|
68
|
+
for (const fieldName in objectDefination) {
|
|
69
|
+
const field = objectDefination[fieldName];
|
|
70
|
+
if (!field)
|
|
71
|
+
continue;
|
|
72
|
+
code += generateDescription(field.description);
|
|
73
|
+
const optionalMark = options?.checkRequired &&
|
|
74
|
+
(field.required || field.validation?.required)
|
|
75
|
+
? ''
|
|
76
|
+
: '?';
|
|
77
|
+
const nullType = optionalMark ? ' | null' : '';
|
|
78
|
+
if (field.type == 'object') {
|
|
79
|
+
const fieldClassName = className + '_' + toTypeScriptClassName(fieldName);
|
|
80
|
+
code += ` ${fieldName}${optionalMark}: ${fieldClassName}${nullType};\n`;
|
|
81
|
+
childrenCode += generateTypescriptClass(field.fields ?? {}, fieldClassName, options);
|
|
82
|
+
}
|
|
83
|
+
else if (field.type == 'keyValue') {
|
|
84
|
+
const valueNullType = options?.checkRequired &&
|
|
85
|
+
(field.values.required || field.values.validation?.required)
|
|
86
|
+
? ''
|
|
87
|
+
: ' | null | undefined';
|
|
88
|
+
if (field.values?.type == 'object') {
|
|
89
|
+
const fieldClassName = className + '_' + toTypeScriptClassName(fieldName);
|
|
90
|
+
code += ` ${fieldName}${optionalMark}: Record<string, ${fieldClassName}${valueNullType}>${nullType};\n`;
|
|
91
|
+
childrenCode += generateTypescriptClass(field.values.fields ?? {}, fieldClassName, options);
|
|
92
|
+
}
|
|
93
|
+
else if (field.values?.type == 'array') {
|
|
94
|
+
const itemNullType = options?.checkRequired &&
|
|
95
|
+
(field.values.items?.required ||
|
|
96
|
+
field.values.items?.validation?.required)
|
|
97
|
+
? ''
|
|
98
|
+
: ' | null | undefined';
|
|
99
|
+
if (field.values.items?.type == 'object') {
|
|
100
|
+
const fieldClassName = className + '_' + toTypeScriptClassName(fieldName);
|
|
101
|
+
code += ` ${fieldName}${optionalMark}: Record<string, Array<${fieldClassName}${itemNullType}>${valueNullType}>${nullType};\n`;
|
|
102
|
+
childrenCode += generateTypescriptClass(field.values.items.fields ?? {}, fieldClassName, options);
|
|
103
|
+
}
|
|
104
|
+
else {
|
|
105
|
+
code += ` ${fieldName}${optionalMark}: Record<string, Array<${getCSharpTypeFromMushroomType(field.values.items?.type ?? 'string')}${itemNullType}>${valueNullType}>${nullType};\n`;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
else {
|
|
109
|
+
code += ` ${fieldName}${optionalMark}: Record<string, ${getCSharpTypeFromMushroomType(field.values?.type ?? 'string')}${valueNullType}>${nullType};\n`;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
else if (field.type == 'array') {
|
|
113
|
+
const itemNullType = options?.checkRequired &&
|
|
114
|
+
(field.items.required || field.items.validation?.required)
|
|
115
|
+
? ''
|
|
116
|
+
: ' | null | undefined';
|
|
117
|
+
if (field.items?.type == 'object') {
|
|
118
|
+
const fieldClassName = className + '_' + toTypeScriptClassName(fieldName);
|
|
119
|
+
code += ` ${fieldName}${optionalMark}: Array<${fieldClassName}${itemNullType}>${nullType};\n`;
|
|
120
|
+
childrenCode += generateTypescriptClass(field.items.fields ?? {}, fieldClassName, options);
|
|
121
|
+
}
|
|
122
|
+
else if (field.items?.type == 'keyValue') {
|
|
123
|
+
const valueNullType = options?.checkRequired &&
|
|
124
|
+
(field.items.values?.required ||
|
|
125
|
+
field.items.values?.validation?.required)
|
|
126
|
+
? ''
|
|
127
|
+
: ' | null | undefined';
|
|
128
|
+
if (field.items.values?.type == 'object') {
|
|
129
|
+
const fieldClassName = className + '_' + toTypeScriptClassName(fieldName);
|
|
130
|
+
code += ` ${fieldName}${optionalMark}: Array<Record<string, ${fieldClassName}${valueNullType}>${itemNullType}>${nullType};\n`;
|
|
131
|
+
childrenCode += generateTypescriptClass(field.items.values.fields ?? {}, fieldClassName, options);
|
|
132
|
+
}
|
|
133
|
+
else {
|
|
134
|
+
code += ` ${fieldName}${optionalMark}: Array<Record<string, ${getCSharpTypeFromMushroomType(field.items.type ?? 'string')}${valueNullType}>${itemNullType}>${nullType};\n`;
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
else {
|
|
138
|
+
code += ` ${fieldName}${optionalMark}: Array<${getCSharpTypeFromMushroomType(field.items?.type ?? 'string')}${itemNullType}>${nullType};\n`;
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
else {
|
|
142
|
+
code += ` ${fieldName}${optionalMark}: ${getCSharpTypeFromMushroomType(field.type ?? 'string')}${nullType};\n`;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
code += '}\n\n';
|
|
146
|
+
return code + childrenCode;
|
|
147
|
+
}
|
|
148
|
+
function generateTypescriptClassFromViewParameters(parameters) {
|
|
149
|
+
if (Array.isArray(parameters)) {
|
|
150
|
+
return ('{\n' +
|
|
151
|
+
parameters
|
|
152
|
+
.map((p) => `${generateDescription(p.description)} ${p.field}${p.validation?.required && p.defaultValue === undefined ? '' : '?'}: ${getCSharpTypeFromMushroomType(p.type || 'string')}${p.isArray ? '[]' : ''}${p.validation?.required && p.defaultValue === undefined ? '' : ' | null'};`)
|
|
153
|
+
.join('\n') +
|
|
154
|
+
'\n}');
|
|
155
|
+
}
|
|
156
|
+
return '{}';
|
|
157
|
+
}
|
|
158
|
+
function generateTopCustomClass(config, entityName, methodName, grantRole, postfix, code) {
|
|
159
|
+
const isKeyValue = config.type == 'keyValue';
|
|
160
|
+
const isArray = isKeyValue ? config.values?.type == 'array' : config.type == 'array';
|
|
161
|
+
const fields = isKeyValue
|
|
162
|
+
? isArray
|
|
163
|
+
? config.values?.items?.fields
|
|
164
|
+
: config.values?.fields
|
|
165
|
+
: isArray
|
|
166
|
+
? config.items?.fields
|
|
167
|
+
: config.fields;
|
|
168
|
+
const type = (isKeyValue
|
|
169
|
+
? isArray
|
|
170
|
+
? config.values?.items?.type
|
|
171
|
+
: config.values?.type
|
|
172
|
+
: isArray
|
|
173
|
+
? config.items?.type
|
|
174
|
+
: config.type) ?? 'string';
|
|
175
|
+
let inputClassName;
|
|
176
|
+
if (type == 'object') {
|
|
177
|
+
if (fields) {
|
|
178
|
+
const roleIndicator = grantRole ? '_' + toTypeScriptClassName(grantRole) + '_' : '';
|
|
179
|
+
inputClassName = `${toTypeScriptClassName(entityName)}_${toTypeScriptClassName(methodName)}${roleIndicator}${postfix}`;
|
|
180
|
+
code.classesCode += generateTypescriptClass(fields, inputClassName, {
|
|
181
|
+
checkRequired: true,
|
|
182
|
+
});
|
|
183
|
+
}
|
|
184
|
+
else {
|
|
185
|
+
inputClassName = 'any';
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
else
|
|
189
|
+
inputClassName = getCSharpTypeFromMushroomType(type);
|
|
190
|
+
return isKeyValue
|
|
191
|
+
? isArray
|
|
192
|
+
? 'Record<string, ' + inputClassName + '[]>'
|
|
193
|
+
: 'Record<string, ' + inputClassName + '>'
|
|
194
|
+
: isArray
|
|
195
|
+
? inputClassName + '[]'
|
|
196
|
+
: inputClassName;
|
|
197
|
+
}
|
|
198
|
+
function generateCustomMethodCode(entityName, actionName, actions) {
|
|
199
|
+
const result = { classesCode: '', methodCode: '' };
|
|
200
|
+
if (!actionName || !actionName.startsWith('_raw_http_method_') || !actions || !actions.length)
|
|
201
|
+
return result;
|
|
202
|
+
actions = actions.filter((action) => action.enabled);
|
|
203
|
+
if (!actions.length)
|
|
204
|
+
return result;
|
|
205
|
+
const methodName = actionName.substring('_raw_http_method_'.length);
|
|
206
|
+
const inputTypes = new Set();
|
|
207
|
+
const outputTypes = new Set();
|
|
208
|
+
actions.forEach((action) => {
|
|
209
|
+
const codeHintDelegator = action?.codeHint?.delegator;
|
|
210
|
+
if (!codeHintDelegator)
|
|
211
|
+
return;
|
|
212
|
+
if (codeHintDelegator.result && !codeHintDelegator.isBinaryResponse) {
|
|
213
|
+
const className = generateTopCustomClass(codeHintDelegator.result, entityName, methodName, actions.length > 1 ? action.grant : '', 'Result', result);
|
|
214
|
+
outputTypes.add(className);
|
|
215
|
+
}
|
|
216
|
+
else {
|
|
217
|
+
outputTypes.add('any');
|
|
218
|
+
}
|
|
219
|
+
if (codeHintDelegator.param && codeHintDelegator.requestBody) {
|
|
220
|
+
const paramClassName = generateTopCustomClass(codeHintDelegator.param, entityName, methodName, actions.length > 1 ? action.grant : '', 'ParamRequest', result);
|
|
221
|
+
const bodyClassName = generateTopCustomClass(codeHintDelegator.requestBody, entityName, methodName, actions.length > 1 ? action.grant : '', 'Request', result);
|
|
222
|
+
inputTypes.add(`CustomMethodRequest<${paramClassName}, ${bodyClassName}>`);
|
|
223
|
+
}
|
|
224
|
+
else if (codeHintDelegator.param) {
|
|
225
|
+
const className = generateTopCustomClass(codeHintDelegator.param, entityName, methodName, actions.length > 1 ? action.grant : '', 'ParamRequest', result);
|
|
226
|
+
inputTypes.add(`CustomMethodParamsRequest<${className}>`);
|
|
227
|
+
}
|
|
228
|
+
else if (codeHintDelegator.requestBody) {
|
|
229
|
+
const className = generateTopCustomClass(codeHintDelegator.requestBody, entityName, methodName, actions.length > 1 ? action.grant : '', 'Request', result);
|
|
230
|
+
inputTypes.add(`CustomMethodBodyRequest<${className}>`);
|
|
231
|
+
}
|
|
232
|
+
else {
|
|
233
|
+
inputTypes.add('MushroomRequest');
|
|
234
|
+
}
|
|
235
|
+
});
|
|
236
|
+
result.methodCode = ` ${methodName}Async: (request: ${inputTypes.size ? [...inputTypes].join(' | ') : 'MushroomRequest'}) => Promise<MushroomResponse<${outputTypes.size ? [...outputTypes].join(' | ') : 'any'}>>;\n`;
|
|
237
|
+
return result;
|
|
238
|
+
}
|
|
239
|
+
export function genTypescriptDriverString(aliasProject, source) {
|
|
240
|
+
if (!aliasProject) {
|
|
241
|
+
return '';
|
|
242
|
+
}
|
|
243
|
+
const entities = common.getEntities(source, aliasProject.allowRoles);
|
|
244
|
+
const extensionsImportLines = [];
|
|
245
|
+
const extensionsExportLines = [];
|
|
246
|
+
const extensionsTypes = [];
|
|
247
|
+
const extensionsCodeLines = [];
|
|
248
|
+
if (Array.isArray(aliasProject.features)) {
|
|
249
|
+
if (aliasProject.features.includes('auth')) {
|
|
250
|
+
extensionsImportLines.push('import * as AuthExtension from "mushroomjs-auth";');
|
|
251
|
+
extensionsExportLines.push('File: FileExtension');
|
|
252
|
+
extensionsTypes.push('AuthExtension.IMushroomAuth & ');
|
|
253
|
+
extensionsCodeLines.push('AuthExtension.useAuth(AuthExtension.AuthLocalStorage, mushroom);');
|
|
254
|
+
}
|
|
255
|
+
if (aliasProject.features.includes('file')) {
|
|
256
|
+
extensionsImportLines.push('import * as FileExtension from "mushroomjs-file";');
|
|
257
|
+
extensionsExportLines.push('Auth: AuthExtension');
|
|
258
|
+
extensionsTypes.push('FileExtension.IMushroomFile & ');
|
|
259
|
+
extensionsCodeLines.push('FileExtension.useFile(mushroom);');
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
let code = `import mushroom, { defineAsyncResource, defineAsyncView, fireEvent, createRestfulAsyncFunction, IdType, IMushroom, Mushroom, MushroomRequest, MushroomRequestSetting, MushroomRestfulRequest, MushroomResponse, MushroomResponseDataType, MushroomResourceBase, MushroomListResource, MushroomFindByIdResource, MushroomCreateResource, MushroomBatchCreateResource, MushroomUpdateResource, MushroomBatchUpdateResource, MushroomPartialUpdateResource, MushroomDeleteResource, MushroomBatchDeleteResource, MushroomExtensibleResource, MushroomViewFunction, MushroomError, IMushroomOfflineResponse, MushroomOfflineResponse, MushroomOfflineResponseState } from "mushroomjs";
|
|
263
|
+
${extensionsImportLines.join('\n')}
|
|
264
|
+
export * from "mushroomjs";
|
|
265
|
+
export const extensions = {
|
|
266
|
+
${extensionsExportLines.join(',\n ')}
|
|
267
|
+
};
|
|
268
|
+
|
|
269
|
+
export type ISODateValue = string | Date;
|
|
270
|
+
export type IdValue = ${source.idType == 'AutoIncInt' || source.idType == 'AutoIncLong' ? 'number' : 'string'};
|
|
271
|
+
|
|
272
|
+
export interface CustomMethodRequest<TParam extends {}, TBody> extends MushroomRequest {
|
|
273
|
+
params?: TParam;
|
|
274
|
+
body?: TBody;
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
export interface CustomMethodParamsRequest<TParam extends {}> extends MushroomRequest {
|
|
278
|
+
params?: TParam;
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
export interface CustomMethodBodyRequest<TBody> extends MushroomRequest {
|
|
282
|
+
body?: TBody;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
`;
|
|
286
|
+
let iApiClassBody = '';
|
|
287
|
+
for (const entityName in entities) {
|
|
288
|
+
const entity = entities[entityName];
|
|
289
|
+
const typescriptClassName = toTypeScriptClassName(entityName);
|
|
290
|
+
code += generateTypescriptClass(entity.fields, typescriptClassName);
|
|
291
|
+
const actions = {};
|
|
292
|
+
iApiClassBody += generateDescription(entity.description);
|
|
293
|
+
iApiClassBody += ` ${entityName}: MushroomResourceBase`;
|
|
294
|
+
let customMethodCode = '';
|
|
295
|
+
for (const actionName in entity.actions) {
|
|
296
|
+
let clientCache = undefined;
|
|
297
|
+
let includeTotal = undefined;
|
|
298
|
+
let offlineMode = undefined;
|
|
299
|
+
if ((actionName === 'findById' || actionName === 'findMany') && entity.actions[actionName]) {
|
|
300
|
+
if (isAllowCache(entity.actions[actionName], true))
|
|
301
|
+
clientCache = true;
|
|
302
|
+
if (actionName === 'findMany' && entity.actions[actionName].some((a) => a.includeTotal))
|
|
303
|
+
includeTotal = true;
|
|
304
|
+
if (entity.actions[actionName].some((a) => a.offlineMode === 'disallow'))
|
|
305
|
+
offlineMode = 'disallow';
|
|
306
|
+
else if (!entity.actions[actionName].length ||
|
|
307
|
+
entity.actions[actionName].some((a) => a.offlineMode === 'allow'))
|
|
308
|
+
offlineMode = 'allow';
|
|
309
|
+
}
|
|
310
|
+
actions[actionName] = {
|
|
311
|
+
clientCache,
|
|
312
|
+
includeTotal,
|
|
313
|
+
offlineMode,
|
|
314
|
+
};
|
|
315
|
+
switch (actionName) {
|
|
316
|
+
case 'findMany': {
|
|
317
|
+
iApiClassBody += ` & MushroomListResource<${typescriptClassName}>`;
|
|
318
|
+
break;
|
|
319
|
+
}
|
|
320
|
+
case 'findById': {
|
|
321
|
+
iApiClassBody += ` & MushroomFindByIdResource<${typescriptClassName}>`;
|
|
322
|
+
break;
|
|
323
|
+
}
|
|
324
|
+
case 'createOne': {
|
|
325
|
+
iApiClassBody += ` & MushroomCreateResource<${typescriptClassName}>`;
|
|
326
|
+
break;
|
|
327
|
+
}
|
|
328
|
+
case 'createMany': {
|
|
329
|
+
iApiClassBody += ` & MushroomBatchCreateResource<${typescriptClassName}>`;
|
|
330
|
+
break;
|
|
331
|
+
}
|
|
332
|
+
case 'updateOne': {
|
|
333
|
+
iApiClassBody += ` & MushroomUpdateResource<${typescriptClassName}>`;
|
|
334
|
+
break;
|
|
335
|
+
}
|
|
336
|
+
case 'updateMany': {
|
|
337
|
+
iApiClassBody += ` & MushroomBatchUpdateResource<${typescriptClassName}>`;
|
|
338
|
+
break;
|
|
339
|
+
}
|
|
340
|
+
case 'updatePartially': {
|
|
341
|
+
iApiClassBody += ` & MushroomPartialUpdateResource<${typescriptClassName}>`;
|
|
342
|
+
break;
|
|
343
|
+
}
|
|
344
|
+
case 'deleteOne': {
|
|
345
|
+
iApiClassBody += ' & MushroomDeleteResource';
|
|
346
|
+
break;
|
|
347
|
+
}
|
|
348
|
+
case 'deleteMany': {
|
|
349
|
+
iApiClassBody += ' & MushroomBatchDeleteResource';
|
|
350
|
+
break;
|
|
351
|
+
}
|
|
352
|
+
default: {
|
|
353
|
+
if (actionName.indexOf('_raw_http_method_') === 0) {
|
|
354
|
+
const customCode = generateCustomMethodCode(entityName, actionName, entity.actions[actionName]);
|
|
355
|
+
customMethodCode += customCode.methodCode;
|
|
356
|
+
code += customCode.classesCode;
|
|
357
|
+
break;
|
|
358
|
+
}
|
|
359
|
+
else {
|
|
360
|
+
common.logWarning(`Unknown action name: ${entityName}.${actionName}`);
|
|
361
|
+
break;
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
if (customMethodCode) {
|
|
367
|
+
code += `export interface ${typescriptClassName}$CustomMethodResource {\n${customMethodCode}}\n`;
|
|
368
|
+
iApiClassBody += ` & ${typescriptClassName}$CustomMethodResource`;
|
|
369
|
+
}
|
|
370
|
+
const views = {};
|
|
371
|
+
let viewCode = '';
|
|
372
|
+
for (const viewName in entity.views) {
|
|
373
|
+
const viewRoles = entity.views[viewName];
|
|
374
|
+
if (!Array.isArray(viewRoles) || !viewRoles.length)
|
|
375
|
+
continue;
|
|
376
|
+
views[viewName] = { clientCache: true };
|
|
377
|
+
const viewParameterTypes = viewRoles.map((view) => {
|
|
378
|
+
const inputType = `${typescriptClassName}$ViewsResource_${viewName}View_${view.grant === '*' ? '' : toTypeScriptClassName(view.grant)}Parameters`;
|
|
379
|
+
const outputType = view.codeHint?.output
|
|
380
|
+
? `${typescriptClassName}$ViewsResource_${viewName}View_${view.grant === '*' ? '' : toTypeScriptClassName(view.grant)}Result`
|
|
381
|
+
: 'any';
|
|
382
|
+
code += `export interface ${inputType} ${generateTypescriptClassFromViewParameters(view.parameters)};
|
|
383
|
+
`;
|
|
384
|
+
if (view.codeHint?.output)
|
|
385
|
+
code += generateTypescriptClass(view.codeHint.output.fields ?? {}, outputType, { checkRequired: true });
|
|
386
|
+
return `MushroomViewFunction<${outputType}, ${inputType}>`;
|
|
387
|
+
});
|
|
388
|
+
viewCode += `
|
|
389
|
+
${viewName}Async: ${viewParameterTypes.join(' | ')};`;
|
|
390
|
+
}
|
|
391
|
+
if (viewCode) {
|
|
392
|
+
code += `export interface ${typescriptClassName}$ViewsResource {
|
|
393
|
+
views: {${viewCode}
|
|
394
|
+
}
|
|
395
|
+
}
|
|
396
|
+
`;
|
|
397
|
+
iApiClassBody += ` & ${typescriptClassName}$ViewsResource`;
|
|
398
|
+
}
|
|
399
|
+
iApiClassBody += `,
|
|
400
|
+
`;
|
|
401
|
+
code += `defineAsyncResource<${typescriptClassName}>(${JSON.stringify({ name: entityName, actions: actions, views: views })});
|
|
402
|
+
|
|
403
|
+
`;
|
|
404
|
+
}
|
|
405
|
+
code += `
|
|
406
|
+
mushroom.$using(${JSON.stringify(common.getRootUrl(source))});
|
|
407
|
+
|
|
408
|
+
(function(){
|
|
409
|
+
${extensionsCodeLines.join('\n')}
|
|
410
|
+
})();
|
|
411
|
+
|
|
412
|
+
export interface IApi extends IMushroom {
|
|
413
|
+
${iApiClassBody}};
|
|
414
|
+
|
|
415
|
+
export type Api = ${extensionsTypes.join('')}IApi;
|
|
416
|
+
|
|
417
|
+
export default mushroom as Api;`;
|
|
418
|
+
return code;
|
|
419
|
+
}
|
|
420
|
+
export function genDtsString(aliasProject, source) {
|
|
421
|
+
if (!aliasProject) {
|
|
422
|
+
return '';
|
|
423
|
+
}
|
|
424
|
+
const entities = common.getEntities(source, aliasProject.allowRoles);
|
|
425
|
+
const extensionsImportLines = [];
|
|
426
|
+
const extensionsExportLines = [];
|
|
427
|
+
const extensionsTypes = [];
|
|
428
|
+
if (Array.isArray(aliasProject.features)) {
|
|
429
|
+
if (aliasProject.features.includes('auth')) {
|
|
430
|
+
extensionsImportLines.push('import * as AuthExtension from "mushroomjs-auth";');
|
|
431
|
+
extensionsExportLines.push('Auth: AuthExtension');
|
|
432
|
+
extensionsTypes.push('AuthExtension.IMushroomAuth & ');
|
|
433
|
+
}
|
|
434
|
+
if (aliasProject.features.includes('file')) {
|
|
435
|
+
extensionsImportLines.push('import * as FileExtension from "mushroomjs-file";');
|
|
436
|
+
extensionsExportLines.push('File: FileExtension');
|
|
437
|
+
extensionsTypes.push('FileExtension.IMushroomFile & ');
|
|
438
|
+
}
|
|
439
|
+
}
|
|
440
|
+
let code = `import { IdType, IMushroom, Mushroom, MushroomRequest, MushroomRequestSetting, MushroomRestfulRequest, MushroomResponse, MushroomResponseDataType, MushroomResourceBase, MushroomListResource, MushroomFindByIdResource, MushroomCreateResource, MushroomBatchCreateResource, MushroomUpdateResource, MushroomBatchUpdateResource, MushroomPartialUpdateResource, MushroomDeleteResource, MushroomBatchDeleteResource, MushroomExtensibleResource, MushroomViewFunction, MushroomError, IMushroomOfflineResponse, MushroomOfflineResponse, MushroomOfflineResponseState } from "mushroomjs";
|
|
441
|
+
${extensionsImportLines.join('\n')}
|
|
442
|
+
export * from "mushroomjs";
|
|
443
|
+
export declare const extensions = {
|
|
444
|
+
${extensionsExportLines.join(',\n ')}
|
|
445
|
+
};
|
|
446
|
+
|
|
447
|
+
export declare type ISODateValue = string | Date;
|
|
448
|
+
export declare type IdValue = ${source.idType == 'AutoIncInt' || source.idType == 'AutoIncLong' ? 'number' : 'string'};
|
|
449
|
+
|
|
450
|
+
export interface CustomMethodRequest<TParam extends {}, TBody> extends MushroomRequest {
|
|
451
|
+
params?: TParam;
|
|
452
|
+
body?: TBody;
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
export interface CustomMethodParamsRequest<TParam extends {}> extends MushroomRequest {
|
|
456
|
+
params?: TParam;
|
|
457
|
+
}
|
|
458
|
+
|
|
459
|
+
export interface CustomMethodBodyRequest<TBody> extends MushroomRequest {
|
|
460
|
+
body?: TBody;
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
`;
|
|
464
|
+
let iApiClassBody = '';
|
|
465
|
+
for (const entityName in entities) {
|
|
466
|
+
const entity = entities[entityName];
|
|
467
|
+
const typescriptClassName = toTypeScriptClassName(entityName);
|
|
468
|
+
code += generateTypescriptClass(entity.fields, typescriptClassName);
|
|
469
|
+
const actions = {};
|
|
470
|
+
iApiClassBody += ` ${entityName}: MushroomResourceBase`;
|
|
471
|
+
let customMethodCode = '';
|
|
472
|
+
for (const actionName in entity.actions) {
|
|
473
|
+
let clientCache = undefined;
|
|
474
|
+
let includeTotal = undefined;
|
|
475
|
+
let offlineMode = undefined;
|
|
476
|
+
if ((actionName === 'findById' || actionName === 'findMany') && entity.actions[actionName]) {
|
|
477
|
+
if (isAllowCache(entity.actions[actionName], true))
|
|
478
|
+
clientCache = true;
|
|
479
|
+
if (actionName === 'findMany' && entity.actions[actionName].some((a) => a.includeTotal))
|
|
480
|
+
includeTotal = true;
|
|
481
|
+
if (entity.actions[actionName].some((a) => a.offlineMode === 'disallow'))
|
|
482
|
+
offlineMode = 'disallow';
|
|
483
|
+
else if (!entity.actions[actionName].length ||
|
|
484
|
+
entity.actions[actionName].some((a) => a.offlineMode === 'allow'))
|
|
485
|
+
offlineMode = 'allow';
|
|
486
|
+
}
|
|
487
|
+
actions[actionName] = {
|
|
488
|
+
clientCache,
|
|
489
|
+
includeTotal,
|
|
490
|
+
offlineMode,
|
|
491
|
+
};
|
|
492
|
+
switch (actionName) {
|
|
493
|
+
case 'findMany': {
|
|
494
|
+
iApiClassBody += ` & MushroomListResource<${typescriptClassName}>`;
|
|
495
|
+
break;
|
|
496
|
+
}
|
|
497
|
+
case 'findById': {
|
|
498
|
+
iApiClassBody += ` & MushroomFindByIdResource<${typescriptClassName}>`;
|
|
499
|
+
break;
|
|
500
|
+
}
|
|
501
|
+
case 'createOne': {
|
|
502
|
+
iApiClassBody += ` & MushroomCreateResource<${typescriptClassName}>`;
|
|
503
|
+
break;
|
|
504
|
+
}
|
|
505
|
+
case 'createMany': {
|
|
506
|
+
iApiClassBody += ` & MushroomBatchCreateResource<${typescriptClassName}>`;
|
|
507
|
+
break;
|
|
508
|
+
}
|
|
509
|
+
case 'updateOne': {
|
|
510
|
+
iApiClassBody += ` & MushroomUpdateResource<${typescriptClassName}>`;
|
|
511
|
+
break;
|
|
512
|
+
}
|
|
513
|
+
case 'updateMany': {
|
|
514
|
+
iApiClassBody += ` & MushroomBatchUpdateResource<${typescriptClassName}>`;
|
|
515
|
+
break;
|
|
516
|
+
}
|
|
517
|
+
case 'updatePartially': {
|
|
518
|
+
iApiClassBody += ` & MushroomPartialUpdateResource<${typescriptClassName}>`;
|
|
519
|
+
break;
|
|
520
|
+
}
|
|
521
|
+
case 'deleteOne': {
|
|
522
|
+
iApiClassBody += ' & MushroomDeleteResource';
|
|
523
|
+
break;
|
|
524
|
+
}
|
|
525
|
+
case 'deleteMany': {
|
|
526
|
+
iApiClassBody += ' & MushroomBatchDeleteResource';
|
|
527
|
+
break;
|
|
528
|
+
}
|
|
529
|
+
default: {
|
|
530
|
+
if (actionName.indexOf('_raw_http_method_') === 0) {
|
|
531
|
+
customMethodCode += ` ${actionName.substring('_raw_http_method_'.length)}Async: (rawRequest: MushroomRequest) => Promise<MushroomResponse<any>>;\n`;
|
|
532
|
+
break;
|
|
533
|
+
}
|
|
534
|
+
else {
|
|
535
|
+
common.logWarning(`Unknown action name: ${entityName}.${actionName}`);
|
|
536
|
+
break;
|
|
537
|
+
}
|
|
538
|
+
}
|
|
539
|
+
}
|
|
540
|
+
}
|
|
541
|
+
if (customMethodCode) {
|
|
542
|
+
code += `export interface ${typescriptClassName}$CustomMethodResource {
|
|
543
|
+
${customMethodCode}}
|
|
544
|
+
`;
|
|
545
|
+
iApiClassBody += ` & ${typescriptClassName}$CustomMethodResource`;
|
|
546
|
+
}
|
|
547
|
+
const views = {};
|
|
548
|
+
let viewCode = '';
|
|
549
|
+
for (const viewName in entity.views) {
|
|
550
|
+
const viewRoles = entity.views[viewName];
|
|
551
|
+
if (!Array.isArray(viewRoles) || !viewRoles.length)
|
|
552
|
+
continue;
|
|
553
|
+
views[viewName] = { clientCache: true };
|
|
554
|
+
const viewParameterTypes = viewRoles.map((view) => {
|
|
555
|
+
const inputType = `${typescriptClassName}$ViewsResource_${viewName}View_${view.grant === '*' ? '' : toTypeScriptClassName(view.grant)}Parameters`;
|
|
556
|
+
const outputType = view.codeHint?.output
|
|
557
|
+
? `${typescriptClassName}$ViewsResource_${viewName}View_${view.grant === '*' ? '' : toTypeScriptClassName(view.grant)}Result`
|
|
558
|
+
: 'any';
|
|
559
|
+
code += `export interface ${inputType} ${generateTypescriptClassFromViewParameters(view.parameters)};\n`;
|
|
560
|
+
if (view.codeHint?.output)
|
|
561
|
+
code += generateTypescriptClass(view.codeHint.output.fields ?? {}, outputType, { checkRequired: true });
|
|
562
|
+
return `MushroomViewFunction<${outputType}, ${inputType}>`;
|
|
563
|
+
});
|
|
564
|
+
viewCode += `
|
|
565
|
+
${viewName}Async: ${viewParameterTypes.join(' | ')},`;
|
|
566
|
+
}
|
|
567
|
+
if (viewCode) {
|
|
568
|
+
code += `export interface ${typescriptClassName}$ViewsResource {
|
|
569
|
+
views: {${viewCode}
|
|
570
|
+
}
|
|
571
|
+
}
|
|
572
|
+
`;
|
|
573
|
+
iApiClassBody += ` & ${typescriptClassName}$ViewsResource`;
|
|
574
|
+
}
|
|
575
|
+
iApiClassBody += `,
|
|
576
|
+
`;
|
|
577
|
+
}
|
|
578
|
+
code += `
|
|
579
|
+
export interface IApi extends IMushroom {
|
|
580
|
+
${iApiClassBody}};
|
|
581
|
+
|
|
582
|
+
declare type Api = ${extensionsTypes.join('')}IApi;
|
|
583
|
+
declare const _default: Api;
|
|
584
|
+
export default _default;`;
|
|
585
|
+
return code;
|
|
586
|
+
}
|
|
587
|
+
export function genTypescriptDriver(args, projectName, project, alias, source) {
|
|
588
|
+
const aliasProject = ((project.tsDriver || {}).alias || {})[alias];
|
|
589
|
+
if (!aliasProject) {
|
|
590
|
+
throw new Error(`Not found gen ts-driver configuration. Please run 'npx mushroom-cli config gen ${projectName} ts-driver OUTPUT_FILE.ts${alias === 'default' ? '' : ' alias ' + alias}' first`);
|
|
591
|
+
}
|
|
592
|
+
const code = genTypescriptDriverString(aliasProject, source);
|
|
593
|
+
common.ensureFolder(aliasProject.output);
|
|
594
|
+
fs.writeFileSync(aliasProject.output, code);
|
|
595
|
+
common.logInfo(`Generated Typescript driver for ${projectName}@${alias} to ${aliasProject.output}`);
|
|
596
|
+
}
|