@nestjs-rpc/client
Version:
Type-safe RPC for NestJS — call Nest methods like local functions with zero boilerplate.
140 lines (138 loc) • 4.97 kB
JavaScript
;
var __create = Object.create;
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __getProtoOf = Object.getPrototypeOf;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __export = (target, all) => {
for (var name in all)
__defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
if (from && typeof from === "object" || typeof from === "function") {
for (let key of __getOwnPropNames(from))
if (!__hasOwnProp.call(to, key) && key !== except)
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
}
return to;
};
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
// If the importer is in node compatibility mode or this is not an ESM
// file that has been converted to a CommonJS file using a Babel-
// compatible transform (i.e. "__esModule" has not been set), then set
// "default" to the CommonJS "module.exports" for node compatibility.
isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
mod
));
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
// index.ts
var index_exports = {};
__export(index_exports, {
RpcClient: () => RpcClient
});
module.exports = __toCommonJS(index_exports);
// rpc-client.ts
var import_lodash = __toESM(require("lodash.merge"));
var import_axios = __toESM(require("axios"));
var RpcClient = class {
config;
/**
* 🏗️ Construct a new client.
*
* @param config - ⚙️ Client configuration.
* - `apiPrefix` default: "nestjs-rpc"
* - `requestOptions` default: `{}`
* - `axiosInstance` default: `axios`
* - `baseUrl` default: `undefined` (you should provide it)
*/
constructor(config) {
this.$setConfig(config);
}
/**
* ⚙️ Set or replace the client configuration.
*
* - Trims leading/trailing slashes from `apiPrefix` and `baseUrl`.
* - Fills in defaults for missing values.
*
* @param config - 🧩 Partial or full configuration to apply.
* @returns void - ✅ Updates internal config.
*/
$setConfig(config) {
let { apiPrefix = "nestjs-rpc", requestOptions = {}, axiosInstance = import_axios.default, baseUrl } = config;
const trimSlashesRgx = /^\/+|\/+$/g;
apiPrefix = apiPrefix.replace(trimSlashesRgx, "");
baseUrl = baseUrl?.replace(trimSlashesRgx, "");
this.config = { apiPrefix, requestOptions, axiosInstance, baseUrl };
}
/**
* 🧮 Update a single configuration property.
*
* @param key - 🔑 One of the keys of `RpcClientConfig`.
* @param value - 🧱 New value for the given key.
* @returns void - ✅ Applies the update and recomputes normalized config.
*/
$setConfigProperty(key, value) {
this.$setConfig({ ...this.config, [key]: value });
}
/**
* 📦 Current normalized configuration.
*
* - `apiPrefix`: string (no leading/trailing slashes)
* - `baseUrl`: string | undefined (no leading/trailing slashes)
* - `requestOptions`: AxiosRequestConfig
* - `axiosInstance`: AxiosInstance
*/
get $config() {
return this.config;
}
/**
* 🧭 Get a specific router proxy by key.
*
* @param router - 🏷️ Router key from your manifest.
* @returns A proxy exposing the methods of the router with typed calls.
*/
route(router) {
return this.routers()[router];
}
/**
* 🌳 Get the root proxy for navigating routers and calling methods.
*
* @returns A nested proxy matching the structure of your manifest.
*/
routers() {
const that = this;
function buildProxy(path = []) {
return new Proxy((() => {
}), {
get(_, propertyKey) {
if (typeof propertyKey === "symbol") {
throw new Error(
`Invalid property name: Property name cannot be of type symbol, got: ${propertyKey.toString()}`
);
}
return buildProxy([...path, propertyKey.toString()]);
},
async apply(_, __, args) {
if (path.length === 0) {
throw new Error("NOT A FUNCTION, Proxy tree access without method");
}
return await that.handleRequest(path, ...args);
}
});
}
return buildProxy();
}
async handleRequest(path, body, options) {
return await (options?.axiosInstance ?? this.config.axiosInstance).post(
`${this.$config.baseUrl}/${this.$config.apiPrefix}/${path.join("/")}`,
{ param: body },
(0, import_lodash.default)({}, this.$config.requestOptions, options?.requestOptions ?? {})
);
}
};
// Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = {
RpcClient
});
//# sourceMappingURL=index.js.map