Files
ppc_amnet/amnet-shared/dist/index.d.ts
T

51 lines
1.7 KiB
TypeScript

/**
* The latest version of the AMNet API this library supports
*/
declare const AMNET_API_VERSION = 1;
interface AMCardInRequest {
cardId: string;
}
/**
* Information needed to perform a request against an AMNet server
*/
interface AMServerConnectionInfo {
apiVersion: number;
serverAddress: string;
}
/**
* Received metadata from an AMNet server
*/
interface AMServerInfoResponse extends AMServerConnectionInfo {
serverName: string;
gameId?: string | null | undefined;
}
/**
* Performs the card-in request to the specified server
* @param server The server to perform the request against
* @param request The card-in request to send
* @param signal The abort signal to use for the request
*/
declare function performCardIn(server: AMServerConnectionInfo, request: AMCardInRequest, signal: AbortSignal): Promise<boolean>;
/**
* Attempts to connect to the specified server and fetch its info
* @param serverAddress The origin address of the server to connect to
* @param abort The abort signal to use for the request (for cancellation)
*/
declare function fetchServerInfo(serverAddress: string, abort: AbortSignal): Promise<AMServerInfoResponse | null>;
declare const CARD_ID_REGEX: RegExp;
declare function generateCardNumber(): string;
/**
* Validates the provided card id by known parameters
* @param id The card id to validate
*/
declare function validateCardId(id: string): boolean;
/**
* Get the game name from the game identifier (4-letter code)
* @param id
*/
declare function getGameName(id: string): string | null;
export { type AMCardInRequest, AMNET_API_VERSION, type AMServerConnectionInfo, type AMServerInfoResponse, CARD_ID_REGEX, fetchServerInfo, generateCardNumber, getGameName, performCardIn, validateCardId };