loop-client 0.0.1

package/build/web-client.js

@@ -0,0 +1,421 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebClient = void 0;
+const logger_1 = require("@triple-sun/logger");
+const again_ts_1 = require("again-ts");
+const axios_1 = __importDefault(require("axios"));
+const breadline_ts_1 = require("breadline-ts");
+const const_1 = require("./const");
+const errors_1 = require("./errors");
+const instrument_1 = require("./instrument");
+const logger_2 = require("./logger");
+const methods_1 = require("./methods");
+const web_client_1 = require("./types/web-client");
+const utils_1 = require("./utils");
+class WebClient extends methods_1.Methods {
+    /**
+     * @description The base URL for reaching Loop/Mattermost Web API
+     * Must end with `api/v4/`
+     * @example https://your-loop.loop.ru/api/v4/
+     */
+    url;
+    /**
+     * @descripton Authentication and authorization token for accessing Loop/Mattermost API
+     */
+    token;
+    /**
+     * Configuration for retry operations. See {@link https://github.com/triplesunn/again-ts|Again} for more details.
+     */
+    retryConfig;
+    /**
+     * Queue of requests in which a maximum of {@link WebClientOptions.maxRequestConcurrency} can concurrently be
+     * in-flight.
+     */
+    breadline;
+    /**
+     * Axios HTTP client instance used by this client
+     */
+    axios;
+    /**
+     * Configuration for custom TLS handling
+     */
+    tlsConfig;
+    /**
+     * The name used to prefix all logging generated from this object
+     */
+    static loggerName = "LoopWebClient";
+    /**
+     * This object's logger instance
+     */
+    logger;
+    /**
+     * @description Current userID
+     * useCurrentUserForDirectChannels and useCurrentUserForPostCreation will
+     * use it instead of fetching from server if not overriden by token
+     */
+    userID;
+    /**
+     * @description Use current user_id if only one was provided for direct channel creation.
+     * Will fetch current user ID from server if no userID was provided or overridden by token in options
+     *
+     * @default true
+     */
+    useCurrentUserForDirectChannels;
+    /**
+     * @description Use post.user_id in PostCreateArguments to fetch a channel_id for post
+     * Will call channels.create.direct for current user if true
+     * Will fetch current user ID from server if no userID was provided or overridden by token in options
+     *
+     * @default true
+     * @default false if userID is provided
+     */
+    useCurrentUserForPostCreation;
+    /**
+     * @description If true the client will set its userID if it was fetched while
+     * useCurrentUserForDirectChannels=true, useCurrentUserForPostCreation=true
+     * or via users.profile.get.me()
+     *
+     * @default false
+     */
+    saveFetchedUserID;
+    clusterId;
+    serverVersion;
+    constructor(url, { token = undefined, userID = undefined, logger = undefined, logLevel = undefined, maxRequestConcurrency = 100, retryConfig = const_1.tenRetriesInAboutThirtyMinutes, useCurrentUserForDirectChannels = true, useCurrentUserForPostCreation = true, saveFetchedUserID = false, testConnectionOnInit = false, agent = undefined, tls = undefined, timeout = 0, headers = {}, requestInterceptor = undefined, adapter = undefined } = {}) {
+        super();
+        this.token = token;
+        this.url = url;
+        if (!this.url.endsWith("/"))
+            this.url += "/";
+        if (!this.url.endsWith(`api/v4/`))
+            this.url += `api/v4/`;
+        this.userID = userID;
+        this.clusterId = "";
+        this.serverVersion = "";
+        this.retryConfig = retryConfig;
+        this.breadline = new breadline_ts_1.Breadline({ concurrency: maxRequestConcurrency });
+        // NOTE: may want to filter the keys to only those acceptable for TLS options
+        this.tlsConfig = tls;
+        this.useCurrentUserForDirectChannels = useCurrentUserForDirectChannels;
+        this.useCurrentUserForPostCreation = useCurrentUserForPostCreation;
+        this.saveFetchedUserID = saveFetchedUserID;
+        /** Set up logging */
+        if (logger !== undefined) {
+            this.logger = logger;
+            if (logLevel !== undefined) {
+                this.logger.debug("The logLevel given to WebClient was ignored as you also gave logger");
+            }
+        }
+        else {
+            this.logger = (0, logger_2.getLogger)(WebClient.loggerName, logLevel ?? logger_1.LogLevel.INFO, logger);
+        }
+        if (this.token && !headers.Authorization) {
+            headers.Authorization = `Bearer ${this.token}`;
+        }
+        this.axios = axios_1.default.create({
+            timeout,
+            baseURL: this.url,
+            httpAgent: agent,
+            httpsAgent: agent,
+            headers: { ...headers, "User-Agent": (0, instrument_1.getUserAgent)() },
+            validateStatus: () => true, // all HTTP status codes should result in a resolved promise (as opposed to only 2xx)
+            maxRedirects: 0,
+            // disabling axios' automatic proxy support:
+            // axios would read from envvars to configure a proxy automatically, but it doesn't support TLS destinations.
+            // for compatibility and for a larger set of possible proxies (SOCKS or other
+            // protocols), users of this package should use the `agent` option to configure a proxy.
+            proxy: false
+        });
+        /** config.type and serializeApiCallData will set ContentType automatically */
+        this.axios.defaults.headers.post["Content-Type"] = null;
+        if (requestInterceptor) {
+            /**
+             * request interceptors have reversed execution order
+             * see: {@link https://github.com/axios/axios/blob/v1.x/test/specs/interceptors.spec.js#L88}
+             */
+            this.axios.interceptors.request.use(requestInterceptor, null);
+        }
+        if (adapter) {
+            this.axios.defaults.adapter = (config) => adapter({ ...config });
+        }
+        /**
+         * Built-int interceptors
+         */
+        /** set current user for direct channels interceptor */
+        if (this.useCurrentUserForDirectChannels) {
+            this.axios.interceptors.request.use(this.setCurrentUserForDirectChannel.bind(this));
+        }
+        /** set current user for posts interceptor */
+        if (this.useCurrentUserForPostCreation) {
+            this.axios.interceptors.request.use(this.setCurrentUserForPostCreation.bind(this));
+        }
+        /** path specific transformations */
+        this.axios.interceptors.request.use(this.transformPathSpecificParams.bind(this));
+        /** main data serializer interceptor */
+        this.axios.interceptors.request.use(this.serializeApiCallData.bind(this));
+        /** test connection if needed */
+        if (testConnectionOnInit)
+            this.system.checkHealth();
+        this.logger.debug("initialized");
+    }
+    /**
+     * Generic method for calling a Web API method
+     * @param path - the Web API path to call
+     * @param options - method options
+     *
+     * @throws WebApiCallFailedError with detailed errors in ctx.errors
+     */
+    async apiCall(config, options = {}) {
+        this.logger.debug(`APICall [${config.method} ${config.path}] start`);
+        if (typeof options === "string" ||
+            typeof options === "number" ||
+            typeof options === "boolean") {
+            throw new TypeError(`Expected options; instead got ${typeof options}`);
+        }
+        /** gotta set headers! */
+        const headers = {
+            "Content-Type": config.type
+        };
+        /** and handle TokenOverridable */
+        if (typeof options["token"] === "string") {
+            headers["Authorization"] = `Bearer ${options[""]}`;
+            options["token"] = undefined;
+            this.logger.debug(`token has been overridden`);
+        }
+        /** and warn if no fallback in attachments */
+        (0, utils_1.warnIfFallbackIsMissing)(config.path, this.logger, options);
+        /** and fill url from options */
+        const url = this.fillRequestUrl(config, options);
+        const response = await this.makeRequest(url, {
+            headers,
+            method: config.method,
+            data: options
+        });
+        const result = this.buildResult(url, response);
+        this.logger.debug(`APICall result: ${JSON.stringify(result, null, 2)}`);
+        this.logger.debug(`APICall [${config.method} ${config.path}] end`);
+        return result;
+    }
+    /**
+     * @description Low-level function to make a single API request.
+     * Handles queueing, retries, and http-level errors
+     */
+    async makeRequest(url, config) {
+        const task = () => 
+        // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <jesting>
+        this.breadline.add(async () => {
+            const cfg = {
+                ...config,
+                ...this.tlsConfig
+            };
+            if (this.logger.getLevel() === logger_1.LogLevel.DEBUG) {
+                this.logger.debug(`http request url: ${url}`);
+                this.logger.debug(`http request data: ${(0, utils_1.redact)(config.data)}`);
+                this.logger.debug(`http request headers: ${(0, utils_1.redact)({
+                    ...this.axios.defaults.headers.common,
+                    ...config.headers
+                })}`);
+            }
+            /** ApiCallData is serialized through interceptors */
+            const response = await this.axios(url, cfg);
+            this.logger.debug("http response received");
+            this.logger.debug(`http response status: ${response.status}`);
+            if (this.serverVersion !== response.headers[const_1.HEADER_X_VERSION_ID]) {
+                this.serverVersion = response.headers[const_1.HEADER_X_VERSION_ID];
+            }
+            if (this.clusterId !== response.headers[const_1.HEADER_X_CLUSTER_ID]) {
+                this.clusterId = response.headers[const_1.HEADER_X_CLUSTER_ID];
+            }
+            /** handle error status code */
+            if (response.status > 300) {
+                this.logger.debug(`http error: ${JSON.stringify(response.data, null, 2)}`);
+                const { data } = response;
+                if ((0, errors_1.isServerError)(data)) {
+                    if (response.status === 429)
+                        throw new errors_1.WebAPIRateLimitedError(data);
+                    throw new errors_1.WebAPIServerError(data);
+                }
+                throw new errors_1.WebAPIRequestError(data);
+            }
+            return response;
+        });
+        return await (0, again_ts_1.retry)("safe", task, this.retryConfig);
+    }
+    /**
+     * Processes an HTTP response into a WebAPICallResult by performing JSON parsing on the body and merging relevant
+     * HTTP headers into the object.
+     * @param response - an http response
+     */
+    buildResult(url, result) {
+        const ctx = { ...result.ctx, url };
+        /** short-circuit if we have an error */
+        if (!result.ok)
+            throw result.ctx.errors[result.ctx.errors.length - 1];
+        this.logger.debug(`response headers: ${JSON.stringify(result.value.headers, null, 2)}`);
+        /**
+         * handle string responses?
+         * @todo check if it's actually needed
+         */
+        if (typeof result.value.data === "string") {
+            try {
+                result.value.data = JSON.parse(result.value.data);
+            }
+            catch (err) {
+                // failed to parse the string value as JSON data
+                throw err instanceof Error
+                    ? err
+                    : new TypeError(`non-error type thrown: ${err}`);
+            }
+        }
+        return Object.freeze({ data: result.value.data, ctx });
+    }
+    fillRequestUrl(config, options) {
+        let requestUrl = `${config.path}`;
+        /** fills :something with { something: "something" } from options */
+        if (requestUrl.match(new RegExp(/\/:\D*/))) {
+            for (const [k, v] of Object.entries(options)) {
+                this.logger.debug(`Replacing :${k} with ${v} in ${requestUrl}`);
+                requestUrl = requestUrl.replace(new RegExp(`:${k}`, "g"), String(v));
+            }
+        }
+        /** if no user_id in options: get 'me' user_id by default */
+        if (requestUrl.includes("users/:user_id")) {
+            requestUrl = requestUrl.replace(":user_id", "me");
+        }
+        return `${this.axios.getUri()}${requestUrl}`;
+    }
+    /**
+     * @description Sets authenticated user id for channel creation
+     */
+    async setCurrentUserForDirectChannel(config) {
+        const { data } = config;
+        if (config.url?.endsWith("/api/v4/channels/direct")) {
+            const userIDs = data;
+            if (!Array.isArray(userIDs)) {
+                throw new errors_1.WebClientOptionsError(`Expected user_ids to be an array`);
+            }
+            if (userIDs.length === 0) {
+                throw new errors_1.WebClientOptionsError(`To create a direct channel you should use at least one user_id in a tuple`);
+            }
+            if (userIDs.length === 1) {
+                /** throw if not enough user_ids and can't fetch current from server */
+                if (!this.useCurrentUserForDirectChannels) {
+                    throw new errors_1.WebClientOptionsError(`If useCurrentUserForDirectChannels is false you MUST use two user_ids in a tuple to create a direct channel`);
+                }
+                config.data = [userIDs[0], await this.getCurrentUserID(data)];
+            }
+        }
+        return config;
+    }
+    /**
+     * @description Sets channel_id for user_id for post creation
+     */
+    async setCurrentUserForPostCreation(config) {
+        if (config.url?.endsWith("/api/v4/posts") && config.method === "post") {
+            const { data } = config;
+            /** throw if we dont have required params and we can't fetch them */
+            if (!this.useCurrentUserForPostCreation && !data.channel_id) {
+                throw new errors_1.WebClientOptionsError("If useCurrentUserForPostCreation is false you MUST provide channel_id to send a post");
+            }
+            /** throw if we don't even have options required to fetch missing data */
+            if (!data.user_id && !data.channel_id) {
+                throw new errors_1.WebClientOptionsError("To create a post you need to provide either a channel_id or user_id");
+            }
+            if (typeof data.user_id === "string" && !data.channel_id) {
+                const opts = {
+                    token: data["token"],
+                    user_ids: [data.user_id, await this.getCurrentUserID(data)]
+                };
+                /** if token overridable or no userID - fetch channel_id from server  */
+                const channel = await this.channels.create.direct(opts);
+                config.data.channel_id = channel.data.id;
+            }
+        }
+        return config;
+    }
+    /**
+     * Gets or fetches current user ID using
+     * @param data Axios config.data
+     * @returns
+     */
+    async getCurrentUserID(data) {
+        const opts = {};
+        if (typeof data["token"] === "string") {
+            opts.token = data["token"];
+        }
+        if (opts.token || !this.userID) {
+            /** if token overridable or no userID - fetch userID from server  */
+            const me = await this.users.profile.get.me(opts);
+            /** save if needed */
+            if (this.saveFetchedUserID) {
+                this.userID = me.data.id;
+            }
+            return me.data.id;
+        }
+        else {
+            return this.userID;
+        }
+    }
+    transformPathSpecificParams(config) {
+        const { data } = config;
+        /** transform to array */
+        if (config.url?.endsWith("/api/v4/channels/direct")) {
+            const userIDs = data.user_ids;
+            if (!Array.isArray(userIDs)) {
+                throw new errors_1.WebClientOptionsError(`Expected data.user_ids to be an array`);
+            }
+            config.data = userIDs;
+        }
+        if (config.url?.endsWith("/channels/ids")) {
+            const channelIDs = data.channel_ids;
+            if (!Array.isArray(channelIDs)) {
+                throw new errors_1.WebClientOptionsError(`Expected data.channel_ids to be an array`);
+            }
+            config.data = channelIDs;
+        }
+        if (config.url?.endsWith("/api/v4/roles/names") &&
+            config.method?.toLowerCase() === "post") {
+            const roles = data.roles;
+            if (!Array.isArray(roles)) {
+                throw new errors_1.WebClientOptionsError(`Expected data.channel_ids to be an array`);
+            }
+            config.data = roles;
+        }
+        return config;
+    }
+    /**
+     * Transforms options (a simple key-value object) into an acceptable value for a body. This can be either
+     * a string, used when posting with a content-type of url-encoded. Or, it can be a readable stream, used
+     * when the options contain a binary (a stream or a buffer) and the upload should be done
+     * with content-type multipart/form-data.
+     * @param config - The Axios request configuration object
+     */
+    serializeApiCallData(config) {
+        const { data, headers } = config;
+        const hasBinaryData = (0, utils_1.checkForBinaryData)(data);
+        /** Handling multipart form-data */
+        if (hasBinaryData ||
+            config.headers["Content-Type"] === web_client_1.ContentType.FormData) {
+            this.logger.debug("Request arguments contain binary data");
+            return (0, utils_1.getFormDataConfig)(data, headers);
+        }
+        /** Use json for json oh wow ¯\_(ツ)_/¯ */
+        if (headers["Content-Type"] === web_client_1.ContentType.JSON) {
+            return { ...config, data };
+        }
+        /** Otherwise it's a query */
+        return {
+            ...config,
+            params: Object.entries(data).reduce((accumulator, [key, value]) => {
+                if (key !== undefined && value !== undefined) {
+                    accumulator[key] = value;
+                }
+                return accumulator;
+            }, {})
+        };
+    }
+}
+exports.WebClient = WebClient;
+//# sourceMappingURL=web-client.js.map

package/build/web-client.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "loop-client",
+  "version": "0.0.1",
+  "main": "build/index.js",
+  "description": "\"Loop/Mattermost TypeScript client\"",
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/triple-sun/loop-client.git"
+  },
+  "author": "triple-sun",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/triple-sun/loop-client/issues"
+  },
+  "homepage": "https://github.com/triple-sun/loop-client#readme",
+  "files": [
+    "build/**/*",
+    "*.md"
+  ],
+  "dependencies": {
+    "@triple-sun/logger": "^0.0.1",
+    "again-ts": "^1.0.5",
+    "axios": "^1.13.3",
+    "breadline-ts": "^1.0.0",
+    "eventemitter3": "^5.0.4",
+    "form-data": "^4.0.5",
+    "is-stream": "^4.0.1",
+    "qs": "^6.14.1",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.10",
+    "@tsconfig/recommended": "^1",
+    "@types/jest": "^30.0.0",
+    "@types/nock": "^10.0.3",
+    "@types/node": "^25.0.10",
+    "@types/qs": "^6.14.0",
+    "@types/ws": "^8.5.11",
+    "dotenv": "^17.2.3",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "lint-staged": "^16.2.7",
+    "nock": "^15.0.0",
+    "rimraf": "^6.1.2",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "ts-to-zod": "^5.1.0",
+    "tsd": "^0.33.0",
+    "typescript": "5.9.3",
+    "zod": "^4.3.6"
+  },
+  "lint-staged": {
+    "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+      "biome check --files-ignore-unknown=true",
+      "biome check --write --no-errors-on-unmatched"
+    ],
+    "*": [
+      "biome check --no-errors-on-unmatched --files-ignore-unknown=true"
+    ],
+    "test/integration/real-api/schemas/*": []
+  },
+  "scripts": {
+    "test": "jest",
+    "build": "rimraf ./build && tsc -p tsconfig.json",
+    "format": "biome format ./ --write",
+    "gen:schemas:res": "./scripts/generate-response-schemas.sh",
+    "lint": "biome lint ./src",
+    "test:real:base": "jest --testPathIgnorePatterns=null",
+    "test:real:only": "jest --testPathIgnorePatterns=null --testMatch=\"**/test/integration/real-api/*.test.ts\""
+  }
+}