1id 0.4.1 → 0.7.0

package/dist/world.js

@@ -0,0 +1,122 @@
+/**
+ * World/status endpoint for the 1id.com Node.js SDK.
+ *
+ * Fetches the full identity state from the server's world endpoint:
+ * identity, devices, connected services, available services, and operator guidance.
+ *
+ * Results are cached for 5 minutes. Call invalidate_world_cache() to force a fresh fetch.
+ */
+import { load_credentials } from "./credentials.js";
+import { get_token } from "./auth.js";
+import { OneIDAPIClient } from "./client.js";
+const WORLD_CACHE_TTL_MILLISECONDS = 5 * 60 * 1000;
+let cached_world_status = null;
+let cached_world_status_fetched_at = 0;
+/**
+ * Fetch the full world state from the server.
+ *
+ * Returns everything: identity, devices, connected services, available services,
+ * and operator guidance. Results are cached for 5 minutes.
+ *
+ * @param credentials Optional pre-loaded credentials.
+ * @returns WorldStatus with complete identity state.
+ * @throws NotEnrolledError if no credentials exist.
+ * @throws AuthenticationError if the token is invalid or expired.
+ * @throws NetworkError if the server cannot be reached.
+ */
+export async function fetch_world_status_from_server(credentials) {
+    if (cached_world_status != null) {
+        const elapsed_since_cached_fetch = Date.now() - cached_world_status_fetched_at;
+        if (elapsed_since_cached_fetch < WORLD_CACHE_TTL_MILLISECONDS) {
+            return cached_world_status;
+        }
+    }
+    if (credentials == null) {
+        credentials = load_credentials();
+    }
+    const token = await get_token(false, credentials);
+    const api_client = new OneIDAPIClient(credentials.api_base_url);
+    const world_data = await api_client.make_authenticated_request("GET", "/api/v1/identity/world", token.access_token);
+    const parsed_world_status = parse_world_response_to_world_status(world_data);
+    cached_world_status = parsed_world_status;
+    cached_world_status_fetched_at = Date.now();
+    return parsed_world_status;
+}
+/**
+ * Clear the cached world status, forcing a fresh fetch on next call.
+ */
+export function invalidate_world_cache() {
+    cached_world_status = null;
+    cached_world_status_fetched_at = 0;
+}
+function parse_world_response_to_world_status(data) {
+    const raw_identity = (data.identity ?? {});
+    const raw_devices = (data.devices ?? []);
+    const raw_connected = (data.connected_services ?? []);
+    const raw_available = (data.available_services ?? []);
+    const raw_guidance = data.operator_guidance;
+    const identity = {
+        internal_id: (raw_identity.internal_id ?? raw_identity.agent_id ?? ""),
+        handle: (raw_identity.handle ?? ""),
+        trust_tier: (raw_identity.trust_tier ?? "declared"),
+        display_name: (raw_identity.display_name ?? null),
+        agent_identity_urn: (raw_identity.agent_identity_urn ?? null),
+        enrolled_at: (raw_identity.enrolled_at ?? null),
+        hardware_locked: Boolean(raw_identity.hardware_locked),
+        locked_at: (raw_identity.locked_at ?? null),
+        hardware_lock_notice: (raw_identity.hardware_lock_notice ?? null),
+        operator_email_registered: Boolean(raw_identity.operator_email_registered),
+        credential_pointer_count: (raw_identity.credential_pointer_count ?? 0),
+    };
+    const devices = raw_devices.map((device_data) => ({
+        device_type: (device_data.device_type ?? ""),
+        device_fingerprint: (device_data.device_fingerprint ?? ""),
+        device_status: (device_data.device_status ?? "active"),
+        trust_tier: (device_data.trust_tier ?? null),
+        tpm_manufacturer: (device_data.tpm_manufacturer ?? null),
+        piv_serial: (device_data.piv_serial ?? null),
+        bound_at: (device_data.bound_at ?? null),
+        burned_at: (device_data.burned_at ?? null),
+        burn_reason: (device_data.burn_reason ?? null),
+    }));
+    const connected_services = raw_connected.map(parse_service_entry_from_raw_data);
+    const available_services = raw_available.map(parse_service_entry_from_raw_data);
+    let operator_guidance = null;
+    if (raw_guidance != null) {
+        const raw_items = (raw_guidance.items ?? []);
+        operator_guidance = {
+            message_for_human: (raw_guidance.message_for_human ?? ""),
+            items: raw_items.map((item_data) => ({
+                id: (item_data.id ?? ""),
+                priority: (item_data.priority ?? "recommended"),
+                title: (item_data.title ?? ""),
+                description: (item_data.description ?? ""),
+                human_action_url: (item_data.human_action_url ?? null),
+                agent_api_endpoint: (item_data.agent_api_endpoint ?? null),
+            })),
+        };
+    }
+    return {
+        identity,
+        devices,
+        connected_services,
+        available_services,
+        operator_guidance,
+        raw_data: data,
+    };
+}
+function parse_service_entry_from_raw_data(raw) {
+    return {
+        service_id: (raw.service_id ?? ""),
+        service_name: (raw.service_name ?? ""),
+        service_type: (raw.service_type ?? null),
+        category: (raw.category ?? null),
+        status: (raw.status ?? raw.account_status ?? null),
+        primary_identifier: (raw.primary_identifier ?? null),
+        aliases: (raw.aliases ?? null),
+        dashboard_url: (raw.dashboard_url ?? null),
+        description: (raw.description ?? null),
+        minimum_trust_tier: (raw.minimum_trust_tier ?? null),
+    };
+}
+//# sourceMappingURL=world.js.map

package/dist/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "1id",
-  "version": "0.4.1",
+  "version": "0.7.0",
   "description": "Hardware-anchored identity SDK for AI agents -- 1id.com",
   "keywords": [
     "identity",