gdc-sdk-front-ts 0.7.0 → 0.8.1

package/README.md

@@ -78,6 +78,7 @@ Recommended entry point:
 
 Main references:
 
+- [gdc-common-utils-ts/docs/101-EMPLOYEE_ENTRY_EDITOR.md](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/docs/101-EMPLOYEE_ENTRY_EDITOR.md)
 - [gdc-sdk-core-ts/docs/101-EMPLOYEES.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/101-EMPLOYEES.md)
 - [gdc-sdk-core-ts/docs/101-CONSENT_COMMUNICATION.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/101-CONSENT_COMMUNICATION.md)
 - [gdc-common-utils-ts/docs/101-CONSENT_ACCESS.md](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/docs/101-CONSENT_ACCESS.md)
@@ -86,7 +87,7 @@ Main references:
 
 Use:
 
-- `BundleEditor` for employee create/search/disable/purge payloads
+- `BundleEditor` plus `EmployeeEntryEditor` for employee create/search/disable/purge payloads
 - `CommunicationAttachedBundleSession` for `Communication`-carried bundles
 - `createConsentAccessEditor(...)` for consent editing inside a communication bundle
 
@@ -114,7 +115,7 @@ Those actor families should start from their own business flow:
 
 ### Create
 
-Use `BundleEditor` to prepare one employee create bundle. The browser
+Use `BundleEditor` plus one employee entry editor to prepare one employee create bundle. The browser
 does not send it directly to GW CORE.
 The portal backend wraps it into its own request/envelope, then applies KMS,
 DIDComm, submit, and poll.
@@ -126,14 +127,21 @@ import {
   EXAMPLE_PROVIDER_ORGANIZATION_DID,
 } from 'gdc-common-utils-ts/examples';
 import { ClaimsPersonSchemaorg } from 'gdc-common-utils-ts/constants/schemaorg';
-import { EmployeeBundleOperations } from 'gdc-common-utils-ts/utils/employee';
+import {
+  EmployeeBundleOperations,
+  EmployeeResourceTypes,
+} from 'gdc-common-utils-ts/utils/employee';
 
 // This editor lives only in frontend memory.
 // It helps the UI build the canonical employee payload before sending it to
 // the portal backend.
 const bundle = new BundleEditor()
   .setBundleOperation(EmployeeBundleOperations.create)
+  .setAllowedResourceType(EmployeeResourceTypes.employee);
+
+const employeeEntry = bundle
   .newEntry()
+  .asEmployee()
   .setEmail(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.email)
   .setRole(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.role)
   .addClaim(ClaimsPersonSchemaorg.memberOf, EXAMPLE_PROVIDER_ORGANIZATION_DID);
@@ -141,8 +149,10 @@ const bundle = new BundleEditor()
 // `employeeCreateBatchBundle` is the canonical one-entry employee `_batch` bundle.
 // Your Vite frontend normally sends this bundle to its own backend, not
 // directly to GW CORE.
-const generatedEmployeeIdentifier = bundle.getIdentifier();
-const employeeCreateBatchBundle = bundle.doneEntry().build();
+const generatedEmployeeIdentifier = employeeEntry.getIdentifier();
+employeeEntry.doneEntry();
+
+const employeeCreateBatchBundle = bundle.build();
 console.log(employeeCreateBatchBundle);
 ```
 
@@ -154,12 +164,18 @@ import { EmployeeBundleOperations } from 'gdc-common-utils-ts/utils/employee';
 
 const bundle = new BundleEditor()
   .setBundleOperation(EmployeeBundleOperations.create)
+  .setAllowedResourceType(EmployeeResourceTypes.employee);
+
+const employeeEntry = bundle
   .newEntry()
+  .asEmployee()
   .setEmail(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.email)
   .setRole(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.role);
 
-const employeeCreateBatchBundle = bundle.doneEntry().build();
-const generatedEmployeeIdentifier = bundle.getIdentifier();
+const generatedEmployeeIdentifier = employeeEntry.getIdentifier();
+employeeEntry.doneEntry();
+
+const employeeCreateBatchBundle = bundle.build();
 ```
 
 If a frontend needs explicit claim-level control instead of only `setEmail()` /
@@ -172,18 +188,27 @@ import {
   EXAMPLE_PROVIDER_ORGANIZATION_DID,
 } from 'gdc-common-utils-ts/examples';
 import { ClaimsPersonSchemaorg } from 'gdc-common-utils-ts/constants/schemaorg';
-import { EmployeeBundleOperations } from 'gdc-common-utils-ts/utils/employee';
+import {
+  EmployeeBundleOperations,
+  EmployeeResourceTypes,
+} from 'gdc-common-utils-ts/utils/employee';
 
 const bundle = new BundleEditor()
   .setBundleOperation(EmployeeBundleOperations.create)
+  .setAllowedResourceType(EmployeeResourceTypes.employee);
+
+const employeeEntry = bundle
   .newEntry(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.identifier)
+  .asEmployee()
   .setClaim(ClaimsPersonSchemaorg.email, EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.email)
   .setClaim(ClaimsPersonSchemaorg.hasOccupationalRoleValue, EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.role)
   .addClaim(ClaimsPersonSchemaorg.memberOf, EXAMPLE_PROVIDER_ORGANIZATION_DID);
 
-console.log(bundle.getClaim(ClaimsPersonSchemaorg.email));
+console.log(employeeEntry.getClaim(ClaimsPersonSchemaorg.email));
+
+employeeEntry.doneEntry();
 
-const employeeCreateBatchBundle = bundle.doneEntry().build();
+const employeeCreateBatchBundle = bundle.build();
 ```
 
 ### Search
@@ -195,15 +220,23 @@ Search is a different operation and should be built separately.
 ```ts
 import { BundleEditor } from 'gdc-sdk-core-ts';
 import { EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE } from 'gdc-common-utils-ts/examples';
-import { EmployeeBundleOperations } from 'gdc-common-utils-ts/utils/employee';
+import {
+  EmployeeBundleOperations,
+  EmployeeResourceTypes,
+} from 'gdc-common-utils-ts/utils/employee';
 
-const employeeSearchBundle = new BundleEditor()
+const bundle = new BundleEditor()
   .setBundleOperation(EmployeeBundleOperations.search)
+  .setAllowedResourceType(EmployeeResourceTypes.employee);
+
+bundle
   .newEntry()
+  .asEmployee()
   .setEmail(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.email)
   .setRole(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.role)
-  .doneEntry()
-  .build();
+  .doneEntry();
+
+const employeeSearchBundle = bundle.build();
 
 console.log(employeeSearchBundle);
 ```
@@ -223,13 +256,21 @@ produces the canonical `_batch` bundle with inner `request.method = DELETE`.
 ```ts
 import { BundleEditor } from 'gdc-sdk-core-ts';
 import { EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE } from 'gdc-common-utils-ts/examples';
-import { EmployeeBundleOperations } from 'gdc-common-utils-ts/utils/employee';
+import {
+  EmployeeBundleOperations,
+  EmployeeResourceTypes,
+} from 'gdc-common-utils-ts/utils/employee';
 
-const employeeDisableBatchBundle = new BundleEditor()
+const bundle = new BundleEditor()
   .setBundleOperation(EmployeeBundleOperations.disable)
+  .setAllowedResourceType(EmployeeResourceTypes.employee);
+
+bundle
   .newEntry(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.identifier)
-  .doneEntry()
-  .build();
+  .asEmployee()
+  .doneEntry();
+
+const employeeDisableBatchBundle = bundle.build();
 
 console.log(employeeDisableBatchBundle);
 ```
@@ -250,7 +291,9 @@ import { EmployeeBundleOperations } from 'gdc-common-utils-ts/utils/employee';
 
 const employeeDisablePatchBatchBundle = new BundleEditor()
   .setBundleOperation(EmployeeBundleOperations.disable)
-  .newEntry(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.identifier);
+  .setAllowedResourceType(EmployeeResourceTypes.employee)
+  .newEntry(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.identifier)
+  .asEmployee();
 ```
 
 Business meaning:
@@ -270,11 +313,16 @@ the employee `identifier`.
 ```ts
 import { BundleEditor } from 'gdc-sdk-core-ts';
 import { EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE } from 'gdc-common-utils-ts/examples';
-import { EmployeeBundleOperations } from 'gdc-common-utils-ts/utils/employee';
+import {
+  EmployeeBundleOperations,
+  EmployeeResourceTypes,
+} from 'gdc-common-utils-ts/utils/employee';
 
 const employeePurgeBundle = new BundleEditor()
   .setBundleOperation(EmployeeBundleOperations.purge)
+  .setAllowedResourceType(EmployeeResourceTypes.employee)
   .newEntry(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.identifier)
+  .asEmployee()
   .doneEntry()
   .build();
 
@@ -328,7 +376,10 @@ import {
   EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE,
   EXAMPLE_PROFILE_SESSION_INPUT,
 } from 'gdc-common-utils-ts/examples';
-import { EmployeeBundleOperations } from 'gdc-common-utils-ts/utils/employee';
+import {
+  EmployeeBundleOperations,
+  EmployeeResourceTypes,
+} from 'gdc-common-utils-ts/utils/employee';
 
 const appId = frontendAppConfig.appId;
 const client = new ClientSDK({ appId });
@@ -338,10 +389,12 @@ const client = new ClientSDK({ appId });
 // can later expose organization-controller/professional capabilities.
 const session = await client.initializeSession(EXAMPLE_PROFILE_SESSION_INPUT);
 
-// The shared editor from sdk-core is still used to model the employee bundle.
+// The shared bundle editor from sdk-core is still used to model the employee bundle.
 const employeeSearchBundle = new BundleEditor()
   .setBundleOperation(EmployeeBundleOperations.search)
+  .setAllowedResourceType(EmployeeResourceTypes.employee)
   .newEntry()
+  .asEmployee()
   .setEmail(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.email)
   .setRole(EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.role)
   .doneEntry()

package/dist/ProfileManager.js

@@ -198,6 +198,9 @@ export class ProfileManager {
         return new OrganizationControllerSdk(this.runtimeClient);
     }
     asOrganizationEmployee() {
+        if (this.profile.appType !== 'Organization') {
+            throw new Error('OrganizationEmployeeSdk is not available for this profile.');
+        }
         return new OrganizationEmployeeSdk(this.runtimeClient);
     }
     asIndividualController() {
@@ -217,7 +220,7 @@ export class ProfileManager {
         return new PersonalSdk(this.runtimeClient);
     }
     asProfessional() {
-        if (!this.professional?.physician && !this.professional?.paramedic && !this.individual?.service) {
+        if (!this.professional?.physician && !this.professional?.paramedic) {
             throw new Error('ProfessionalSdk is not available for this profile.');
         }
         return new ProfessionalSdk(this.runtimeClient);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-sdk-front-ts",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Next-generation frontend runtime package for the GDC SDK family",
   "license": "Apache-2.0",
   "author": "Antifraud Services Inc.",
@@ -17,8 +17,8 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.28.4",
-    "gdc-common-utils-ts": "^1.15.0",
-    "gdc-sdk-core-ts": "^0.7.0"
+    "gdc-common-utils-ts": "^1.16.0",
+    "gdc-sdk-core-ts": "^0.8.1"
   },
   "devDependencies": {
     "@types/node": "^20.14.10",