openxiangda-devkit-core 2.0.0-alpha.98 → 2.0.0

package/dist/compiler/bundle.js

@@ -1,3 +1,5 @@
+import { projectDataResourceView } from 'openxiangda-contracts';
+import { nativeFieldRequiresCreateInputV2 } from 'openxiangda-contracts/native-compiler';
 import { createHash } from 'node:crypto';
 import { canonicalJson, applicationEventHandlerPathV2, DATA_EVENT_TYPES_V2, nativePlatformCapabilityCatalog, OPENXIANGDA_COMPILER_CONTRACT_VERSION, SCHEMA_VERSIONS, WORKFLOW_EVENT_TYPES_V2, sha256Digest, } from 'openxiangda-contracts';
 import { AppConfigValidationError, } from './config.js';
@@ -237,6 +239,9 @@ export function normalizeConfiguration(config) {
                 ...(operation.platformAccess
                     ? {
                         platformAccess: {
+                            ...(operation.platformAccess.roleAssertions ? {
+                                roleAssertions: { roleCodes: uniqueSorted(operation.platformAccess.roleAssertions.roleCodes) },
+                            } : {}),
                             ...(operation.platformAccess.directory
                                 ? {
                                     directory: {
@@ -306,6 +311,19 @@ export function normalizeConfiguration(config) {
         },
         data: {
             resources: sorted((config.data?.resources || []).map(normalizeDataResource), item => item.code),
+            ...((config.data?.resources || []).some(resource => resource.detailRouteCode)
+                ? {
+                    resourceDetailRoutes: sorted((config.data?.resources || []).flatMap(resource => resource.detailRouteCode
+                        ? [
+                            {
+                                resourceCode: resource.code,
+                                desktop: resource.detailRouteCode.desktop,
+                                mobile: resource.detailRouteCode.mobile,
+                            },
+                        ]
+                        : []), item => item.resourceCode),
+                }
+                : {}),
         },
         events: {
             schemas: sorted((config.events?.schemas || []).map(schema => ({
@@ -381,7 +399,7 @@ export function normalizeConfiguration(config) {
             definitions: sorted((config.workflows?.definitions || []).map(item => ({
                 version: item.version,
                 definition: normalizeWorkflowDefinition(item.definition),
-                launch: { mode: item.launch?.mode || 'work-center-only' },
+                launch: normalizeWorkflowLaunchDeclaration(item.launch),
                 ...(item.detailRouteCode
                     ? { detailRouteCode: { ...item.detailRouteCode } }
                     : {}),
@@ -427,12 +445,35 @@ export function normalizeConfiguration(config) {
         },
         frontend: {
             routes: compileFrontendRoutes(config),
+            user: {
+                applicationTodoCenter: config.frontend.user?.applicationTodoCenter === true,
+            },
             devicePolicy: compileRouteManifestDevicePolicy(config),
             authentication: compileApplicationAuthentication(config),
             ...(config.frontend.publicAccess
                 ? { publicAccess: compileAnonymousPublicAccess(config) }
                 : {}),
             admin: {
+                ...(config.frontend.admin?.access
+                    ? {
+                        access: {
+                            ...(config.frontend.admin.access.allOf
+                                ? {
+                                    allOf: uniqueSorted([
+                                        ...config.frontend.admin.access.allOf,
+                                    ]),
+                                }
+                                : {}),
+                            ...(config.frontend.admin.access.anyOf
+                                ? {
+                                    anyOf: uniqueSorted([
+                                        ...config.frontend.admin.access.anyOf,
+                                    ]),
+                                }
+                                : {}),
+                        },
+                    }
+                    : {}),
                 navigation: (config.frontend.admin?.navigation || []).map(group => ({
                     code: group.code,
                     label: group.label,
@@ -593,7 +634,7 @@ function compileContractBundleFromNormalized(config, configDigest, generatorVers
         appCode: config.app.code,
         configDigest,
         perspectives: normalizedConfiguration.perspectives,
-        resources: compileResources(config),
+        resources: compileResources(normalizedConfiguration),
         capabilities,
         operations: compileOperations(config),
         eventConsumers,
@@ -620,7 +661,10 @@ function compileContractBundleFromNormalized(config, configDigest, generatorVers
         ...(config.frontend.publicAccess
             ? { publicAccess: compileAnonymousPublicAccess(config) }
             : {}),
-        routeManifest: compileStandardRouteManifest(config, adminPages),
+        ...(normalizedConfiguration.frontend.admin.access
+            ? { adminAccess: normalizedConfiguration.frontend.admin.access }
+            : {}),
+        routeManifest: compileStandardRouteManifest(config),
         adminPages,
         adminNavigation: compileAdminNavigation(config),
     };
@@ -727,8 +771,79 @@ function generatedResourceOperations(resource) {
         delete: resource.surface?.generated?.delete ?? native,
     };
 }
-function generatedAdminResourcePath(resourceCode, operation) {
-    const base = `/admin/resources/${resourceCode}`;
+function normalizeWorkflowNamedOperationIntent(intent) {
+    return {
+        operationCode: intent.operationCode,
+        inputs: Object.fromEntries(Object.entries(intent.inputs)
+            .sort(([left], [right]) => compare(left, right))
+            .map(([inputCode, binding]) => [inputCode, { ...binding }])),
+        output: { ...intent.output },
+    };
+}
+function normalizeWorkflowLaunchDeclaration(launch) {
+    return {
+        mode: launch?.mode || 'work-center-only',
+        ...(launch?.submission
+            ? {
+                submission: {
+                    kind: 'named-operation',
+                    ...(launch.submission.create
+                        ? {
+                            create: normalizeWorkflowNamedOperationIntent(launch.submission.create),
+                        }
+                        : {}),
+                    ...(launch.submission.existing
+                        ? {
+                            existing: normalizeWorkflowNamedOperationIntent(launch.submission.existing),
+                        }
+                        : {}),
+                    ...(launch.submission.context
+                        ? {
+                            context: [...launch.submission.context]
+                                .map(context => ({ ...context }))
+                                .sort((left, right) => compare(left.queryParameter, right.queryParameter)),
+                        }
+                        : {}),
+                },
+            }
+            : {}),
+    };
+}
+function compileWorkflowNamedOperationIntent(config, intent) {
+    const operation = (config.backend?.operations || []).find(candidate => candidate.code === intent.operationCode);
+    return {
+        ...normalizeWorkflowNamedOperationIntent(intent),
+        method: 'POST',
+        path: operation.path,
+        requiredCapability: operation.capability,
+        requestSchemaDigest: sha256Digest(operation.requestSchema),
+        responseSchemaDigest: sha256Digest(operation.responseSchema),
+    };
+}
+function compileWorkflowLaunchContract(config, launch) {
+    const normalized = normalizeWorkflowLaunchDeclaration(launch);
+    if (!normalized.submission)
+        return { mode: normalized.mode };
+    return {
+        mode: normalized.mode,
+        submission: {
+            kind: 'named-operation',
+            ...(normalized.submission.create
+                ? {
+                    create: compileWorkflowNamedOperationIntent(config, normalized.submission.create),
+                }
+                : {}),
+            ...(normalized.submission.existing
+                ? {
+                    existing: compileWorkflowNamedOperationIntent(config, normalized.submission.existing),
+                }
+                : {}),
+            context: [...(normalized.submission.context || [])],
+        },
+    };
+}
+function generatedAdminResourcePath(resourceCode, operation, viewCode) {
+    const base = `/admin/resources/${resourceCode}${viewCode ? `/views/${viewCode}` : ""}`;
     if (operation === 'list')
         return base;
     if (operation === 'create')
@@ -739,13 +854,18 @@ function generatedAdminResourcePath(resourceCode, operation) {
 }
 function compileAdminPages(config) {
     const pages = [];
-    for (const resource of sorted(config.data?.resources || [], item => item.code)) {
+    for (const selection of sorted(config.data?.resources || [], item => item.code).flatMap(resource => [
+        { resource, viewCode: undefined },
+        ...(resource.surface?.views || []).map(view => ({ viewCode: view.code,
+            resource: { ...resource, name: view.name, surface: projectDataResourceView(resource.surface, view.code) } })),
+    ])) {
+        const { resource, viewCode } = selection;
         const generated = generatedResourceOperations(resource);
         const candidates = [
             {
                 operation: 'list',
                 kind: 'resource-list',
-                path: generatedAdminResourcePath(resource.code, 'list'),
+                path: generatedAdminResourcePath(resource.code, 'list', viewCode),
                 label: resource.name,
                 capability: resource.capabilities.read,
                 navigationEligible: true,
@@ -753,7 +873,7 @@ function compileAdminPages(config) {
             {
                 operation: 'detail',
                 kind: 'resource-detail',
-                path: generatedAdminResourcePath(resource.code, 'detail'),
+                path: generatedAdminResourcePath(resource.code, 'detail', viewCode),
                 label: `${resource.name}详情`,
                 capability: resource.capabilities.read,
                 navigationEligible: false,
@@ -761,7 +881,7 @@ function compileAdminPages(config) {
             {
                 operation: 'create',
                 kind: 'resource-create',
-                path: generatedAdminResourcePath(resource.code, 'create'),
+                path: generatedAdminResourcePath(resource.code, 'create', viewCode),
                 label: `新增${resource.name}`,
                 capability: resource.capabilities.create,
                 navigationEligible: false,
@@ -769,7 +889,7 @@ function compileAdminPages(config) {
             {
                 operation: 'update',
                 kind: 'resource-update',
-                path: generatedAdminResourcePath(resource.code, 'update'),
+                path: generatedAdminResourcePath(resource.code, 'update', viewCode),
                 label: `编辑${resource.name}`,
                 capability: resource.capabilities.update,
                 navigationEligible: false,
@@ -779,13 +899,14 @@ function compileAdminPages(config) {
             if (!generated[candidate.operation])
                 continue;
             pages.push({
-                code: `resource:${resource.code}:${candidate.operation}`,
+                code: `resource:${resource.code}${viewCode ? `:view:${viewCode}` : ""}:${candidate.operation}`,
                 kind: candidate.kind,
                 path: candidate.path,
                 label: candidate.label,
                 navigationEligible: candidate.navigationEligible,
                 capability: candidate.capability,
                 resourceCode: resource.code,
+                ...(viewCode ? { viewCode } : {}),
             });
         }
     }
@@ -797,53 +918,10 @@ function compileAdminPages(config) {
             kind: 'operation',
             path: route.path,
             label: route.label,
-            navigationEligible: !/[:*]/.test(route.path),
+            navigationEligible: !route.path.startsWith('/m/admin') && !/[:*]/.test(route.path),
             routeCode: route.code,
         });
     }
-    if ((config.frontend.admin?.navigation || []).some(group => group.items.some(item => item.page.kind === 'application-todo-center'))) {
-        pages.push({
-            code: 'application:todo-center',
-            kind: 'application-todo-center',
-            path: '/admin/todos',
-            label: '待办中心',
-            navigationEligible: true,
-        });
-    }
-    const workflows = compileWorkflows(config);
-    if (workflows.length) {
-        pages.push({
-            code: 'workflow:work-center',
-            kind: 'workflow-work-center',
-            path: '/admin/work-center',
-            label: '我的审批',
-            navigationEligible: true,
-        }, {
-            code: 'workflow:task',
-            kind: 'workflow-task',
-            path: '/tasks/:taskId',
-            label: '审批任务',
-            navigationEligible: false,
-        }, {
-            code: 'workflow:instance',
-            kind: 'workflow-instance',
-            path: '/workflows/:instanceId',
-            label: '流程详情',
-            navigationEligible: false,
-        });
-    }
-    for (const workflow of workflows) {
-        if (!['standalone', 'hidden-handoff'].includes(workflow.launch.mode))
-            continue;
-        pages.push({
-            code: `workflow:${workflow.code}:launch`,
-            kind: 'workflow-launch',
-            path: `/admin/workflows/${workflow.code}/new`,
-            label: `发起${workflow.title}`,
-            navigationEligible: workflow.launch.mode === 'standalone',
-            workflowCode: workflow.code,
-        });
-    }
     return pages.sort((left, right) => compare(left.code, right.code));
 }
 function routePathParams(path) {
@@ -860,14 +938,14 @@ function compileRouteManifestDevicePolicy(config) {
         ...(config.frontend.devicePolicy || {}),
     };
 }
-function compileStandardRouteManifestRoute(routeCode, path, surface, page) {
+function compileStandardRouteManifestRoute(routeCode, path, surface, access) {
     return {
         routeCode,
         path,
         surface,
         pathParams: routePathParams(path),
-        ...(page?.capability ? { capability: page.capability } : {}),
-        ...(page?.access ? { access: page.access } : {}),
+        ...(access?.capability ? { capability: access.capability } : {}),
+        ...(access?.access ? { access: access.access } : {}),
         requiresAuthentication: true,
     };
 }
@@ -878,35 +956,38 @@ function standardRouteCode(kind, device, workflowCode) {
         return `application.todo-center.${device}`;
     return `${kind.replaceAll('-', '.')}.${device}`;
 }
-function compileStandardRouteManifest(config, adminPages) {
+function compileStandardRouteManifest(config) {
     const routes = [];
-    for (const page of adminPages) {
-        if (page.kind !== 'application-todo-center' &&
-            page.kind !== 'workflow-work-center' &&
-            page.kind !== 'workflow-task' &&
-            page.kind !== 'workflow-instance' &&
-            page.kind !== 'workflow-launch')
-            continue;
-        const workflowCode = page.workflowCode;
-        const desktopPath = page.path;
-        const mobilePath = page.kind === 'application-todo-center'
-            ? '/m/todos'
-            : page.kind === 'workflow-work-center'
-                ? '/m/work-center'
-                : page.kind === 'workflow-task'
-                    ? '/m/tasks/:taskId'
-                    : page.kind === 'workflow-instance'
-                        ? '/m/workflows/:instanceId'
-                        : '/m/workflows/:workflowCode/start';
-        const desktop = compileStandardRouteManifestRoute(standardRouteCode(page.kind, 'desktop', workflowCode), desktopPath, 'admin', page);
-        const mobile = compileStandardRouteManifestRoute(standardRouteCode(page.kind, 'mobile', workflowCode), mobilePath, 'user', page);
+    const addRoute = (code, kind, desktopPath, mobilePath, workflowCode, access) => {
         routes.push({
-            code: page.code,
-            kind: page.kind,
+            code,
+            kind,
             ...(workflowCode ? { workflowCode } : {}),
-            desktop,
-            mobile,
+            desktop: compileStandardRouteManifestRoute(standardRouteCode(kind, 'desktop', workflowCode), desktopPath, 'user', access),
+            mobile: compileStandardRouteManifestRoute(standardRouteCode(kind, 'mobile', workflowCode), mobilePath, 'user', access),
         });
+    };
+    if (config.frontend.user?.applicationTodoCenter === true) {
+        addRoute('application:todo-center', 'application-todo-center', '/todos', '/m/todos');
+    }
+    const workflows = compileWorkflows(config);
+    if (workflows.length > 0) {
+        addRoute('workflow:work-center', 'workflow-work-center', '/work-center', '/m/work-center');
+        addRoute('workflow:task', 'workflow-task', '/tasks/:taskId', '/m/tasks/:taskId');
+        addRoute('workflow:instance', 'workflow-instance', '/workflows/:instanceId', '/m/workflows/:instanceId');
+    }
+    for (const workflow of workflows) {
+        if (!['standalone', 'hidden-handoff'].includes(workflow.launch.mode))
+            continue;
+        const namedCapabilities = uniqueSorted([
+            workflow.launch.submission?.create?.requiredCapability,
+            workflow.launch.submission?.existing?.requiredCapability,
+        ].filter((capability) => Boolean(capability)));
+        addRoute(`workflow:${workflow.code}:launch`, 'workflow-launch', '/workflows/:workflowCode/start', '/m/workflows/:workflowCode/start', workflow.code, namedCapabilities.length === 1
+            ? { capability: namedCapabilities[0] }
+            : namedCapabilities.length > 1
+                ? { access: { anyOf: namedCapabilities } }
+                : undefined);
     }
     const normalizedRoutes = routes.sort((left, right) => compare(left.code, right.code));
     const staticRoute = (device) => {
@@ -975,14 +1056,8 @@ function validManifestStaticPath(path) {
 }
 function pageCodeForReference(reference) {
     if (reference.kind === 'resource')
-        return `resource:${reference.resourceCode}:list`;
-    if (reference.kind === 'operation')
-        return `operation:${reference.routeCode}`;
-    if (reference.kind === 'application-todo-center')
-        return 'application:todo-center';
-    if (reference.kind === 'workflow-work-center')
-        return 'workflow:work-center';
-    return `workflow:${reference.workflowCode}:launch`;
+        return `resource:${reference.resourceCode}${reference.viewCode ? `:view:${reference.viewCode}` : ""}:list`;
+    return `operation:${reference.routeCode}`;
 }
 function compileAdminNavigation(config) {
     return (config.frontend.admin?.navigation || [])
@@ -1061,8 +1136,12 @@ function compileCapabilities(configuration) {
     return [...capabilities.values()].sort((left, right) => compare(left.code, right.code));
 }
 function compileResources(config) {
-    return sorted((config.data?.resources || []).map(sourceResource => {
-        const resource = normalizeDataResource(sourceResource);
+    const detailRouteByResourceCode = new Map((config.data.resourceDetailRoutes || []).map(declaration => [
+        declaration.resourceCode,
+        declaration,
+    ]));
+    return sorted(config.data.resources.map(resource => {
+        const detailRouteCode = detailRouteByResourceCode.get(resource.code);
         return {
             code: resource.code,
             // The platform only receives immutable artifact bytes. Bind the
@@ -1073,6 +1152,14 @@ function compileResources(config) {
                 code: field.code,
                 type: field.type,
             })), field => field.code),
+            ...(detailRouteCode
+                ? {
+                    detailRouteCode: {
+                        desktop: detailRouteCode.desktop,
+                        mobile: detailRouteCode.mobile,
+                    },
+                }
+                : {}),
         };
     }), item => item.code);
 }
@@ -1090,6 +1177,9 @@ function compileOperations(config) {
         ...(operation.platformAccess
             ? {
                 platformAccess: {
+                    ...(operation.platformAccess.roleAssertions ? {
+                        roleAssertions: { roleCodes: uniqueSorted(operation.platformAccess.roleAssertions.roleCodes) },
+                    } : {}),
                     ...(operation.platformAccess.directory
                         ? {
                             directory: {
@@ -1164,10 +1254,8 @@ function compileWorkflows(config) {
                     ? [...currentDefinition.definition.subject.summaryFields]
                     : [],
             },
-            launch: {
-                mode: currentDefinition.launch?.mode || 'work-center-only',
-            },
-            ...(['standalone', 'hidden-handoff'].includes(currentDefinition.launch?.mode || 'work-center-only')
+            launch: compileWorkflowLaunchContract(config, currentDefinition.launch),
+            ...(['standalone', 'hidden-handoff'].includes(currentDefinition.launch?.mode || 'work-center-only') && !currentDefinition.launch?.submission
                 ? {
                     processOperationCode: `openxiangda.workflow.${code}.submit`,
                 }
@@ -1426,6 +1514,9 @@ export function renderGeneratedContracts(config, contract = compileContractBundl
             .map(item => `  ${JSON.stringify(item.code)}: {\n` +
             `    code: ${JSON.stringify(item.code)},\n` +
             `    name: ${JSON.stringify(item.name)},\n` +
+            (item.detailRouteCode
+                ? `    detailRouteCode: ${JSON.stringify(item.detailRouteCode)},\n`
+                : '') +
             `    capabilities: ${JSON.stringify(item.capabilities, null, 2)
                 .split('\n')
                 .map((line, index) => (index === 0 ? line : `    ${line}`))
@@ -1491,6 +1582,9 @@ export function renderGeneratedContracts(config, contract = compileContractBundl
         platformAuthManifest
             ? `export const platformAuthManifest = ${JSON.stringify(platformAuthManifest, null, 2)} as const;`
             : 'export const platformAuthManifest = null;',
+        contract.adminAccess
+            ? `export const adminAccess = ${JSON.stringify(contract.adminAccess, null, 2)} as const;`
+            : 'export const adminAccess = undefined;',
         `export const routeManifest = ${JSON.stringify(contract.routeManifest, null, 2)} as const;`,
         `export const adminPages = ${JSON.stringify(contract.adminPages, null, 2)} as const;`,
         `export const adminNavigation = ${JSON.stringify(contract.adminNavigation, null, 2)} as const;`,
@@ -1526,6 +1620,7 @@ export function renderGeneratedContracts(config, contract = compileContractBundl
         'export type ApplicationAuthenticationSurface = (typeof authenticationSurfaces)[keyof typeof authenticationSurfaces];',
         'export type ApplicationAuthenticationSurfaceCode = ApplicationAuthenticationSurface["routeCode"];',
         'export type AnonymousPublicAccess = typeof anonymousPublicAccess;',
+        'export type AdminAccess = typeof adminAccess;',
         'export type RouteManifest = typeof routeManifest;',
         'export type AdminPage = (typeof adminPages)[number];',
         'export type AdminNavigationGroup = (typeof adminNavigation)[number];',
@@ -1611,6 +1706,7 @@ function normalizeResourceSurface(surface) {
                 ? { requiredHint: field.requiredHint }
                 : {}),
             ...(field.system !== undefined ? { system: field.system } : {}),
+            ...(field.hidden !== undefined ? { hidden: field.hidden } : {}),
             readCapabilities: uniqueSorted(field.readCapabilities),
             createCapabilities: uniqueSorted(field.createCapabilities),
             updateCapabilities: uniqueSorted(field.updateCapabilities),
@@ -1642,6 +1738,7 @@ function normalizeResourceSurface(surface) {
         },
     ]));
     return {
+        ...(surface.views?.length ? { views: sorted(surface.views, view => view.code) } : {}),
         ...(surface.mutationOwner !== undefined
             ? { mutationOwner: surface.mutationOwner }
             : {}),
@@ -1652,6 +1749,7 @@ function normalizeResourceSurface(surface) {
         ...(surface.list
             ? {
                 list: {
+                    ...(surface.list.fieldOrder ? { fieldOrder: [...surface.list.fieldOrder] } : {}),
                     ...(surface.list.defaultPageSize !== undefined
                         ? { defaultPageSize: surface.list.defaultPageSize }
                         : {}),
@@ -1686,7 +1784,7 @@ function defaultResourceSurface(resource) {
             label: field.code,
             type: field.type,
             widget: resolveDataFieldSurfaceWidget(field),
-            ...(field.nullable === false ? { requiredHint: true } : {}),
+            ...(nativeFieldRequiresCreateInputV2(field) ? { requiredHint: true } : {}),
             ...(field.maxLength !== undefined ? { maxLength: field.maxLength } : {}),
             ...(field.precision !== undefined ? { precision: field.precision } : {}),
             ...(field.scale !== undefined ? { scale: field.scale } : {}),