mocktp 0.0.1-security → 3.15.3

package/dist/client/admin-client.d.ts

@@ -0,0 +1,112 @@
+import { EventEmitter } from 'events';
+import { Duplex } from 'stream';
+import { TypedError } from 'typed-error';
+import { AdminPlugin, PluginClientResponsesMap, PluginStartParamsMap } from '../admin/admin-plugin-types';
+import { SchemaIntrospector } from './schema-introspection';
+import { AdminQuery } from './admin-query';
+export declare class ConnectionError extends TypedError {
+}
+declare global {
+    interface Response {
+    }
+}
+export declare class RequestError extends TypedError {
+    response: Response;
+    constructor(message: string, response: Response);
+}
+export declare class GraphQLError extends RequestError {
+    errors: Array<{
+        message: string;
+    }>;
+    constructor(response: Response, errors: Array<{
+        message: string;
+    }>);
+}
+export type AdminClientEvent = 'starting' | 'started' | 'start-failed' | 'stopping' | 'stopped' | 'stream-error' | 'stream-reconnecting' | 'stream-reconnected' | 'stream-reconnect-failed' | 'subscription-error' | 'subscription-reconnecting';
+export interface AdminClientOptions {
+    /**
+     * Should the client print extra debug information?
+     */
+    debug?: boolean;
+    /**
+     * The full URL to use to connect to a Mockttp admin server when using a
+     * remote (or local but browser) client.
+     *
+     * When using a local server, this option is ignored.
+     */
+    adminServerUrl?: string;
+    /**
+     * Options to include on all client requests.
+     */
+    requestOptions?: {
+        headers?: {
+            [key: string]: string;
+        };
+    };
+}
+/**
+ * Reset a remote admin server, shutting down all Mockttp servers controlled by that
+ * admin server. This is equivalent to calling `client.stop()` for all remote
+ * clients of the target server.
+ *
+ * This can be useful in some rare cases, where a client might fail to reliably tear down
+ * its own server, e.g. in Cypress testing. In this case, it's useful to reset the
+ * admin server completely remotely without needing access to any previous client
+ * instances, to ensure all servers from previous test runs have been shut down.
+ *
+ * After this is called, behaviour of any previously connected clients is undefined, and
+ * it's likely that they may throw errors or experience other undefined behaviour. Ensure
+ * that `client.stop()` has been called on all active clients before calling this method.
+ */
+export declare function resetAdminServer(options?: AdminClientOptions): Promise<void>;
+/**
+ * A bare admin server client. This is not intended for general use, but can be useful when
+ * building admin server plugins to mock non-HTTP protocols and other advanced use cases.
+ *
+ * For normal usage of Mockttp, you should use `Mockttp.getRemote()` instead, to get a Mockttp
+ * remote client, which wraps this class with the full Mockttp API for mocking HTTP.
+ *
+ * This is part of Mockttp's experimental 'pluggable admin' API. It may change
+ * unpredictably, even in minor releases.
+ */
+export declare class AdminClient<Plugins extends {
+    [key: string]: AdminPlugin<any, any>;
+}> extends EventEmitter {
+    private adminClientOptions;
+    private adminSessionBaseUrl;
+    private adminServerStream;
+    private subscriptionClient;
+    private adminServerSchema;
+    private adminServerMetadata;
+    private debug;
+    private running;
+    constructor(options?: AdminClientOptions);
+    private attachStreamWebsocket;
+    private openStreamToMockServer;
+    private prepareSubscriptionClientToAdminServer;
+    private requestFromMockServer;
+    private queryMockServer;
+    start(pluginStartParams: PluginStartParamsMap<Plugins>): Promise<PluginClientResponsesMap<Plugins>>;
+    isRunning(): boolean;
+    get metadata(): PluginClientResponsesMap<Plugins>;
+    get schema(): SchemaIntrospector;
+    get adminStream(): Duplex;
+    stop(): Promise<void>;
+    private requestServerStop;
+    enableDebug: () => Promise<void>;
+    reset: () => Promise<void>;
+    sendQuery<Response, Result = Response>(query: AdminQuery<Response, Result>): Promise<Result>;
+    sendQueries<Queries extends Array<AdminQuery<any>>>(...queries: [...Queries]): Promise<{
+        [n in keyof Queries]: Queries[n] extends AdminQuery<any, infer R> ? R : never;
+    }>;
+    subscribe<Response, Result = Response>(query: AdminQuery<Response, Result>, callback: (data: Result) => void): Promise<void>;
+    /**
+     * List the names of the rule parameters defined by the admin server. This can be
+     * used in some advanced use cases to confirm that the parameters a client wishes to
+     * reference are available.
+     *
+     * Only defined for remote clients.
+     */
+    getRuleParameterKeys(): Promise<string[]>;
+}
+//# sourceMappingURL=admin-client.d.ts.map

package/dist/client/admin-client.d.ts.map

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

package/dist/client/admin-client.js

@@ -0,0 +1,511 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminClient = exports.GraphQLError = exports.RequestError = exports.ConnectionError = void 0;
+exports.resetAdminServer = resetAdminServer;
+const _ = require("lodash");
+const events_1 = require("events");
+const DuplexPair = require("native-duplexpair");
+const typed_error_1 = require("typed-error");
+const CrossFetch = require("cross-fetch");
+const WebSocket = require("isomorphic-ws");
+const connectWebSocketStream = require("@httptoolkit/websocket-stream");
+const subscriptions_transport_ws_1 = require("@httptoolkit/subscriptions-transport-ws");
+const graphql_1 = require("graphql");
+const types_1 = require("../types");
+const util_1 = require("../util/util");
+const error_1 = require("../util/error");
+const promise_1 = require("../util/promise");
+const schema_introspection_1 = require("./schema-introspection");
+const schema_introspection_2 = require("./schema-introspection");
+const admin_query_1 = require("./admin-query");
+const { fetch, Headers } = util_1.isNode || typeof globalThis.fetch === 'undefined'
+    ? CrossFetch
+    : globalThis;
+class ConnectionError extends typed_error_1.TypedError {
+}
+exports.ConnectionError = ConnectionError;
+class RequestError extends typed_error_1.TypedError {
+    constructor(message, response) {
+        super(message);
+        this.response = response;
+    }
+}
+exports.RequestError = RequestError;
+class GraphQLError extends RequestError {
+    constructor(response, errors) {
+        super(errors.length === 0
+            ? `GraphQL request failed with ${response.status} response`
+            : errors.length === 1
+                ? `GraphQL request failed with: ${errors[0].message}`
+                : // >1
+                    `GraphQL request failed, with errors:\n${errors.map((e) => e.message).join('\n')}`, response);
+        this.errors = errors;
+    }
+}
+exports.GraphQLError = GraphQLError;
+const mergeClientOptions = (options, defaultOptions) => {
+    if (!defaultOptions)
+        return options;
+    if (!options)
+        return defaultOptions;
+    if (defaultOptions.headers) {
+        if (!options.headers) {
+            options.headers = defaultOptions.headers;
+        }
+        else if (options.headers instanceof Headers) {
+            _.forEach(defaultOptions.headers, (value, key) => {
+                options.headers.append(key, value);
+            });
+        }
+        else if (_.isObject(options.headers)) {
+            Object.assign(options.headers, defaultOptions.headers);
+        }
+    }
+    return options;
+};
+async function requestFromAdminServer(serverUrl, path, options) {
+    const url = `${serverUrl}${path}`;
+    let response;
+    try {
+        response = await fetch(url, options);
+    }
+    catch (e) {
+        if ((0, error_1.isErrorLike)(e) && e.code === 'ECONNREFUSED') {
+            throw new ConnectionError(`Failed to connect to admin server at ${serverUrl}`);
+        }
+        else
+            throw e;
+    }
+    if (response.status >= 400) {
+        let body = await response.text();
+        let jsonBody = null;
+        try {
+            jsonBody = JSON.parse(body);
+        }
+        catch (e) { }
+        if (jsonBody && jsonBody.error) {
+            throw new RequestError(jsonBody.error, response);
+        }
+        else {
+            throw new RequestError(`Request to ${url} failed, with status ${response.status} and response body: ${body}`, response);
+        }
+    }
+    else {
+        return response.json();
+    }
+}
+/**
+ * Reset a remote admin server, shutting down all Mockttp servers controlled by that
+ * admin server. This is equivalent to calling `client.stop()` for all remote
+ * clients of the target server.
+ *
+ * This can be useful in some rare cases, where a client might fail to reliably tear down
+ * its own server, e.g. in Cypress testing. In this case, it's useful to reset the
+ * admin server completely remotely without needing access to any previous client
+ * instances, to ensure all servers from previous test runs have been shut down.
+ *
+ * After this is called, behaviour of any previously connected clients is undefined, and
+ * it's likely that they may throw errors or experience other undefined behaviour. Ensure
+ * that `client.stop()` has been called on all active clients before calling this method.
+ */
+async function resetAdminServer(options = {}) {
+    const serverUrl = options.adminServerUrl ||
+        `http://localhost:${types_1.DEFAULT_ADMIN_SERVER_PORT}`;
+    await requestFromAdminServer(serverUrl, '/reset', {
+        ...options.requestOptions,
+        method: 'POST'
+    });
+}
+/**
+ * A bare admin server client. This is not intended for general use, but can be useful when
+ * building admin server plugins to mock non-HTTP protocols and other advanced use cases.
+ *
+ * For normal usage of Mockttp, you should use `Mockttp.getRemote()` instead, to get a Mockttp
+ * remote client, which wraps this class with the full Mockttp API for mocking HTTP.
+ *
+ * This is part of Mockttp's experimental 'pluggable admin' API. It may change
+ * unpredictably, even in minor releases.
+ */
+class AdminClient extends events_1.EventEmitter {
+    constructor(options = {}) {
+        super();
+        this.debug = false;
+        // True if server is entirely initialized, false if it's entirely shut down, or a promise
+        // that resolves to one or the other if it's currently changing state.
+        this.running = false;
+        this.enableDebug = async () => {
+            this.debug = true;
+            return (await this.queryMockServer(`mutation EnableDebug {
+                enableDebug
+            }`));
+        };
+        this.reset = async () => {
+            return (await this.queryMockServer(`mutation Reset {
+                reset
+            }`));
+        };
+        this.debug = !!options.debug;
+        this.adminClientOptions = _.defaults(options, {
+            adminServerUrl: `http://localhost:${types_1.DEFAULT_ADMIN_SERVER_PORT}`
+        });
+    }
+    attachStreamWebsocket(adminSessionBaseUrl, targetStream) {
+        const adminSessionBaseWSUrl = adminSessionBaseUrl.replace(/^http/, 'ws');
+        const wsStream = connectWebSocketStream(`${adminSessionBaseWSUrl}/stream`, {
+            headers: this.adminClientOptions?.requestOptions?.headers // Only used in Node.js (via WS)
+        });
+        let streamConnected = false;
+        wsStream.on('connect', () => {
+            streamConnected = true;
+            targetStream.pipe(wsStream);
+            wsStream.pipe(targetStream, { end: false });
+        });
+        // We ignore errors, but websocket closure eventually results in reconnect or shutdown
+        wsStream.on('error', (e) => {
+            if (this.debug)
+                console.warn('Admin client stream error', e);
+            this.emit('stream-error', e);
+        });
+        // When the websocket closes (after connect, either close frame, error, or socket shutdown):
+        wsStream.on('ws-close', async (closeEvent) => {
+            targetStream.unpipe(wsStream);
+            const serverShutdown = closeEvent.code === 1000;
+            if (serverShutdown) {
+                // Clean shutdown implies the server is gone, and we need to shutdown & cleanup.
+                targetStream.emit('server-shutdown');
+            }
+            else if (streamConnected && (await this.running) === true) {
+                console.warn('Admin client stream unexpectedly disconnected', closeEvent);
+                this.emit('stream-reconnecting');
+                // Unclean shutdown means something has gone wrong somewhere. Try to reconnect.
+                const newStream = this.attachStreamWebsocket(adminSessionBaseUrl, targetStream);
+                new Promise((resolve, reject) => {
+                    newStream.once('connect', resolve);
+                    newStream.once('error', reject);
+                }).then(() => {
+                    // On a successful connect, business resumes as normal.
+                    console.warn('Admin client stream reconnected');
+                    this.emit('stream-reconnected');
+                }).catch((err) => {
+                    // On a failed reconnect, we just shut down completely.
+                    console.warn('Admin client stream reconnection failed, shutting down:', err.message);
+                    if (this.debug)
+                        console.warn(err);
+                    this.emit('stream-reconnect-failed', err);
+                    targetStream.emit('server-shutdown');
+                });
+            }
+            // If never connected successfully, we do nothing.
+        });
+        targetStream.on('finish', () => {
+            // Ignore any further WebSocket events - the websocket stream is no longer useful
+            wsStream.removeAllListeners('connect');
+            wsStream.removeAllListeners('ws-close');
+            wsStream.destroy();
+        });
+        return wsStream;
+    }
+    openStreamToMockServer(adminSessionBaseUrl) {
+        // To allow reconnects, we need to not end the client stream when an individual web socket ends.
+        // To make that work, we return a separate stream, which isn't directly connected to the websocket
+        // and doesn't receive WS 'end' events, and then we can swap the WS inputs accordingly.
+        const { socket1: wsTarget, socket2: exposedStream } = new DuplexPair();
+        const wsStream = this.attachStreamWebsocket(adminSessionBaseUrl, wsTarget);
+        wsTarget.on('error', (e) => exposedStream.emit('error', e));
+        // When the server stream ends, end the target stream, which will automatically end all websockets.
+        exposedStream.on('finish', () => wsTarget.end());
+        // Propagate 'server is definitely no longer available' back from the websockets:
+        wsTarget.on('server-shutdown', () => exposedStream.emit('server-shutdown'));
+        // These receive a lot of listeners! One channel per matcher, handler & completion checker,
+        // and each adds listeners for data/error/finish/etc. That's OK, it's not generally a leak,
+        // but maybe 100 would be a bit suspicious (unless you have 30+ active rules).
+        exposedStream.setMaxListeners(100);
+        return new Promise((resolve, reject) => {
+            wsStream.once('connect', () => resolve(exposedStream));
+            wsStream.once('error', reject);
+        });
+    }
+    prepareSubscriptionClientToAdminServer(adminSessionBaseUrl) {
+        const adminSessionBaseWSUrl = adminSessionBaseUrl.replace(/^http/, 'ws');
+        const subscriptionUrl = `${adminSessionBaseWSUrl}/subscription`;
+        this.subscriptionClient = new subscriptions_transport_ws_1.SubscriptionClient(subscriptionUrl, {
+            lazy: true, // Doesn't actually connect until you use subscriptions
+            reconnect: true,
+            reconnectionAttempts: 8,
+            wsOptionArguments: [this.adminClientOptions.requestOptions]
+        }, WebSocket);
+        this.subscriptionClient.onError((e) => {
+            this.emit('subscription-error', e);
+            if (this.debug)
+                console.error("Subscription error", e);
+        });
+        this.subscriptionClient.onReconnecting(() => {
+            this.emit('subscription-reconnecting');
+            console.warn('Reconnecting Mockttp subscription client');
+        });
+    }
+    async requestFromMockServer(path, options) {
+        // Must check for session URL, not this.running, or we can't send the /stop request during shutdown!
+        if (!this.adminSessionBaseUrl)
+            throw new Error('Not connected to mock server');
+        let url = this.adminSessionBaseUrl + path;
+        let response = await fetch(url, mergeClientOptions(options, this.adminClientOptions.requestOptions));
+        if (response.status >= 400) {
+            if (this.debug)
+                console.error(`Remote client server request failed with status ${response.status}`);
+            throw new RequestError(`Request to ${url} failed, with status ${response.status}`, response);
+        }
+        else {
+            return response;
+        }
+    }
+    async queryMockServer(query, variables) {
+        try {
+            const response = (await this.requestFromMockServer('/', {
+                method: 'POST',
+                headers: new Headers({
+                    'Content-Type': 'application/json'
+                }),
+                body: JSON.stringify({ query, variables })
+            }));
+            const { data, errors } = await response.json();
+            if (errors && errors.length) {
+                throw new GraphQLError(response, errors);
+            }
+            else {
+                return data;
+            }
+        }
+        catch (e) {
+            if (this.debug)
+                console.error(`Remote client query error: ${e}`);
+            if (!(e instanceof RequestError))
+                throw e;
+            let graphQLErrors = undefined;
+            try {
+                graphQLErrors = (await e.response.json()).errors;
+            }
+            catch (e2) { }
+            if (graphQLErrors) {
+                throw new GraphQLError(e.response, graphQLErrors);
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+    async start(pluginStartParams) {
+        if (this.adminSessionBaseUrl || await this.running)
+            throw new Error('Server is already started');
+        if (this.debug)
+            console.log(`Starting remote mock server`);
+        this.emit('starting');
+        const startPromise = (0, promise_1.getDeferred)();
+        this.running = startPromise.then((result) => {
+            this.emit(result ? 'started' : 'start-failed');
+            this.running = result;
+            return result;
+        });
+        try {
+            const supportOldServers = 'http' in pluginStartParams;
+            const portConfig = supportOldServers
+                ? pluginStartParams['http'].port
+                : undefined;
+            const path = portConfig ? `/start?port=${JSON.stringify(portConfig)}` : '/start';
+            const adminServerResponse = await requestFromAdminServer(this.adminClientOptions.adminServerUrl, path, mergeClientOptions({
+                method: 'POST',
+                headers: new Headers({
+                    'Content-Type': 'application/json'
+                }),
+                body: JSON.stringify({
+                    plugins: pluginStartParams,
+                    // Include all the Mockttp params at the root too, for backward compat with old admin servers:
+                    ...pluginStartParams.http?.options
+                })
+            }, this.adminClientOptions.requestOptions));
+            // Backward compat for old servers
+            const isPluginAwareServer = 'id' in adminServerResponse;
+            const sessionId = isPluginAwareServer
+                ? adminServerResponse.id
+                : adminServerResponse.port.toString();
+            const adminSessionBaseUrl = `${this.adminClientOptions.adminServerUrl}/${isPluginAwareServer ? 'session' : 'server'}/${sessionId}`;
+            // Also open a stream connection, for 2-way communication we might need later.
+            const adminServerStream = await this.openStreamToMockServer(adminSessionBaseUrl);
+            adminServerStream.on('server-shutdown', () => {
+                // When the server remotely disconnects the stream, shut down the client iff the client hasn't
+                // stopped & restarted in the meantime (can happen, since all shutdown is async).
+                if (this.adminServerStream === adminServerStream) {
+                    console.warn('Client stopping due to admin server shutdown');
+                    this.stop();
+                }
+            });
+            this.adminServerStream = adminServerStream;
+            // Create a subscription client, preconfigured & ready to connect if on() is called later:
+            this.prepareSubscriptionClientToAdminServer(adminSessionBaseUrl);
+            // We don't persist the id or resolve the start promise until everything is set up
+            this.adminSessionBaseUrl = adminSessionBaseUrl;
+            // Load the schema on server start, so we can check for feature support
+            this.adminServerSchema = new schema_introspection_2.SchemaIntrospector((await this.queryMockServer(schema_introspection_1.introspectionQuery)).__schema);
+            if (this.debug)
+                console.log('Started remote mock server');
+            const serverMetadata = this.adminServerMetadata = // Set field before we resolve the promise
+                'pluginData' in adminServerResponse
+                    ? adminServerResponse.pluginData
+                    : {
+                        // Backward compat - convert old always-HTTP data into per-plugin format:
+                        http: adminServerResponse
+                    };
+            startPromise.resolve(true);
+            return serverMetadata;
+        }
+        catch (e) {
+            startPromise.resolve(false);
+            throw e;
+        }
+    }
+    isRunning() {
+        return this.running === true;
+    }
+    get metadata() {
+        if (!this.isRunning())
+            throw new Error("Metadata is not available until the mock server is started");
+        return this.adminServerMetadata;
+    }
+    get schema() {
+        if (!this.isRunning())
+            throw new Error("Admin schema is not available until the mock server is started");
+        return this.adminServerSchema;
+    }
+    get adminStream() {
+        if (!this.isRunning())
+            throw new Error("Admin stream is not available until the mock server is started");
+        return this.adminServerStream;
+    }
+    // Call when either we want the server to stop, or it appears that the server has already stopped,
+    // and we just want to ensure that's happened and clean everything up.
+    async stop() {
+        if (await this.running === false)
+            return; // If stopped or stopping, do nothing.
+        this.emit('stopping');
+        const stopPromise = (0, promise_1.getDeferred)();
+        this.running = stopPromise.then((result) => {
+            this.emit('stopped');
+            this.running = result;
+            return result;
+        });
+        try {
+            if (this.debug)
+                console.log('Stopping remote mock server');
+            try {
+                this.subscriptionClient?.close();
+            }
+            catch (e) {
+                console.log(e);
+            }
+            this.subscriptionClient = undefined;
+            try {
+                this.adminServerStream?.end();
+            }
+            catch (e) {
+                console.log(e);
+            }
+            this.adminServerStream = undefined;
+            await this.requestServerStop();
+        }
+        finally {
+            // The client is always stopped (and so restartable) once stopping completes, in all
+            // cases, since it can always be started again to reset it. The promise is just here
+            // so that we successfully handle (and always wait for) parallel stops.
+            stopPromise.resolve(false);
+        }
+    }
+    requestServerStop() {
+        return this.requestFromMockServer('/stop', {
+            method: 'POST'
+        }).catch((e) => {
+            if (e instanceof RequestError && e.response.status === 404) {
+                // 404 means it doesn't exist, generally because it was already stopped
+                // by some other parallel shutdown process.
+                return;
+            }
+            else {
+                throw e;
+            }
+        }).then(() => {
+            this.adminSessionBaseUrl = undefined;
+            this.adminServerSchema = undefined;
+            this.adminServerMetadata = undefined;
+        });
+    }
+    async sendQuery(query) {
+        return (await this.sendQueries(query))[0];
+    }
+    async sendQueries(...queries) {
+        const results = queries.map(async ({ query, variables, transformResponse }) => {
+            const result = await this.queryMockServer((0, graphql_1.print)(query), variables);
+            return transformResponse
+                ? transformResponse(result, { adminClient: this })
+                : result;
+        });
+        return Promise.all(results);
+    }
+    async subscribe(query, callback) {
+        if (await this.running === false)
+            throw new Error('Not connected to mock server');
+        const fieldName = (0, admin_query_1.getSingleSelectedFieldName)(query);
+        if (!this.schema.typeHasField('Subscription', fieldName)) {
+            console.warn(`Ignoring client subscription for event unrecognized by Mockttp server: ${fieldName}`);
+            return Promise.resolve();
+        }
+        // This isn't 100% correct (you can be WS-connected, but still negotiating some GQL
+        // setup) but it's good enough for our purposes (knowing-ish if the connection worked).
+        let isConnected = !!this.subscriptionClient.client;
+        this.subscriptionClient.request(query).subscribe({
+            next: async (value) => {
+                if (value.data) {
+                    const response = value.data[fieldName];
+                    const result = query.transformResponse
+                        ? await query.transformResponse(response, { adminClient: this })
+                        : response;
+                    callback(result);
+                }
+                else if (value.errors) {
+                    console.error('Error in subscription', value.errors);
+                }
+            },
+            error: (e) => this.debug && console.warn('Error in remote subscription:', e)
+        });
+        return new Promise((resolve, reject) => {
+            if (isConnected)
+                resolve();
+            else {
+                this.subscriptionClient.onConnected(resolve);
+                this.subscriptionClient.onDisconnected(reject);
+                this.subscriptionClient.onError(reject);
+            }
+        });
+    }
+    /**
+     * List the names of the rule parameters defined by the admin server. This can be
+     * used in some advanced use cases to confirm that the parameters a client wishes to
+     * reference are available.
+     *
+     * Only defined for remote clients.
+     */
+    async getRuleParameterKeys() {
+        if (await this.running === false) {
+            throw new Error('Cannot query rule parameters before the server is started');
+        }
+        if (!this.schema.queryTypeDefined('ruleParameterKeys')) {
+            // If this endpoint isn't supported, that's because parameters aren't supported
+            // at all, so we can safely report that immediately.
+            return [];
+        }
+        let result = await this.queryMockServer(`query GetRuleParameterNames {
+                ruleParameterKeys
+            }`);
+        return result.ruleParameterKeys;
+    }
+}
+exports.AdminClient = AdminClient;
+//# sourceMappingURL=admin-client.js.map

package/dist/client/admin-client.js.map

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