gdc-common-utils-ts 1.14.9 → 1.14.13

package/dist/utils/ips-bundle-claims.js

@@ -0,0 +1,104 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+export const DEFAULT_META_CLAIM_TAG_SYSTEM = 'urn:gdc:fhir:meta-claim';
+/**
+ * Removes the versioned/contextualized FHIR prefix from a flattened claim key.
+ *
+ * Examples:
+ * - `org.hl7.fhir.r4.Immunization.vaccine-code` -> `Immunization.vaccine-code`
+ * - `org.hl7.fhir.api.MedicationStatement.subject` -> `MedicationStatement.subject`
+ * - `Consent.identifier` -> `Consent.identifier`
+ */
+export function toVersionAgnosticMetaClaimKey(claimKey) {
+    const raw = String(claimKey || '').trim();
+    if (!raw)
+        return '';
+    return raw
+        .replace(/^org\.hl7\.fhir\.[a-z0-9]+\./i, '')
+        .replace(/^org\.hl7\.fhir\.api\./i, '');
+}
+/**
+ * Extracts all `resource.meta.claims` blocks from a FHIR/JSON:API bundle.
+ *
+ * This is intentionally claims-first: only resources that already carry
+ * `resource.meta.claims` are returned.
+ */
+export function extractResourceMetaClaimsFromBundle(bundle) {
+    const entries = Array.isArray(bundle?.entry)
+        ? bundle.entry
+        : Array.isArray(bundle?.data)
+            ? bundle.data
+            : [];
+    return entries
+        .map((entry) => extractResourceMetaClaimsFromEntry(entry))
+        .filter((value) => !!value);
+}
+/**
+ * Builds FHIR `meta.tag[]` codings from a flat claims record.
+ *
+ * The generated `code` is version-agnostic so UI/frontends can use the same
+ * tag keys across `org.hl7.fhir.r4.*` and `org.hl7.fhir.api.*` payloads.
+ */
+export function createFhirMetaTagsFromClaims(claims, options) {
+    const system = String(options?.system || DEFAULT_META_CLAIM_TAG_SYSTEM).trim();
+    const includeContext = Boolean(options?.includeContext);
+    const tags = [];
+    for (const key of Object.keys(claims || {})) {
+        if (key === '@context' || key === '@type')
+            continue;
+        const code = includeContext ? String(key).trim() : toVersionAgnosticMetaClaimKey(key);
+        if (!code)
+            continue;
+        const display = stringifyClaimValue(claims[key]);
+        tags.push({
+            system,
+            code,
+            ...(display ? { display } : {}),
+        });
+    }
+    return tags;
+}
+/**
+ * Returns a shallow resource copy whose `meta.tag[]` is derived from
+ * `resource.meta.claims`.
+ */
+export function withDerivedFhirMetaTagsFromClaims(resource, options) {
+    const claims = asRecord(resource?.meta?.claims);
+    const tags = createFhirMetaTagsFromClaims(claims, options);
+    return {
+        ...resource,
+        meta: {
+            ...(resource?.meta || {}),
+            tag: tags,
+        },
+    };
+}
+function extractResourceMetaClaimsFromEntry(entry) {
+    const resource = entry?.resource;
+    const claims = asRecord(resource?.meta?.claims);
+    if (!resource || !claims || Object.keys(claims).length === 0)
+        return undefined;
+    return {
+        resourceType: String(resource.resourceType || 'Unknown'),
+        fullUrl: typeof entry.fullUrl === 'string' ? entry.fullUrl : undefined,
+        claims,
+    };
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    return value;
+}
+function stringifyClaimValue(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/utils/jwt.d.ts

@@ -51,3 +51,19 @@ export declare function encodeSignature(signatureBytes?: Uint8Array): string;
  * @returns A compact JWT string.
  */
 export declare function compactJWT(header: object, payload: object, signatureBytes?: Uint8Array): Promise<string>;
+/**
+ * Builds an unsigned compact JWT with `alg=none`.
+ *
+ * Useful for local demos, fixtures, and live tests where the transport/runtime
+ * only needs a syntactically valid JWT shell.
+ */
+export declare function buildUnsignedJwt(payload: Record<string, unknown>, options?: Readonly<{
+    nowSeconds?: number;
+    ttlSeconds?: number;
+    nonce?: string;
+}>): string;
+export declare function buildUnsignedVpJwt(payload: Record<string, unknown>, options?: Readonly<{
+    nowSeconds?: number;
+    ttlSeconds?: number;
+    nonce?: string;
+}>): string;

package/dist/utils/jwt.js

@@ -152,3 +152,24 @@ export async function compactJWT(header, payload, signatureBytes) {
     const encodedSignature = encodeSignature(signatureBytes);
     return `${encodedHeader}.${encodedPayload}.${encodedSignature}`;
 }
+/**
+ * Builds an unsigned compact JWT with `alg=none`.
+ *
+ * Useful for local demos, fixtures, and live tests where the transport/runtime
+ * only needs a syntactically valid JWT shell.
+ */
+export function buildUnsignedJwt(payload, options = {}) {
+    const now = options.nowSeconds ?? Math.floor(Date.now() / 1000);
+    const ttl = options.ttlSeconds ?? 600;
+    const header = { alg: 'none', typ: 'JWT' };
+    const claims = {
+        iat: now,
+        exp: now + ttl,
+        nonce: options.nonce ?? `nonce-${now}`,
+        ...payload,
+    };
+    return `${Content.objectToRawBase64UrlSafe(header)}.${Content.objectToRawBase64UrlSafe(claims)}.`;
+}
+export function buildUnsignedVpJwt(payload, options = {}) {
+    return buildUnsignedJwt(payload, options);
+}

package/dist/utils/related-person-claim-helpers.d.ts

@@ -0,0 +1,8 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type RelatedPersonInteroperableClaims = GenericInteroperableClaims;
+export declare function getRelatedPersonClaimList(claims: RelatedPersonInteroperableClaims, claimKey: string): string[];
+export declare function setRelatedPersonClaimList(claims: RelatedPersonInteroperableClaims, claimKey: string, values: string | readonly string[]): RelatedPersonInteroperableClaims;
+export declare function addRelatedPersonClaimList(claims: RelatedPersonInteroperableClaims, claimKey: string, values: string | readonly string[]): RelatedPersonInteroperableClaims;
+export declare function removeRelatedPersonClaimList(claims: RelatedPersonInteroperableClaims, claimKey: string, values: string | readonly string[]): RelatedPersonInteroperableClaims;
+export declare function getRelatedPersonIdentifier(claims: RelatedPersonInteroperableClaims): string;
+export declare function setRelatedPersonIdentifier(claims: RelatedPersonInteroperableClaims, value: string): RelatedPersonInteroperableClaims;

package/dist/utils/related-person-claim-helpers.js

@@ -0,0 +1,20 @@
+import { RelatedPersonClaim } from '../models/interoperable-claims/related-person-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getRelatedPersonClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setRelatedPersonClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addRelatedPersonClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeRelatedPersonClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getRelatedPersonIdentifier(claims) {
+    return normalizeClaimScalar(claims[RelatedPersonClaim.Identifier]);
+}
+export function setRelatedPersonIdentifier(claims, value) {
+    return { ...claims, [RelatedPersonClaim.Identifier]: normalizeClaimScalar(value) };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "1.14.9",
+  "version": "1.14.13",
   "publishConfig": {
     "access": "public"
   },
@@ -46,6 +46,14 @@
       "types": "./dist/examples/*.d.ts",
       "default": "./dist/examples/*.js"
     },
+    "./claims": {
+      "types": "./dist/claims/index.d.ts",
+      "default": "./dist/claims/index.js"
+    },
+    "./claims/*": {
+      "types": "./dist/claims/*.d.ts",
+      "default": "./dist/claims/*.js"
+    },
     "./constants/*": {
       "types": "./dist/constants/*.d.ts",
       "default": "./dist/constants/*.js"
@@ -66,6 +74,14 @@
       "types": "./dist/constants/index.d.ts",
       "default": "./dist/constants/index.js"
     },
+    "./convert": {
+      "types": "./dist/convert/index.d.ts",
+      "default": "./dist/convert/index.js"
+    },
+    "./convert/*": {
+      "types": "./dist/convert/*.d.ts",
+      "default": "./dist/convert/*.js"
+    },
     "./models": {
       "types": "./dist/models/index.d.ts",
       "default": "./dist/models/index.js"