omc-core 0.4.36 → 0.4.38

package/dist/wire-facts.js

@@ -0,0 +1,88 @@
+/**
+ * CloudPivot 平台 wire 事实（真机实证）：规则状态/动态源键/模型互删码/运行面查询提交契约与算子表。
+ * 原居 omc-cli 契约文件；C1 拆分后真 lane 与假平台（@stalfh233/omc-fake-platform）共同取用——一张表喂两个适配器。
+ */
+export const RULE_STATUS = Object.freeze({ enabled: "ENABLE", disabled: "DISABLED" });
+export const DYNAMIC_CONDITION_SOURCE_KEY = "currentSchemaDataItem";
+export const DYNAMIC_ACTION_SOURCE_KEY = "currentDataItemValue";
+export const MODEL_REFERENCED_DELETE_ERRCODE = 50000;
+/**
+ * M2 runtime-data wire facts (live-proven). The submit chain, the replayToken
+ * gate, the three-layer queryCondition, and the propertyType injection are the
+ * single source for the handler, the arg schemas, and the fake.
+ */
+export const RUNTIME_DATA_WIRE = Object.freeze({
+    queryConditionShape: "List<List<List<FilterModel>>>（level 1 AND across groups, level 2 OR across and-groups, level 3 AND across leaves）",
+    dslShape: "or>and>叶子",
+    queryBodyCanon: "filters:[], queryVersion:1, queryCode=schemaCode, showTotal",
+    typeCastErrcode: 10009,
+    emptyModelErrcode: 301005,
+    absenceErrcode: 304001,
+    formTypeNoWorkflow: "2",
+    formTypeWorkflow: "1",
+    replayTokenEndpoint: "/api/api/runtime/form/getReplayToken",
+    replayTokenErrcode: 100005,
+    approvalNpeErrcode: 50000,
+    workflowStartDuplicateErrcode: 40000,
+    submitChain: "submit 自持久化（ticket 18 源码证据）：form/submit 持久化 bizObject.data——formType=2 submitBizSheet→saveBizObject（置 COMPLETED，mergeObject 合并）；formType=1 workItem→SubmitDataChangeHandlerImpl.updateBizObject；payload {id,schemaCode,sheetCode,ownerId?,data}+actionCode:\"submit\"，owner 服务端以库内行回填，data 剥 engine 键（sequenceStatus/sequenceNo）",
+    submitInPlace: "无流程且 bizObjectId 有值时先 form/load 预检（缺席 304001 拒绝），再以预检行+formData 合成最小对象直提 runtime/form/submit（submit 自持久化，无预 save/构建 load）；submit 返回 objectId 必须仍是目标 id，否则拒绝；仅无 workflowCode/workItemId/workflowInstanceId 的无 id 便捷链先 form/save 建稿再直提（新建记录）；带 workItemId 或 workflowInstanceId 而缺 bizObjectId 时 fail-closed 拒绝（submit-biz-object-id-required）；workflowCode + 既有无实例 bizObjectId 在 8.6.26 无 REST 就地面（见 workflowStartCreateOnly），持续拒绝并指向 workflowDraftSave 两段式",
+    workflowDraftSave: "门户暂存形状（ticket 13）：POST runtime/form/save 顶层带 workflowCode（无 workflowInstanceId/workItemId）→ FormRuntimeController.saveWorkflow→startWorkflow(finishStart=FALSE)：同 id 建 DRAFT 行 + DRAFT 流程实例 + 发起 workItem，FormSaveVO 返回 {objectId,workflowInstanceId,workItem:{id}}；必须先 GET getReplayToken（isStartWf 分支 verifyReplay，否则 100005），且 data 显式 sequenceStatus:\"DRAFT\"（createAndGetBizObject 空缺省按 PROCESSING 建实例）；提交该草稿 = form/submit formType=1 + workItemId + workflowInstanceId + bizObject.id（submitWorkflowByInstanceIdAndItemId），同 id 就地 PROCESSING，绝不走 workflowCode 分支",
+    workflowStartCreateOnly: "form/submit formType=1 + workflowCode（无 workItemId）→ submitWorkflowByWorkflowCode→startWorkflowInstance(create)→BizObjectFacadeImpl.createAndGetBizObject 纯 INSERT（BizObjectInsertModel 无存在性检查）→ 既有 id 必 40000 Duplicate entry（TID 771f64ee 全栈：ExecutorBase INSERT→BizObjectServiceImplCompanion:275→40000）；8.6.26 唯一 load+update 型就地发起是 WorkflowInstanceFacade 5 参重载（908 行，facade 层供二开扩展消费），无 REST 面",
+    sheetResolution: "explicit caller arg > default-form sheetCode from bizsheet/get > schemaCode fallback",
+    updateBranch: "POST runtime/form/save 更新既有记录：目标 id 必须放进 bizObject.data[\"id\"]（平台 BizObjectModel.getId() 读 data 的 id 键；顶层 bizObject.id 会被忽略并退化为新建）；命中既有记录时 FormRuntimeController.saveBizSheet→BizObjectFacadeImpl.updateBizObject，未命中则 createBizObject 插入",
+    updateStatusRule: "既有记录的 DRAFT/COMPLETED 状态在未显式传 sequenceStatus 时原样保留（saveBizSheet 分支），COMPLETED 记录可直接 update，无需流程",
+    updateMergeRule: "updateBizObject.mergeObject 以库内旧值打底、以本次 data 覆盖 → 部分字段（patch）更新，未传字段保持不变",
+    childRowStatusNote: "子表行（CHILD_TABLE(8)）在 form-save 路径按每行 `rowStatus` 分派（BizObjectUpdateModel.convertBizObjectOpItem）：Added=插入 / Modified=更新 / Deleted=删除；**缺失或其它值=immutable（静默忽略）**。门户前端会为改动行标 `rowStatus:\"Modified\"`；手拼载荷漏了它，子表改动不落库、但写仍返回 errcode 0（真机 2026-10-08：data.update 改子表行无 rowStatus，process_name/计划时间读回全不变）。OMC 自动补：带自身 id 的行→\"Modified\"，无 id 的行→\"Added\"，显式 rowStatus 原样保留。",
+    updateAbsentGuard: "平台对\"带 id 但库内不存在\"不报错而是静默插入（createBizObject），故 data.update 先 form/load 预检，命中缺席则以 304001 拒绝，绝不静默转新增",
+    projectionHint: "所选列在默认视图未配置（值可能存在但列表投影为 null）；先用 listview.configure 配置列，或用 data.load 读单条权威值",
+    formulaFieldNote: "计算字段（FORMULA / 表单「计算」控件、子表计算规则）**不在服务端 API 路径回填/重算**：门户是**前端**算好再提交，API save/update/submit 都不会替它算（真机 2026-09-25：子表计算规则字段落库仍 null；纯主表表达式会算）。OMC 的定位是「字段配好即默认它在前台会算」——**写测试数据时应在 formData 里显式带上预算好的计算值**（让数据与预期自洽），**不要指望平台在 API 保存时替它算，也不要用 API 回读值去断言公式/计算是否正确**。**这类纯前台行为最终由人工在前台（配表单→填表）确认。** 另：带**子表计算字段**的模型，API data.save/data.update 可能因服务端重算（CalculateHandler→FormulaProcessor）NPE 而 50000（真机 2026-10-07，前台路径正常）——此类模型请改用门户录入或避开该字段，别据此判定配置错误。",
+});
+function encodeScalar(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (value instanceof Date)
+        return value.toISOString();
+    return JSON.stringify(value);
+}
+function encodeList(value) {
+    if (Array.isArray(value))
+        return value.map(encodeScalar).join(";");
+    if (typeof value === "string")
+        return value;
+    return encodeScalar(value);
+}
+const numeric = (value) => Number(value);
+function betweenBounds(expected) {
+    const [low, high] = expected.split(";").map(Number);
+    return [low ?? 0, high ?? 0];
+}
+export const RUNTIME_QUERY_OPERATORS = Object.freeze({
+    Eq: { encode: encodeScalar, matches: (actual, expected) => String(actual ?? "") === expected },
+    NotEq: { encode: encodeScalar, matches: (actual, expected) => String(actual ?? "") !== expected },
+    Gt: { encode: encodeScalar, matches: (actual, expected) => numeric(actual) > numeric(expected) },
+    Lt: { encode: encodeScalar, matches: (actual, expected) => numeric(actual) < numeric(expected) },
+    Gte: { encode: encodeScalar, matches: (actual, expected) => numeric(actual) >= numeric(expected) },
+    Lte: { encode: encodeScalar, matches: (actual, expected) => numeric(actual) <= numeric(expected) },
+    Like: { encode: encodeScalar, matches: (actual, expected) => String(actual ?? "").includes(expected) },
+    NotLike: { encode: encodeScalar, matches: (actual, expected) => !String(actual ?? "").includes(expected) },
+    In: { encode: encodeList, matches: (actual, expected) => expected.split(";").includes(String(actual ?? "")) },
+    NotIn: { encode: encodeList, matches: (actual, expected) => !expected.split(";").includes(String(actual ?? "")) },
+    Between: { encode: encodeList, matches: (actual, expected) => { const [low, high] = betweenBounds(expected); return numeric(actual) >= low && numeric(actual) <= high; } },
+    NotBetween: { encode: encodeList, matches: (actual, expected) => { const [low, high] = betweenBounds(expected); return !(numeric(actual) >= low && numeric(actual) <= high); } },
+    IsNull: { encode: () => "", matches: (actual) => actual === null || actual === undefined },
+    IsNotNull: { encode: () => "", matches: (actual) => actual !== null && actual !== undefined },
+});
+export const ENGINE_OWNED_KEYS = Object.freeze(["sequenceStatus", "2147483647_sequenceNo"]);
+export const SUBMIT_STATUS_TRANSITIONS = Object.freeze({
+    /** Start submit / start-item finish moves the row DRAFT -> PROCESSING. */
+    workflowStart: "PROCESSING",
+    /** Approval submit with agree!==false completes the row. */
+    approvalAgree: "COMPLETED",
+    /** Approval submit with agree===false cancels the row. */
+    approvalReject: "CANCELED",
+    /** formType=2 submitBizSheet -> saveBizObject completes in place. */
+    inPlaceSubmit: "COMPLETED",
+});
+//# sourceMappingURL=wire-facts.js.map

package/dist/zip.js

@@ -0,0 +1,156 @@
+import { inflateRawSync } from "node:zlib";
+/**
+ * Ticket 106 — a minimal, dependency-free ZIP reader/writer for the bizservice
+ * IE package face.
+ *
+ * The platform export answers a ZIP with manifest.json + version.md
+ * (BizServiceIEController.java:124-138). Java's ZipOutputStream typically
+ * writes local headers with zeroed sizes plus a trailing data descriptor
+ * (general-purpose bit 3), so the READER resolves entries through the central
+ * directory (whose sizes/CRCs are authoritative) and only uses each local
+ * header to locate the data offset. The WRITER emits stored (method 0)
+ * entries — real zips for fake routes and tests; the platform reader accepts
+ * both stored and deflated entries.
+ */
+const EOCD_SIGNATURE = 0x06054b50;
+const CENTRAL_SIGNATURE = 0x02014b50;
+const LOCAL_SIGNATURE = 0x04034b50;
+const EOCD_SCAN_LIMIT = 65_557; // fixed EOCD (22) + max comment (65_535)
+export class ZipFormatError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ZipFormatError";
+    }
+}
+/** CRC-32 (IEEE 802.3), table-driven. */
+const CRC_TABLE = (() => {
+    const table = new Array(256);
+    for (let n = 0; n < 256; n += 1) {
+        let c = n;
+        for (let k = 0; k < 8; k += 1)
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        table[n] = c >>> 0;
+    }
+    return table;
+})();
+function crc32(buffer) {
+    let crc = 0xffffffff;
+    for (const byte of buffer)
+        crc = CRC_TABLE[(crc ^ byte) & 0xff] ^ (crc >>> 8);
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Locate the End Of Central Directory record; returns its byte offset. */
+function locateEocd(buffer) {
+    const start = Math.max(0, buffer.length - EOCD_SCAN_LIMIT);
+    for (let offset = buffer.length - 22; offset >= start; offset -= 1) {
+        if (buffer.readUInt32LE(offset) === EOCD_SIGNATURE) {
+            const commentLength = buffer.readUInt16LE(offset + 20);
+            if (offset + 22 + commentLength === buffer.length)
+                return offset;
+        }
+    }
+    throw new ZipFormatError("no end-of-central-directory record found");
+}
+/** Read every central-directory entry as name → decompressed Buffer. */
+export function readZipEntries(buffer) {
+    const eocd = locateEocd(buffer);
+    const entryCount = buffer.readUInt16LE(eocd + 10);
+    let cursor = buffer.readUInt32LE(eocd + 16);
+    const entries = new Map();
+    for (let index = 0; index < entryCount; index += 1) {
+        if (cursor + 46 > buffer.length || buffer.readUInt32LE(cursor) !== CENTRAL_SIGNATURE)
+            throw new ZipFormatError(`central directory entry ${index} is malformed`);
+        const method = buffer.readUInt16LE(cursor + 10);
+        const compressedSize = buffer.readUInt32LE(cursor + 20);
+        const nameLength = buffer.readUInt16LE(cursor + 28);
+        const extraLength = buffer.readUInt16LE(cursor + 30);
+        const commentLength = buffer.readUInt16LE(cursor + 32);
+        const localOffset = buffer.readUInt32LE(cursor + 42);
+        const name = buffer.subarray(cursor + 46, cursor + 46 + nameLength).toString("utf8");
+        // The local header carries its OWN name/extra lengths (they may differ
+        // from the central copies); the data starts right after them.
+        if (localOffset + 30 > buffer.length || buffer.readUInt32LE(localOffset) !== LOCAL_SIGNATURE)
+            throw new ZipFormatError(`local header for "${name}" is malformed`);
+        const localNameLength = buffer.readUInt16LE(localOffset + 26);
+        const localExtraLength = buffer.readUInt16LE(localOffset + 28);
+        const dataStart = localOffset + 30 + localNameLength + localExtraLength;
+        const data = buffer.subarray(dataStart, dataStart + compressedSize);
+        if (method === 0)
+            entries.set(name, Buffer.from(data));
+        else if (method === 8)
+            entries.set(name, inflateRawSync(data));
+        else
+            throw new ZipFormatError(`entry "${name}" uses unsupported compression method ${method}`);
+        cursor += 46 + nameLength + extraLength + commentLength;
+    }
+    return entries;
+}
+/** Build a stored-entry ZIP (method 0, UTF-8 names flagged via bit 11). */
+export function buildZip(files) {
+    const chunks = [];
+    const central = [];
+    let offset = 0;
+    for (const file of files) {
+        const nameBytes = Buffer.from(file.name, "utf8");
+        const crc = crc32(file.data);
+        const local = Buffer.alloc(30);
+        local.writeUInt32LE(LOCAL_SIGNATURE, 0);
+        local.writeUInt16LE(0x0800, 6); // UTF-8 name flag
+        local.writeUInt16LE(0, 8); // stored
+        local.writeUInt16LE(0, 10); // time
+        local.writeUInt16LE(0x2100, 12); // date (1996-01-01, deterministic)
+        local.writeUInt32LE(crc, 14);
+        local.writeUInt32LE(file.data.length, 18);
+        local.writeUInt32LE(file.data.length, 22);
+        local.writeUInt16LE(nameBytes.length, 26);
+        local.writeUInt16LE(0, 28);
+        chunks.push(local, nameBytes, file.data);
+        const entry = Buffer.alloc(46);
+        entry.writeUInt32LE(CENTRAL_SIGNATURE, 0);
+        entry.writeUInt16LE(0x031e, 4); // made by UNIX/ZIP 3.0
+        entry.writeUInt16LE(0x0014, 6); // extract by DOS/ZIP 2.0
+        entry.writeUInt16LE(0x0800, 8);
+        entry.writeUInt16LE(0, 10);
+        entry.writeUInt16LE(0, 12);
+        entry.writeUInt16LE(0x2100, 14);
+        entry.writeUInt32LE(crc, 16);
+        entry.writeUInt32LE(file.data.length, 20);
+        entry.writeUInt32LE(file.data.length, 24);
+        entry.writeUInt16LE(nameBytes.length, 28);
+        entry.writeUInt16LE(0, 30);
+        entry.writeUInt16LE(0, 32);
+        entry.writeUInt16LE(0, 34);
+        entry.writeUInt16LE(0, 36);
+        entry.writeUInt32LE(0, 38);
+        entry.writeUInt32LE(offset, 42);
+        central.push(entry, nameBytes);
+        offset += 30 + nameBytes.length + file.data.length;
+    }
+    const centralBuffer = Buffer.concat(central);
+    const eocd = Buffer.alloc(22);
+    eocd.writeUInt32LE(EOCD_SIGNATURE, 0);
+    eocd.writeUInt16LE(0, 4);
+    eocd.writeUInt16LE(0, 6);
+    eocd.writeUInt16LE(files.length, 8);
+    eocd.writeUInt16LE(files.length, 10);
+    eocd.writeUInt32LE(centralBuffer.length, 12);
+    eocd.writeUInt32LE(offset, 16);
+    eocd.writeUInt16LE(0, 20);
+    return Buffer.concat([...chunks, centralBuffer, eocd]);
+}
+/**
+ * Resolve an entry by BASENAME: the platform export compresses the staging
+ * DIRECTORY, so entries carry a `bizService-<uuid>/` prefix
+ * (live 2026-09-15: bizService-59d72d4a…/manifest.json).
+ */
+export function zipEntryByBasename(entries, basename) {
+    const direct = entries.get(basename);
+    if (direct !== undefined)
+        return direct;
+    const suffix = `/${basename}`;
+    for (const [name, data] of entries)
+        if (name.endsWith(suffix))
+            return data;
+    return undefined;
+}
+//# sourceMappingURL=zip.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omc-core",
-  "version": "0.4.36",
+  "version": "0.4.38",
   "description": "Shared OMC capability kernel: capability contracts, governance, and decoders. Zero DSH dependencies.",
   "type": "module",
   "files": [
@@ -12,7 +12,17 @@
     "!dist/**/*.d.ts.map"
   ],
   "exports": {
-    ".": "./dist/index.js",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./zip": "./dist/zip.js",
+    "./capability-shape": "./dist/capability-shape.js",
+    "./json-column": "./dist/json-column.js",
+    "./refusal": "./dist/refusal.js",
+    "./wire-facts": "./dist/wire-facts.js",
+    "./relation-shape": "./dist/relation-shape.js",
+    "./list-view-wire": "./dist/list-view-wire.js",
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -34,5 +44,6 @@
     "type": "git",
     "url": "https://gitlab.h3yun.com/fuwenbin/oh-my-cpagents.git",
     "directory": "packages/omc-core"
-  }
+  },
+  "types": "./dist/index.d.ts"
 }