gdc-common-utils-ts 2.6.2 → 2.6.4

package/dist/constants/employee-lifecycle.d.ts

@@ -16,6 +16,11 @@ export declare const EmployeeLifecycleActions: Readonly<{
 export declare const EmployeeLifecycleQueryActions: Readonly<{
     readonly List: "list";
 }>;
+/** Stable response-entry types for the shared employee and seat directory. */
+export declare const OrganizationEmployeeSearchResponseEntryTypes: Readonly<{
+    readonly Employee: "Employee-search-response-v1.0";
+    readonly License: "License-search-response-v1.0";
+}>;
 export type EmployeeLifecycleAction = typeof EmployeeLifecycleActions[keyof typeof EmployeeLifecycleActions];
 /** Version tag for routing metadata stored outside the high-entropy GW credential. */
 export declare const EmployeeActivationGrantVersions: Readonly<{

package/dist/constants/employee-lifecycle.js

@@ -15,6 +15,11 @@ export const EmployeeLifecycleActions = Object.freeze({
 export const EmployeeLifecycleQueryActions = Object.freeze({
     List: 'list',
 });
+/** Stable response-entry types for the shared employee and seat directory. */
+export const OrganizationEmployeeSearchResponseEntryTypes = Object.freeze({
+    Employee: 'Employee-search-response-v1.0',
+    License: 'License-search-response-v1.0',
+});
 /** Version tag for routing metadata stored outside the high-entropy GW credential. */
 export const EmployeeActivationGrantVersions = Object.freeze({
     V1: 'employee-activation-grant-v1',

package/dist/examples/employee.d.ts

@@ -75,11 +75,43 @@ export declare function buildExampleEmployeeClaims(record: ExampleEmployeeRecord
  * to show employee directory flows without reauthoring `meta.claims` by hand.
  */
 export declare const EXAMPLE_EMPLOYEE_SEARCH_RESPONSE_BODY: Readonly<{
+    readonly resourceType: "Bundle";
+    readonly type: "batch-response";
+    readonly total: 3;
     readonly data: {
-        id: string;
-        meta: {
+        type: "Employee-search-response-v1.0";
+        resource: {
+            id: string;
             status: "active" | "inactive" | "purged";
             claims: Readonly<Record<string, string>>;
+            meta: {
+                status: "active" | "inactive" | "purged";
+                claims: Readonly<Record<string, string>>;
+            };
+        };
+        response: {
+            status: "200";
         };
     }[];
 }>;
+/** @deprecated Read-only fixture for GW versions that nested search rows. */
+export declare const EXAMPLE_EMPLOYEE_SEARCH_RESPONSE_BODY_LEGACY: Readonly<{
+    readonly data: readonly [{
+        readonly type: "Employee-search-response-v1.0";
+        readonly resource: {
+            readonly total: 3;
+            readonly data: {
+                id: string;
+                status: "active" | "inactive" | "purged";
+                claims: Readonly<Record<string, string>>;
+                meta: {
+                    status: "active" | "inactive" | "purged";
+                    claims: Readonly<Record<string, string>>;
+                };
+            }[];
+        };
+        readonly response: {
+            readonly status: "200";
+        };
+    }];
+}>;

package/dist/examples/employee.js

@@ -1,4 +1,6 @@
+import { OrganizationEmployeeSearchResponseEntryTypes } from '../constants/employee-lifecycle.js';
 import { ClaimsPersonSchemaorg } from '../constants/schemaorg.js';
+import { EXAMPLE_BUNDLE_RESOURCE_TYPE, EXAMPLE_BUNDLE_TYPE_BATCH_RESPONSE, ExampleHttpStatusText, } from './shared.js';
 export const ExampleEmployeeEmails = Object.freeze({
     SharedProfessional: 'shared.professional@example.org',
 });
@@ -68,11 +70,31 @@ export function buildExampleEmployeeClaims(record) {
  * to show employee directory flows without reauthoring `meta.claims` by hand.
  */
 export const EXAMPLE_EMPLOYEE_SEARCH_RESPONSE_BODY = Object.freeze({
+    resourceType: EXAMPLE_BUNDLE_RESOURCE_TYPE,
+    type: EXAMPLE_BUNDLE_TYPE_BATCH_RESPONSE,
+    total: EXAMPLE_EMPLOYEE_DIRECTORY_RECORDS.length,
     data: EXAMPLE_EMPLOYEE_DIRECTORY_RECORDS.map((record) => ({
-        id: record.resourceId,
-        meta: {
+        type: OrganizationEmployeeSearchResponseEntryTypes.Employee,
+        resource: {
+            id: record.resourceId,
             status: record.status,
             claims: buildExampleEmployeeClaims(record),
+            meta: {
+                status: record.status,
+                claims: buildExampleEmployeeClaims(record),
+            },
         },
+        response: { status: ExampleHttpStatusText.Ok },
     })),
 });
+/** @deprecated Read-only fixture for GW versions that nested search rows. */
+export const EXAMPLE_EMPLOYEE_SEARCH_RESPONSE_BODY_LEGACY = Object.freeze({
+    data: [{
+            type: OrganizationEmployeeSearchResponseEntryTypes.Employee,
+            resource: {
+                total: EXAMPLE_EMPLOYEE_SEARCH_RESPONSE_BODY.total,
+                data: EXAMPLE_EMPLOYEE_SEARCH_RESPONSE_BODY.data.map(entry => entry.resource),
+            },
+            response: { status: ExampleHttpStatusText.Ok },
+        }],
+});

package/dist/examples/license.d.ts

@@ -141,9 +141,50 @@ export declare const EXAMPLE_LICENSE_ISSUE_RESPONSE_BODY: Readonly<{
 }>;
 /** Shared license search response containing the default two-installation state. */
 export declare const EXAMPLE_LICENSE_LIST_RESPONSE_BODY_WITH_DEVICES: Readonly<{
+    readonly body: {
+        readonly resourceType: "Bundle";
+        readonly type: "batch-response";
+        readonly total: 1;
+        readonly data: readonly [{
+            readonly type: "License-search-response-v1.0";
+            readonly resource: {
+                readonly id: "8a8a5e1b-0d8e-4a7c-8c39-3b8034440001";
+                readonly meta: {
+                    readonly status: "active";
+                    readonly subjectId: string;
+                    readonly maxDevices: 2;
+                    readonly deviceBindings: readonly [Readonly<{
+                        clientId: "client-employee-primary";
+                        clientInstanceId: "installation-employee-primary";
+                        status: "active";
+                        deviceInfo: Readonly<{
+                            clientInstanceId: "installation-employee-primary";
+                            model: "Shared browser profile";
+                        }>;
+                        activatedAt: 1786570800;
+                    }>, Readonly<{
+                        clientId: "client-employee-secondary";
+                        clientInstanceId: "installation-employee-secondary";
+                        status: "revoked";
+                        deviceInfo: Readonly<{
+                            clientInstanceId: "installation-employee-secondary";
+                        }>;
+                        activatedAt: 1786570900;
+                        revokedAt: 1786571000;
+                    }>];
+                };
+            };
+            readonly response: {
+                readonly status: "200";
+            };
+        }];
+    };
+}>;
+/** @deprecated Read-only fixture for GW versions that nested search rows. */
+export declare const EXAMPLE_LICENSE_LIST_RESPONSE_BODY_WITH_DEVICES_LEGACY: Readonly<{
     readonly body: {
         readonly resource: {
-            readonly data: readonly [{
+            readonly data: {
                 readonly id: "8a8a5e1b-0d8e-4a7c-8c39-3b8034440001";
                 readonly meta: {
                     readonly status: "active";
@@ -169,7 +210,7 @@ export declare const EXAMPLE_LICENSE_LIST_RESPONSE_BODY_WITH_DEVICES: Readonly<{
                         revokedAt: 1786571000;
                     }>];
                 };
-            }];
+            }[];
         };
     };
 }>;

package/dist/examples/license.js

@@ -1,8 +1,9 @@
 import { DeviceAppTypes, DeviceBindingStatuses, DeviceUserClasses } from '../constants/device.js';
+import { OrganizationEmployeeSearchResponseEntryTypes } from '../constants/employee-lifecycle.js';
 import { ClaimsOrderSchemaorg, ClaimsIndividualProductSchemaorg, ClaimsOfferSchemaorg, ClaimsPersonSchemaorg, } from '../constants/schemaorg.js';
 import { buildLicenseIssueClaims, buildLicensePurchaseClaims, LicenseClaimContext, LicenseCategories, LicenseStatuses, } from '../utils/license.js';
 import { createLicenseOfferOrderEditor } from '../utils/license-offer-order.js';
-import { EXAMPLE_LICENSE_ACCEPTED_OFFER_ID, EXAMPLE_LICENSE_AMOUNT, EXAMPLE_LICENSE_CHECKOUT_URL, EXAMPLE_LICENSE_CURRENCY, EXAMPLE_EMAIL_CONTROLLER_ORG, EXAMPLE_EMPLOYEE_ACTIVATION_CODE, EXAMPLE_EMPLOYEE_DEVICE_CLIENT_ID_PRIMARY, EXAMPLE_EMPLOYEE_DEVICE_CLIENT_ID_SECONDARY, EXAMPLE_EMPLOYEE_DEVICE_INSTANCE_ID_PRIMARY, EXAMPLE_EMPLOYEE_DEVICE_INSTANCE_ID_SECONDARY, EXAMPLE_EMPLOYEE_DEVICE_MODEL_PRIMARY, EXAMPLE_HEALTHCARE_ACTOR_ROLE_GENERALIST_MEDICAL_PRACTITIONER, EXAMPLE_LICENSE_INVOICE_ID, EXAMPLE_LICENSE_OFFER_ID, EXAMPLE_LICENSE_PLAN_DEFAULT, EXAMPLE_LICENSE_PAYMENT_METHOD_INVOICE, EXAMPLE_LICENSE_PAYMENT_URL, EXAMPLE_LICENSE_RENEWAL_CYCLE_YEARLY, EXAMPLE_LICENSE_PLAN_NAME, EXAMPLE_LICENSE_SEAT_UUID_ACTIVE, EXAMPLE_LICENSE_SEAT_UUID_AVAILABLE, EXAMPLE_LICENSE_SEAT_UUID_SECONDARY, EXAMPLE_LICENSE_SKU, EXAMPLE_LICENSE_SUBJECT_ID_ACTIVE, EXAMPLE_LICENSE_SUBJECT_ID_AVAILABLE, EXAMPLE_TENANT_IDENTIFIER, } from './shared.js';
+import { EXAMPLE_LICENSE_ACCEPTED_OFFER_ID, EXAMPLE_LICENSE_AMOUNT, EXAMPLE_LICENSE_CHECKOUT_URL, EXAMPLE_LICENSE_CURRENCY, EXAMPLE_EMAIL_CONTROLLER_ORG, EXAMPLE_EMPLOYEE_ACTIVATION_CODE, EXAMPLE_EMPLOYEE_DEVICE_CLIENT_ID_PRIMARY, EXAMPLE_EMPLOYEE_DEVICE_CLIENT_ID_SECONDARY, EXAMPLE_EMPLOYEE_DEVICE_INSTANCE_ID_PRIMARY, EXAMPLE_EMPLOYEE_DEVICE_INSTANCE_ID_SECONDARY, EXAMPLE_EMPLOYEE_DEVICE_MODEL_PRIMARY, EXAMPLE_BUNDLE_RESOURCE_TYPE, EXAMPLE_BUNDLE_TYPE_BATCH_RESPONSE, EXAMPLE_HEALTHCARE_ACTOR_ROLE_GENERALIST_MEDICAL_PRACTITIONER, EXAMPLE_LICENSE_INVOICE_ID, EXAMPLE_LICENSE_OFFER_ID, EXAMPLE_LICENSE_PLAN_DEFAULT, EXAMPLE_LICENSE_PAYMENT_METHOD_INVOICE, EXAMPLE_LICENSE_PAYMENT_URL, EXAMPLE_LICENSE_RENEWAL_CYCLE_YEARLY, EXAMPLE_LICENSE_PLAN_NAME, EXAMPLE_LICENSE_SEAT_UUID_ACTIVE, EXAMPLE_LICENSE_SEAT_UUID_AVAILABLE, EXAMPLE_LICENSE_SEAT_UUID_SECONDARY, EXAMPLE_LICENSE_SKU, EXAMPLE_LICENSE_SUBJECT_ID_ACTIVE, EXAMPLE_LICENSE_SUBJECT_ID_AVAILABLE, EXAMPLE_TENANT_IDENTIFIER, ExampleHttpStatusText, } from './shared.js';
 import { DEFAULT_LICENSE_DEVICE_ALLOWANCE } from '../utils/license.js';
 import { EXAMPLE_EMPLOYEE_CONTROLLER_ACTIVE } from './employee.js';
 export const EXAMPLE_EMPLOYEE_DEVICE_BINDINGS = Object.freeze([
@@ -123,8 +124,12 @@ export const EXAMPLE_LICENSE_ISSUE_RESPONSE_BODY = Object.freeze({
 /** Shared license search response containing the default two-installation state. */
 export const EXAMPLE_LICENSE_LIST_RESPONSE_BODY_WITH_DEVICES = Object.freeze({
     body: {
-        resource: {
-            data: [{
+        resourceType: EXAMPLE_BUNDLE_RESOURCE_TYPE,
+        type: EXAMPLE_BUNDLE_TYPE_BATCH_RESPONSE,
+        total: 1,
+        data: [{
+                type: OrganizationEmployeeSearchResponseEntryTypes.License,
+                resource: {
                     id: EXAMPLE_LICENSE_ACTIVE_RECORD.id,
                     meta: {
                         status: EXAMPLE_LICENSE_ACTIVE_RECORD.status,
@@ -132,7 +137,16 @@ export const EXAMPLE_LICENSE_LIST_RESPONSE_BODY_WITH_DEVICES = Object.freeze({
                         maxDevices: DEFAULT_LICENSE_DEVICE_ALLOWANCE,
                         deviceBindings: EXAMPLE_EMPLOYEE_DEVICE_BINDINGS,
                     },
-                }],
+                },
+                response: { status: ExampleHttpStatusText.Ok },
+            }],
+    },
+});
+/** @deprecated Read-only fixture for GW versions that nested search rows. */
+export const EXAMPLE_LICENSE_LIST_RESPONSE_BODY_WITH_DEVICES_LEGACY = Object.freeze({
+    body: {
+        resource: {
+            data: EXAMPLE_LICENSE_LIST_RESPONSE_BODY_WITH_DEVICES.body.data.map(entry => entry.resource),
         },
     },
 });

package/dist/examples/shared.d.ts

@@ -247,6 +247,7 @@ export declare const EXAMPLE_CONTENT_TYPE_FHIR_JSON: "application/fhir+json";
 export declare const EXAMPLE_IPS_BUNDLE_ATTACHMENT_TITLE: "IPS Document Bundle";
 export declare const EXAMPLE_BUNDLE_RESOURCE_TYPE: "Bundle";
 export declare const EXAMPLE_BUNDLE_TYPE_BATCH: "batch";
+export declare const EXAMPLE_BUNDLE_TYPE_BATCH_RESPONSE: "batch-response";
 export declare const EXAMPLE_BUNDLE_TYPE_DOCUMENT: "document";
 export declare const EXAMPLE_MEDICATION_STATEMENT_UUID: "urn:uuid:medication-statement-example-001";
 export declare const EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER: "urn:uuid:medication-statement-example-001";

package/dist/examples/shared.js

@@ -289,6 +289,7 @@ export const EXAMPLE_CONTENT_TYPE_FHIR_JSON = 'application/fhir+json';
 export const EXAMPLE_IPS_BUNDLE_ATTACHMENT_TITLE = 'IPS Document Bundle';
 export const EXAMPLE_BUNDLE_RESOURCE_TYPE = 'Bundle';
 export const EXAMPLE_BUNDLE_TYPE_BATCH = 'batch';
+export const EXAMPLE_BUNDLE_TYPE_BATCH_RESPONSE = 'batch-response';
 export const EXAMPLE_BUNDLE_TYPE_DOCUMENT = 'document';
 export const EXAMPLE_MEDICATION_STATEMENT_UUID = 'urn:uuid:medication-statement-example-001';
 export const EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER = EXAMPLE_MEDICATION_STATEMENT_UUID;

package/dist/utils/organization-employee-lifecycle.d.ts

@@ -3,8 +3,16 @@ import type { EmployeeDeviceRevocationTarget, OrganizationEmployeeLifecycleRecor
 export declare function buildEmployeeDeviceRevocationBody(target: EmployeeDeviceRevocationTarget): Readonly<Record<string, string>>;
 /** Reads an employee activation credential from canonical and legacy GW envelopes. */
 export declare function readEmployeeActivationCode(value: unknown): string;
-/** Extracts GW search rows regardless of async job envelope depth. */
-export declare function extractGwSearchResources(value: unknown): ReadonlyArray<Record<string, unknown>>;
+/**
+ * Extracts primary resources from a DIDComm FHIR-like response Bundle.
+ *
+ * Canonical search matches live at `body.data[].resource`. The deprecated
+ * `resource.{total,data}` aggregate remains a read-only compatibility path so
+ * an SDK can survive a rolling GW deployment; producers must not emit it.
+ */
+export declare function extractBundleSearchResources(value: unknown): ReadonlyArray<Record<string, unknown>>;
+/** @deprecated Use the transport-neutral `extractBundleSearchResources`. */
+export declare const extractGwSearchResources: typeof extractBundleSearchResources;
 /** Combines employee directory and license search results into one typed view. */
 export declare function projectOrganizationEmployeeLifecycle(input: Readonly<{
     employeeResponse: unknown;

package/dist/utils/organization-employee-lifecycle.js

@@ -25,19 +25,52 @@ export function readEmployeeActivationCode(value) {
     }
     return '';
 }
-/** Extracts GW search rows regardless of async job envelope depth. */
-export function extractGwSearchResources(value) {
+/**
+ * Extracts primary resources from a DIDComm FHIR-like response Bundle.
+ *
+ * Canonical search matches live at `body.data[].resource`. The deprecated
+ * `resource.{total,data}` aggregate remains a read-only compatibility path so
+ * an SDK can survive a rolling GW deployment; producers must not emit it.
+ */
+export function extractBundleSearchResources(value) {
     for (const candidate of listNestedRecords(value)) {
-        const data = record(candidate.resource)?.data || candidate.data;
-        if (Array.isArray(data))
-            return data.map(record).filter(isRecord);
+        if (!Array.isArray(candidate.data))
+            continue;
+        const entries = candidate.data.map(record).filter(isRecord);
+        if (entries.length === 0)
+            return [];
+        let recognizedSearchEnvelope = false;
+        const resources = entries.flatMap((entry) => {
+            const resource = record(entry.resource);
+            if (!resource)
+                return [];
+            const legacyRows = resource.total !== undefined && Array.isArray(resource.data)
+                ? resource.data.map(record).filter(isRecord)
+                : undefined;
+            if (legacyRows)
+                recognizedSearchEnvelope = true;
+            return legacyRows ?? [resource];
+        });
+        if (resources.length > 0)
+            return resources;
+        if (recognizedSearchEnvelope)
+            return [];
+        // Compatibility for older SDK fixtures that passed already-extracted rows.
+        return entries;
+    }
+    for (const candidate of listNestedRecords(value)) {
+        const legacyRows = record(candidate.resource)?.data;
+        if (Array.isArray(legacyRows))
+            return legacyRows.map(record).filter(isRecord);
     }
     return [];
 }
+/** @deprecated Use the transport-neutral `extractBundleSearchResources`. */
+export const extractGwSearchResources = extractBundleSearchResources;
 /** Combines employee directory and license search results into one typed view. */
 export function projectOrganizationEmployeeLifecycle(input) {
-    const licenses = extractGwSearchResources(input.licenseResponse);
-    return extractGwSearchResources(input.employeeResponse).map((employee) => {
+    const licenses = extractBundleSearchResources(input.licenseResponse);
+    return extractBundleSearchResources(input.employeeResponse).map((employee) => {
         const claims = record(employee.claims) || record(record(employee.meta)?.claims) || {};
         const resourceId = text(employee.id);
         const employeeDid = text(claims[ClaimsPersonSchemaorg.identifier]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "2.6.2",
+  "version": "2.6.4",
   "publishConfig": {
     "access": "public"
   },