gdc-common-utils-ts 1.20.2 → 1.23.0

package/dist/utils/consent-lifecycle-result-reader.d.ts

@@ -0,0 +1,24 @@
+import { createLifecycleResultReader, LifecycleResultAnalysis, LifecycleResultEntrySummary, LifecycleResultReader } from './lifecycle-result-reader.js';
+export type ConsentLifecycleResultEntrySummary = LifecycleResultEntrySummary;
+export type ConsentLifecycleResultAnalysis = LifecycleResultAnalysis;
+/**
+ * Consent-named alias over the neutral lifecycle result reader.
+ *
+ * Intent:
+ * - keep one explicit frontend-facing entry point for consent lifecycle
+ *   responses
+ * - avoid duplicating parser logic already shared by `LifecycleResultReader`
+ * - make docs/tests easier to follow for teams integrating consent first
+ */
+export declare class ConsentLifecycleResultReader extends LifecycleResultReader {
+}
+/**
+ * Creates one consent-named lifecycle result reader while preserving the same
+ * neutral output contract as `createLifecycleResultReader(...)`.
+ */
+export declare function createConsentLifecycleResultReader(result: Record<string, unknown>): ConsentLifecycleResultReader;
+/**
+ * Short alias for teams that prefer an explicit read verb in code examples.
+ */
+export declare function readConsentLifecycleResult(result: Record<string, unknown>): ConsentLifecycleResultReader;
+export { createLifecycleResultReader, };

package/dist/utils/consent-lifecycle-result-reader.js

@@ -0,0 +1,27 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { createLifecycleResultReader, LifecycleResultReader, } from './lifecycle-result-reader.js';
+/**
+ * Consent-named alias over the neutral lifecycle result reader.
+ *
+ * Intent:
+ * - keep one explicit frontend-facing entry point for consent lifecycle
+ *   responses
+ * - avoid duplicating parser logic already shared by `LifecycleResultReader`
+ * - make docs/tests easier to follow for teams integrating consent first
+ */
+export class ConsentLifecycleResultReader extends LifecycleResultReader {
+}
+/**
+ * Creates one consent-named lifecycle result reader while preserving the same
+ * neutral output contract as `createLifecycleResultReader(...)`.
+ */
+export function createConsentLifecycleResultReader(result) {
+    return new ConsentLifecycleResultReader(result);
+}
+/**
+ * Short alias for teams that prefer an explicit read verb in code examples.
+ */
+export function readConsentLifecycleResult(result) {
+    return createConsentLifecycleResultReader(result);
+}
+export { createLifecycleResultReader, };

package/dist/utils/employee.d.ts

@@ -33,6 +33,17 @@ export type EmployeeSearchBundleInput = Readonly<{
     encoding?: SearchRequestEncoding;
     resourceType?: 'Employee';
 }>;
+export type EmployeeSearchResultRecord = Readonly<{
+    identifier?: string;
+    email?: string;
+    role?: string;
+    worksFor?: string;
+    memberOf?: string;
+    memberOfOrgTaxId?: string;
+    resourceId?: string;
+    status?: string;
+    claims: Record<string, unknown>;
+}>;
 export declare const EmployeeBundleOperations: Readonly<{
     readonly create: "create";
     readonly search: "search";
@@ -131,3 +142,17 @@ export declare function buildEmployeeSearchBundle(input?: EmployeeSearchBundleIn
         };
     }>;
 };
+/**
+ * Reads employee-like search/list records from one current GW-style result body
+ * without forcing frontend callers to inspect `meta.claims` manually.
+ *
+ * Accepted inputs:
+ * - direct bundle-like payloads with `entry[]` or `data[]`
+ * - wrapper objects with `body.entry[]` or `body.data[]`
+ */
+export declare function readEmployeeSearchResults(body: unknown): EmployeeSearchResultRecord[];
+/**
+ * Returns one employee result by canonical identifier from current search/list
+ * results.
+ */
+export declare function findEmployeeSearchResult(body: unknown, identifier: string): EmployeeSearchResultRecord | undefined;

package/dist/utils/employee.js

@@ -39,6 +39,18 @@ function normalizeEmployeeSearchClaims(claims) {
     }
     return normalized;
 }
+function normalizeText(value) {
+    const normalized = String(value ?? '').trim();
+    return normalized || undefined;
+}
+function extractEntryClaims(entry) {
+    const meta = entry.meta && typeof entry.meta === 'object' ? entry.meta : {};
+    const resource = entry.resource && typeof entry.resource === 'object' ? entry.resource : {};
+    const resourceMeta = resource.meta && typeof resource.meta === 'object' ? resource.meta : {};
+    const metaClaims = meta.claims && typeof meta.claims === 'object' ? meta.claims : undefined;
+    const resourceClaims = resourceMeta.claims && typeof resourceMeta.claims === 'object' ? resourceMeta.claims : undefined;
+    return { ...(resourceClaims || {}), ...(metaClaims || {}) };
+}
 function inferEmployeeEntryType(method) {
     switch (method) {
         case 'DELETE':
@@ -181,3 +193,48 @@ export function buildEmployeeSearchBundle(input = {}) {
         ],
     };
 }
+/**
+ * Reads employee-like search/list records from one current GW-style result body
+ * without forcing frontend callers to inspect `meta.claims` manually.
+ *
+ * Accepted inputs:
+ * - direct bundle-like payloads with `entry[]` or `data[]`
+ * - wrapper objects with `body.entry[]` or `body.data[]`
+ */
+export function readEmployeeSearchResults(body) {
+    const root = body && typeof body === 'object' ? body : {};
+    const bodyNode = root.body && typeof root.body === 'object' ? root.body : root;
+    const rawEntries = Array.isArray(bodyNode.entry)
+        ? bodyNode.entry
+        : (Array.isArray(bodyNode.data) ? bodyNode.data : []);
+    return rawEntries
+        .filter((entry) => !!entry && typeof entry === 'object')
+        .map((entry) => {
+        const claims = extractEntryClaims(entry);
+        const meta = entry.meta && typeof entry.meta === 'object' ? entry.meta : {};
+        const resource = entry.resource && typeof entry.resource === 'object' ? entry.resource : {};
+        return {
+            identifier: normalizeText(claims[ClaimsPersonSchemaorg.identifier]),
+            email: normalizeText(claims[ClaimsPersonSchemaorg.email]),
+            role: normalizeText(claims[ClaimsPersonSchemaorg.hasOccupationalRoleValue]),
+            worksFor: normalizeText(claims[ClaimsPersonSchemaorg.worksFor]),
+            memberOf: normalizeText(claims[ClaimsPersonSchemaorg.memberOf]),
+            memberOfOrgTaxId: normalizeText(claims[ClaimsPersonSchemaorg.memberOfOrgTaxId]),
+            resourceId: normalizeText(resource.id || entry.id),
+            status: normalizeText(meta.status),
+            claims,
+        };
+    });
+}
+/**
+ * Returns one employee result by canonical identifier from current search/list
+ * results.
+ */
+export function findEmployeeSearchResult(body, identifier) {
+    const normalizedIdentifier = normalizeText(identifier);
+    if (!normalizedIdentifier) {
+        return undefined;
+    }
+    return readEmployeeSearchResults(body)
+        .find((record) => record.identifier === normalizedIdentifier);
+}

package/dist/utils/gw-core-path.d.ts

@@ -0,0 +1,24 @@
+import type { ServiceEndpointSelector } from '../models/did';
+/**
+ * Minimal tenant-scoped route context required to describe one concrete GW CORE
+ * resource action endpoint.
+ *
+ * This helper intentionally models the stable HTTP path shape instead of the
+ * transport envelope. Frontend and SDK layers can use it to keep route
+ * semantics explicit without handcrafting string paths inline.
+ */
+export type GwCoreTenantResourceActionSelector = Readonly<{
+    tenantId: string;
+    jurisdiction: string;
+    version: string;
+    sector: string;
+} & Pick<ServiceEndpointSelector, 'section' | 'format' | 'resourceType' | 'action'>>;
+/**
+ * Builds the canonical tenant-scoped GW CORE route path:
+ * `/{tenantId}/cds-{jurisdiction}/{version}/{sector}/{section}/{format}/{resourceType}/{action}`
+ *
+ * Use this helper when tests, docs, or SDK adapters need to express the real
+ * GW endpoint structure instead of ad hoc relative targets such as
+ * `License/_search`.
+ */
+export declare function buildGwCoreTenantResourceActionPath(input: GwCoreTenantResourceActionSelector): string;

package/dist/utils/gw-core-path.js

@@ -0,0 +1,21 @@
+function normalizePathSegment(value) {
+    return String(value || '').trim().replace(/^\/+|\/+$/g, '');
+}
+/**
+ * Builds the canonical tenant-scoped GW CORE route path:
+ * `/{tenantId}/cds-{jurisdiction}/{version}/{sector}/{section}/{format}/{resourceType}/{action}`
+ *
+ * Use this helper when tests, docs, or SDK adapters need to express the real
+ * GW endpoint structure instead of ad hoc relative targets such as
+ * `License/_search`.
+ */
+export function buildGwCoreTenantResourceActionPath(input) {
+    return `/${normalizePathSegment(input.tenantId)}`
+        + `/cds-${normalizePathSegment(input.jurisdiction)}`
+        + `/${normalizePathSegment(input.version)}`
+        + `/${normalizePathSegment(input.sector)}`
+        + `/${normalizePathSegment(input.section)}`
+        + `/${normalizePathSegment(input.format)}`
+        + `/${normalizePathSegment(input.resourceType)}`
+        + `/${normalizePathSegment(input.action)}`;
+}

package/dist/utils/index.d.ts

@@ -11,6 +11,7 @@ export * from './content';
 export * from '../convert';
 export * from './bundle-document-builder';
 export * from './consent';
+export * from './consent-lifecycle-result-reader';
 export * from './consent-blockchain-rules';
 export * from './consent-duplicate-rules';
 export * from './did';
@@ -27,23 +28,33 @@ export * from './discovery-normalization';
 export * from './format-converter';
 export * from './fhir-cid';
 export * from './fhir-search';
+export * from './gw-core-path';
 export * from './communication-fhir-r4';
 export * from './communication-document-reference';
 export * from './communication-bundle-document-request';
 export * from './communication-identity';
 export * from './communication-attached-bundle-session';
 export * from './permission-templates';
+export * from './related-person-list';
 export * from './clinical-resource-converters';
 export * from './clinical-resource-view';
 export * from './fhir-validator';
 export * from './individual-form-pdf';
 export * from './individual-organization-claims';
+export * from './individual-organization-lifecycle';
 export * from './individual-onboarding-editor';
 export * from './individual-onboarding-document-reference';
 export * from './individual-organization-kyc';
+export * from './individual-bundle-vault';
+export * from './invoice-bundle';
 export * from './ips-bundle-claims';
+export * from './interoperable-resource-operation';
 export * from './jwt';
 export * from './license';
+export * from './license-commercial-search';
+export * from './license-list-search';
+export * from './license-offer-order';
+export * from './lifecycle-result-reader';
 export * from './manager-error';
 export * from './multibase58';
 export * from './multibasehash';

package/dist/utils/index.js

@@ -11,6 +11,7 @@ export * from './content.js';
 export * from '../convert/index.js';
 export * from './bundle-document-builder.js';
 export * from './consent.js';
+export * from './consent-lifecycle-result-reader.js';
 export * from './consent-blockchain-rules.js';
 export * from './consent-duplicate-rules.js';
 export * from './did.js';
@@ -27,23 +28,33 @@ export * from './discovery-normalization.js';
 export * from './format-converter.js';
 export * from './fhir-cid.js';
 export * from './fhir-search.js';
+export * from './gw-core-path.js';
 export * from './communication-fhir-r4.js';
 export * from './communication-document-reference.js';
 export * from './communication-bundle-document-request.js';
 export * from './communication-identity.js';
 export * from './communication-attached-bundle-session.js';
 export * from './permission-templates.js';
+export * from './related-person-list.js';
 export * from './clinical-resource-converters.js';
 export * from './clinical-resource-view.js';
 export * from './fhir-validator.js';
 export * from './individual-form-pdf.js';
 export * from './individual-organization-claims.js';
+export * from './individual-organization-lifecycle.js';
 export * from './individual-onboarding-editor.js';
 export * from './individual-onboarding-document-reference.js';
 export * from './individual-organization-kyc.js';
+export * from './individual-bundle-vault.js';
+export * from './invoice-bundle.js';
 export * from './ips-bundle-claims.js';
+export * from './interoperable-resource-operation.js';
 export * from './jwt.js';
 export * from './license.js';
+export * from './license-commercial-search.js';
+export * from './license-list-search.js';
+export * from './license-offer-order.js';
+export * from './lifecycle-result-reader.js';
 export * from './manager-error.js';
 export * from './multibase58.js';
 export * from './multibasehash.js';

package/dist/utils/individual-bundle-vault.d.ts

@@ -0,0 +1,144 @@
+import { type IndividualSectionDescriptor } from '../constants/individual-sections';
+import { type CodingDescriptor } from '../constants/vital-signs';
+import type { IVaultRepository } from '../storage/IVaultRepository';
+import { CommunicationAttachedBundleSession } from './communication-attached-bundle-session';
+export type IndividualSectionManifest = Readonly<{
+    section: string;
+    collectionName: string;
+    containerIds: readonly string[];
+    resourceTypes: readonly string[];
+    updatedAt: string;
+}>;
+type SectionSelector = string | Pick<IndividualSectionDescriptor, 'attributeValue'> | {
+    attributeValue: string;
+};
+export type BuildVitalSignObservationClaimsInput = Readonly<{
+    identifier: string;
+    subject: string;
+    code: CodingDescriptor;
+    effectiveDateTime?: string;
+    issued?: string;
+    status?: string;
+    note?: string;
+    unit?: CodingDescriptor;
+    valueQuantity?: number;
+    valueString?: string;
+}>;
+export type IndividualBundleVaultOptions = Readonly<{
+    vaultRepository: IVaultRepository;
+    individualId: string;
+    compositionIdentifier?: string;
+    compositionType?: string;
+    compositionTitle?: string;
+    now?: () => string;
+}>;
+export declare function buildVitalSignObservationClaims(input: BuildVitalSignObservationClaimsInput): Record<string, unknown>;
+export declare class IndividualBundleVault {
+    private readonly vaultRepository;
+    private readonly individualId;
+    private readonly now;
+    private compositionClaims;
+    private readonly sectionEditors;
+    private manifest;
+    constructor(options: IndividualBundleVaultOptions);
+    initialize(): Promise<this>;
+    getCompositionClaims(): Record<string, unknown>;
+    getSectionEditor(section: SectionSelector): Promise<CommunicationAttachedBundleSession>;
+    listSections(): IndividualSectionManifest[];
+    getSectionContainerIds(section: SectionSelector): string[];
+    /**
+     * Returns only visible/searchable Vital Signs rows for the individual.
+     *
+     * Reduced indexed component rows derived from FHIR `component` are kept in
+     * local storage for reconstruction/export but excluded here because they do
+     * not carry `Observation.status`.
+     */
+    getDisplayableVitalSignResourceIds(): Promise<string[]>;
+    saveSection(section: SectionSelector): Promise<this>;
+    upsertSectionEntry(section: SectionSelector, input: Readonly<{
+        resourceType: string;
+        claims: Record<string, unknown>;
+        fullUrl?: string;
+        type?: string;
+    }>): Promise<this>;
+    upsertVitalSign(input: BuildVitalSignObservationClaimsInput): Promise<this>;
+    importBundleDocument(bundle: Record<string, any>): Promise<this>;
+    private resolveSectionsForClaims;
+    private buildDefaultFullUrl;
+    private resolveClaimsIdentifier;
+    private buildBundleDocumentSectionMap;
+    private resolveBundleSectionsForResource;
+    private entryToStoredSectionRecord;
+    private buildIndexedData;
+    private resolveAllowedIndexableClaims;
+    private resolveEntryRecordId;
+    private updateCompositionFromManifest;
+    private persistComposition;
+    private resolveSectionValue;
+    private getCollectionName;
+    private getCompositionRecordId;
+    static decodeCollectionSectionKey(encodedSection: string): string;
+    static getDefaultVitalSignInputs(): {
+        heartRate: {
+            code: Readonly<{
+                system: string;
+                code: string;
+                display?: string;
+                claim: string;
+            }>;
+            unit: Readonly<{
+                system: string;
+                code: string;
+                display?: string;
+                claim: string;
+            }>;
+            section: string;
+        };
+        bodyTemperature: {
+            code: Readonly<{
+                system: string;
+                code: string;
+                display?: string;
+                claim: string;
+            }>;
+            unit: Readonly<{
+                system: string;
+                code: string;
+                display?: string;
+                claim: string;
+            }>;
+            section: string;
+        };
+        systolicBloodPressure: {
+            code: Readonly<{
+                system: string;
+                code: string;
+                display?: string;
+                claim: string;
+            }>;
+            unit: Readonly<{
+                system: string;
+                code: string;
+                display?: string;
+                claim: string;
+            }>;
+            section: string;
+        };
+        diastolicBloodPressure: {
+            code: Readonly<{
+                system: string;
+                code: string;
+                display?: string;
+                claim: string;
+            }>;
+            unit: Readonly<{
+                system: string;
+                code: string;
+                display?: string;
+                claim: string;
+            }>;
+            section: string;
+        };
+    };
+}
+export {};