/*
This file is part of GNU Taler
(C) 2022-2024 Taler Systems S.A.
GNU Taler is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation; either version 3, or (at your option) any later version.
GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
GNU Taler; see the file COPYING. If not, see
*/
import {
CacheEvictor,
LibtoolVersion,
ObservabilityEvent,
ObservableHttpClientLibrary,
TalerError,
TalerExchangeApi,
TalerExchangeCacheEviction,
TalerExchangeHttpClient
} from "@gnu-taler/taler-util";
import {
ComponentChildren,
FunctionComponent,
VNode,
createContext,
h,
} from "preact";
import { useContext, useEffect, useState } from "preact/hooks";
import { BrowserFetchHttpLib, ErrorLoading, useTranslationContext } from "../index.browser.js";
import {
APIClient,
ActiviyTracker,
ExchangeLib,
Subscriber,
} from "./activity.js";
/**
*
* @author Sebastian Javier Marchano (sebasjm)
*/
export type ExchangeContextType = {
url: URL;
config: TalerExchangeApi.ExchangeVersionResponse;
lib: ExchangeLib;
hints: VersionHint[];
onActivity: Subscriber;
cancelRequest: (eventId: string) => void;
};
// FIXME: below
// @ts-expect-error default value to undefined, should it be another thing?
const ExchangeContext = createContext(undefined);
export const useExchangeApiContext = (): ExchangeContextType =>
useContext(ExchangeContext);
enum VersionHint {
NONE,
}
type Evictors = {
exchange?: CacheEvictor;
};
type ConfigResult =
| undefined
| { type: "ok"; config: T; hints: VersionHint[] }
| ConfigResultFail;
type ConfigResultFail =
| { type: "incompatible"; result: T; supported: string }
| { type: "error"; error: TalerError };
const CONFIG_FAIL_TRY_AGAIN_MS = 5000;
export const ExchangeApiProvider = ({
baseUrl,
children,
evictors = {},
frameOnError,
}: {
baseUrl: URL;
evictors?: Evictors;
children: ComponentChildren;
frameOnError: FunctionComponent<{ children: ComponentChildren }>;
}): VNode => {
const [checked, setChecked] =
useState>();
const { i18n } = useTranslationContext();
const { getRemoteConfig, VERSION, lib, cancelRequest, onActivity } =
buildExchangeApiClient(baseUrl, evictors);
useEffect(() => {
let keepRetrying = true;
async function testConfig(): Promise {
try {
const config = await getRemoteConfig();
if (LibtoolVersion.compare(VERSION, config.version)) {
setChecked({ type: "ok", config, hints: [] });
} else {
setChecked({
type: "incompatible",
result: config,
supported: VERSION,
});
}
} catch (error) {
if (error instanceof TalerError) {
if (keepRetrying) {
setTimeout(() => {
testConfig();
}, CONFIG_FAIL_TRY_AGAIN_MS);
}
setChecked({ type: "error", error });
} else {
setChecked({ type: "error", error: TalerError.fromException(error) });
}
}
}
testConfig();
return () => {
// on unload, stop retry
keepRetrying = false;
};
}, []);
if (checked === undefined) {
return h(frameOnError, {
children: h("div", {}, "checking compatibility with server..."),
});
}
if (checked.type === "error") {
return h(frameOnError, {
children: h(ErrorLoading, { error: checked.error, showDetail: true }),
});
}
if (checked.type === "incompatible") {
return h(frameOnError, {
children: h(
"div",
{},
i18n.str`The server version is not supported. Supported version "${checked.supported}", server version "${checked.result.version}"`,
),
});
}
const value: ExchangeContextType = {
url: baseUrl,
config: checked.config,
onActivity: onActivity,
lib,
cancelRequest,
hints: checked.hints,
};
return h(ExchangeContext.Provider, {
value,
children,
});
};
function buildExchangeApiClient(
url: URL,
evictors: Evictors,
): APIClient {
const httpFetch = new BrowserFetchHttpLib({
enableThrottling: true,
requireTls: false,
});
const tracker = new ActiviyTracker();
const httpLib = new ObservableHttpClientLibrary(httpFetch, {
observe(ev) {
tracker.notify(ev);
},
});
const ex = new TalerExchangeHttpClient(url.href, httpLib, evictors.exchange);
async function getRemoteConfig(): Promise {
const resp = await ex.getConfig();
if (resp.type === "fail") {
throw TalerError.fromUncheckedDetail(resp.detail);
}
return resp.body;
}
return {
getRemoteConfig,
VERSION: ex.PROTOCOL_VERSION,
lib: {
exchange: ex,
},
onActivity: tracker.subscribe,
cancelRequest: httpLib.cancelRequest,
};
}
export const ExchangeApiProviderTesting = ({
children,
value,
}: {
value: ExchangeContextType;
children: ComponentChildren;
}): VNode => {
return h(ExchangeContext.Provider, {
value,
children,
});
};