gdc-common-utils-ts 2.9.23 → 2.9.25

package/README.md

@@ -378,9 +378,11 @@ import { JweObject, JwtCompactParts } from 'gdc-common-utils-ts/models';
 - [docs/101-CLINICAL-IPS.md](docs/101-CLINICAL-IPS.md)
   - shortest high-level onboarding for `ipsBundleReader`, section summaries,
     family queries, and UI-ready narrative helpers
+- [docs/101-CLINICAL-ENTRY-GETTERS-SETTERS.md](docs/101-CLINICAL-ENTRY-GETTERS-SETTERS.md)
+  - complete typed getter/setter guide for creating entries and reopening
+    received `entry[]` or `data[]` Bundles through an editable clone
 - [docs/REFERENCE-CLINICAL-IPS-API.md](docs/REFERENCE-CLINICAL-IPS-API.md)
-  - canonical claim/method matrix with `TODO` coverage for missing typed
-    `get...` / `set...` helpers
+  - canonical claim/method matrix and reader/query reference
 
 ## Dataspace Protocol And Discovery
 

package/dist/examples/consent-access.d.ts

@@ -5,6 +5,8 @@ export declare const EXAMPLE_PROVIDER_ORGANIZATION_DID_WEB: "did:web:hospital.ac
 export { EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_EMAIL_RELATED_PERSON };
 export declare const EXAMPLE_CONSENT_ACCESS_JURISDICTION: "ES";
 export declare const EXAMPLE_CONSENT_ACCESS_COUNTRY_ACTOR_IDENTIFIER: string;
+export declare const EXAMPLE_CONSENT_ACCESS_SUBDIVISION = "CA-BC";
+export declare const EXAMPLE_CONSENT_ACCESS_SUBDIVISION_ACTOR_IDENTIFIER = "urn:iso:3166-2:CA-BC";
 /**
  * Legacy compatibility aliases kept so older docs/tests/imports continue to work
  * while the canonical variable names converge.

package/dist/examples/consent-access.js

@@ -9,6 +9,8 @@ export const EXAMPLE_PROVIDER_ORGANIZATION_DID_WEB = EXAMPLE_PROVIDER_ORGANIZATI
 export { EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_EMAIL_RELATED_PERSON };
 export const EXAMPLE_CONSENT_ACCESS_JURISDICTION = EXAMPLE_HEALTHCARE_JURISDICTION;
 export const EXAMPLE_CONSENT_ACCESS_COUNTRY_ACTOR_IDENTIFIER = `urn:iso:3166:${EXAMPLE_CONSENT_ACCESS_JURISDICTION}`;
+export const EXAMPLE_CONSENT_ACCESS_SUBDIVISION = 'CA-BC';
+export const EXAMPLE_CONSENT_ACCESS_SUBDIVISION_ACTOR_IDENTIFIER = `urn:iso:3166-2:${EXAMPLE_CONSENT_ACCESS_SUBDIVISION}`;
 /**
  * Legacy compatibility aliases kept so older docs/tests/imports continue to work
  * while the canonical variable names converge.

package/dist/utils/bundle-editor-core.d.ts

@@ -88,6 +88,15 @@ export declare class BundleEditor {
     newEntryAs<T extends AllowedResourceType>(resourceType: T, resourceId?: string): ResourceTypeEntryEditor<T>;
     /** Reopens one existing entry by `resource.id` or `fullUrl`. */
     openEntry(resourceIdOrFullUrl: string): BundleEntryEditor;
+    /**
+     * Reopens one existing entry by its current array position.
+     *
+     * Prefer `openEntry(resourceIdOrFullUrl)` when a stable identifier is
+     * available. This positional form exists for the explicit
+     * `BundleReader.toBundleEditor()` handoff, where the reader has already
+     * selected one entry index and the received resource may not expose an id.
+     */
+    openEntryByArrayIndex(index: number): BundleEntryEditor;
     /** Returns cloned staged entries for inspection or debugging. */
     getEntries(): readonly BuiltBundleEntry[];
     /** Returns the current Composition-level claims used when building a document bundle. */

package/dist/utils/bundle-editor-core.js

@@ -201,6 +201,18 @@ export class BundleEditor {
         }
         return new BundleEntryEditor(this, entryIndex);
     }
+    /**
+     * Reopens one existing entry by its current array position.
+     *
+     * Prefer `openEntry(resourceIdOrFullUrl)` when a stable identifier is
+     * available. This positional form exists for the explicit
+     * `BundleReader.toBundleEditor()` handoff, where the reader has already
+     * selected one entry index and the received resource may not expose an id.
+     */
+    openEntryByArrayIndex(index) {
+        this.getMutableEntry(index);
+        return new BundleEntryEditor(this, index);
+    }
     /** Returns cloned staged entries for inspection or debugging. */
     getEntries() {
         return this.entries.map((entry) => cloneEntry(entry));

package/dist/utils/bundle-reader.d.ts

@@ -1,4 +1,5 @@
 import { type IssueSeverityCode } from '../models/issue.js';
+import { BundleEditor } from './bundle-editor-core.js';
 import { type BundleResourceIdFilters } from './bundle-query.js';
 export type BundleReaderEntry = Record<string, unknown>;
 export type BundleReaderEntrySummary = Readonly<{
@@ -65,13 +66,23 @@ export declare function getClaimsInFirstDataEntry(bundle: unknown): Record<strin
 export declare class BundleReader {
     private readonly bundle;
     private activeEntryIndex;
-    constructor(bundle: Record<string, unknown>);
+    constructor(bundle: unknown);
     /** Returns the current bundle resource type when present. */
     getResourceType(): string | undefined;
     /** Returns the current FHIR bundle type when present. */
     getBundleType(): string | undefined;
     /** Returns cloned bundle entries. */
     getEntries(): readonly BundleReaderEntry[];
+    /**
+     * Creates a detached editable clone of this received Bundle.
+     *
+     * `BundleReader` remains the read-only navigation and response-analysis
+     * surface. Call this method when an application wants the typed
+     * `asAllergy()`, `asMedicationStatement()`, `asImmunization()`, and other
+     * entry getters/setters supplied by `BundleEditor`. Changes made through the
+     * returned editor never mutate the Bundle held by this reader.
+     */
+    toBundleEditor(): BundleEditor;
     /** Opens one entry by index. */
     openEntry(index: number): this;
     /** Returns the resolved identifier for one entry array index when present. */

package/dist/utils/bundle-reader.js

@@ -1,4 +1,5 @@
 import { getHighestIssueSeverity, isIssueSeverityCode, IssueSeverity, } from '../models/issue.js';
+import { BundleEditor } from './bundle-editor-core.js';
 import { BundleQuery } from './bundle-query.js';
 function cloneEntry(value) {
     return JSON.parse(JSON.stringify(value));
@@ -60,7 +61,7 @@ export class BundleReader {
     bundle;
     activeEntryIndex = null;
     constructor(bundle) {
-        this.bundle = cloneEntry(bundle);
+        this.bundle = cloneEntry(asRecord(bundle));
     }
     /** Returns the current bundle resource type when present. */
     getResourceType() {
@@ -79,6 +80,23 @@ export class BundleReader {
             : (Array.isArray(this.bundle.data) ? this.bundle.data : []);
         return entries.map((entry) => cloneEntry(entry));
     }
+    /**
+     * Creates a detached editable clone of this received Bundle.
+     *
+     * `BundleReader` remains the read-only navigation and response-analysis
+     * surface. Call this method when an application wants the typed
+     * `asAllergy()`, `asMedicationStatement()`, `asImmunization()`, and other
+     * entry getters/setters supplied by `BundleEditor`. Changes made through the
+     * returned editor never mutate the Bundle held by this reader.
+     */
+    toBundleEditor() {
+        const bundle = {
+            resourceType: this.getResourceType(),
+            type: this.getBundleType(),
+            data: this.getEntries().map((entry) => cloneEntry(entry)),
+        };
+        return new BundleEditor().setBundle(bundle);
+    }
     /** Opens one entry by index. */
     openEntry(index) {
         const entries = this.getEntries();

package/dist/utils/consent.js

@@ -245,6 +245,9 @@ function normalizeJurisdiction(value) {
     const isoStd = trimmed.match(/^urn:iso:std:iso:3166\|([a-z]{2})$/i);
     if (isoStd)
         return isoStd[1].toUpperCase();
+    const isoSubdivision = trimmed.match(/^urn:iso:3166-2:([a-z]{2}-[a-z0-9]{1,3})$/i);
+    if (isoSubdivision)
+        return isoSubdivision[1].toUpperCase();
     const iso = trimmed.match(/^urn:iso:3166(?:-2)?:([a-z]{2})(?:[-:].*)?$/i);
     if (iso)
         return iso[1].toUpperCase();
@@ -386,7 +389,7 @@ export function normalizeConsentTarget(input, options = {}) {
         return {
             raw,
             kind: 'jurisdiction',
-            canonicalValue: parsed.value,
+            canonicalValue: normalizeJurisdiction(parsed.value),
             isDirectTarget: false,
             isOrganizationTarget: false,
             isJurisdictionTarget: true,

package/dist/utils/employee-entry-editor.d.ts

@@ -29,8 +29,14 @@ export declare class EmployeeEntryEditor extends BundleEntryEditor {
     getRole(): string | undefined;
     /** Writes the canonical employee `worksFor` claim on this entry. */
     setWorksFor(worksFor: string): this;
+    /** Reads the canonical organization for which the employee works. */
+    getWorksFor(): string | undefined;
     /** Writes the canonical employee `memberOf` claim on this entry. */
     setMemberOf(memberOf: string): this;
+    /** Reads the canonical organization membership reference. */
+    getMemberOf(): string | undefined;
     /** Writes the canonical employee organization tax id claim on this entry. */
     setMemberOfOrgTaxId(taxId: string): this;
+    /** Reads the canonical fiscal identifier attached to the membership. */
+    getMemberOfOrgTaxId(): string | undefined;
 }

package/dist/utils/employee-entry-editor.js

@@ -76,13 +76,25 @@ export class EmployeeEntryEditor extends BundleEntryEditor {
     setWorksFor(worksFor) {
         return this.setClaim(ClaimsPersonSchemaorg.worksFor, String(worksFor).trim());
     }
+    /** Reads the canonical organization for which the employee works. */
+    getWorksFor() {
+        return normalizeOptionalIdentifier(this.getClaim(ClaimsPersonSchemaorg.worksFor));
+    }
     /** Writes the canonical employee `memberOf` claim on this entry. */
     setMemberOf(memberOf) {
         return this.setClaim(ClaimsPersonSchemaorg.memberOf, String(memberOf).trim());
     }
+    /** Reads the canonical organization membership reference. */
+    getMemberOf() {
+        return normalizeOptionalIdentifier(this.getClaim(ClaimsPersonSchemaorg.memberOf));
+    }
     /** Writes the canonical employee organization tax id claim on this entry. */
     setMemberOfOrgTaxId(taxId) {
         return this.setClaim(ClaimsPersonSchemaorg.memberOfOrgTaxId, String(taxId).trim());
     }
+    /** Reads the canonical fiscal identifier attached to the membership. */
+    getMemberOfOrgTaxId() {
+        return normalizeOptionalIdentifier(this.getClaim(ClaimsPersonSchemaorg.memberOfOrgTaxId));
+    }
 }
 registerBundleEntryEditor(BundleEditableResourceTypes.employee, EmployeeEntryEditor);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "2.9.23",
+  "version": "2.9.25",
   "publishConfig": {
     "access": "public"
   },
@@ -11,7 +11,6 @@
     "@stablelib/base64": "^1.0.1",
     "@stablelib/utf8": "^1.0.2",
     "base-x": "^4.0.0",
-    "gdc-common-utils-ts": "^2.0.1",
     "jose": "^4.15.9",
     "pako": "^2.1.0"
   },