sos-sdk-node-ts 0.1.3 → 0.1.4

package/README.md

@@ -26,6 +26,19 @@ persistence, jobs and prompt-audio runtime behavior. It does not own
 deterministic data contracts, common authorization or sector policy. Vet, UHC
 and SOSChain may consume it without depending on one another.
 
+`BundleSyncDraftService` is the trusted-runtime adapter for the shared durable
+editor outbox. The application injects protected storage, payload protection
+and the real provider executor. The service stores no clear clinical Bundle,
+reuses the same idempotent draft after transient failures, and does not report
+confirmation until the provider write has been followed by authoritative
+readback.
+
+It also does not duplicate the typed clinical Bundle editors exposed by the
+GDC Node SDK. Add a SOS Node adapter only when a real shared channel workflow
+requires runtime behavior, following the
+[SOS/Vet/UHC clinical accessor adoption matrix](https://github.com/Fundacion-UNID/sos-data-utils-ts/blob/main/docs/CLINICAL_TYPED_ACCESSOR_ADOPTION.md).
+Portals and assistants without that editor remain on their verified versions.
+
 The first adapter, `SosEmergencyDispatchClient`, sends an already-authorized
 emergency request over HTTPS with a stable idempotency key and validates the
 provider acknowledgement. The bearer credential remains only in the trusted

package/dist/bundle-sync-service.d.ts

@@ -0,0 +1,46 @@
+import { type BundleSyncDraft, type BundleSyncPayload, type BundleSyncState } from 'sos-sdk-core-ts/bundle-sync-draft';
+export type ProtectedBundleSyncRecord = Readonly<{
+    id: string;
+    kind: BundleSyncDraft['kind'];
+    subjectReference: string;
+    state: BundleSyncState;
+    protectedPayload: string;
+    createdAt: string;
+    updatedAt: string;
+}>;
+export interface BundleSyncRepository {
+    put(record: ProtectedBundleSyncRecord): Promise<void>;
+    get(id: string): Promise<ProtectedBundleSyncRecord | undefined>;
+    list(): Promise<readonly ProtectedBundleSyncRecord[]>;
+}
+export interface BundleSyncProtection {
+    protect(draft: BundleSyncDraft): Promise<string>;
+    unprotect(protectedPayload: string): Promise<BundleSyncDraft>;
+}
+export interface BundleSyncExecutor {
+    submit(draft: BundleSyncDraft): Promise<BundleSyncPayload>;
+    readback(draft: BundleSyncDraft): Promise<BundleSyncPayload>;
+}
+export type BundleSyncDraftServiceOptions = Readonly<{
+    repository: BundleSyncRepository;
+    protection: BundleSyncProtection;
+    executor: BundleSyncExecutor;
+    now?: () => Date;
+}>;
+/** Deterministic test adapter. Production runtimes inject durable storage. */
+export declare class BundleSyncRepositoryMemory implements BundleSyncRepository {
+    #private;
+    put(record: ProtectedBundleSyncRecord): Promise<void>;
+    get(id: string): Promise<ProtectedBundleSyncRecord | undefined>;
+    list(): Promise<readonly ProtectedBundleSyncRecord[]>;
+}
+/** Protected outbox shared by clinical, Consent, contact and Encounter Bundles. */
+export declare class BundleSyncDraftService {
+    private readonly options;
+    constructor(options: BundleSyncDraftServiceOptions);
+    enqueue(draft: BundleSyncDraft): Promise<BundleSyncDraft>;
+    read(id: string): Promise<BundleSyncDraft | undefined>;
+    process(id: string): Promise<BundleSyncDraft>;
+    private persist;
+    private now;
+}

package/dist/bundle-sync-service.js

@@ -0,0 +1,82 @@
+// Copyright 2026 Connecting Solution & Applications Ltd under the Apache License, Version 2.0.
+import { BundleSyncStates, confirmBundleSyncDraft, markBundleSyncRetryable, reconcileBundleSyncSubmission, submitBundleSyncDraft, } from 'sos-sdk-core-ts/bundle-sync-draft';
+/** Deterministic test adapter. Production runtimes inject durable storage. */
+export class BundleSyncRepositoryMemory {
+    #records = new Map();
+    async put(record) {
+        this.#records.set(record.id, structuredClone(record));
+    }
+    async get(id) {
+        const record = this.#records.get(id);
+        return record ? structuredClone(record) : undefined;
+    }
+    async list() {
+        return [...this.#records.values()].map((record) => structuredClone(record));
+    }
+}
+/** Protected outbox shared by clinical, Consent, contact and Encounter Bundles. */
+export class BundleSyncDraftService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async enqueue(draft) {
+        const current = await this.options.repository.get(draft.id);
+        if (current) {
+            const restored = await this.options.protection.unprotect(current.protectedPayload);
+            if (JSON.stringify(restored.changesBundle) !== JSON.stringify(draft.changesBundle)) {
+                throw new Error('bundle_sync_idempotency_conflict');
+            }
+            return restored;
+        }
+        await this.persist(draft);
+        return draft;
+    }
+    async read(id) {
+        const record = await this.options.repository.get(id);
+        return record ? this.options.protection.unprotect(record.protectedPayload) : undefined;
+    }
+    async process(id) {
+        const draft = await this.read(id);
+        if (!draft)
+            throw new Error('bundle_sync_draft_not_found');
+        if (draft.state === BundleSyncStates.Confirmed || draft.state === BundleSyncStates.Rejected)
+            return draft;
+        const submitting = submitBundleSyncDraft(draft, this.now());
+        await this.persist(submitting);
+        try {
+            const response = await this.options.executor.submit(submitting);
+            const reconciled = reconcileBundleSyncSubmission(submitting, response, this.now());
+            await this.persist(reconciled);
+            if (reconciled.state !== BundleSyncStates.Reconciling)
+                return reconciled;
+            const authoritativeBundle = await this.options.executor.readback(reconciled);
+            const confirmed = confirmBundleSyncDraft(reconciled, authoritativeBundle, this.now());
+            await this.persist(confirmed);
+            return confirmed;
+        }
+        catch (reason) {
+            const retryable = markBundleSyncRetryable(submitting, [classify(reason)], this.now());
+            await this.persist(retryable);
+            return retryable;
+        }
+    }
+    async persist(draft) {
+        await this.options.repository.put({
+            id: draft.id,
+            kind: draft.kind,
+            subjectReference: draft.subjectReference,
+            state: draft.state,
+            protectedPayload: await this.options.protection.protect(draft),
+            createdAt: draft.createdAt,
+            updatedAt: draft.updatedAt,
+        });
+    }
+    now() {
+        return (this.options.now?.() ?? new Date()).toISOString();
+    }
+}
+function classify(reason) {
+    const message = reason instanceof Error ? reason.message : String(reason || 'bundle_sync_failed');
+    return message.slice(0, 300);
+}

package/dist/index.d.ts

@@ -2,3 +2,4 @@
 export * from './emergency-dispatch.js';
 export * from './prompt-audio-runtime.js';
 export * from './secure-message-crypto.js';
+export * from './bundle-sync-service.js';

package/dist/index.js

@@ -2,3 +2,4 @@
 export * from './emergency-dispatch.js';
 export * from './prompt-audio-runtime.js';
 export * from './secure-message-crypto.js';
+export * from './bundle-sync-service.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sos-sdk-node-ts",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Product-neutral Node adapters shared by SOSChain, Vet and UHC runtimes",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
@@ -27,6 +27,10 @@
     "./secure-message-crypto": {
       "types": "./dist/secure-message-crypto.d.ts",
       "default": "./dist/secure-message-crypto.js"
+    },
+    "./bundle-sync-service": {
+      "types": "./dist/bundle-sync-service.d.ts",
+      "default": "./dist/bundle-sync-service.js"
     }
   },
   "files": [
@@ -43,7 +47,7 @@
     "prepack": "npm run check"
   },
   "dependencies": {
-    "sos-sdk-core-ts": "0.2.2"
+    "sos-sdk-core-ts": "0.5.1"
   },
   "devDependencies": {
     "@types/node": "^24.10.0",