@rine-network/core 0.3.5 → 0.4.1

package/README.md

@@ -63,7 +63,7 @@ Config directory resolution (`resolveConfigDir`) uses a smart fallback: `RINE_CO
 
 ## License
 
-[EUPL-1.2](LICENSE) — European Union Public Licence v1.2
+[EUPL-1.2](https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12)
 
 ## For AI Agents
 

package/dist/index.js

@@ -129,11 +129,13 @@ var HttpClient = class {
 	tokenFn;
 	canRefresh;
 	defaultHeaders;
+	defaultSignal;
 	constructor(opts) {
 		this.baseUrl = opts.apiUrl;
 		this.tokenFn = opts.tokenFn;
 		this.canRefresh = opts.canRefresh ?? true;
 		this.defaultHeaders = opts.defaultHeaders ?? {};
+		this.defaultSignal = opts.signal;
 	}
 	async request(method, path, body, params, extraHeaders) {
 		let url = this.baseUrl + path;
@@ -150,7 +152,8 @@ var HttpClient = class {
 			if (body !== void 0) headers["Content-Type"] = "application/json";
 			const init = {
 				method,
-				headers
+				headers,
+				signal: this.defaultSignal
 			};
 			if (body !== void 0) init.body = JSON.stringify(body);
 			return fetch(url, init);
@@ -230,6 +233,13 @@ async function getOrRefreshToken(configDir, apiUrl, entry, profileName, opts) {
 }
 //#endregion
 //#region src/resolve-handle.ts
+const DEFAULT_DOMAIN = ".rine.network";
+function normalizeHandle(handle) {
+	const atIdx = handle.lastIndexOf("@");
+	if (atIdx === -1) return handle;
+	if (handle.slice(atIdx + 1).includes(".")) return handle;
+	return handle + DEFAULT_DOMAIN;
+}
 const UUID_ALIAS_RE = /\/agents\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 /**
@@ -240,8 +250,9 @@ const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/
 * on failure (caller validates UUID format and reports the error).
 */
 async function resolveHandleViaWebFinger(apiUrl, handle) {
+	const normalized = normalizeHandle(handle);
 	try {
-		const params = new URLSearchParams({ resource: `acct:${handle}` });
+		const params = new URLSearchParams({ resource: `acct:${normalized}` });
 		const data = await HttpClient.publicGet(apiUrl, "/.well-known/webfinger", params);
 		for (const alias of data.aliases ?? []) {
 			const match = UUID_ALIAS_RE.exec(alias);
@@ -259,10 +270,11 @@ async function resolveHandleViaWebFinger(apiUrl, handle) {
 async function resolveToUuid(apiUrl, value) {
 	if (!value.includes("@")) {
 		if (UUID_RE.test(value)) return value;
-		throw new Error(`Invalid agent identifier '${value}': expected a UUID or handle (e.g. agent@org.rine.network).`);
+		throw new Error(`Invalid agent identifier '${value}': expected a UUID or handle (e.g. agent@org).`);
 	}
-	const resolved = await resolveHandleViaWebFinger(apiUrl, value);
-	if (!UUID_RE.test(resolved)) throw new Error(`Cannot resolve handle "${value}" to agent ID. Ensure WebFinger is available or use a UUID.`);
+	const normalized = normalizeHandle(value);
+	const resolved = await resolveHandleViaWebFinger(apiUrl, normalized);
+	if (!UUID_RE.test(resolved)) throw new Error(`Cannot resolve handle "${normalized}" to agent ID. Ensure WebFinger is available or use a UUID.`);
 	return resolved;
 }
 /** Check if a value is a bare agent name (not a UUID, not a handle). */
@@ -1038,4 +1050,4 @@ async function performAgentCreation(client, configDir, profile, params) {
 	return agent;
 }
 //#endregion
-export { DEFAULT_API_URL, HttpClient, RineApiError, UUID_RE, advanceChain, agentIdFromKid, agentKeysExist, bytesToUuid, cacheToken, decodeEnvelope, decryptGroupMessage, decryptMessage, deriveMessageKey, distributeSenderKey, encodeEnvelope, encryptGroupMessage, encryptMessage, encryptionPublicKeyToJWK, fetchAgents, fetchAndIngestPendingSKDistributions, fetchOAuthToken, fetchRecipientEncryptionKey, formatError, fromBase64Url, generateAgentKeys, generateEncryptionKeyPair, generateSenderKey, generateSigningKeyPair, getAgentPublicKeys, getCredentialEntry, getOrCreateSenderKey, getOrRefreshToken, ingestSenderKeyDistribution, isBareAgentName, jwkToPublicKey, loadAgentKeys, loadCredentials, loadSenderKeyStates, loadTokenCache, needsRotation, open, openGroup, performAgentCreation, performRegistration, resolveAgent, resolveApiUrl, resolveConfigDir, resolveHandleViaWebFinger, resolveToUuid, saveAgentKeys, saveCredentials, saveSenderKeyState, saveTokenCache, seal, sealGroup, signPayload, signingPublicKeyToJWK, solveTimeLock, solveTimeLockWithProgress, toBase64Url, uuidToBytes, validateEncryptionKey, validatePathId, validateSigningKey, validateSlug, verifySignature };
+export { DEFAULT_API_URL, HttpClient, RineApiError, UUID_RE, advanceChain, agentIdFromKid, agentKeysExist, bytesToUuid, cacheToken, decodeEnvelope, decryptGroupMessage, decryptMessage, deriveMessageKey, distributeSenderKey, encodeEnvelope, encryptGroupMessage, encryptMessage, encryptionPublicKeyToJWK, fetchAgents, fetchAndIngestPendingSKDistributions, fetchOAuthToken, fetchRecipientEncryptionKey, formatError, fromBase64Url, generateAgentKeys, generateEncryptionKeyPair, generateSenderKey, generateSigningKeyPair, getAgentPublicKeys, getCredentialEntry, getOrCreateSenderKey, getOrRefreshToken, ingestSenderKeyDistribution, isBareAgentName, jwkToPublicKey, loadAgentKeys, loadCredentials, loadSenderKeyStates, loadTokenCache, needsRotation, normalizeHandle, open, openGroup, performAgentCreation, performRegistration, resolveAgent, resolveApiUrl, resolveConfigDir, resolveHandleViaWebFinger, resolveToUuid, saveAgentKeys, saveCredentials, saveSenderKeyState, saveTokenCache, seal, sealGroup, signPayload, signingPublicKeyToJWK, solveTimeLock, solveTimeLockWithProgress, toBase64Url, uuidToBytes, validateEncryptionKey, validatePathId, validateSigningKey, validateSlug, verifySignature };

package/dist/src/http.d.ts

@@ -7,12 +7,20 @@ export interface HttpClientOptions {
     canRefresh?: boolean;
     /** Headers injected on every request (e.g. X-Rine-Agent). */
     defaultHeaders?: Record<string, string>;
+    /**
+     * Default abort signal applied to every request made by this instance.
+     * Use one short-lived HttpClient per cancellation scope — e.g. one per
+     * SDK crypto operation. A fired signal propagates to fetch() as-is; the
+     * resulting AbortError is NOT wrapped in RineApiError.
+     */
+    signal?: AbortSignal;
 }
 export declare class HttpClient {
     private readonly baseUrl;
     private readonly tokenFn;
     private readonly canRefresh;
     private readonly defaultHeaders;
+    private readonly defaultSignal;
     constructor(opts: HttpClientOptions);
     private request;
     get(path: string, params?: Record<string, string | number | boolean>, extraHeaders?: Record<string, string>): Promise<unknown>;

package/dist/src/resolve-handle.d.ts

@@ -1,3 +1,4 @@
+export declare function normalizeHandle(handle: string): string;
 declare const UUID_RE: RegExp;
 /**
  * Resolves a handle (e.g. "agent@org.rine.network") to a UUID

package/dist/test/normalize-handle.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rine-network/core",
-	"version": "0.3.5",
+	"version": "0.4.1",
 	"description": "Core library for rine.network — crypto, HTTP, config, agent resolution",
 	"author": "mmmbs <mmmbs@proton.me>",
 	"license": "EUPL-1.2",