gdc-sdk-node-ts 0.6.4 → 0.6.7

package/README.md

@@ -14,43 +14,56 @@ Use this package when your backend needs to:
 This package is for runtime execution. It is not the place where the canonical
 business contract is defined.
 
+Architectural rule:
+
+- shared contracts and actor boundaries come from `gdc-sdk-core-ts`
+- this package executes those flows against GW
+- this package should not widen an actor facade just because the runtime client
+  happens to expose the underlying method
+
 ## Start Here
 
 If you are integrating this package for the first time, open these in order:
 
-1. [docs/SDK_END_TO_END_101.md](./docs/SDK_END_TO_END_101.md)
-   Ordered onboarding guide with end-to-end journeys, copy/paste snippets, and
-   the recommended reading path for new backend integrators.
-2. [docs/SDK_INTEGRATION_101.md](./docs/SDK_INTEGRATION_101.md)
+1. [gdc-sdk-core-ts/docs/101-SDK_PACKAGE_BOUNDARIES.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/101-SDK_PACKAGE_BOUNDARIES.md)
+   Why `core`, `node`, and `front` are separate packages, what belongs in each
+   one, and why actor-scoped facades must stay aligned across runtimes.
+1. [docs/101-SDK_END_TO_END.md](./docs/101-SDK_END_TO_END.md)
+  Ordered onboarding guide with end-to-end journeys, copy/paste snippets, and
+  the recommended reading path for new backend integrators.
+2. [docs/101-SDK_INTEGRATION.md](./docs/101-SDK_INTEGRATION.md)
    Real backend setup, imports, `initializeCommunicationIdentity(...)`,
    `new NodeHttpClient(...)`, route context, facade selection, and live method
    usage.
-3. [docs/DISCOVERY_101.md](./docs/DISCOVERY_101.md)
+3. [docs/101-LIVE_GW_LOCAL.md](./docs/101-LIVE_GW_LOCAL.md)
+   Exact TTY/local/Docker commands for running the SDK against a real local GW
+   CORE, including tenant bootstrap and employee-seat setup.
+4. [docs/101-DISCOVERY.md](./docs/101-DISCOVERY.md)
    Node/BFF dataspace discovery, hosting-operator resolution, provider
    resolution, and the correct integration boundary for fallback and cache.
-4. [gdc-sdk-core-ts/docs/SDK_FLOWS_101.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/SDK_FLOWS_101.md)
+5. [gdc-sdk-core-ts/docs/101-SDK_FLOWS.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/101-SDK_FLOWS.md)
    Actor split and business-flow map across organization, individual,
    permissions, invitation, import, and SMART flows.
-5. [gdc-common-utils-ts/src/examples/](https://github.com/Global-DataCare/gdc-common-utils-ts/tree/main/src/examples)
+6. [gdc-common-utils-ts/src/examples/](https://github.com/Global-DataCare/gdc-common-utils-ts/tree/main/src/examples)
    Shared payload values used by the docs and tests.
-6. [gdc-common-utils-ts/docs/LIFECYCLE_101.md](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/docs/LIFECYCLE_101.md)
+7. [gdc-common-utils-ts/docs/LIFECYCLE_101.md](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/docs/LIFECYCLE_101.md)
    Canonical `enable/disable/delete` semantics and copy/paste placeholders.
 
 If you need the shortest path:
 
 - main onboarding guide:
-  [docs/SDK_END_TO_END_101.md](./docs/SDK_END_TO_END_101.md)
+  [docs/101-SDK_END_TO_END.md](./docs/101-SDK_END_TO_END.md)
 - GW CORE app identity:
   `appId` mandatory, `appVersion` optional with default `v1.0`
 - backend technical identity:
-  [`initializeCommunicationIdentity(...)`](./docs/SDK_INTEGRATION_101.md)
+  [`initializeCommunicationIdentity(...)`](./docs/101-SDK_INTEGRATION.md)
   for the technical channel/runtime identity, not the legal organization id
 - runtime client:
   [`NodeHttpClient`](src/node-runtime-client.ts)
 - step-by-step runtime usage:
-  [docs/SDK_INTEGRATION_101.md](./docs/SDK_INTEGRATION_101.md)
+  [docs/101-SDK_INTEGRATION.md](./docs/101-SDK_INTEGRATION.md)
 - dataspace discovery and fallback/cache boundary:
-  [docs/DISCOVERY_101.md](./docs/DISCOVERY_101.md)
+  [docs/101-DISCOVERY.md](./docs/101-DISCOVERY.md)
 
 ## Executable Usage Examples
 
@@ -70,12 +83,108 @@ Open these tests when you want to see exact method calls and exact inputs:
   SMART token request flow.
 - [tests/live-gw-node-runtime.e2e.test.mjs](tests/live-gw-node-runtime.e2e.test.mjs)
   End-to-end runtime wiring against a real GW environment.
-- [tests/dataspace-resolver.101.test.mjs](tests/dataspace-resolver.101.test.mjs)
-  Dataspace discovery 101 with capability filtering, jurisdiction filtering,
-  reader-vs-provider semantics, and fetcher-level fallback/cache examples.
-- [tests/default-first-dataspace-discovery.101.test.mjs](tests/default-first-dataspace-discovery.101.test.mjs)
-  Portal-style `default-first` discovery with simple `getHosts(...)`,
-  `getIndexProviders(...)`, and `getDigitalTwinProviders(...)` calls.
+- [tests/101-dataspace-resolver.test.mjs](tests/101-dataspace-resolver.test.mjs)
+  Minimal `HttpDataspaceResolver` 101 with one host and one published provider.
+- [tests/101-default-first-dataspace-discovery.test.mjs](tests/101-default-first-dataspace-discovery.test.mjs)
+  Minimal `default-first` discovery with one host and one published
+  `IndexProvider`.
+
+## Live GW CORE Flow
+
+Use [tests/live-gw-node-runtime.e2e.test.mjs](tests/live-gw-node-runtime.e2e.test.mjs)
+as the canonical runtime flow.
+
+Before running that suite, read:
+
+- [docs/101-LIVE_GW_LOCAL.md](./docs/101-LIVE_GW_LOCAL.md)
+
+Teaching rule:
+
+- defaults come from `gdc-common-utils-ts/examples`
+- override with env vars only when your tenant, bearer, or route is different
+- local GW default is `http://127.0.0.1:3000`
+- Docker-exposed GW can be overridden with `BASE_URL=http://127.0.0.1:8000`
+
+Current live flow covered by the test suite:
+
+1. bootstrap tenant / legal organization
+2. bootstrap doctor or controller employee
+3. bootstrap individual and grant consent for the doctor
+   default example: `INDIVIDUAL_ALTERNATE_NAME=Doraemon`
+4. ingest two IPS `Communication` bundles, each with one `MedicationStatement`
+5. read the IPS/clinical index and verify both medications are present
+6. request the consolidated IPS bundle through
+   `Bundle?type=document&composition.subject=<did>&composition.type=http://loinc.org|60591-5`
+7. verify the returned bundle document contains both medication statements
+8. persist audit/debug traces in `test-results/*.jsonl`
+
+Shared example source of truth:
+
+- tenant/route/controller/professional defaults:
+  [gdc-common-utils-ts/src/examples/shared.ts](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/src/examples/shared.ts)
+- live employee defaults:
+  [gdc-common-utils-ts/src/examples/organization-controller.ts](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/src/examples/organization-controller.ts)
+- live consent defaults:
+  [gdc-common-utils-ts/src/examples/individual-controller.ts](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/src/examples/individual-controller.ts)
+
+The two medication defaults used by the live test are intentionally reusable:
+
+- `Ibuprofen 400 mg`
+- `Paracetamol 600 mg`
+- both every `8` hours
+- both `PRN` / `dosage-asneeded = true`
+- note text keeps the `4` hour gap in English
+
+Run the full live runtime baseline:
+
+```bash
+npm run test:e2e:live-gw
+```
+
+Run the IPS ingestion/search branch as well:
+
+```bash
+RUN_LIVE_GW_E2E_IPS_INGESTION=1 \
+npm run test:e2e:live-gw
+```
+
+Implementation note:
+
+- the public runtime contract is still `Bundle/_search`
+- `gdc-sdk-node-ts` submits that request as-is
+- GW CORE resolves it internally from indexed subject sections and returns the
+  consolidated IPS bundle document
+
+Common overrides:
+
+```bash
+BASE_URL=http://127.0.0.1:3000 \
+AUTH_BEARER=... \
+TENANT_ID=VATES-B00112233 \
+TENANT_ROUTE_ID=acme-live \
+JURISDICTION=ES \
+SECTOR=health-care \
+SUBJECT_DID=did:web:api.acme.org:individual:123 \
+RUN_LIVE_GW_E2E_IPS_INGESTION=1 \
+LIVE_GW_NODE_E2E_DEBUG=1 \
+npm run test:e2e:live-gw
+```
+
+Docker-exposed GW example:
+
+```bash
+BASE_URL=http://127.0.0.1:8000 \
+RUN_LIVE_GW_E2E_IPS_INGESTION=1 \
+npm run test:e2e:live-gw
+```
+
+Documentation consistency rule for this repo family:
+
+- scripts, README examples, Swagger examples, and internal tests must reuse the
+  same example data and flow order
+- if a new request/response example is added, add it first to
+  `gdc-common-utils-ts/examples` and consume it from there instead of
+  re-hardcoding values locally
 
 ## Dataspace Discovery Quick Map
 
@@ -88,9 +197,10 @@ Use the Node discovery layer when your backend or BFF needs to:
 
 Primary references:
 
-- [docs/DISCOVERY_101.md](./docs/DISCOVERY_101.md)
-- [tests/default-first-dataspace-discovery.101.test.mjs](tests/default-first-dataspace-discovery.101.test.mjs)
-- [tests/dataspace-resolver.101.test.mjs](tests/dataspace-resolver.101.test.mjs)
+- [docs/101-DISCOVERY.md](./docs/101-DISCOVERY.md)
+- [tests/101-default-first-dataspace-discovery.test.mjs](tests/101-default-first-dataspace-discovery.test.mjs)
+- [tests/101-dataspace-resolver.test.mjs](tests/101-dataspace-resolver.test.mjs)
+- [tests/dataspace-resolver-advanced.test.mjs](tests/dataspace-resolver-advanced.test.mjs)
 - [tests/dataspace-resolver.test.mjs](tests/dataspace-resolver.test.mjs)
 
 Copy/paste starting point:

package/dist/node-runtime-client.d.ts

@@ -5,7 +5,7 @@ import type { NodeOrganizationActivationInput } from './orchestration/client-por
 import { type IndividualOrganizationConfirmOrderInput, type RouteContext } from './individual-onboarding.js';
 import { type SmartTokenRequestInput } from './smart-token.js';
 import { type IndividualOrganizationBootstrapInput, type IndividualOrganizationStartResult } from './individual-start.js';
-import { type CommunicationIngestionInput, type ClinicalBundleSearchInput, type GrantProfessionalAccessInput, type GrantProfessionalAccessResult, type IndividualMemberLifecycleInput, type IndividualOrganizationLifecycleInput, type OrganizationEmployeeCreationInput, type OrganizationEmployeeLifecycleInput, type RelatedPersonUpsertInput } from './resource-operations.js';
+import { type CommunicationIngestionInput, type ClinicalBundleSearchInput, type GrantProfessionalAccessInput, type GrantProfessionalAccessResult, type IndividualMemberLifecycleInput, type IndividualOrganizationLifecycleInput, type OrganizationEmployeeCreationInput, type OrganizationEmployeeLifecycleInput, type OrganizationEmployeeSearchInput, type RelatedPersonUpsertInput } from './resource-operations.js';
 import type { LegalOrganizationOrderInput } from './host-onboarding.js';
 import type { SmartTokenExchangeResult } from './smart-token.js';
 import type { NodeRuntimeClient, PollOptions, PollResult, SubmitAndPollResult, SubmitPayload, SubmitResponse } from './orchestration/client-port.js';
@@ -143,6 +143,10 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
      * Preferred public alias for employee purge in the current SDK surface.
      */
     purgeEmployee(ctx: RouteContext, input: OrganizationEmployeeLifecycleInput, pollOptions?: PollOptions): Promise<SubmitAndPollResult>;
+    /**
+     * Searches employees/professionals under the selected organization tenant.
+     */
+    searchOrganizationEmployees(ctx: RouteContext, input: OrganizationEmployeeSearchInput): Promise<SubmitAndPollResult>;
     /**
      * Starts the onboarding flow for an individual-oriented tenant or index.
      */
@@ -262,6 +266,8 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
     hostRegistryOrderPollPath(ctx?: HostRouteContext): string;
     employeeBatchPath(ctx?: RouteContext): string;
     employeePollPath(ctx?: RouteContext): string;
+    employeeSearchPath(ctx?: RouteContext): string;
+    employeeSearchPollPath(ctx?: RouteContext): string;
     employeePurgePath(ctx?: RouteContext): string;
     employeePurgePollPath(ctx?: RouteContext): string;
     individualFamilyOrganizationBatchPath(ctx?: RouteContext): string;

package/dist/node-runtime-client.js

@@ -9,7 +9,7 @@ import { confirmLegalOrganizationOrderWithDeps } from './host-onboarding.js';
 import { confirmIndividualOrganizationOrderWithDeps, } from './individual-onboarding.js';
 import { requestSmartTokenWithDeps } from './smart-token.js';
 import { startIndividualOrganizationWithDeps } from './individual-start.js';
-import { createOrganizationEmployeeWithDeps, disableIndividualOrganizationWithDeps, disableOrganizationEmployeeWithDeps, grantProfessionalAccessWithDeps, ingestCommunicationAndUpdateIndexWithDeps, purgeIndividualOrganizationWithDeps, purgeOrganizationEmployeeWithDeps, searchClinicalBundleWithDeps, searchLatestIpsWithDeps, upsertRelatedPersonAndPollWithDeps, } from './resource-operations.js';
+import { createOrganizationEmployeeWithDeps, disableIndividualOrganizationWithDeps, disableOrganizationEmployeeWithDeps, grantProfessionalAccessWithDeps, ingestCommunicationAndUpdateIndexWithDeps, purgeIndividualOrganizationWithDeps, purgeOrganizationEmployeeWithDeps, searchOrganizationEmployeesWithDeps, searchClinicalBundleWithDeps, searchLatestIpsWithDeps, upsertRelatedPersonAndPollWithDeps, } from './resource-operations.js';
 import { submitAndPollWithMethods } from './orchestration/client-port.js';
 import { GwCoreLifecycleAction } from './constants/lifecycle.js';
 const bootstrapFacade = createBootstrapFacade();
@@ -200,6 +200,16 @@ export class HttpRuntimeClient {
     async purgeEmployee(ctx, input, pollOptions) {
         return this.purgeOrganizationEmployee(ctx, input, pollOptions);
     }
+    /**
+     * Searches employees/professionals under the selected organization tenant.
+     */
+    async searchOrganizationEmployees(ctx, input) {
+        return searchOrganizationEmployeesWithDeps(ctx, input, {
+            employeeSearchPath: this.employeeSearchPath.bind(this),
+            employeeSearchPollPath: this.employeeSearchPollPath.bind(this),
+            submitAndPoll: this.submitAndPoll.bind(this),
+        });
+    }
     /**
      * Starts the onboarding flow for an individual-oriented tenant or index.
      */
@@ -529,6 +539,8 @@ export class HttpRuntimeClient {
     hostRegistryOrderPollPath(ctx) { return this.hostRegistryPath(ctx, 'Order', '_batch-response'); }
     employeeBatchPath(ctx) { return this.v1Path(ctx, 'entity', 'org.schema', 'Employee', GwCoreLifecycleAction.Batch); }
     employeePollPath(ctx) { return this.v1Path(ctx, 'entity', 'org.schema', 'Employee', GwCoreLifecycleAction.BatchResponse); }
+    employeeSearchPath(ctx) { return this.v1Path(ctx, 'entity', 'org.schema', 'Employee', '_search'); }
+    employeeSearchPollPath(ctx) { return this.v1Path(ctx, 'entity', 'org.schema', 'Employee', '_search-response'); }
     employeePurgePath(ctx) { return this.v1Path(ctx, 'entity', 'org.schema', 'Employee', GwCoreLifecycleAction.Purge); }
     employeePurgePollPath(ctx) { return this.v1Path(ctx, 'entity', 'org.schema', 'Employee', `${GwCoreLifecycleAction.Purge}-response`); }
     individualFamilyOrganizationBatchPath(ctx) { return this.v1Path(ctx, 'individual', 'org.schema', 'Organization', GwCoreLifecycleAction.Batch); }

package/dist/orchestration/client-port.d.ts

@@ -6,7 +6,7 @@ import type { HostRouteContext, LegalOrganizationOrderInput } from '../host-onbo
 import type { IndividualOrganizationConfirmOrderInput, RouteContext } from '../individual-onboarding.js';
 import type { IndividualOrganizationBootstrapInput, IndividualOrganizationStartResult } from '../individual-start.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
-import type { CommunicationIngestionInput, ClinicalBundleSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IndividualOrganizationLifecycleInput, IpsOrFhirImportInput, OrganizationEmployeeCreationInput, OrganizationEmployeeLifecycleInput, RelatedPersonUpsertInput } from '../resource-operations.js';
+import type { CommunicationIngestionInput, ClinicalBundleSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IndividualOrganizationLifecycleInput, IpsOrFhirImportInput, OrganizationEmployeeCreationInput, OrganizationEmployeeLifecycleInput, OrganizationEmployeeSearchInput, RelatedPersonUpsertInput } from '../resource-operations.js';
 /**
  * Shared node-runtime activation input.
  *
@@ -30,6 +30,7 @@ export type RuntimeClient = {
     activateOrganizationInGatewayFromIcaProof?: (hostCtx: HostRouteContext, input: NodeOrganizationActivationInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     confirmLegalOrganizationOrder?: (hostCtx: HostRouteContext, input: LegalOrganizationOrderInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     createOrganizationEmployee?: (ctx: RouteContext, input: OrganizationEmployeeCreationInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
+    searchOrganizationEmployees?: (ctx: RouteContext, input: OrganizationEmployeeSearchInput) => Promise<SubmitAndPollResult>;
     disableEmployee?: (ctx: RouteContext, input: OrganizationEmployeeLifecycleInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     purgeEmployee?: (ctx: RouteContext, input: OrganizationEmployeeLifecycleInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     disableOrganizationEmployee?: (ctx: RouteContext, input: OrganizationEmployeeLifecycleInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;

package/dist/orchestration/professional-sdk.d.ts

@@ -1,12 +1,15 @@
-import { type NodeOrganizationActivationInput, type NodeRuntimeClient, type PollOptions, type SubmitAndPollResult, type SubmitPayload } from './client-port.js';
-import type { HostRouteContext } from '../host-onboarding.js';
+import { type NodeRuntimeClient, type PollOptions, type SubmitAndPollResult, type SubmitPayload } from './client-port.js';
 import type { RouteContext } from '../individual-onboarding.js';
-import type { EmployeeDeviceActivationResult, EmployeeDeviceActivationRequestInput } from '../device-activation.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
-import type { CommunicationIngestionInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, OrganizationEmployeeCreationInput } from '../resource-operations.js';
+import type { CommunicationIngestionInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult } from '../resource-operations.js';
 /**
- * Professional-oriented facade combining host onboarding, employee bootstrap,
- * consent, communication, and SMART token runtime calls.
+ * Professional-oriented facade for runtime actions that belong to the
+ * professional actor itself after tenant and employee provisioning have already
+ * happened through the organization-scoped facades.
+ *
+ * Keep this boundary strict:
+ * - professional runtime actions belong here
+ * - organization activation and employee provisioning do not
  */
 export declare class ProfessionalSdk {
     private readonly client;
@@ -14,20 +17,6 @@ export declare class ProfessionalSdk {
      * @param client Runtime client implementation used to submit and poll GW flows.
      */
     constructor(client: NodeRuntimeClient);
-    /**
-     * Activates the legal organization in the gateway from an ICA-issued proof
-     * token and the declared service capabilities that will be published through
-     * DID/DCAT discovery.
-     */
-    activateOrganizationInGatewayFromIcaProof(hostCtx: HostRouteContext, input: NodeOrganizationActivationInput, pollOptions?: PollOptions): Promise<SubmitAndPollResult>;
-    /**
-     * Creates an employee/professional under the current organization tenant.
-     */
-    createOrganizationEmployee(ctx: RouteContext, input: OrganizationEmployeeCreationInput, pollOptions?: PollOptions): Promise<SubmitAndPollResult>;
-    /**
-     * Activates the current employee device from a previously issued activation request.
-     */
-    activateEmployeeDeviceWithActivationRequest(input: EmployeeDeviceActivationRequestInput): Promise<EmployeeDeviceActivationResult>;
     /**
      * Requests a SMART token suitable for subsequent clinical/document calls.
      *

package/dist/orchestration/professional-sdk.js

@@ -2,8 +2,13 @@
 // Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
 import { requireClientMethod, submitAndPollWithClient, } from './client-port.js';
 /**
- * Professional-oriented facade combining host onboarding, employee bootstrap,
- * consent, communication, and SMART token runtime calls.
+ * Professional-oriented facade for runtime actions that belong to the
+ * professional actor itself after tenant and employee provisioning have already
+ * happened through the organization-scoped facades.
+ *
+ * Keep this boundary strict:
+ * - professional runtime actions belong here
+ * - organization activation and employee provisioning do not
  */
 export class ProfessionalSdk {
     /**
@@ -12,26 +17,6 @@ export class ProfessionalSdk {
     constructor(client) {
         this.client = client;
     }
-    /**
-     * Activates the legal organization in the gateway from an ICA-issued proof
-     * token and the declared service capabilities that will be published through
-     * DID/DCAT discovery.
-     */
-    activateOrganizationInGatewayFromIcaProof(hostCtx, input, pollOptions) {
-        return requireClientMethod(this.client, 'activateOrganizationInGatewayFromIcaProof')(hostCtx, input, pollOptions);
-    }
-    /**
-     * Creates an employee/professional under the current organization tenant.
-     */
-    createOrganizationEmployee(ctx, input, pollOptions) {
-        return requireClientMethod(this.client, 'createOrganizationEmployee')(ctx, input, pollOptions);
-    }
-    /**
-     * Activates the current employee device from a previously issued activation request.
-     */
-    activateEmployeeDeviceWithActivationRequest(input) {
-        return requireClientMethod(this.client, 'activateEmployeeDeviceWithActivationRequest')(input);
-    }
     /**
      * Requests a SMART token suitable for subsequent clinical/document calls.
      *

package/dist/resource-operations.d.ts

@@ -1,4 +1,4 @@
-import type { BundleSearchQuery, CommunicationInput, DateRange } from 'gdc-sdk-core-ts';
+import type { BundleSearchQuery, CommunicationInput, DateRange, EmployeeSearchValue } from 'gdc-sdk-core-ts';
 import type { SubmitAndPollResult } from './orchestration/client-port.js';
 import type { RouteContext } from './individual-onboarding.js';
 export type OrganizationEmployeeCreationInput = {
@@ -43,6 +43,22 @@ export type OrganizationEmployeeLifecycleInput = {
     resourceId?: string;
     dataType?: string;
 };
+export type OrganizationEmployeeSearchInput = {
+    /**
+     * Canonical employee/person claims used as search filters against GW CORE.
+     *
+     * Typical examples:
+     * - `org.schema.Person.email`
+     * - `org.schema.Person.hasOccupation.identifier.value`
+     * - `org.schema.Person.memberOf.taxID`
+     */
+    employeeClaims?: Record<string, EmployeeSearchValue>;
+    requestThid?: string;
+    pollOptions?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    };
+};
 /**
  * Current GW CORE individual/family lifecycle locator payload.
  *
@@ -229,6 +245,16 @@ export declare function purgeOrganizationEmployeeWithDeps(routeCtx: RouteContext
         intervalMs?: number;
     }) => Promise<SubmitAndPollResult>;
 }): Promise<SubmitAndPollResult>;
+export declare function searchOrganizationEmployeesWithDeps(routeCtx: RouteContext, input: OrganizationEmployeeSearchInput, deps: {
+    employeeSearchPath: (ctx: RouteContext) => string;
+    employeeSearchPollPath: (ctx: RouteContext) => string;
+    submitAndPoll: (submitPath: string, pollPath: string, payload: {
+        thid?: string;
+    } & Record<string, unknown>, pollOptions?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    }) => Promise<SubmitAndPollResult>;
+}): Promise<SubmitAndPollResult>;
 export declare function disableIndividualOrganizationWithDeps(routeCtx: RouteContext, input: IndividualOrganizationLifecycleInput, options: {
     timeoutMs?: number;
     intervalMs?: number;

package/dist/resource-operations.js

@@ -1,6 +1,7 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
 import { HealthcareBasicSections } from 'gdc-common-utils-ts/constants';
 import { GwCoreLifecycleRequestMethod, GwCoreLifecycleRequestType, GwCoreLifecycleTodo, } from './constants/lifecycle.js';
+import { buildEmployeeBatchEntry, buildEmployeeSearchBundle, } from 'gdc-sdk-core-ts';
 export async function createOrganizationEmployeeWithDeps(routeCtx, input, options, deps) {
     const payload = buildEmployeeLifecyclePayload({
         routeCtx,
@@ -36,6 +37,12 @@ export async function purgeOrganizationEmployeeWithDeps(routeCtx, input, options
     });
     return deps.submitAndPoll(deps.employeePurgePath(routeCtx), deps.employeePurgePollPath(routeCtx), payload, options);
 }
+export async function searchOrganizationEmployeesWithDeps(routeCtx, input, deps) {
+    return deps.submitAndPoll(deps.employeeSearchPath(routeCtx), deps.employeeSearchPollPath(routeCtx), {
+        thid: input.requestThid || `employee-search-${createRuntimeUuid()}`,
+        body: buildEmployeeSearchBundle({ claims: input.employeeClaims }),
+    }, input.pollOptions);
+}
 export async function disableIndividualOrganizationWithDeps(routeCtx, input, options, deps) {
     // TODO(gw-core-lifecycle-target-patch-individual-disable): migrate from
     // explicit `_disable` to `_batch + PATCH` only after GW CORE supports it.
@@ -186,15 +193,12 @@ function buildEmployeeLifecyclePayload(input) {
         type: 'application/didcomm-plain+json',
         thid: `${input.thidPrefix}-${createRuntimeUuid()}`,
         body: {
-            data: [{
+            data: [buildEmployeeBatchEntry({
                     type: input.requestType,
-                    request: { method: input.requestMethod },
-                    meta: { claims },
-                    resource: {
-                        ...(input.resourceId ? { id: input.resourceId } : {}),
-                        meta: { claims },
-                    },
-                }],
+                    method: input.requestMethod,
+                    claims,
+                    resourceId: input.resourceId,
+                })],
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-sdk-node-ts",
-  "version": "0.6.4",
+  "version": "0.6.7",
   "description": "Next-generation Node runtime package for the GDC SDK family",
   "license": "Apache-2.0",
   "author": "Antifraud Services Inc.",
@@ -17,8 +17,8 @@
     "test:e2e:live-gw": "npm run build && RUN_LIVE_GW_E2E=1 node --test tests/live-gw-node-runtime.e2e.test.mjs"
   },
   "dependencies": {
-    "gdc-common-utils-ts": "file:../gdc-common-utils-ts",
-    "gdc-sdk-core-ts": "^0.6.3"
+    "gdc-common-utils-ts": "^1.14.14",
+    "gdc-sdk-core-ts": "^0.6.12"
   },
   "devDependencies": {
     "@types/node": "^20.14.10",