openxiangda-nest 2.3.3 → 2.4.1

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export * from './notification.js';
 export * from './platform-client.js';
 export * from './runtime.js';
 export * from './standard-operations.js';
+export * from './snapshot-values.js';
 export * from './tokens.js';
 export * from './types.js';
 export * from './workflow.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -17,6 +17,7 @@ export * from './notification.js';
 export * from './platform-client.js';
 export * from './runtime.js';
 export * from './standard-operations.js';
+export * from './snapshot-values.js';
 export * from './tokens.js';
 export * from './types.js';
 export * from './workflow.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/snapshot-values.d.ts

@@ -0,0 +1,20 @@
+import type { DepartmentReferenceValue, ResourceReferenceValue, UserReferenceValue } from 'openxiangda-contracts';
+/**
+ * 快照值写入助手。平台的 option/user/department/resource-ref 字段在 Data API
+ * 写入时保存 `{ label, value }` 显示快照（`value` 是比较键），事务与普通写入
+ * 都必须使用这些形状，直接写裸字符串会被字段校验拒绝。
+ */
+export declare function optionSnapshot(label: string, value: string): {
+    label: string;
+    value: string;
+};
+export declare function userSnapshot(userId: string, displayName?: string): UserReferenceValue;
+export declare function departmentSnapshot(departmentId: string, displayName?: string): DepartmentReferenceValue;
+export declare function resourceSnapshot(resourceCode: string, recordId: string, label: string): ResourceReferenceValue;
+/**
+ * 判定一个错误是否为平台幂等冲突：同一 idempotencyKey 携带了不同内容（典型
+ * 场景是重试时乐观锁 revision 已前进）。捕获后应回读当前状态确认"已生效"并按
+ * 幂等结果返回，而不是把冲突透传给调用方或生成新键重试。
+ */
+export declare function isIdempotencyConflict(error: unknown): boolean;
+//# sourceMappingURL=snapshot-values.d.ts.map

package/dist/snapshot-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-values.d.ts","sourceRoot":"","sources":["../src/snapshot-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAG/B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;EAE1D;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,kBAAkB,CAEpB;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,wBAAwB,CAE1B;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,sBAAsB,CAExB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK7D"}

package/dist/snapshot-values.js

@@ -0,0 +1,28 @@
+import { OpenXiangdaPlatformError } from './platform-client.js';
+/**
+ * 快照值写入助手。平台的 option/user/department/resource-ref 字段在 Data API
+ * 写入时保存 `{ label, value }` 显示快照（`value` 是比较键），事务与普通写入
+ * 都必须使用这些形状，直接写裸字符串会被字段校验拒绝。
+ */
+export function optionSnapshot(label, value) {
+    return { label, value };
+}
+export function userSnapshot(userId, displayName) {
+    return { label: displayName?.trim() || userId, value: userId };
+}
+export function departmentSnapshot(departmentId, displayName) {
+    return { label: displayName?.trim() || departmentId, value: departmentId };
+}
+export function resourceSnapshot(resourceCode, recordId, label) {
+    return { label, value: recordId, resourceCode };
+}
+/**
+ * 判定一个错误是否为平台幂等冲突：同一 idempotencyKey 携带了不同内容（典型
+ * 场景是重试时乐观锁 revision 已前进）。捕获后应回读当前状态确认"已生效"并按
+ * 幂等结果返回，而不是把冲突透传给调用方或生成新键重试。
+ */
+export function isIdempotencyConflict(error) {
+    return (error instanceof OpenXiangdaPlatformError &&
+        error.code === 'OPENXIANGDA_NATIVE_DATA_IDEMPOTENCY_CONFLICT');
+}
+//# sourceMappingURL=snapshot-values.js.map

package/dist/snapshot-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-values.js","sourceRoot":"","sources":["../src/snapshot-values.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAa;IACzD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,WAAoB;IAEpB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,YAAoB,EACpB,WAAoB;IAEpB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,YAAoB,EACpB,QAAgB,EAChB,KAAa;IAEb,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,CACL,KAAK,YAAY,wBAAwB;QACzC,KAAK,CAAC,IAAI,KAAK,8CAA8C,CAC9D,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-nest",
-  "version": "2.3.3",
+  "version": "2.4.1",
   "description": "OpenXiangda 2.0 的受信 NestJS 业务后端集成。",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,7 @@
   ],
   "dependencies": {
     "ajv": "8.20.0",
-    "openxiangda-contracts": "2.12.0"
+    "openxiangda-contracts": "2.14.0"
   },
   "peerDependencies": {
     "@nestjs/common": ">=11 <12",