sos-sdk-core-ts 0.1.6 → 0.2.0

package/CHANGELOG.md

@@ -1,14 +1,15 @@
 # Changelog
 
-## Unreleased
+## 0.2.0
 
+- Redefine `sos-sdk-core-ts` as the runtime-neutral orchestration layer consumed
+  by SOSChain, Vet and UHC, above `sos-data-utils-ts` and below product SDKs.
+- Remove the accidental dependency on and root reexport of `uhc-sdk-core-ts`.
+- Add neutral `authorizeEmergencyAction` and `EmergencyDeliveryTarget` APIs;
+  retain the older `Soschain*` names as deprecated compatibility aliases.
 - Consume emergency evidence, Group/ServiceRequest and card-target contracts
   from `sos-data-utils-ts@0.3.0` instead of maintaining SDK-local copies.
 - Preserve the existing SDK root and subpath exports as compatibility aliases.
-- Pin `uhc-sdk-core-ts@0.6.1` so the complete tree deduplicates to one
-  `sos-data-utils-ts@0.3.0` installation.
-- Pin the first registry release to `uhc-sdk-core-ts@0.6.0` so SOSChain
-  consumers can remove the historical vendored package from staging builds.
 
 ## 0.1.5
 

package/README.md

@@ -1,12 +1,30 @@
-# SOSChain SDK Core
+# Shared SOS SDK Core
 
-Runtime-neutral SOSChain extension of `uhc-sdk-core-ts`. Deterministic record
-types and builders come from `sos-data-utils-ts`; this SDK owns authorization
-and orchestration.
+Runtime-neutral shared SDK for SOSChain, VetChain and UHC. Deterministic
+cross-product record types and builders come from `sos-data-utils-ts`; this SDK
+owns reusable authorization and orchestration without Node, browser, gateway or
+product-specific behavior.
 
-It consumes the exact published `uhc-sdk-core-ts` contract. Git, workspace,
-vendored and `file:` dependencies are forbidden in committed or deployed
-dependency state.
+The canonical architecture keeps both shared layers visible:
+
+```text
+gdc-* frozen
+    ↓
+sos-data-utils-ts
+    ↓
+sos-sdk-core-ts
+    ├──→ vet-sdk-core-ts
+    ├──→ uhc-sdk-core-ts
+    └──→ sos-sdk-node-ts
+```
+
+Vet and UHC may also depend directly on `sos-data-utils-ts` when they import or
+expose its types. `sos-sdk-core-ts` never depends on or reexports either product
+SDK. `sos-sdk-node-ts` owns SOSChain-specific Node transport, persistence and
+jobs; those adapters do not belong here.
+
+Git, workspace, vendored and `file:` dependencies are forbidden in committed
+or deployed dependency state.
 
 The emergency-group contract treats `emergencyGroupId`, `subjectId` and
 `callerId` as opaque business identifiers. A group assistance request is one
@@ -16,14 +34,17 @@ other resource is projected only at an integration boundary.
 Groups are named collections. A scanned card is attached to one selected group
 before that group's identifiers are projected into a single service request.
 
-`authorizeSoschainEmergencyAction` separately checks trusted evidence for every
+`authorizeEmergencyAction` separately checks trusted evidence for every
 member and for `sos:call` or `sos:request`. Identity verification alone never
 grants an emergency capability. Regional/local delivery is represented by
-`SoschainEmergencyDeliveryTarget`; transport and tenant routing stay outside FHIR.
+`EmergencyDeliveryTarget`; transport and tenant routing stay outside FHIR.
 The `incident-reporter` relationship represents a short-lived grant issued by
 a trusted scan resolver to an already verified person at the scene; it does
 not imply guardianship, control or professional status.
 
+The older `SoschainEmergency*` names remain deprecated compatibility aliases
+to the same types and implementation; they are not a second contract.
+
 `buildSoschainPlaceCardAssociationClaims` records a UHC/VetChain card link to
 a canonical SOSChain Place or vehicle without merging either identity.
 

package/dist/emergency-authorization.d.ts

@@ -1,6 +1,7 @@
-import type { SoschainEmergencyAuthorizationEvidence, SoschainEmergencyCapability } from 'sos-data-utils-ts/emergency-evidence';
-export type { SoschainEmergencyAuthorizationEvidence, SoschainEmergencyCapability, SoschainEvidenceDomain, } from 'sos-data-utils-ts/emergency-evidence';
-export type SoschainEmergencyDeliveryTarget = Readonly<{
+import type { EmergencyAuthorizationEvidence, EmergencyCapability, EvidenceDomain } from 'sos-data-utils-ts/emergency-evidence';
+export type { EmergencyAuthorizationEvidence, EmergencyCapability, EvidenceDomain, } from 'sos-data-utils-ts/emergency-evidence';
+/** Runtime-neutral endpoint selected after authorization succeeds. */
+export type EmergencyDeliveryTarget = Readonly<{
     tenantId: string;
     jurisdiction: string;
     locality?: string;
@@ -10,10 +11,20 @@ export type SoschainEmergencyDeliveryTarget = Readonly<{
  * Requires current trusted evidence for every affected subject and capability.
  * Identifier syntax and the legal meaning of each issuer remain policy concerns.
  */
-export declare function authorizeSoschainEmergencyAction(input: Readonly<{
+export declare function authorizeEmergencyAction(input: Readonly<{
     callerId: string;
     memberSubjectIds: readonly string[];
-    capability: SoschainEmergencyCapability;
-    evidence: readonly SoschainEmergencyAuthorizationEvidence[];
+    capability: EmergencyCapability;
+    evidence: readonly EmergencyAuthorizationEvidence[];
     now?: string;
 }>): readonly string[];
+/** @deprecated Use `EmergencyDeliveryTarget`. */
+export type SoschainEmergencyDeliveryTarget = EmergencyDeliveryTarget;
+/** @deprecated Import `EmergencyAuthorizationEvidence` from this module. */
+export type SoschainEmergencyAuthorizationEvidence = EmergencyAuthorizationEvidence;
+/** @deprecated Import `EmergencyCapability` from this module. */
+export type SoschainEmergencyCapability = EmergencyCapability;
+/** @deprecated Import `EvidenceDomain` from this module. */
+export type SoschainEvidenceDomain = EvidenceDomain;
+/** @deprecated Use `authorizeEmergencyAction`. */
+export declare const authorizeSoschainEmergencyAction: typeof authorizeEmergencyAction;

package/dist/emergency-authorization.js

@@ -2,7 +2,7 @@
  * Requires current trusted evidence for every affected subject and capability.
  * Identifier syntax and the legal meaning of each issuer remain policy concerns.
  */
-export function authorizeSoschainEmergencyAction(input) {
+export function authorizeEmergencyAction(input) {
     const at = Date.parse(input.now ?? new Date().toISOString());
     const evidenceIds = new Set();
     for (const subjectId of input.memberSubjectIds) {
@@ -17,3 +17,5 @@ export function authorizeSoschainEmergencyAction(input) {
     }
     return [...evidenceIds];
 }
+/** @deprecated Use `authorizeEmergencyAction`. */
+export const authorizeSoschainEmergencyAction = authorizeEmergencyAction;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-/** SOSChain extends UHC without moving product-specific contracts into UHC. */
-export * from 'uhc-sdk-core-ts';
-export * from 'sos-data-utils-ts/emergency-evidence';
+/** Shared runtime-neutral orchestration remains independent from product SDKs. */
+export { EmergencyCapabilities, EvidenceDomains, EvidenceRelationships, SoschainEmergencyCapabilities, SoschainEvidenceDomains, SoschainEvidenceRelationships, } from 'sos-data-utils-ts/emergency-evidence';
+export type { EvidenceRelationship, SoschainEvidenceRelationship, } from 'sos-data-utils-ts/emergency-evidence';
 export * from './emergency-group.js';
 export * from './emergency-authorization.js';
 export * from './place-card-association.js';

package/dist/index.js

@@ -1,6 +1,5 @@
-/** SOSChain extends UHC without moving product-specific contracts into UHC. */
-export * from 'uhc-sdk-core-ts';
-export * from 'sos-data-utils-ts/emergency-evidence';
+/** Shared runtime-neutral orchestration remains independent from product SDKs. */
+export { EmergencyCapabilities, EvidenceDomains, EvidenceRelationships, SoschainEmergencyCapabilities, SoschainEvidenceDomains, SoschainEvidenceRelationships, } from 'sos-data-utils-ts/emergency-evidence';
 export * from './emergency-group.js';
 export * from './emergency-authorization.js';
 export * from './place-card-association.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sos-sdk-core-ts",
-  "version": "0.1.6",
-  "description": "Runtime-neutral SOSChain contracts extending uhc-sdk-core-ts",
+  "version": "0.2.0",
+  "description": "Runtime-neutral shared orchestration for SOS, Vet and UHC products",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
   "repository": {
@@ -39,8 +39,7 @@
     "prepack": "npm run check"
   },
   "dependencies": {
-    "sos-data-utils-ts": "0.3.0",
-    "uhc-sdk-core-ts": "0.6.1"
+    "sos-data-utils-ts": "0.3.2"
   },
   "devDependencies": {
     "@types/node": "^22.5.0",