@rytass/bpm-core-client 0.1.7 → 0.1.9

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,40 @@ 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.9 — 2026-05-28
12
+
13
+ ### Fixed
14
+
15
+ - **`OrgUnitType` and `ManagerResolutionScopeType` are now re-exports
16
+ from `@rytass/bpm-core-shared`.** Previous versions shipped two
17
+ divergent local definitions: the shared package declared
18
+ `'COMPANY' | 'DIVISION' | 'DEPARTMENT' | 'TEAM'` (UPPERCASE only,
19
+ matching the GraphQL wire) while this package declared the union of
20
+ both cases. Consumers importing the type from different subpaths
21
+ received different unions — silent at compile time, surprising at
22
+ review time. Both subpaths now refer to the single source of truth.
23
+
24
+ ### Why a patch
25
+
26
+ Type-level realignment, no runtime behavior change. Consumers using
27
+ the UPPERCASE literals (the working path) see no difference; consumers
28
+ relying on lowercase (the broken path that failed at GraphQL anyway)
29
+ were already getting runtime errors and need to migrate.
30
+
31
+ ## 0.1.8 — 2026-05-28
32
+
33
+ ### Documentation
34
+
35
+ - README "Organization Mirror Pattern" updated to match the
36
+ `@rytass/bpm-core-nestjs-module@0.1.8` README's clarification that
37
+ `metadataJson` is write-only — records returned by
38
+ `readOrganizationDashboard` don't surface metadata; reconcile by
39
+ `code` instead.
40
+
41
+ ### Why a patch
42
+
43
+ No source change.
44
+
11
45
  ## 0.1.7 — 2026-05-28
12
46
 
13
47
  ### 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.9",
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.9"
77
77
  },
78
78
  "dependencies": {
79
79
  "tslib": "^2.3.0"
@@ -1,5 +1,11 @@
1
- export type OrgUnitType = 'COMPANY' | 'DEPARTMENT' | 'DIVISION' | 'TEAM' | 'company' | 'department' | 'division' | 'team';
2
- export type ManagerResolutionScopeType = 'MEMBER' | 'ORG_UNIT' | 'POSITION';
1
+ import type { OrgUnitType, ManagerResolutionScopeType } from '@rytass/bpm-core-shared';
2
+ /**
3
+ * Re-exported from `@rytass/bpm-core-shared` for consumer convenience —
4
+ * the single source of truth lives there. Both import paths produce
5
+ * the same TypeScript type, so consumers may pick whichever subpath
6
+ * they already import from elsewhere.
7
+ */
8
+ export type { OrgUnitType, ManagerResolutionScopeType };
3
9
  export interface OrgUnitRecord {
4
10
  readonly code: string;
5
11
  readonly createdAt: string;
@@ -165,4 +171,3 @@ export declare function updateManagerResolution(input: {
165
171
  readonly scopeType: ManagerResolutionScopeType | null;
166
172
  }): Promise<ManagerResolutionRecord>;
167
173
  export declare function deleteManagerResolution(id: string): Promise<boolean>;
168
- export {};
@@ -1 +1 @@
1
- {"version":3,"file":"organization-api.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core-client/src/lib/organization/organization-api.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"organization-api.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core-client/src/lib/organization/organization-api.ts"],"names":[],"mappings":"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"}