openxiangda-devkit-core 2.0.0-alpha.12 → 2.0.0-alpha.121

package/dist/testing.js

@@ -0,0 +1,213 @@
+export class PermissionMatrixError extends Error {
+    results;
+    constructor(results) {
+        super(`权限矩阵失败: ${results
+            .filter(result => !result.passed)
+            .map(result => `${result.name} expected=${result.expected} actual=${result.actual}`)
+            .join(", ")}`);
+        this.results = results;
+        this.name = "PermissionMatrixError";
+    }
+}
+export function currentUserFixture(options = {}) {
+    return {
+        userId: options.userId || "user-test",
+        appCode: options.appCode || "reference-app",
+        environmentKey: options.environmentKey || "preproduction",
+        roleCodes: normalized(options.roleCodes || ["instrument_admin"]),
+        capabilityCodes: normalized(options.capabilityCodes || []),
+        isAppSuperAdmin: options.isAppSuperAdmin === true,
+    };
+}
+export function dataRecordEventFixture(options = {}) {
+    const eventType = options.eventType || "openxiangda.data.record.updated.v2";
+    const operation = eventType.endsWith(".created.v2")
+        ? "created"
+        : eventType.endsWith(".deleted.v2")
+            ? "deleted"
+            : "updated";
+    const resourceCode = options.resourceCode || "instruments";
+    const recordId = options.recordId || "00000000-0000-4000-8000-000000000001";
+    const changedFields = normalized(options.changedFields || ["status"]);
+    return {
+        specversion: "1.0",
+        id: options.eventId || "00000000-0000-4000-8000-000000000010",
+        type: eventType,
+        source: `/applications/${options.appCode || "reference-app"}/data-resources/${resourceCode}`,
+        subject: `/records/${recordId}`,
+        time: options.time || "2026-08-24T00:00:00.000Z",
+        datacontenttype: "application/json",
+        dataschema: `openxiangda://events/openxiangda.data.record/${eventType.split(".").at(-1)}`,
+        tenantid: options.tenantId || "tenant-test",
+        appcode: options.appCode || "reference-app",
+        environment: options.environmentKey || "preproduction",
+        traceid: "trace-test",
+        schemaversion: "2.0.0",
+        data: {
+            resourceCode,
+            recordId,
+            operation,
+            revision: options.revision ?? 2,
+            changedFields,
+            changes: options.changes ||
+                Object.fromEntries(changedFields.map(field => [field, { before: "before", after: "after" }])),
+            projection: options.projection || {},
+            actor: { principalType: "user", subjectId: "user-test" },
+            cause: { eventId: null, subscriptionCode: null, depth: 0 },
+            capturePlanRevision: 1,
+        },
+    };
+}
+export function signedEventDeliveryFixture(input) {
+    const rawBody = JSON.stringify(input.event);
+    const timestamp = String(input.timestamp ?? Math.floor(Date.now() / 1000));
+    const signingKeyVersion = String(input.signingKeyVersion ?? 1);
+    const handlerManifestDigest = sha256Digest(input.handlerManifest);
+    const signature = createHmac('sha256', input.signingSecret)
+        .update(eventDeliverySignatureContentV2({
+        timestamp,
+        signingKeyVersion,
+        deliveryId: input.deliveryId,
+        eventId: input.event.id,
+        subscriptionCode: input.subscriptionCode,
+        handlerManifestDigest,
+        rawBody,
+    }))
+        .digest('hex');
+    return {
+        rawBody,
+        handlerManifestDigest,
+        headers: {
+            'content-type': 'application/cloudevents+json; charset=utf-8',
+            'x-openxiangda-event-id': input.event.id,
+            'x-openxiangda-delivery-id': input.deliveryId,
+            'x-openxiangda-subscription-code': input.subscriptionCode,
+            'x-openxiangda-timestamp': timestamp,
+            'x-openxiangda-signing-key-version': signingKeyVersion,
+            'x-openxiangda-handler-manifest-digest': handlerManifestDigest,
+            'x-openxiangda-signature': `v2=${signature}`,
+        },
+    };
+}
+export function eventMatchesSubscription(event, filter = {}) {
+    if (filter.resourceCodes?.length &&
+        !filter.resourceCodes.includes(event.data.resourceCode)) {
+        return false;
+    }
+    if (filter.subject?.equals !== undefined &&
+        event.subject !== filter.subject.equals) {
+        return false;
+    }
+    if (filter.subject?.prefix !== undefined &&
+        !String(event.subject || "").startsWith(filter.subject.prefix)) {
+        return false;
+    }
+    const changed = new Set(event.data.changedFields);
+    if (filter.changedFields?.anyOf?.length &&
+        !filter.changedFields.anyOf.some(field => changed.has(field))) {
+        return false;
+    }
+    if (filter.changedFields?.allOf?.length &&
+        !filter.changedFields.allOf.every(field => changed.has(field))) {
+        return false;
+    }
+    if (filter.changedFields?.noneOf?.some(field => changed.has(field))) {
+        return false;
+    }
+    if (filter.changes?.some(change => !eventChangeMatches(event.data, change))) {
+        return false;
+    }
+    return filter.where ? eventConditionMatches(event.data, filter.where) : true;
+}
+export function simulateEventSubscription(event, input) {
+    if (!eventMatchesSubscription(event, input.filter || {})) {
+        return { matched: false, event: null };
+    }
+    const fields = input.payload?.fields || [];
+    const projection = Object.fromEntries(fields
+        .filter(field => Object.prototype.hasOwnProperty.call(event.data.projection, field))
+        .map(field => [field, event.data.projection[field]]));
+    return {
+        matched: true,
+        event: {
+            ...event,
+            data: {
+                ...event.data,
+                changes: input.payload?.includeChanges === false ? {} : event.data.changes,
+                projection,
+            },
+        },
+    };
+}
+export async function runPermissionMatrix(cases, authorize) {
+    const results = [];
+    for (const testCase of cases) {
+        const actual = (await authorize(testCase)) ? "allow" : "deny";
+        results.push({
+            name: testCase.name,
+            expected: testCase.expected,
+            actual,
+            passed: actual === testCase.expected,
+        });
+    }
+    return results;
+}
+export async function assertPermissionMatrix(cases, authorize) {
+    const results = await runPermissionMatrix(cases, authorize);
+    if (results.some(result => !result.passed)) {
+        throw new PermissionMatrixError(results);
+    }
+    return results;
+}
+function normalized(values) {
+    return [...new Set(values.map(String).map(value => value.trim()).filter(Boolean))]
+        .sort();
+}
+function eventConditionMatches(data, condition) {
+    if ("change" in condition)
+        return eventChangeMatches(data, condition.change);
+    if ("all" in condition) {
+        return condition.all.every(item => eventConditionMatches(data, item));
+    }
+    if ("any" in condition) {
+        return condition.any.some(item => eventConditionMatches(data, item));
+    }
+    return !eventConditionMatches(data, condition.not);
+}
+function eventChangeMatches(data, filter) {
+    const change = data.changes[filter.field];
+    if (!change)
+        return false;
+    return ((!filter.before || eventPredicateMatches(change.before, filter.before)) &&
+        (!filter.after || eventPredicateMatches(change.after, filter.after)));
+}
+function eventPredicateMatches(value, predicate) {
+    if ("exists" in predicate)
+        return predicate.exists === (value !== undefined);
+    if ("eq" in predicate)
+        return canonicalEqual(value, predicate.eq);
+    if ("ne" in predicate)
+        return !canonicalEqual(value, predicate.ne);
+    if ("in" in predicate) {
+        return (predicate.in || []).some(item => canonicalEqual(value, item));
+    }
+    return !(predicate.notIn || []).some(item => canonicalEqual(value, item));
+}
+function canonicalEqual(left, right) {
+    return canonicalJsonValue(left) === canonicalJsonValue(right);
+}
+function canonicalJsonValue(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalJsonValue).join(",")}]`;
+    }
+    if (value && typeof value === "object") {
+        return `{${Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, item]) => `${JSON.stringify(key)}:${canonicalJsonValue(item)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+import { eventDeliverySignatureContentV2, sha256Digest, } from "openxiangda-contracts";
+import { createHmac } from 'node:crypto';
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"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"}

package/dist/toolchain-capsule.d.ts

@@ -0,0 +1,45 @@
+import { type Diagnostic } from "openxiangda-contracts";
+export declare const TOOLCHAIN_CAPSULE_SCHEMA_VERSION: "openxiangda.toolchain-capsule/v1";
+export declare const TOOLCHAIN_CAPSULE_MAX_PACKAGE_FILES = 2000;
+export declare const TOOLCHAIN_CAPSULE_MAX_MANIFEST_BYTES = 1000000;
+/**
+ * These are the minimum app-facing packages owned by the official application
+ * template. This is a contract boundary, not a version table: versions are
+ * always read from the current template/package manifests. Additional
+ * openxiangda-* packages discovered in the template are included as well.
+ */
+export declare const TOOLCHAIN_CAPSULE_PACKAGE_NAMES: readonly ["openxiangda"];
+export declare function isOpenXiangdaPackageName(name: string): boolean;
+export type ToolchainCapsulePackageName = (typeof TOOLCHAIN_CAPSULE_PACKAGE_NAMES)[number];
+export interface ToolchainCapsule {
+    readonly schemaVersion: typeof TOOLCHAIN_CAPSULE_SCHEMA_VERSION;
+    readonly owner: "cli-template" | "devkit-core";
+    readonly packages: Readonly<Record<string, string>>;
+}
+export interface WorkspaceToolchainDependency {
+    readonly name: string;
+    readonly specifier: string;
+    readonly packageFile: string;
+    readonly section: string;
+}
+export interface ToolchainCapsuleMismatch {
+    readonly expected: string | null;
+    readonly actual: string;
+    readonly packageFile: string;
+    readonly section: string;
+}
+export declare class ToolchainCapsuleScanLimitError extends Error {
+    readonly code: "OPENXIANGDA_WORKSPACE_CAPSULE_SCAN_LIMIT";
+    constructor(message: string);
+}
+export declare function createToolchainCapsule(packages: ReadonlyMap<string, string> | Readonly<Record<string, string>>, owner?: ToolchainCapsule["owner"]): ToolchainCapsule;
+/**
+ * A framework-neutral devkit caller has no CLI template owner. It can still
+ * reject a stale core/contracts pair using the two versions it actually
+ * executes and imports.
+ */
+export declare function defaultDevkitCoreToolchainCapsule(): ToolchainCapsule;
+export declare function collectWorkspaceToolchainDependencies(root: string): WorkspaceToolchainDependency[];
+export declare function toolchainCapsuleMismatches(dependencies: readonly WorkspaceToolchainDependency[], capsule: ToolchainCapsule): ToolchainCapsuleMismatch[];
+export declare function toolchainCapsuleDiagnostic(dependencies: readonly WorkspaceToolchainDependency[], capsule: ToolchainCapsule): Diagnostic | undefined;
+//# sourceMappingURL=toolchain-capsule.d.ts.map

package/dist/toolchain-capsule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain-capsule.d.ts","sourceRoot":"","sources":["../src/toolchain-capsule.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,gCAAgC,EAC3C,kCAA2C,CAAC;AAC9C,eAAO,MAAM,mCAAmC,OAAQ,CAAC;AACzD,eAAO,MAAM,oCAAoC,UAAY,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,0BAA2B,CAAC;AAExE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,WAEpD;AAED,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IAChE,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAG,0CAA0C,CAAU;gBAExD,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACxE,KAAK,GAAE,gBAAgB,CAAC,OAAO,CAAkB,GAChD,gBAAgB,CAiBlB;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,IAAI,gBAAgB,CAmBpE;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,MAAM,GACX,4BAA4B,EAAE,CA2EhC;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,SAAS,4BAA4B,EAAE,EACrD,OAAO,EAAE,gBAAgB,GACxB,wBAAwB,EAAE,CA+B5B;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,SAAS,4BAA4B,EAAE,EACrD,OAAO,EAAE,gBAAgB,GACxB,UAAU,GAAG,SAAS,CAmBxB"}

package/dist/toolchain-capsule.js

@@ -0,0 +1,165 @@
+import { SCHEMA_VERSIONS, } from "openxiangda-contracts";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { OPENXIANGDA_TOOLCHAIN_VERSION } from "./version.js";
+export const TOOLCHAIN_CAPSULE_SCHEMA_VERSION = "openxiangda.toolchain-capsule/v1";
+export const TOOLCHAIN_CAPSULE_MAX_PACKAGE_FILES = 2_000;
+export const TOOLCHAIN_CAPSULE_MAX_MANIFEST_BYTES = 1_000_000;
+/**
+ * These are the minimum app-facing packages owned by the official application
+ * template. This is a contract boundary, not a version table: versions are
+ * always read from the current template/package manifests. Additional
+ * openxiangda-* packages discovered in the template are included as well.
+ */
+export const TOOLCHAIN_CAPSULE_PACKAGE_NAMES = ["openxiangda"];
+export function isOpenXiangdaPackageName(name) {
+    return name === "openxiangda" || name.startsWith("openxiangda-");
+}
+export class ToolchainCapsuleScanLimitError extends Error {
+    code = "OPENXIANGDA_WORKSPACE_CAPSULE_SCAN_LIMIT";
+    constructor(message) {
+        super(message);
+        this.name = "ToolchainCapsuleScanLimitError";
+    }
+}
+export function createToolchainCapsule(packages, owner = "cli-template") {
+    const entries = packages instanceof Map
+        ? [...packages.entries()]
+        : Object.entries(packages);
+    const normalized = Object.fromEntries(entries
+        .filter(([name, version]) => isOpenXiangdaPackageName(name) && Boolean(String(version).trim()))
+        .map(([name, version]) => [name, String(version).trim()])
+        .sort(([left], [right]) => left.localeCompare(right)));
+    return Object.freeze({
+        schemaVersion: TOOLCHAIN_CAPSULE_SCHEMA_VERSION,
+        owner,
+        packages: Object.freeze(normalized),
+    });
+}
+/**
+ * A framework-neutral devkit caller has no CLI template owner. It can still
+ * reject a stale core/contracts pair using the two versions it actually
+ * executes and imports.
+ */
+export function defaultDevkitCoreToolchainCapsule() {
+    const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+    const contractsVersion = String(manifest.dependencies?.["openxiangda-contracts"] || "").trim();
+    if (!contractsVersion || /[<>=*^~| ]/.test(contractsVersion)) {
+        throw new Error("OPENXIANGDA_CONTRACT_DEPENDENCY_NOT_EXACT");
+    }
+    return createToolchainCapsule(new Map([
+        ["openxiangda-contracts", contractsVersion],
+        ["openxiangda-devkit-core", OPENXIANGDA_TOOLCHAIN_VERSION],
+    ]), "devkit-core");
+}
+export function collectWorkspaceToolchainDependencies(root) {
+    const dependencies = [];
+    let packageFileCount = 0;
+    const visit = (directory) => {
+        for (const entry of readdirSync(directory, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name))) {
+            if ([
+                "node_modules",
+                "dist",
+                "coverage",
+                "playwright-report",
+                "test-results",
+                ".git",
+                ".openxiangda",
+                ".turbo",
+            ].includes(entry.name)) {
+                continue;
+            }
+            const path = join(directory, entry.name);
+            if (entry.isDirectory()) {
+                visit(path);
+                continue;
+            }
+            if (!entry.isFile() || entry.name !== "package.json")
+                continue;
+            packageFileCount += 1;
+            if (packageFileCount > TOOLCHAIN_CAPSULE_MAX_PACKAGE_FILES) {
+                throw new ToolchainCapsuleScanLimitError(`workspace package.json count exceeds ${TOOLCHAIN_CAPSULE_MAX_PACKAGE_FILES}`);
+            }
+            const manifestBytes = statSync(path).size;
+            if (manifestBytes > TOOLCHAIN_CAPSULE_MAX_MANIFEST_BYTES) {
+                throw new ToolchainCapsuleScanLimitError(`${relative(root, path)} exceeds ${TOOLCHAIN_CAPSULE_MAX_MANIFEST_BYTES} bytes`);
+            }
+            const packageJson = JSON.parse(readFileSync(path, "utf8"));
+            for (const section of [
+                "dependencies",
+                "devDependencies",
+                "peerDependencies",
+                "optionalDependencies",
+            ]) {
+                const values = packageJson[section];
+                if (!values || typeof values !== "object")
+                    continue;
+                for (const [name, specifier] of Object.entries(values)) {
+                    if (!isOpenXiangdaPackageName(name)) {
+                        continue;
+                    }
+                    dependencies.push({
+                        name,
+                        specifier: String(specifier),
+                        packageFile: relative(root, path).replaceAll("\\", "/"),
+                        section,
+                    });
+                }
+            }
+        }
+    };
+    if (!existsSync(root))
+        return dependencies;
+    visit(root);
+    return dependencies.sort((left, right) => left.name.localeCompare(right.name) ||
+        left.packageFile.localeCompare(right.packageFile) ||
+        left.section.localeCompare(right.section));
+}
+export function toolchainCapsuleMismatches(dependencies, capsule) {
+    const expected = capsule.packages;
+    const relevant = dependencies.filter(item => isOpenXiangdaPackageName(item.name) &&
+        (capsule.owner === "cli-template" ||
+            Object.prototype.hasOwnProperty.call(expected, item.name)));
+    const actualByName = new Map();
+    for (const dependency of relevant) {
+        const values = actualByName.get(dependency.name) || new Set();
+        values.add(dependency.specifier);
+        actualByName.set(dependency.name, values);
+    }
+    const mismatches = [];
+    for (const dependency of relevant) {
+        const expectedVersion = String(expected[dependency.name] || "");
+        const values = actualByName.get(dependency.name) || new Set();
+        if (dependency.specifier !== expectedVersion ||
+            values.size > 1) {
+            mismatches.push({
+                expected: expectedVersion || null,
+                actual: dependency.specifier,
+                packageFile: dependency.packageFile,
+                section: dependency.section,
+            });
+        }
+    }
+    return mismatches;
+}
+export function toolchainCapsuleDiagnostic(dependencies, capsule) {
+    const mismatches = toolchainCapsuleMismatches(dependencies, capsule);
+    if (mismatches.length === 0)
+        return undefined;
+    return {
+        schemaVersion: SCHEMA_VERSIONS.diagnostic,
+        code: "OPENXIANGDA_WORKSPACE_CAPSULE_MISMATCH",
+        severity: "error",
+        message: "工作区 OpenXiangda 依赖与当前 CLI 模板版本胶囊不一致",
+        path: "package.json",
+        retryable: false,
+        remediation: "使用当前 CLI 重新 create，或将所有 OpenXiangda 包更新为胶囊中的精确版本后运行 pnpm install --frozen-lockfile",
+        details: {
+            owner: capsule.owner,
+            schemaVersion: capsule.schemaVersion,
+            expected: capsule.packages,
+            mismatches,
+        },
+    };
+}
+//# sourceMappingURL=toolchain-capsule.js.map

package/dist/toolchain-capsule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain-capsule.js","sourceRoot":"","sources":["../src/toolchain-capsule.ts"],"names":[],"mappings":"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"}

package/dist/workspace-loader.d.ts

@@ -1,4 +1,4 @@
-import type { OpenXiangdaAppConfig } from 'openxiangda-compiler';
+import { type OpenXiangdaAppConfig } from './compiler/config.js';
 import { createWorkspaceContext } from './workspace.js';
 export interface LoadedWorkspace {
     root: string;

package/dist/workspace-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-loader.d.ts","sourceRoot":"","sources":["../src/workspace-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;CACpD;AAED,wBAAsB,aAAa,CACjC,KAAK,SAAgB,EACrB,gBAAgB,SAAgC,GAC/C,OAAO,CAAC,eAAe,CAAC,CAyB1B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,SAAgB;;;EAetD;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,iCAqCrD;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAS/C"}
+{"version":3,"file":"workspace-loader.d.ts","sourceRoot":"","sources":["../src/workspace-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;CACpD;AAED,wBAAsB,aAAa,CACjC,KAAK,SAAgB,EACrB,gBAAgB,SAAgC,GAC/C,OAAO,CAAC,eAAe,CAAC,CAyB1B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,SAAgB;;;EAetD;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,iCA4ErD;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAS/C"}

package/dist/workspace-loader.js

@@ -1,7 +1,9 @@
 import { execFileSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join, parse, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { build } from 'esbuild';
+import { defineOpenXiangdaApp, } from './compiler/config.js';
 import { OPENXIANGDA_TOOLCHAIN_VERSION } from './version.js';
 import { createWorkspaceContext } from './workspace.js';
 const CONFIG_NAMES = ['openxiangda.config.ts', 'openxiangda-app.config.ts'];
@@ -47,12 +49,36 @@ export function discoverWorkspace(start = process.cwd()) {
     throw Object.assign(new Error('未找到 openxiangda.config.ts；当前目录不是 2.0 应用工作区'), { code: 'OPENXIANGDA_V2_WORKSPACE_NOT_FOUND' });
 }
 export async function loadAppConfig(configPath) {
+    const moduleRoot = dirname(fileURLToPath(import.meta.url));
+    const schemaCompositionModule = [
+        join(moduleRoot, 'compiler', 'schema-composition.js'),
+        join(moduleRoot, 'compiler', 'schema-composition.ts'),
+    ].find(existsSync);
+    if (!schemaCompositionModule) {
+        throw new Error('OPENXIANGDA_CONFIG_SCHEMA_HELPERS_MISSING');
+    }
+    const configHelpersModule = [
+        join(moduleRoot, 'compiler', 'config.js'),
+        join(moduleRoot, 'compiler', 'config.ts'),
+    ].find(existsSync);
+    const modelHelpersModule = [
+        join(moduleRoot, 'compiler', 'application-model.js'),
+        join(moduleRoot, 'compiler', 'application-model.ts'),
+    ].find(existsSync);
+    if (!configHelpersModule || !modelHelpersModule) {
+        throw new Error('OPENXIANGDA_CONFIG_HELPERS_MISSING');
+    }
     const result = await build({
         entryPoints: [configPath],
         bundle: true,
         format: 'esm',
         platform: 'node',
         target: 'node20',
+        // Application workspace packages expose committed JavaScript for normal
+        // Node/Vite execution and their current TypeScript sources only to the
+        // declaration compiler. This prevents stale dist files from being sealed
+        // while keeping production runtimes free of TypeScript loaders.
+        conditions: ['openxiangda-source', 'import', 'default'],
         write: false,
         sourcemap: false,
         logLevel: 'silent',
@@ -60,10 +86,16 @@ export async function loadAppConfig(configPath) {
             {
                 name: 'openxiangda-config-contract',
                 setup(context) {
-                    context.onResolve({ filter: /^openxiangda-devkit-core$/ }, () => ({ path: 'devkit-core', namespace: 'openxiangda-config' }));
+                    context.onResolve({ filter: /^openxiangda-config-helpers$/ }, () => ({ path: configHelpersModule }));
+                    context.onResolve({ filter: /^openxiangda-model-helpers$/ }, () => ({ path: modelHelpersModule }));
+                    context.onResolve({ filter: /^openxiangda-schema-composition$/ }, () => ({ path: schemaCompositionModule }));
+                    context.onResolve({ filter: /^openxiangda\/config$/ }, () => ({ path: 'config', namespace: 'openxiangda-config' }));
                     context.onLoad({ filter: /.*/, namespace: 'openxiangda-config' }, () => ({
                         loader: 'js',
-                        contents: 'export const defineOpenXiangdaApp = value => Object.freeze(value);',
+                        contents: 'export const defineOpenXiangdaApp = value => Object.freeze(value); export const defineAdminNavigation = value => Object.freeze(value); export const adminNavigationGroup = (code, label, items, options = {}) => ({ code, label, items, ...options }); export const adminResourcePage = (resourceCode, options = {}) => ({ page: { kind: "resource", resourceCode }, ...options }); export const adminOperationPage = (routeCode, options = {}) => ({ page: { kind: "operation", routeCode }, ...options }); export const adminApplicationTodoCenterPage = (options = {}) => ({ page: { kind: "application-todo-center" }, ...options }); export const resourceCapabilityCodes = (appCode, resourceCode) => { const prefix = `app:${appCode}:data:${resourceCode}`; return { read: `${prefix}:read`, create: `${prefix}:create`, update: `${prefix}:update`, delete: `${prefix}:delete` }; }; export const currentUserDataPolicy = input => ({ code: input.code, name: input.name, resourceCode: input.resourceCode, ...(input.unrestrictedRoleCodes ? { unrestrictedRoleCodes: [...input.unrestrictedRoleCodes] } : {}), matchMode: "AND", rules: [{ subject: "current_user", field: input.field, roleCodes: [...input.roleCodes] }] }); export const dataPolicyExpression = { allOf: (...values) => ({ allOf: values }), anyOf: (...values) => ({ anyOf: values }), constant: input => ({ ...input }), null: input => ({ ...input }), databaseNow: input => ({ ...input, operand: "db_now" }), currentUser: input => ({ ...input, subject: "current_user" }), dimension: input => ({ ...input }), relation: input => ({ ...input }) }; export const resourceReadPolicy = input => ({ code: input.code, name: input.name, resourceCode: input.resourceCode, ...(input.unrestrictedRoleCodes ? { unrestrictedRoleCodes: [...input.unrestrictedRoleCodes] } : {}), matchMode: input.writeBoundary === "capability_only" ? "AND" : input.matchMode, rules: input.writeBoundary === "capability_only" ? [] : input.rules, readExpression: input.expression, ...(input.writeBoundary === "capability_only" ? { writeBoundary: "capability_only" } : {}) });' +
+                            ' export { composeAppOperationSchemas, composeJsonSchema, resourceRecordSchema, schemaRef } from "openxiangda-schema-composition";' +
+                            ' export { defineApplicationModule, defineDataModel, defineResourceForm, defineResourceList } from "openxiangda-model-helpers";' +
+                            ' export { resourceRoleCapabilities } from "openxiangda-config-helpers";',
                     }));
                 },
             },
@@ -75,7 +107,7 @@ export async function loadAppConfig(configPath) {
     const module = (await import(`data:text/javascript;base64,${Buffer.from(source).toString('base64')}`));
     if (!module.default)
         throw new Error('OPENXIANGDA_V2_CONFIG_DEFAULT_REQUIRED');
-    return module.default;
+    return defineOpenXiangdaApp(module.default);
 }
 export function git(root, args) {
     try {

package/dist/workspace-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-loader.js","sourceRoot":"","sources":["../src/workspace-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace-loader.js","sourceRoot":"","sources":["../src/workspace-loader.ts"],"names":[],"mappings":"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"}

package/dist/workspace-operation.d.ts

@@ -0,0 +1,3 @@
+/** 本机工作区互斥；部署状态仍由平台持有。异常退出的锁由操作者确认进程退出后处理。 */
+export declare function withWorkspaceOperation<T>(root: string | undefined, operation: string, execute: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=workspace-operation.d.ts.map

package/dist/workspace-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operation.d.ts","sourceRoot":"","sources":["../src/workspace-operation.ts"],"names":[],"mappings":"AAIA,8CAA8C;AAC9C,wBAAsB,sBAAsB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBlI"}

package/dist/workspace-operation.js

@@ -0,0 +1,45 @@
+import { randomUUID } from 'node:crypto';
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+/** 本机工作区互斥；部署状态仍由平台持有。异常退出的锁由操作者确认进程退出后处理。 */
+export async function withWorkspaceOperation(root, operation, execute) {
+    const directory = resolve(root || process.cwd(), '.openxiangda');
+    mkdirSync(directory, { recursive: true });
+    const path = resolve(directory, 'operation.lock');
+    const token = randomUUID();
+    let descriptor;
+    try {
+        descriptor = openSync(path, 'wx', 0o600);
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            throw new Error(`WORKSPACE_OPERATION_BUSY: 工作区已有检查或部署持有 ${path}；等待其完成。异常退出时先确认锁中进程已退出，再移除锁文件`);
+        }
+        throw error;
+    }
+    try {
+        writeFileSync(descriptor, JSON.stringify({ pid: process.pid, token, operation, startedAt: new Date().toISOString() }));
+    }
+    catch (error) {
+        unlinkSync(path);
+        throw error;
+    }
+    finally {
+        closeSync(descriptor);
+    }
+    try {
+        return await execute();
+    }
+    finally {
+        if (existsSync(path)) {
+            let owner;
+            try {
+                owner = JSON.parse(readFileSync(path, 'utf8'));
+            }
+            catch { /* 无法识别的锁不自动删除。 */ }
+            if (owner?.token === token)
+                unlinkSync(path);
+        }
+    }
+}
+//# sourceMappingURL=workspace-operation.js.map

package/dist/workspace-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-operation.js","sourceRoot":"","sources":["../src/workspace-operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAI,IAAwB,EAAE,SAAiB,EAAE,OAAyB;IACpH,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IACjE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAAC,CAAC;IACjD,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,+BAA+B,CAAC,CAAC;QACjG,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IAC/H,OAAO,KAAK,EAAE,CAAC;QAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;YACxC,CAAC;QAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAAC,CAAC;IAClC,IAAI,CAAC;QAAC,OAAO,MAAM,OAAO,EAAE,CAAC;IAAC,CAAC;YACvB,CAAC;QACP,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,KAAqC,CAAC;YAC1C,IAAI,CAAC;gBAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YACpF,IAAI,KAAK,EAAE,KAAK,KAAK,KAAK;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}