@amxts/core 0.1.0 → 0.2.0

package/src/testing/tables.ts

@@ -48,6 +48,30 @@ export interface Tables {
 	stringFields: Set<number>;
 	/** Members read with an element index: m_rgpPlayerItems. */
 	arrayFields: Set<number>;
+	/** An entvar by its offset in entvars_t, as the module's ent_get takes it: its constant, and a vector's component. */
+	entvarAt: Map<number, { field: number; component: number }>;
+	/** A member by its class and name in the gamedata, as member_slot takes it ("CBasePlayer::m_iAccount"): its constant. */
+	memberNamed: Map<string, number>;
+}
+
+/**
+ * The entvars by their offset (a vector's components each) and the members by
+ * their gamedata name, as the module reads them: the lists as/entities.ts
+ * keeps beside its member table.
+ */
+function fieldPlaces(constants: Map<string, number>, entities: string) {
+	const entvarAt = new Map<number, { field: number; component: number }>();
+	for (const [, name, offset, vector] of entities.matchAll(/^\/\/ (var_\w+) (\d+)( vector)?$/gm)) {
+		const field = constants.get(name);
+		if (field === undefined) continue;
+		for (let component = 0; component < (vector ? 3 : 1); component++) entvarAt.set(Number(offset) + component * 4, { field, component });
+	}
+	const memberNamed = new Map<string, number>();
+	for (const [, className, name, reapi] of entities.matchAll(/^\t"(\w+)", "(\w+)", \/\/ (\w+)$/gm)) {
+		const field = constants.get(reapi);
+		if (field !== undefined) memberNamed.set(`${className}::${name}`, field);
+	}
+	return { entvarAt, memberNamed };
 }
 
 let cached: Tables | null = null;
@@ -126,6 +150,7 @@ export function tables(): Tables {
 		vectorFields: fieldsOf(kind => (kind & 3) === 2),
 		stringFields: fieldsOf(kind => (kind & 3) === 3),
 		arrayFields: fieldsOf(kind => (kind & 4) !== 0),
+		...fieldPlaces(constants, generated('entities.ts')),
 	};
 
 	return cached;

package/as/modules/http.ts

@@ -1,184 +0,0 @@
-// fetch() over the easy_http module.
-//
-// An extension, not the core: easy_http is a third-party AMX Mod X module
-// (github.com/Next21Team/AmxxEasyHttp), so a plugin imports this file itself -
-// `import { fetch } from "~/modules/http"` - and a server without the module
-// gets one clear line in the log instead of a missing-native error.
-//
-//   const response = await fetch("https://example.com/");
-//   if (response.ok) console.log(response.text);
-//
-//   fetch("https://example.com/")
-//     .then((response) => console.log(`${response.status}: ${response.text}`))
-//     .catch((error) => console.log(error.message));
-//
-// A real Promise (as/promise.ts): awaited in an async function, or given
-// .then and .catch. `signal` cancels the request, as the Fetch standard's does.
-import { CellBuffer, WideHandler } from "~/facade";
-import {
-	LibraryExists, ezhttp_cancel_request, ezhttp_create_options, ezhttp_delete, ezhttp_get,
-	ezhttp_get_downloaded_bytes, ezhttp_get_error_code, ezhttp_get_error_message, ezhttp_get_http_code,
-	ezhttp_option_set_body, ezhttp_option_set_header, ezhttp_patch, ezhttp_post, ezhttp_put
-} from "~/natives";
-import { LibType_Library } from "~/constants";
-
-/** A request's options besides its URL. Every field is optional. */
-export class RequestInit {
-	/** The request's method, one of `"GET"` (the default), `"POST"`, `"PUT"`, `"PATCH"`, `"DELETE"`. */
-	method?: string = "GET";
-	/** The text sent with the request, such as JSON for a POST; empty by default. */
-	body?: string = "";
-	/** The request's headers, as pairs: `[["Content-Type", "application/json"]]`. */
-	headers?: string[][] = [];
-	/**
-	 * A signal that cancels the request; the promise then rejects with an
-	 * Error named `"AbortError"`. In an async command handler or player event,
-	 * the player leaving cancels the request too.
-	 */
-	signal?: AbortSignal | null = null;
-}
-
-/** The server's response to a request. */
-export class Response {
-	constructor(
-		/** The response's HTTP status: `200`, `404`, ... */
-		public status: number,
-		/** The response's body, as text. */
-		public text: string
-	) {}
-
-	/** `true` for a 2xx status. */
-	get ok() {
-		return this.status >= 200 && this.status < 300;
-	}
-}
-
-/**
- * Sends a request. The promise is fulfilled with the response on a later
- * frame, and rejected when there is none - no connection, a bad URL, a
- * timeout, no `easy_http`, or an abort. An HTTP error such as `404` is a
- * response, as in fetch: check `response.ok`.
- *
- * Pawn: `ezhttp_get`, `ezhttp_post` (easy_http)
- */
-export function fetch(url: string, init: RequestInit = {}): Promise<Response> {
-	const promise = __co_promise<Response>();
-
-	if (LibraryExists("easy_http", LibType_Library) == 0) {
-		console.error(`fetch(${url}): the easy_http module is not loaded - add it to modules.ini`);
-		__co_reject(promise, new Error("easy_http is not loaded"));
-		return promise;
-	}
-
-	const request = new Request(promise);
-	const guard = new __AbortGuard(request, init.signal as AbortSignal | null);
-	request.guard = guard;
-	const aborted = guard.aborted;
-	if (aborted) {
-		guard.release();
-		__co_reject(promise, aborted);
-		return promise;
-	}
-
-	let options = 0;
-	// An optional field reads as `T | undefined`, though a field the literal
-	// leaves out holds its default: `||` makes the type plain.
-	const body = init.body || "";
-	const headers = init.headers || [];
-
-	if (body.length > 0 || headers.length > 0) {
-		options = ezhttp_create_options();
-		if (body.length > 0) ezhttp_option_set_body(options, body);
-		for (const pair of headers) ezhttp_option_set_header(options, pair[0], pair[1]);
-	}
-
-	const callback = completeName();
-	if (callback.length == 0) {
-		guard.release();
-		__co_reject(promise, new Error("no callback slot left"));
-		return promise;
-	}
-
-	const method = init.method || "GET";
-	let id = 0;
-
-	if (method == "GET") id = ezhttp_get(url, callback, options);
-	else if (method == "POST") id = ezhttp_post(url, callback, options);
-	else if (method == "PUT") id = ezhttp_put(url, callback, options);
-	else if (method == "PATCH") id = ezhttp_patch(url, callback, options);
-	else if (method == "DELETE") id = ezhttp_delete(url, callback, options);
-	else {
-		guard.release();
-		__co_reject(promise, new Error(`easy_http has no ${method}`));
-		return promise;
-	}
-
-	request.id = id;
-	pending.set(id, request);
-	return promise;
-}
-
-/** A request under way, and what cancels it when a signal aborts. */
-class Request extends __AbortWatch {
-	id = 0;
-	guard: __AbortGuard | null = null;
-
-	constructor(public promise: Promise<Response>) {
-		super();
-	}
-
-	run(reason: Error): void {
-		if (!pending.has(this.id)) return;
-		pending.delete(this.id);
-		ezhttp_cancel_request(this.id);
-		this.settled();
-		__co_reject(this.promise, reason);
-	}
-
-	settled(): void {
-		const guard = this.guard;
-		if (guard) guard.release();
-	}
-}
-
-const pending = new Map<number, Request>();
-
-// Must match SLOT_REUSED in runtime/src/module.cpp, and SHAPE_WIDE the facade's.
-const REUSED = 0x10000;
-const SHAPE_WIDE = 1;
-
-// @ts-ignore: decorator
-@external("env", "ezhttp_get_data") declare function _getData(request: i32, buffer: i32, length: i32): i32;
-// @ts-ignore: decorator
-@external("env", "slot") declare function _slot(fn: i32, shape: i32, key: string, fallback: i32): i32;
-
-/**
- * The host public that calls onComplete. Not publicFor: that one answers ""
- * after a hot reload so a registration is not made twice, and every request
- * names its callback afresh, so the name is needed every time.
- */
-function completeName() {
-	const handler: WideHandler = onComplete;
-	const slot = _slot(handler.index, SHAPE_WIDE, "ezhttp:complete", 0);
-	if (slot < 0) return "";
-	return `__amxts_cb${slot & (REUSED - 1)}`;
-}
-
-// easy_http calls on_complete(request_id) once, on the frame the answer came in.
-function onComplete(id: number, b: number, c: number, d: number) {
-	if (!pending.has(id)) return;
-	const request = pending.get(id);
-	pending.delete(id);
-	request.settled();
-
-	if (ezhttp_get_error_code(id) != 0) {
-		__co_reject(request.promise, new Error(ezhttp_get_error_message(id)));
-		return;
-	}
-
-	// The whole body, however long: the generated ezhttp_get_data stops at 255.
-	const size = ezhttp_get_downloaded_bytes(id) + 1;
-	const cells = new CellBuffer(size);
-	_getData(<i32>id, <i32>cells.address, <i32>size - 1);
-	__co_resolve(request.promise, new Response(ezhttp_get_http_code(id), cells.text()));
-}

package/scripts/docs/as/modules/http.ts

@@ -1,66 +0,0 @@
-// The tooltips of as/modules/http.ts, in both languages: scripts/apply-docs.ts writes the
-// one AMXTS_DOCS_LANG picks into the JSDoc above each element.
-export default {
-	'RequestInit': {
-		en: `A request's options besides its URL. Every field is optional.`,
-		ru: `Настройки запроса помимо URL. Все поля необязательны.`,
-	},
-	'RequestInit.method': {
-		en: `The request's method, one of \`"GET"\` (the default), \`"POST"\`, \`"PUT"\`, \`"PATCH"\`, \`"DELETE"\`.`,
-		ru: `Метод запроса, одно из \`"GET"\` (по умолчанию), \`"POST"\`, \`"PUT"\`, \`"PATCH"\`, \`"DELETE"\`.`,
-	},
-	'RequestInit.body': {
-		en: `The text sent with the request, such as JSON for a POST; empty by default.`,
-		ru: `Текст, который уходит с запросом, например JSON для POST; по умолчанию пустой.`,
-	},
-	'RequestInit.headers': {
-		en: `The request's headers, as pairs: \`[["Content-Type", "application/json"]]\`.`,
-		ru: `Заголовки запроса, парами: \`[["Content-Type", "application/json"]]\`.`,
-	},
-	'RequestInit.signal': {
-		en: `
-			A signal that cancels the request; the promise then rejects with an
-			Error named \`"AbortError"\`. In an async command handler or player event,
-			the player leaving cancels the request too.
-		`,
-		ru: `
-			Сигнал, который отменяет запрос; промис тогда отклоняется с Error с
-			именем \`"AbortError"\`. В async-обработчике команды или события игрока
-			запрос отменяется и тогда, когда игрок выходит.
-		`,
-	},
-	'Response': {
-		en: `The server's response to a request.`,
-		ru: `Ответ сервера на запрос.`,
-	},
-	'Response.status': {
-		en: `The response's HTTP status: \`200\`, \`404\`, ...`,
-		ru: `HTTP-статус ответа: \`200\`, \`404\`, ...`,
-	},
-	'Response.text': {
-		en: `The response's body, as text.`,
-		ru: `Тело ответа, текстом.`,
-	},
-	'Response.ok': {
-		en: `\`true\` for a 2xx status.`,
-		ru: `\`true\` при статусе 2xx.`,
-	},
-	'fetch': {
-		en: `
-			Sends a request. The promise is fulfilled with the response on a later
-			frame, and rejected when there is none - no connection, a bad URL, a
-			timeout, no \`easy_http\`, or an abort. An HTTP error such as \`404\` is a
-			response, as in fetch: check \`response.ok\`.
-
-			Pawn: \`ezhttp_get\`, \`ezhttp_post\` (easy_http)
-		`,
-		ru: `
-			Отправляет запрос. Промис выполняется с ответом в одном из следующих
-			кадров и отклоняется, если ответа нет: нет соединения, плохой URL,
-			таймаут, нет \`easy_http\` или отмена. HTTP-ошибка вроде \`404\` — это ответ,
-			как и в fetch: проверяйте \`response.ok\`.
-
-			Pawn: \`ezhttp_get\`, \`ezhttp_post\` (easy_http)
-		`,
-	},
-};