gdc-sdk-front-ts 2.0.7 → 2.0.9

package/README.md

@@ -38,17 +38,10 @@ If you are integrating this package for the first time, open these in order:
 1. [gdc-sdk-core-ts/docs/101-SDK_PACKAGE_BOUNDARIES.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/101-SDK_PACKAGE_BOUNDARIES.md)
    Why `core`, `node`, and `front` are separate packages, what each one owns,
    and why frontend facades should mirror backend actor boundaries.
-1. [tests/101-frontend-profile-runtime.test.mjs](./tests/101-frontend-profile-runtime.test.mjs)
-   Minimal frontend-generic walkthrough for loading one actor profile,
-   registering one trusted device/runtime context, connecting to one subject
-   index, and reading one subject index composition.
-1. [tests/101-individual-controller-frontend-runtime.test.mjs](./tests/101-individual-controller-frontend-runtime.test.mjs)
-   First pragmatic frontend wrapper over the generic profile runtime for the
-   current individual-controller baseline.
 1. [docs/101-SDK_INTEGRATION.md](./docs/101-SDK_INTEGRATION.md)
   Real frontend/native setup, imports, `new ClientSDK(...)`,
-  `initializeCommunicationIdentity(...)`, provider discovery, and
-   `initializeSession(...)`.
+  `initializeCommunicationIdentity(...)`, `initializeSession(...)`, and the
+  public actor entrypoints exposed by `ProfileManager.asXxx()`.
 2. [docs/DATASPACE_DISCOVERY_FRONTEND_TODO.md](./docs/DATASPACE_DISCOVERY_FRONTEND_TODO.md)
    Frontend discovery guide for BFF-first provider/operator discovery, UI card
    mapping, and copy/paste backend DTO consumption.
@@ -64,6 +57,12 @@ If you are integrating this package for the first time, open these in order:
    Shared profile/session payload source of truth.
 7. [gdc-common-utils-ts/docs/101-LIFECYCLE.md](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/docs/101-LIFECYCLE.md)
    Canonical lifecycle semantics and reusable placeholders for UI and portal flows.
+8. [tests/101-frontend-profile-runtime.test.mjs](./tests/101-frontend-profile-runtime.test.mjs)
+   Technical frontend runtime slice for profile/device/session wiring.
+   Read this after the public actor-session guides, not before them.
+9. [tests/101-individual-controller-frontend-runtime.test.mjs](./tests/101-individual-controller-frontend-runtime.test.mjs)
+   Technical wrapper slice around the generic runtime for the current
+   individual-controller baseline.
 
 If you need the shortest path:
 
@@ -76,6 +75,9 @@ If you need the shortest path:
   [`ClientSDK`](src/ClientSDK.ts)
 - profile/session bootstrap:
   [`initializeSession(...)`](./docs/101-SDK_INTEGRATION.md)
+- first public actor entrypoints:
+  `session.asHostOnboarding()`, `session.asOrganizationController()`,
+  `session.asIndividualController()`, `session.asProfessional()`
 
 ## Frontend Runtime Modes
 

package/dist/UserProfileIndexStore.d.ts

@@ -0,0 +1,58 @@
+import type { IVaultRepository, UserProfileIndex, UserProfileLookupKey } from './types.js';
+/**
+ * Persisted local user-profile index document.
+ *
+ * The shared `UserProfileIndex` contract from `gdc-sdk-core-ts` does not impose
+ * a storage identifier because it is runtime-neutral. Frontend runtimes need a
+ * stable document id to persist and replace one logical index record.
+ */
+export interface UserProfileIndexRecord extends UserProfileIndex {
+    /**
+     * Stable storage identifier for one local profile-index document.
+     */
+    id: string;
+}
+/**
+ * Frontend persistence adapter for local hashed user-profile indexes.
+ *
+ * Responsibilities:
+ * - store ordered local profile indexes
+ * - list available index documents
+ * - resolve one index by hashed lookup key before profile unlock
+ *
+ * Non-responsibilities:
+ * - hashing raw phone/email input
+ * - unlocking profiles with PIN
+ * - storing seeds or decrypted key material
+ */
+export declare class UserProfileIndexStore {
+    private readonly vault;
+    constructor(vault: IVaultRepository);
+    /**
+     * Initializes the underlying storage adapter.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Creates or replaces one stored user-profile index record.
+     */
+    upsert(record: UserProfileIndexRecord): Promise<UserProfileIndexRecord>;
+    /**
+     * Returns every stored user-profile index record.
+     */
+    list(): Promise<UserProfileIndexRecord[]>;
+    /**
+     * Returns one stored index by storage id.
+     */
+    get(id: string): Promise<UserProfileIndexRecord | undefined>;
+    /**
+     * Resolves the first stored index that contains the given hashed lookup key.
+     *
+     * This intentionally compares hashed lookup tokens only. Raw phone/email
+     * values are outside this store contract.
+     */
+    findByLookup(lookup: UserProfileLookupKey): Promise<UserProfileIndexRecord | undefined>;
+    /**
+     * Deletes one stored index by storage id.
+     */
+    remove(id: string): Promise<boolean>;
+}

package/dist/UserProfileIndexStore.js

@@ -0,0 +1,66 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+const COLLECTION = 'user-profile-index';
+/**
+ * Frontend persistence adapter for local hashed user-profile indexes.
+ *
+ * Responsibilities:
+ * - store ordered local profile indexes
+ * - list available index documents
+ * - resolve one index by hashed lookup key before profile unlock
+ *
+ * Non-responsibilities:
+ * - hashing raw phone/email input
+ * - unlocking profiles with PIN
+ * - storing seeds or decrypted key material
+ */
+export class UserProfileIndexStore {
+    constructor(vault) {
+        this.vault = vault;
+    }
+    /**
+     * Initializes the underlying storage adapter.
+     */
+    async initialize() {
+        await this.vault.initialize();
+    }
+    /**
+     * Creates or replaces one stored user-profile index record.
+     */
+    async upsert(record) {
+        await this.vault.put(COLLECTION, record);
+        return record;
+    }
+    /**
+     * Returns every stored user-profile index record.
+     */
+    async list() {
+        return this.vault.query(COLLECTION, {});
+    }
+    /**
+     * Returns one stored index by storage id.
+     */
+    async get(id) {
+        return this.vault.get(COLLECTION, id);
+    }
+    /**
+     * Resolves the first stored index that contains the given hashed lookup key.
+     *
+     * This intentionally compares hashed lookup tokens only. Raw phone/email
+     * values are outside this store contract.
+     */
+    async findByLookup(lookup) {
+        const records = await this.list();
+        return records.find((record) => record.lookup.some((item) => lookupEquals(item, lookup)));
+    }
+    /**
+     * Deletes one stored index by storage id.
+     */
+    async remove(id) {
+        return this.vault.delete(COLLECTION, id);
+    }
+}
+function lookupEquals(left, right) {
+    return left.kind === right.kind
+        && left.algorithm === right.algorithm
+        && left.value === right.value;
+}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './capabilityMapper.js';
 export * from './VerifierService.js';
 export * from './ProfileManager.js';
 export * from './ProfileRegistry.js';
+export * from './UserProfileIndexStore.js';
 export * from './ClientSDK.js';
 export * from './frontend-profile-runtime.js';
 export * from './individual-controller-frontend-runtime.js';

package/dist/index.js

@@ -11,6 +11,7 @@ export * from './capabilityMapper.js';
 export * from './VerifierService.js';
 export * from './ProfileManager.js';
 export * from './ProfileRegistry.js';
+export * from './UserProfileIndexStore.js';
 export * from './ClientSDK.js';
 export * from './frontend-profile-runtime.js';
 export * from './individual-controller-frontend-runtime.js';

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { IApiConfig, INetwork, BundleSearchQuery, CommunicationInput, DateRange } from 'gdc-sdk-core-ts';
-export type { AppInfo, ResolvedAppInfo, InitializeSessionParams, Profile, ProfileRegistryEntry, VaultQueryCondition, VaultQuery, IVaultRepository, IApiConfig, INetwork, IVerifier } from 'gdc-sdk-core-ts';
+export type { AppInfo, ResolvedAppInfo, InitializeSessionParams, Profile, ProfileRegistryEntry, UserProfileIndex, UserProfileLookupKey, VaultQueryCondition, VaultQuery, IVaultRepository, IApiConfig, INetwork, IVerifier } from 'gdc-sdk-core-ts';
 export type SdkConfig = {
     crypto?: unknown;
     network: INetwork;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-sdk-front-ts",
-  "version": "2.0.7",
+  "version": "2.0.9",
   "description": "Next-generation frontend runtime package for the GDC SDK family",
   "license": "Apache-2.0",
   "author": "Antifraud Services Inc.",
@@ -17,8 +17,8 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.28.4",
-    "gdc-common-utils-ts": "^2.0.10",
-    "gdc-sdk-core-ts": "^2.0.7"
+    "gdc-common-utils-ts": "^2.0.11",
+    "gdc-sdk-core-ts": "file:../gdc-sdk-core-ts"
   },
   "devDependencies": {
     "@types/node": "^20.14.10",