@nimiplatform/sdk 0.5.14

package/dist/realm/client-helpers.js

@@ -0,0 +1,176 @@
+import { ReasonCode } from '../types/index.js';
+import { asNimiError, createNimiError } from '../runtime/errors.js';
+import { asRecord, normalizeText, nowIso, readString } from '../internal/utils.js';
+export const DEFAULT_REALM_TIMEOUT_MS = 10000;
+export { asRecord, normalizeText, nowIso };
+export function hasValue(value) {
+    return value !== undefined && value !== null;
+}
+export function resolveBaseUrl(value) {
+    const baseUrl = normalizeText(value);
+    if (!baseUrl) {
+        throw createNimiError({
+            message: 'realm endpoint (baseUrl) is required',
+            reasonCode: ReasonCode.SDK_REALM_ENDPOINT_REQUIRED,
+            actionHint: 'set_realm_base_url',
+            source: 'sdk',
+        });
+    }
+    return baseUrl.replace(/\/+$/, '');
+}
+function isAbortLikeError(error) {
+    if (!error) {
+        return false;
+    }
+    if (typeof DOMException !== 'undefined' && error instanceof DOMException) {
+        return error.name === 'AbortError';
+    }
+    const record = asRecord(error);
+    const name = normalizeText(record.name);
+    const code = normalizeText(record.code);
+    if (name === 'AbortError' || code === 'ABORT_ERR') {
+        return true;
+    }
+    const message = normalizeText(record.message).toLowerCase();
+    return message.includes('aborted');
+}
+function mapRealmStatusReasonCode(status) {
+    if (status === 401) {
+        return ReasonCode.AUTH_TOKEN_INVALID;
+    }
+    if (status === 403) {
+        return ReasonCode.PRINCIPAL_UNAUTHORIZED;
+    }
+    if (status === 404) {
+        return ReasonCode.REALM_NOT_FOUND;
+    }
+    if (status === 409) {
+        return ReasonCode.REALM_CONFLICT;
+    }
+    if (status === 429) {
+        return ReasonCode.REALM_RATE_LIMITED;
+    }
+    if (status === 400 || status === 422) {
+        return ReasonCode.CONFIG_INVALID;
+    }
+    if (status >= 500) {
+        return ReasonCode.REALM_UNAVAILABLE;
+    }
+    return ReasonCode.ACTION_INPUT_INVALID;
+}
+function mapRealmStatusActionHint(status) {
+    if (status === 401) {
+        return 'refresh_realm_token_or_reauthenticate';
+    }
+    if (status === 403) {
+        return 'check_principal_permissions_or_resource_visibility';
+    }
+    if (status === 404) {
+        return 'check_realm_path_or_resource_id';
+    }
+    if (status === 409) {
+        return 'resolve_realm_conflict_then_retry';
+    }
+    if (status === 429) {
+        return 'retry_after_backoff';
+    }
+    if (status === 400 || status === 422) {
+        return 'fix_realm_config_or_request_payload';
+    }
+    if (status >= 500) {
+        return 'retry_or_check_realm_status';
+    }
+    return 'check_realm_request_payload';
+}
+export function isResponse(value) {
+    return typeof Response !== 'undefined' && value instanceof Response;
+}
+export function readErrorBody(value) {
+    if (!value) {
+        return {};
+    }
+    if (typeof value === 'string') {
+        try {
+            const parsed = JSON.parse(value);
+            return asRecord(parsed);
+        }
+        catch {
+            return { message: value };
+        }
+    }
+    if (typeof value === 'object') {
+        return asRecord(value);
+    }
+    return {};
+}
+export function extractResponseReasonCode(body, response) {
+    const nestedError = asRecord(body.error);
+    const rawReasonCode = readString(body, ['reasonCode', 'reason_code'])
+        || readString(nestedError, ['reasonCode', 'reason_code'])
+        || normalizeText(response.headers.get('x-reason-code'));
+    const statusReasonCode = mapRealmStatusReasonCode(response.status);
+    const reasonCode = response.status === 403 ? statusReasonCode : rawReasonCode || statusReasonCode;
+    const code = mapRealmStatusReasonCode(response.status);
+    const rawActionHint = readString(body, ['actionHint', 'action_hint'])
+        || readString(nestedError, ['actionHint', 'action_hint'])
+        || normalizeText(response.headers.get('x-action-hint'));
+    const statusActionHint = mapRealmStatusActionHint(response.status);
+    const actionHint = response.status === 403 ? statusActionHint : rawActionHint || statusActionHint;
+    const traceId = readString(body, ['traceId', 'trace_id'])
+        || readString(nestedError, ['traceId', 'trace_id'])
+        || normalizeText(response.headers.get('x-trace-id'));
+    const message = readString(body, ['message'])
+        || readString(nestedError, ['message'])
+        || `${response.status} ${response.statusText}`;
+    const retryable = response.status === 429 || response.status >= 500;
+    const details = {
+        httpStatus: response.status,
+    };
+    if (rawReasonCode) {
+        details.rawReasonCode = rawReasonCode;
+    }
+    if (rawActionHint) {
+        details.rawActionHint = rawActionHint;
+    }
+    return {
+        rawReasonCode,
+        reasonCode,
+        code,
+        actionHint,
+        traceId,
+        message,
+        retryable,
+        details,
+    };
+}
+export function mapRealmError(error) {
+    if (isAbortLikeError(error)) {
+        return createNimiError({
+            message: normalizeText(asRecord(error).message) || 'realm request aborted',
+            code: ReasonCode.OPERATION_ABORTED,
+            reasonCode: ReasonCode.OPERATION_ABORTED,
+            actionHint: 'retry_if_needed',
+            source: 'realm',
+        });
+    }
+    const normalized = asNimiError(error, {
+        code: ReasonCode.REALM_UNAVAILABLE,
+        reasonCode: ReasonCode.REALM_UNAVAILABLE,
+        actionHint: 'retry_or_check_realm_network',
+        source: 'realm',
+    });
+    const message = normalizeText(normalized.message).toLowerCase();
+    if (message.includes('aborted')) {
+        return createNimiError({
+            message: normalized.message,
+            code: ReasonCode.OPERATION_ABORTED,
+            reasonCode: ReasonCode.OPERATION_ABORTED,
+            actionHint: 'retry_if_needed',
+            traceId: normalized.traceId || undefined,
+            source: 'realm',
+            retryable: false,
+        });
+    }
+    return normalized;
+}
+//# sourceMappingURL=client-helpers.js.map

package/dist/realm/client-helpers.js.map

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

package/dist/realm/client-types.d.ts

@@ -0,0 +1,68 @@
+import type { NimiError } from '../types/index.js';
+import type { JsonObject } from '../internal/utils.js';
+import type { RealmGeneratedServiceRegistry, RealmRawRequestInput } from './generated/service-registry.js';
+export type RealmConnectionState = {
+    status: 'idle' | 'connecting' | 'ready' | 'closing' | 'closed';
+    connectedAt?: string;
+    lastReadyAt?: string;
+};
+export type RealmTelemetryEvent = {
+    name: string;
+    at: string;
+    data?: JsonObject;
+};
+export type RealmTokenRefreshResult = {
+    accessToken: string;
+    refreshToken?: string;
+    expiresIn?: number;
+};
+export type RealmFetchImpl = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export type RealmAuthCustodyMode = 'runtime_account' | 'external_principal';
+export type RealmAuthOptions = {
+    mode: RealmAuthCustodyMode;
+    accessToken?: string | (() => Promise<string> | string);
+    refreshToken?: string | (() => Promise<string> | string);
+    onTokenRefreshed?: (result: RealmTokenRefreshResult) => void;
+    onRefreshFailed?: (error: unknown) => void;
+};
+export type RealmRetryOptions = {
+    maxRetries?: number;
+    retryableStatuses?: number[];
+    backoffMs?: number;
+    maxBackoffMs?: number;
+};
+export type RealmOptions = {
+    baseUrl: string;
+    auth?: RealmAuthOptions | null;
+    headers?: Record<string, string> | (() => Promise<Record<string, string>> | Record<string, string>);
+    retry?: RealmRetryOptions;
+    timeoutMs?: number;
+    fetchImpl?: RealmFetchImpl;
+    telemetry?: {
+        enabled?: boolean;
+        onEvent?: (event: RealmTelemetryEvent) => void;
+    };
+};
+export type RealmResponseParser<T> = (value: unknown) => T;
+export type RealmUnsafeRawModule = {
+    /**
+     * Unsafe escape hatch. Prefer generated `realm.services.*` methods so request and response
+     * contracts stay bound to the published OpenAPI schema.
+     */
+    request(input: RealmRawRequestInput): Promise<unknown>;
+    request<T>(input: RealmRawRequestInput & {
+        parseResponse: RealmResponseParser<T>;
+    }): Promise<T>;
+};
+export type RealmServiceRegistry = RealmGeneratedServiceRegistry;
+export type RealmEventsModule = {
+    on(name: 'error', handler: (event: {
+        error: NimiError;
+        at: string;
+    }) => void): () => void;
+    once(name: 'error', handler: (event: {
+        error: NimiError;
+        at: string;
+    }) => void): () => void;
+};
+//# sourceMappingURL=client-types.d.ts.map

package/dist/realm/client-types.d.ts.map

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

package/dist/realm/client-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client-types.js.map

package/dist/realm/client-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-types.js","sourceRoot":"","sources":["../../src/realm/client-types.ts"],"names":[],"mappings":""}

package/dist/realm/client.d.ts

@@ -0,0 +1,39 @@
+import type { RealmAuthOptions, RealmConnectionState, RealmEventsModule, RealmOptions, RealmServiceRegistry, RealmTokenRefreshResult, RealmUnsafeRawModule } from './client-types.js';
+export declare class Realm {
+    #private;
+    readonly services: RealmServiceRegistry;
+    readonly events: RealmEventsModule;
+    readonly unsafeRaw: RealmUnsafeRawModule;
+    readonly baseUrl: string;
+    constructor(options: RealmOptions);
+    connect(): Promise<void>;
+    ready(input?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    close(): Promise<void>;
+    state(): RealmConnectionState;
+    updateAuth(patch: Partial<RealmAuthOptions>): void;
+    clearAuth(): void;
+    static refreshAccessToken(input: {
+        authMode: 'external_principal';
+        realmBaseUrl: string;
+        refreshToken: string;
+        fetchImpl?: typeof fetch;
+    }): Promise<RealmTokenRefreshResult>;
+    /**
+     * Decodes the unverified JWT payload for UX hints only.
+     * Do not use this helper for trust, authorization, or expiry enforcement.
+     *
+     * @deprecated Prefer {@link Realm.decodeTokenExpiryUnsafe} in new code to make
+     * the lack of signature verification explicit.
+     */
+    static decodeTokenExpiry(jwt: string): {
+        expiresAt: number;
+        expiresInMs: number;
+    } | null;
+    static decodeTokenExpiryUnsafe(jwt: string): {
+        expiresAt: number;
+        expiresInMs: number;
+    } | null;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/realm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/realm/client.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EAGZ,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAoG3B,qBAAa,KAAK;;IAChB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IAExC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IAEzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAcb,OAAO,EAAE,YAAY;IAiD3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAWxB,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,KAAK,IAAI,oBAAoB;IAI7B,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAQlD,SAAS,IAAI,IAAI;WAIJ,kBAAkB,CAAC,KAAK,EAAE;QACrC,QAAQ,EAAE,oBAAoB,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;KAC1B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAscpC;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA4BxF,MAAM,CAAC,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAwC/F"}