@rytass/bpm-core-client 0.1.7 → 0.1.8

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/CHANGELOG.md CHANGED
@@ -8,6 +8,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
8
8
  Releases are managed by [`nx release`](https://nx.dev/recipes/nx-release) with
9
9
  Conventional Commits — see `nx.json` for the release config.
10
10
 
11
+ ## 0.1.8 — 2026-05-28
12
+
13
+ ### Documentation
14
+
15
+ - README "Organization Mirror Pattern" updated to match the
16
+ `@rytass/bpm-core-nestjs-module@0.1.8` README's clarification that
17
+ `metadataJson` is write-only — records returned by
18
+ `readOrganizationDashboard` don't surface metadata; reconcile by
19
+ `code` instead.
20
+
21
+ ### Why a patch
22
+
23
+ No source change.
24
+
11
25
  ## 0.1.7 — 2026-05-28
12
26
 
13
27
  ### Documentation
package/README.md CHANGED
@@ -223,9 +223,12 @@ data in. Three rules keep the mirror idempotent:
223
223
  1. **Use `code` as the natural key.** Both `OrgUnit` and `Position`
224
224
  carry a unique `code` you control. On every sync, look up by `code`
225
225
  before deciding INSERT vs UPDATE.
226
- 2. **Stash the host-FK in `metadata`.** Both entities carry an opaque
227
- `metadata` JSON BPM never introspects — store your host's primary
228
- key there to chase pointers back during reconciliation.
226
+ 2. **`metadataJson` is write-only.** The mutations accept it for audit
227
+ purposes — BPM stores the JSON verbatim — but the records returned
228
+ by `readOrganizationDashboard` do NOT include the metadata field
229
+ (kept out of paginated payloads). **Always reconcile by `code`**;
230
+ treat `metadataJson` as an audit/debugging breadcrumb, not a live
231
+ FK pointer.
229
232
  3. **Soft-delete via the `delete*` mutations.** They set `deletedAt`;
230
233
  live queries (`orgUnits`, `orgUnitCount`, etc.) filter soft-deleted
231
234
  rows automatically.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rytass/bpm-core-client",
3
- "version": "0.1.7",
3
+ "version": "0.1.8",
4
4
  "description": "Framework-agnostic TypeScript client for the Rytass BPM approval workflow GraphQL surface: fetch-based GraphQL transport, REST auth client, pre-baked typed operations for organization, member, form, template, and workflow.",
5
5
  "keywords": [
6
6
  "bpm",
@@ -73,7 +73,7 @@
73
73
  }
74
74
  },
75
75
  "peerDependencies": {
76
- "@rytass/bpm-core-shared": "^0.1.7"
76
+ "@rytass/bpm-core-shared": "^0.1.8"
77
77
  },
78
78
  "dependencies": {
79
79
  "tslib": "^2.3.0"