@forestadmin/gateway 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2021-2026 Forest Admin
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/cli-dispatch.d.ts

@@ -0,0 +1,9 @@
+import type { BFFHttpServer, Logger } from '@forestadmin/agent-bff';
+export declare const USAGE = "Usage: forest-gateway [command]\n\nCommands:\n  (none)      Start the Gateway, configured from the environment.\n              FOREST_GATEWAY_SERVICES lists what it serves: mcp, api or mcp,api.\n  openapi     Write the API's OpenAPI document to stdout, its paths under\n              FOREST_GATEWAY_BASE_PATH/api, its server FOREST_GATEWAY_API_PUBLIC_URL\n              when set.\n              --output [file]  Write to a file instead of stdout, defaulting\n                               to openapi.json in the current directory.\n\nOptions:\n  -h, --help     Show this help and exit.\n  -v, --version  Show the package version and exit.";
+export declare const HINT = "Run 'forest-gateway --help' for usage.";
+export interface DispatchOutcome {
+    exitCode: number;
+    server?: BFFHttpServer;
+}
+export default function dispatchCli(argv: string[], env: NodeJS.ProcessEnv, logger?: Logger): Promise<DispatchOutcome>;
+//# sourceMappingURL=cli-dispatch.d.ts.map

package/dist/cli-dispatch.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HINT = exports.USAGE = void 0;
+exports.default = dispatchCli;
+const agent_bff_1 = require("@forestadmin/agent-bff");
+const gateway_env_1 = require("./gateway-env");
+const run_gateway_1 = __importDefault(require("./run-gateway"));
+const version_1 = __importDefault(require("./version"));
+exports.USAGE = `Usage: forest-gateway [command]
+
+Commands:
+  (none)      Start the Gateway, configured from the environment.
+              FOREST_GATEWAY_SERVICES lists what it serves: mcp, api or mcp,api.
+  openapi     Write the API's OpenAPI document to stdout, its paths under
+              FOREST_GATEWAY_BASE_PATH/api, its server FOREST_GATEWAY_API_PUBLIC_URL
+              when set.
+              --output [file]  Write to a file instead of stdout, defaulting
+                               to ${agent_bff_1.DEFAULT_OUTPUT_FILE} in the current directory.
+
+Options:
+  -h, --help     Show this help and exit.
+  -v, --version  Show the package version and exit.`;
+exports.HINT = "Run 'forest-gateway --help' for usage.";
+const HELP_FLAGS = new Set(['-h', '--help']);
+const VERSION_FLAGS = new Set(['-v', '--version']);
+function rejectCli(reason) {
+    process.stderr.write(`${reason}\n${exports.HINT}\n`);
+    return { exitCode: 1 };
+}
+async function renderGatewayOpenApi(env, logger) {
+    const { basePath, api, warnings } = (0, gateway_env_1.parseOpenApiEnv)(env);
+    warnings.forEach(warning => logger('Warn', warning));
+    return (0, agent_bff_1.renderOpenApi)(api.env, logger, { basePath: (0, gateway_env_1.apiBasePath)(basePath), labels: api.labels });
+}
+async function dispatchCli(argv, env, logger) {
+    const [subcommand, ...rest] = argv;
+    if (subcommand === undefined) {
+        return { exitCode: 0, server: await (0, run_gateway_1.default)(env, logger) };
+    }
+    if (HELP_FLAGS.has(subcommand)) {
+        process.stdout.write(`${exports.USAGE}\n`);
+        return { exitCode: 0 };
+    }
+    if (VERSION_FLAGS.has(subcommand)) {
+        process.stdout.write(`${version_1.default}\n`);
+        return { exitCode: 0 };
+    }
+    if (subcommand !== 'openapi') {
+        return rejectCli(subcommand === agent_bff_1.OUTPUT_FLAG
+            ? `${agent_bff_1.OUTPUT_FLAG} only applies to the openapi command`
+            : `Unknown command: ${subcommand}`);
+    }
+    const { file, extras } = (0, agent_bff_1.parseOutputOption)(rest);
+    if (extras.length > 0) {
+        return rejectCli(`openapi accepts only --output, got: ${extras.map(extra => JSON.stringify(extra)).join(' ')}`);
+    }
+    const document = await renderGatewayOpenApi(env, logger ?? (0, agent_bff_1.createConsoleLogger)());
+    if (file !== undefined) {
+        return (0, agent_bff_1.writeOutputFile)(file, document);
+    }
+    process.stdout.write(document);
+    return { exitCode: 0 };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLWRpc3BhdGNoLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NsaS1kaXNwYXRjaC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFzREEsOEJBZ0RDO0FBcEdELHNEQU9nQztBQUVoQywrQ0FBNkQ7QUFDN0QsZ0VBQXVDO0FBQ3ZDLHdEQUFnQztBQUVuQixRQUFBLEtBQUssR0FBRzs7Ozs7Ozs7O29DQVNlLCtCQUFtQjs7OztvREFJSCxDQUFDO0FBRXhDLFFBQUEsSUFBSSxHQUFHLHdDQUF3QyxDQUFDO0FBRTdELE1BQU0sVUFBVSxHQUFHLElBQUksR0FBRyxDQUFDLENBQUMsSUFBSSxFQUFFLFFBQVEsQ0FBQyxDQUFDLENBQUM7QUFDN0MsTUFBTSxhQUFhLEdBQUcsSUFBSSxHQUFHLENBQUMsQ0FBQyxJQUFJLEVBQUUsV0FBVyxDQUFDLENBQUMsQ0FBQztBQU9uRCxTQUFTLFNBQVMsQ0FBQyxNQUFjO0lBQy9CLE9BQU8sQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLEdBQUcsTUFBTSxLQUFLLFlBQUksSUFBSSxDQUFDLENBQUM7SUFFN0MsT0FBTyxFQUFFLFFBQVEsRUFBRSxDQUFDLEVBQUUsQ0FBQztBQUN6QixDQUFDO0FBRUQsS0FBSyxVQUFVLG9CQUFvQixDQUFDLEdBQXNCLEVBQUUsTUFBYztJQUN4RSxNQUFNLEVBQUUsUUFBUSxFQUFFLEdBQUcsRUFBRSxRQUFRLEVBQUUsR0FBRyxJQUFBLDZCQUFlLEVBQUMsR0FBRyxDQUFDLENBQUM7SUFFekQsUUFBUSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDLENBQUMsQ0FBQztJQUVyRCxPQUFPLElBQUEseUJBQWEsRUFBQyxHQUFHLENBQUMsR0FBRyxFQUFFLE1BQU0sRUFBRSxFQUFFLFFBQVEsRUFBRSxJQUFBLHlCQUFXLEVBQUMsUUFBUSxDQUFDLEVBQUUsTUFBTSxFQUFFLEdBQUcsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDO0FBQ2pHLENBQUM7QUFFYyxLQUFLLFVBQVUsV0FBVyxDQUN2QyxJQUFjLEVBQ2QsR0FBc0IsRUFDdEIsTUFBZTtJQUVmLE1BQU0sQ0FBQyxVQUFVLEVBQUUsR0FBRyxJQUFJLENBQUMsR0FBRyxJQUFJLENBQUM7SUFFbkMsSUFBSSxVQUFVLEtBQUssU0FBUyxFQUFFLENBQUM7UUFDN0IsT0FBTyxFQUFFLFFBQVEsRUFBRSxDQUFDLEVBQUUsTUFBTSxFQUFFLE1BQU0sSUFBQSxxQkFBVSxFQUFDLEdBQUcsRUFBRSxNQUFNLENBQUMsRUFBRSxDQUFDO0lBQ2hFLENBQUM7SUFFRCxJQUFJLFVBQVUsQ0FBQyxHQUFHLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQztRQUMvQixPQUFPLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFHLGFBQUssSUFBSSxDQUFDLENBQUM7UUFFbkMsT0FBTyxFQUFFLFFBQVEsRUFBRSxDQUFDLEVBQUUsQ0FBQztJQUN6QixDQUFDO0lBRUQsSUFBSSxhQUFhLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQUM7UUFDbEMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxpQkFBTyxJQUFJLENBQUMsQ0FBQztRQUVyQyxPQUFPLEVBQUUsUUFBUSxFQUFFLENBQUMsRUFBRSxDQUFDO0lBQ3pCLENBQUM7SUFFRCxJQUFJLFVBQVUsS0FBSyxTQUFTLEVBQUUsQ0FBQztRQUM3QixPQUFPLFNBQVMsQ0FDZCxVQUFVLEtBQUssdUJBQVc7WUFDeEIsQ0FBQyxDQUFDLEdBQUcsdUJBQVcsc0NBQXNDO1lBQ3RELENBQUMsQ0FBQyxvQkFBb0IsVUFBVSxFQUFFLENBQ3JDLENBQUM7SUFDSixDQUFDO0lBRUQsTUFBTSxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsR0FBRyxJQUFBLDZCQUFpQixFQUFDLElBQUksQ0FBQyxDQUFDO0lBRWpELElBQUksTUFBTSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUN0QixPQUFPLFNBQVMsQ0FDZCx1Q0FBdUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FDOUYsQ0FBQztJQUNKLENBQUM7SUFFRCxNQUFNLFFBQVEsR0FBRyxNQUFNLG9CQUFvQixDQUFDLEdBQUcsRUFBRSxNQUFNLElBQUksSUFBQSwrQkFBbUIsR0FBRSxDQUFDLENBQUM7SUFFbEYsSUFBSSxJQUFJLEtBQUssU0FBUyxFQUFFLENBQUM7UUFDdkIsT0FBTyxJQUFBLDJCQUFlLEVBQUMsSUFBSSxFQUFFLFFBQVEsQ0FBQyxDQUFDO0lBQ3pDLENBQUM7SUFFRCxPQUFPLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUUvQixPQUFPLEVBQUUsUUFBUSxFQUFFLENBQUMsRUFBRSxDQUFDO0FBQ3pCLENBQUMifQ==

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* istanbul ignore file */
+const cli_dispatch_1 = __importDefault(require("./cli-dispatch"));
+if (require.main === module) {
+    (0, cli_dispatch_1.default)(process.argv.slice(2), process.env)
+        .then(({ exitCode }) => {
+        if (exitCode !== 0)
+            process.exitCode = exitCode;
+    })
+        .catch(error => {
+        process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFDQSwwQkFBMEI7QUFDMUIsa0VBQXlDO0FBRXpDLElBQUksT0FBTyxDQUFDLElBQUksS0FBSyxNQUFNLEVBQUUsQ0FBQztJQUM1QixJQUFBLHNCQUFXLEVBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQztTQUM1QyxJQUFJLENBQUMsQ0FBQyxFQUFFLFFBQVEsRUFBRSxFQUFFLEVBQUU7UUFDckIsSUFBSSxRQUFRLEtBQUssQ0FBQztZQUFFLE9BQU8sQ0FBQyxRQUFRLEdBQUcsUUFBUSxDQUFDO0lBQ2xELENBQUMsQ0FBQztTQUNELEtBQUssQ0FBQyxLQUFLLENBQUMsRUFBRTtRQUNiLE9BQU8sQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLFVBQVUsS0FBSyxZQUFZLEtBQUssQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUMzRixPQUFPLENBQUMsUUFBUSxHQUFHLENBQUMsQ0FBQztJQUN2QixDQUFDLENBQUMsQ0FBQztBQUNQLENBQUMifQ==

package/dist/env-aliases.d.ts

@@ -0,0 +1,15 @@
+export interface Resolution {
+    key: string;
+    value?: string;
+}
+export interface ResolveOptions {
+    blankIsSet?: boolean;
+}
+export default class EnvAliases {
+    private readonly env;
+    readonly warnings: string[];
+    constructor(env: NodeJS.ProcessEnv);
+    resolve(name: string, aliases?: readonly string[], { blankIsSet }?: ResolveOptions): Resolution;
+    ignore(keys: readonly string[], reason: string): void;
+}
+//# sourceMappingURL=env-aliases.d.ts.map

package/dist/env-aliases.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const agent_bff_1 = require("@forestadmin/agent-bff");
+function isSet(value) {
+    return value !== undefined && value.trim() !== '';
+}
+function isNonEmpty(value) {
+    return value !== undefined && value !== '';
+}
+class EnvAliases {
+    constructor(env) {
+        this.env = env;
+        this.warnings = [];
+    }
+    resolve(name, aliases = [], { blankIsSet = false } = {}) {
+        const isUsed = blankIsSet ? isNonEmpty : isSet;
+        const usedAliases = aliases.filter(alias => isUsed(this.env[alias]));
+        if (isUsed(this.env[name])) {
+            usedAliases.forEach(alias => this.warnings.push(`${alias} is ignored: ${name} is set`));
+            return { key: name, value: this.env[name] };
+        }
+        if (new Set(usedAliases.map(alias => this.env[alias]?.trim())).size > 1) {
+            throw new agent_bff_1.ConfigurationError(`${usedAliases.join(' and ')} disagree: set ${name} to the value the Gateway should use.`);
+        }
+        usedAliases.forEach(alias => this.warnings.push(`${alias} is a legacy name: use ${name} instead`));
+        return usedAliases.length > 0
+            ? { key: usedAliases[0], value: this.env[usedAliases[0]] }
+            : { key: name };
+    }
+    ignore(keys, reason) {
+        keys
+            .filter(key => isSet(this.env[key]))
+            .forEach(key => this.warnings.push(`${key} is ignored: ${reason}`));
+    }
+}
+exports.default = EnvAliases;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW52LWFsaWFzZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZW52LWFsaWFzZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSxzREFBNEQ7QUFXNUQsU0FBUyxLQUFLLENBQUMsS0FBeUI7SUFDdEMsT0FBTyxLQUFLLEtBQUssU0FBUyxJQUFJLEtBQUssQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLENBQUM7QUFDcEQsQ0FBQztBQUVELFNBQVMsVUFBVSxDQUFDLEtBQXlCO0lBQzNDLE9BQU8sS0FBSyxLQUFLLFNBQVMsSUFBSSxLQUFLLEtBQUssRUFBRSxDQUFDO0FBQzdDLENBQUM7QUFFRCxNQUFxQixVQUFVO0lBRzdCLFlBQTZCLEdBQXNCO1FBQXRCLFFBQUcsR0FBSCxHQUFHLENBQW1CO1FBRjFDLGFBQVEsR0FBYSxFQUFFLENBQUM7SUFFcUIsQ0FBQztJQUV2RCxPQUFPLENBQ0wsSUFBWSxFQUNaLFVBQTZCLEVBQUUsRUFDL0IsRUFBRSxVQUFVLEdBQUcsS0FBSyxLQUFxQixFQUFFO1FBRTNDLE1BQU0sTUFBTSxHQUFHLFVBQVUsQ0FBQyxDQUFDLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUM7UUFDL0MsTUFBTSxXQUFXLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUVyRSxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsQ0FBQztZQUMzQixXQUFXLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsR0FBRyxLQUFLLGdCQUFnQixJQUFJLFNBQVMsQ0FBQyxDQUFDLENBQUM7WUFFeEYsT0FBTyxFQUFFLEdBQUcsRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztRQUM5QyxDQUFDO1FBRUQsSUFBSSxJQUFJLEdBQUcsQ0FBQyxXQUFXLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQ3hFLE1BQU0sSUFBSSw4QkFBa0IsQ0FDMUIsR0FBRyxXQUFXLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxrQkFBa0IsSUFBSSx1Q0FBdUMsQ0FDMUYsQ0FBQztRQUNKLENBQUM7UUFFRCxXQUFXLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQzFCLElBQUksQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEdBQUcsS0FBSywwQkFBMEIsSUFBSSxVQUFVLENBQUMsQ0FDckUsQ0FBQztRQUVGLE9BQU8sV0FBVyxDQUFDLE1BQU0sR0FBRyxDQUFDO1lBQzNCLENBQUMsQ0FBQyxFQUFFLEdBQUcsRUFBRSxXQUFXLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLElBQUksQ0FBQyxHQUFHLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUU7WUFDMUQsQ0FBQyxDQUFDLEVBQUUsR0FBRyxFQUFFLElBQUksRUFBRSxDQUFDO0lBQ3BCLENBQUM7SUFFRCxNQUFNLENBQUMsSUFBdUIsRUFBRSxNQUFjO1FBQzVDLElBQUk7YUFDRCxNQUFNLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDO2FBQ25DLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEdBQUcsR0FBRyxnQkFBZ0IsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBQ3hFLENBQUM7Q0FDRjtBQXZDRCw2QkF1Q0MifQ==

package/dist/gateway-env.d.ts

@@ -0,0 +1,42 @@
+import type { ConfigLabels } from '@forestadmin/agent-bff';
+import type { McpEnv, McpEnvLabels } from '@forestadmin/mcp-server';
+export type Service = 'mcp' | 'api';
+export declare const SERVICES: readonly Service[];
+export declare const SERVICES_VAR = "FOREST_GATEWAY_SERVICES";
+export declare const BASE_PATH_VAR = "FOREST_GATEWAY_BASE_PATH";
+export declare const PUBLIC_URL_VAR = "FOREST_GATEWAY_URL";
+export declare const PORT_VAR = "PORT";
+export declare const AGENT_URL_VAR = "FOREST_AGENT_URL";
+export declare const API_PUBLIC_URL_VAR = "FOREST_GATEWAY_API_PUBLIC_URL";
+export declare const ALLOWED_OAUTH_CLIENTS_VAR = "FOREST_GATEWAY_ALLOWED_OAUTH_CLIENTS";
+export declare const DEFAULT_MCP_PORT = 3931;
+export declare const DEFAULT_API_PORT = 3450;
+export interface McpSettings {
+    env: McpEnv;
+    labels: Partial<McpEnvLabels>;
+}
+export interface ApiSettings {
+    env: NodeJS.ProcessEnv;
+    labels: ConfigLabels;
+    allowedOAuthClients?: string[];
+}
+export interface GatewayEnv {
+    services: Set<Service>;
+    basePath: string;
+    port: number;
+    publicUrl?: string;
+    mcp?: McpSettings;
+    api?: ApiSettings;
+    warnings: string[];
+}
+export interface OpenApiEnv {
+    basePath: string;
+    api: ApiSettings;
+    warnings: string[];
+}
+export declare function parseServices(raw: string | undefined): Set<Service>;
+export declare function apiBasePath(basePath: string): string;
+export declare function parseOpenApiEnv(env: NodeJS.ProcessEnv): OpenApiEnv;
+export declare function resolveListenPort(env: NodeJS.ProcessEnv): number;
+export default function parseGatewayEnv(env: NodeJS.ProcessEnv): GatewayEnv;
+//# sourceMappingURL=gateway-env.d.ts.map

package/dist/gateway-env.js

@@ -0,0 +1,181 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_API_PORT = exports.DEFAULT_MCP_PORT = exports.ALLOWED_OAUTH_CLIENTS_VAR = exports.API_PUBLIC_URL_VAR = exports.AGENT_URL_VAR = exports.PORT_VAR = exports.PUBLIC_URL_VAR = exports.BASE_PATH_VAR = exports.SERVICES_VAR = exports.SERVICES = void 0;
+exports.parseServices = parseServices;
+exports.apiBasePath = apiBasePath;
+exports.parseOpenApiEnv = parseOpenApiEnv;
+exports.resolveListenPort = resolveListenPort;
+exports.default = parseGatewayEnv;
+const agent_bff_1 = require("@forestadmin/agent-bff");
+const forestadmin_client_1 = require("@forestadmin/forestadmin-client");
+const mcp_server_1 = require("@forestadmin/mcp-server");
+const env_aliases_1 = __importDefault(require("./env-aliases"));
+exports.SERVICES = ['mcp', 'api'];
+exports.SERVICES_VAR = 'FOREST_GATEWAY_SERVICES';
+exports.BASE_PATH_VAR = 'FOREST_GATEWAY_BASE_PATH';
+exports.PUBLIC_URL_VAR = 'FOREST_GATEWAY_URL';
+exports.PORT_VAR = 'PORT';
+exports.AGENT_URL_VAR = 'FOREST_AGENT_URL';
+exports.API_PUBLIC_URL_VAR = 'FOREST_GATEWAY_API_PUBLIC_URL';
+exports.ALLOWED_OAUTH_CLIENTS_VAR = 'FOREST_GATEWAY_ALLOWED_OAUTH_CLIENTS';
+const API_VAR_PREFIX = 'FOREST_GATEWAY_API_';
+const BFF_VAR_PREFIX = 'BFF_';
+const BFF_LISTENER_ENV = {
+    port: 'HTTP_PORT',
+    publicUrl: 'BFF_PUBLIC_URL',
+};
+const PORT_ALIASES = [mcp_server_1.MCP_LISTENER_ENV.port, BFF_LISTENER_ENV.port];
+const PUBLIC_URL_ALIASES = [mcp_server_1.MCP_LISTENER_ENV.publicUrl];
+const AGENT_URL_ALIASES = ['AGENT_URL'];
+const ALLOWED_OAUTH_CLIENTS_ALIASES = ['FOREST_MCP_ALLOWED_OAUTH_CLIENTS'];
+const MCP_LABELS = {
+    accessTokenTtl: 'FOREST_MCP_ACCESS_TOKEN_TTL_SECONDS',
+    refreshTokenTtl: 'FOREST_MCP_REFRESH_TOKEN_TTL_SECONDS',
+};
+exports.DEFAULT_MCP_PORT = 3931;
+exports.DEFAULT_API_PORT = 3450;
+const MAX_PORT = 65535;
+const DECIMAL_INTEGER = /^\d+$/;
+const HTTP_PROTOCOLS = ['http:', 'https:'];
+function isService(value) {
+    return exports.SERVICES.includes(value);
+}
+function parseServices(raw) {
+    const entries = (raw ?? '')
+        .split(',')
+        .map(entry => entry.trim())
+        .filter(entry => entry !== '');
+    if (entries.length === 0 || !entries.every(isService)) {
+        throw new agent_bff_1.ConfigurationError(`Invalid ${exports.SERVICES_VAR} "${raw ?? ''}": list the services to serve, ` +
+            `among ${exports.SERVICES.map(service => `"${service}"`).join(', ')} (e.g. "mcp,api").`);
+    }
+    return new Set(entries);
+}
+function apiBasePath(basePath) {
+    return `${basePath}/api`;
+}
+function parsePort({ key, value }, fallback) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return fallback;
+    const port = DECIMAL_INTEGER.test(trimmed) ? Number(trimmed) : NaN;
+    if (Number.isNaN(port) || port > MAX_PORT) {
+        throw new agent_bff_1.ConfigurationError(`Invalid ${key} "${value}": expected an integer between 0 and ${MAX_PORT}.`);
+    }
+    return port;
+}
+function parseGatewayUrl({ key, value }) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return undefined;
+    const parsed = URL.canParse(trimmed) ? new URL(trimmed) : undefined;
+    const isBareHttpOrigin = parsed && HTTP_PROTOCOLS.includes(parsed.protocol) && parsed.href === `${parsed.origin}/`;
+    if (!isBareHttpOrigin) {
+        throw new agent_bff_1.ConfigurationError(`Invalid ${key}: expected an http(s) origin with no path, query, fragment or ` +
+            'credentials, e.g. https://gateway.example.com');
+    }
+    return parsed.origin;
+}
+function assertAgentUrl({ key, value }) {
+    if (value === undefined)
+        return;
+    const parsed = !/\s/.test(value) && URL.canParse(value) ? new URL(value) : undefined;
+    if (!parsed || !HTTP_PROTOCOLS.includes(parsed.protocol) || parsed.search || parsed.hash) {
+        throw new agent_bff_1.ConfigurationError(`Invalid ${key}: expected an absolute http(s) URL with no query string or fragment.`);
+    }
+}
+function parseAllowedOAuthClients({ key, value }) {
+    if (value === undefined)
+        return undefined;
+    return (0, forestadmin_client_1.normalizeDomainList)((0, forestadmin_client_1.parseDomainList)(value) ?? [], key);
+}
+function assertApiPublicUrl(value, key, basePath) {
+    const url = (0, agent_bff_1.parsePublicUrl)(value, key);
+    const suffix = apiBasePath(basePath);
+    if (url !== undefined && !new URL(url).pathname.endsWith(suffix)) {
+        throw new agent_bff_1.ConfigurationError(`Invalid configuration: ${key} must end with ${suffix}, where the Gateway serves the API.`);
+    }
+}
+function resolveApi(env, aliases, basePath, agentUrl) {
+    const apiEnv = {
+        ...env,
+        AGENT_URL: agentUrl.value,
+        [BFF_LISTENER_ENV.port]: undefined,
+    };
+    const labels = { AGENT_URL: agentUrl.key };
+    const bffKeys = agent_bff_1.CONFIG_KEYS.filter((key) => key.startsWith(BFF_VAR_PREFIX));
+    for (const bffKey of bffKeys) {
+        const { key, value } = aliases.resolve(`${API_VAR_PREFIX}${bffKey.slice(BFF_VAR_PREFIX.length)}`, [bffKey]);
+        apiEnv[bffKey] = value;
+        labels[bffKey] = key;
+    }
+    assertApiPublicUrl(apiEnv.BFF_PUBLIC_URL, labels.BFF_PUBLIC_URL ?? exports.API_PUBLIC_URL_VAR, basePath);
+    return { env: apiEnv, labels };
+}
+function resolveAgentUrl(aliases, withApi) {
+    if (!withApi) {
+        aliases.ignore(AGENT_URL_ALIASES, `the api service is off: use ${exports.AGENT_URL_VAR}`);
+    }
+    const agentUrl = aliases.resolve(exports.AGENT_URL_VAR, withApi ? AGENT_URL_ALIASES : []);
+    assertAgentUrl(agentUrl);
+    return agentUrl;
+}
+function parseOpenApiEnv(env) {
+    const basePath = (0, mcp_server_1.normalizeMountPath)(env[exports.BASE_PATH_VAR], exports.BASE_PATH_VAR);
+    const aliases = new env_aliases_1.default(env);
+    const api = resolveApi(env, aliases, basePath, resolveAgentUrl(aliases, true));
+    return { basePath, api, warnings: aliases.warnings };
+}
+function resolvePort(aliases, withMcp) {
+    return parsePort(aliases.resolve(exports.PORT_VAR, PORT_ALIASES), withMcp ? exports.DEFAULT_MCP_PORT : exports.DEFAULT_API_PORT);
+}
+function resolveListenPort(env) {
+    return resolvePort(new env_aliases_1.default(env), parseServices(env[exports.SERVICES_VAR]).has('mcp'));
+}
+function parseGatewayEnv(env) {
+    const services = parseServices(env[exports.SERVICES_VAR]);
+    const withMcp = services.has('mcp');
+    const withApi = services.has('api');
+    const basePath = (0, mcp_server_1.normalizeMountPath)(env[exports.BASE_PATH_VAR], exports.BASE_PATH_VAR);
+    const aliases = new env_aliases_1.default(env);
+    const port = resolvePort(aliases, withMcp);
+    if (!withMcp) {
+        aliases.ignore([exports.PUBLIC_URL_VAR, ...PUBLIC_URL_ALIASES], `the mcp service is off: the API reads ${exports.API_PUBLIC_URL_VAR}`);
+    }
+    const publicUrl = withMcp
+        ? parseGatewayUrl(aliases.resolve(exports.PUBLIC_URL_VAR, PUBLIC_URL_ALIASES))
+        : undefined;
+    const agentUrl = resolveAgentUrl(aliases, withApi);
+    const allowedOAuthClients = aliases.resolve(exports.ALLOWED_OAUTH_CLIENTS_VAR, ALLOWED_OAUTH_CLIENTS_ALIASES, { blankIsSet: true });
+    const allowedClientDomains = parseAllowedOAuthClients(allowedOAuthClients);
+    if (withMcp && port === 0 && !publicUrl) {
+        throw new agent_bff_1.ConfigurationError(`${exports.PORT_VAR}=0 binds a port chosen by the OS, which cannot be in the url advertised to MCP ` +
+            `clients. Set ${exports.PUBLIC_URL_VAR} to the public url they should use.`);
+    }
+    if (withMcp && !publicUrl) {
+        aliases.warnings.push(`${exports.PUBLIC_URL_VAR} is not set: MCP clients are told http://localhost:${port}`);
+    }
+    const mcp = withMcp
+        ? {
+            env: {
+                ...env,
+                FOREST_AGENT_URL: agentUrl.value,
+                FOREST_MCP_ALLOWED_OAUTH_CLIENTS: allowedOAuthClients.value,
+                [mcp_server_1.MCP_LISTENER_ENV.port]: undefined,
+                [mcp_server_1.MCP_LISTENER_ENV.publicUrl]: undefined,
+            },
+            labels: { ...MCP_LABELS, agentUrl: agentUrl.key },
+        }
+        : undefined;
+    const api = withApi
+        ? {
+            ...resolveApi(env, aliases, basePath, agentUrl),
+            allowedOAuthClients: allowedClientDomains,
+        }
+        : undefined;
+    return { services, basePath, port, publicUrl, mcp, api, warnings: aliases.warnings };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2F0ZXdheS1lbnYuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZ2F0ZXdheS1lbnYudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBOEVBLHNDQWNDO0FBRUQsa0NBRUM7QUEwR0QsMENBTUM7QUFTRCw4Q0FFQztBQUVELGtDQTJEQztBQXBSRCxzREFBeUY7QUFDekYsd0VBQXVGO0FBQ3ZGLHdEQUErRTtBQUUvRSxnRUFBdUM7QUFJMUIsUUFBQSxRQUFRLEdBQXVCLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxDQUFDO0FBRTlDLFFBQUEsWUFBWSxHQUFHLHlCQUF5QixDQUFDO0FBQ3pDLFFBQUEsYUFBYSxHQUFHLDBCQUEwQixDQUFDO0FBQzNDLFFBQUEsY0FBYyxHQUFHLG9CQUFvQixDQUFDO0FBQ3RDLFFBQUEsUUFBUSxHQUFHLE1BQU0sQ0FBQztBQUNsQixRQUFBLGFBQWEsR0FBRyxrQkFBa0IsQ0FBQztBQUNuQyxRQUFBLGtCQUFrQixHQUFHLCtCQUErQixDQUFDO0FBQ3JELFFBQUEseUJBQXlCLEdBQUcsc0NBQXNDLENBQUM7QUFFaEYsTUFBTSxjQUFjLEdBQUcscUJBQXFCLENBQUM7QUFDN0MsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDO0FBRTlCLE1BQU0sZ0JBQWdCLEdBQUc7SUFDdkIsSUFBSSxFQUFFLFdBQVc7SUFDakIsU0FBUyxFQUFFLGdCQUFnQjtDQUNpQixDQUFDO0FBRS9DLE1BQU0sWUFBWSxHQUFHLENBQUMsNkJBQWdCLENBQUMsSUFBSSxFQUFFLGdCQUFnQixDQUFDLElBQUksQ0FBQyxDQUFDO0FBQ3BFLE1BQU0sa0JBQWtCLEdBQUcsQ0FBQyw2QkFBZ0IsQ0FBQyxTQUFTLENBQUMsQ0FBQztBQUN4RCxNQUFNLGlCQUFpQixHQUFHLENBQUMsV0FBVyxDQUFDLENBQUM7QUFDeEMsTUFBTSw2QkFBNkIsR0FBRyxDQUFDLGtDQUFrQyxDQUFDLENBQUM7QUFFM0UsTUFBTSxVQUFVLEdBQTBCO0lBQ3hD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

package/dist/healthcheck.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export default function probeHealth(env: NodeJS.ProcessEnv, timeoutMs?: number): Promise<string | undefined>;
+//# sourceMappingURL=healthcheck.d.ts.map

package/dist/healthcheck.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = probeHealth;
+const http_1 = __importDefault(require("http"));
+const gateway_env_1 = require("./gateway-env");
+const standalone_handler_1 = require("./standalone-handler");
+const HTTP_OK = 200;
+const PROBE_TIMEOUT_MS = 4000;
+async function probeHealth(env, timeoutMs = PROBE_TIMEOUT_MS) {
+    let port;
+    try {
+        port = (0, gateway_env_1.resolveListenPort)(env);
+    }
+    catch (error) {
+        return error.message;
+    }
+    if (port === 0)
+        return 'PORT=0 binds a port chosen by the OS, which cannot be probed';
+    return new Promise(resolve => {
+        const request = http_1.default.get({ host: 'localhost', port, path: standalone_handler_1.HEALTH_PATH, timeout: timeoutMs }, response => {
+            response.resume();
+            resolve(response.statusCode === HTTP_OK
+                ? undefined
+                : `${standalone_handler_1.HEALTH_PATH} on port ${port} answered ${response.statusCode}`);
+        });
+        request.on('timeout', () => request.destroy(new Error(`timed out after ${timeoutMs}ms`)));
+        request.on('error', (error) => resolve(`${standalone_handler_1.HEALTH_PATH} on port ${port}: ${error.code ?? error.message}`));
+    });
+}
+/* istanbul ignore next */
+if (require.main === module) {
+    probeHealth(process.env).then(failure => {
+        if (failure === undefined)
+            return;
+        process.stderr.write(`${failure}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVhbHRoY2hlY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaGVhbHRoY2hlY2sudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBU0EsOEJBZ0NDO0FBeENELGdEQUF3QjtBQUV4QiwrQ0FBa0Q7QUFDbEQsNkRBQW1EO0FBRW5ELE1BQU0sT0FBTyxHQUFHLEdBQUcsQ0FBQztBQUNwQixNQUFNLGdCQUFnQixHQUFHLElBQUksQ0FBQztBQUVmLEtBQUssVUFBVSxXQUFXLENBQ3ZDLEdBQXNCLEVBQ3RCLFNBQVMsR0FBRyxnQkFBZ0I7SUFFNUIsSUFBSSxJQUFZLENBQUM7SUFFakIsSUFBSSxDQUFDO1FBQ0gsSUFBSSxHQUFHLElBQUEsK0JBQWlCLEVBQUMsR0FBRyxDQUFDLENBQUM7SUFDaEMsQ0FBQztJQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7UUFDZixPQUFRLEtBQWUsQ0FBQyxPQUFPLENBQUM7SUFDbEMsQ0FBQztJQUVELElBQUksSUFBSSxLQUFLLENBQUM7UUFBRSxPQUFPLDhEQUE4RCxDQUFDO0lBRXRGLE9BQU8sSUFBSSxPQUFPLENBQUMsT0FBTyxDQUFDLEVBQUU7UUFDM0IsTUFBTSxPQUFPLEdBQUcsY0FBSSxDQUFDLEdBQUcsQ0FDdEIsRUFBRSxJQUFJLEVBQUUsV0FBVyxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsZ0NBQVcsRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFFLEVBQ2xFLFFBQVEsQ0FBQyxFQUFFO1lBQ1QsUUFBUSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ2xCLE9BQU8sQ0FDTCxRQUFRLENBQUMsVUFBVSxLQUFLLE9BQU87Z0JBQzdCLENBQUMsQ0FBQyxTQUFTO2dCQUNYLENBQUMsQ0FBQyxHQUFHLGdDQUFXLFlBQVksSUFBSSxhQUFhLFFBQVEsQ0FBQyxVQUFVLEVBQUUsQ0FDckUsQ0FBQztRQUNKLENBQUMsQ0FDRixDQUFDO1FBRUYsT0FBTyxDQUFDLEVBQUUsQ0FBQyxTQUFTLEVBQUUsR0FBRyxFQUFFLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLEtBQUssQ0FBQyxtQkFBbUIsU0FBUyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDMUYsT0FBTyxDQUFDLEVBQUUsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxLQUE0QixFQUFFLEVBQUUsQ0FDbkQsT0FBTyxDQUFDLEdBQUcsZ0NBQVcsWUFBWSxJQUFJLEtBQUssS0FBSyxDQUFDLElBQUksSUFBSSxLQUFLLENBQUMsT0FBTyxFQUFFLENBQUMsQ0FDMUUsQ0FBQztJQUNKLENBQUMsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQUVELDBCQUEwQjtBQUMxQixJQUFJLE9BQU8sQ0FBQyxJQUFJLEtBQUssTUFBTSxFQUFFLENBQUM7SUFDNUIsV0FBVyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEVBQUU7UUFDdEMsSUFBSSxPQUFPLEtBQUssU0FBUztZQUFFLE9BQU87UUFFbEMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxPQUFPLElBQUksQ0FBQyxDQUFDO1FBQ3JDLE9BQU8sQ0FBQyxRQUFRLEdBQUcsQ0FBQyxDQUFDO0lBQ3ZCLENBQUMsQ0FBQyxDQUFDO0FBQ0wsQ0FBQyJ9

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { default as runGateway, GATEWAY_NAME } from './run-gateway';
+export { default as dispatchCli } from './cli-dispatch';
+export { default as parseGatewayEnv, parseServices, DEFAULT_API_PORT, DEFAULT_MCP_PORT, } from './gateway-env';
+export type { GatewayEnv, Service } from './gateway-env';
+export { GATEWAY_VERSION_HEADER } from './standalone-handler';
+export type { GatewayHealth } from './standalone-handler';
+export { default as version } from './version';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.version = exports.GATEWAY_VERSION_HEADER = exports.DEFAULT_MCP_PORT = exports.DEFAULT_API_PORT = exports.parseServices = exports.parseGatewayEnv = exports.dispatchCli = exports.GATEWAY_NAME = exports.runGateway = void 0;
+var run_gateway_1 = require("./run-gateway");
+Object.defineProperty(exports, "runGateway", { enumerable: true, get: function () { return __importDefault(run_gateway_1).default; } });
+Object.defineProperty(exports, "GATEWAY_NAME", { enumerable: true, get: function () { return run_gateway_1.GATEWAY_NAME; } });
+var cli_dispatch_1 = require("./cli-dispatch");
+Object.defineProperty(exports, "dispatchCli", { enumerable: true, get: function () { return __importDefault(cli_dispatch_1).default; } });
+var gateway_env_1 = require("./gateway-env");
+Object.defineProperty(exports, "parseGatewayEnv", { enumerable: true, get: function () { return __importDefault(gateway_env_1).default; } });
+Object.defineProperty(exports, "parseServices", { enumerable: true, get: function () { return gateway_env_1.parseServices; } });
+Object.defineProperty(exports, "DEFAULT_API_PORT", { enumerable: true, get: function () { return gateway_env_1.DEFAULT_API_PORT; } });
+Object.defineProperty(exports, "DEFAULT_MCP_PORT", { enumerable: true, get: function () { return gateway_env_1.DEFAULT_MCP_PORT; } });
+var standalone_handler_1 = require("./standalone-handler");
+Object.defineProperty(exports, "GATEWAY_VERSION_HEADER", { enumerable: true, get: function () { return standalone_handler_1.GATEWAY_VERSION_HEADER; } });
+var version_1 = require("./version");
+Object.defineProperty(exports, "version", { enumerable: true, get: function () { return __importDefault(version_1).default; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBQUEsNkNBQW9FO0FBQTNELDBIQUFBLE9BQU8sT0FBYztBQUFFLDJHQUFBLFlBQVksT0FBQTtBQUM1QywrQ0FBd0Q7QUFBL0MsNEhBQUEsT0FBTyxPQUFlO0FBQy9CLDZDQUt1QjtBQUpyQiwrSEFBQSxPQUFPLE9BQW1CO0FBQzFCLDRHQUFBLGFBQWEsT0FBQTtBQUNiLCtHQUFBLGdCQUFnQixPQUFBO0FBQ2hCLCtHQUFBLGdCQUFnQixPQUFBO0FBR2xCLDJEQUE4RDtBQUFyRCw0SEFBQSxzQkFBc0IsT0FBQTtBQUUvQixxQ0FBK0M7QUFBdEMsbUhBQUEsT0FBTyxPQUFXIn0=

package/dist/run-gateway.d.ts

@@ -0,0 +1,6 @@
+import type { Logger } from '@forestadmin/agent-bff';
+import { BFFHttpServer } from '@forestadmin/agent-bff';
+export declare const GATEWAY_NAME = "Forest Gateway";
+export declare const GATEWAY_API_NAME = "Gateway API";
+export default function runGateway(env: NodeJS.ProcessEnv, logger?: Logger): Promise<BFFHttpServer>;
+//# sourceMappingURL=run-gateway.d.ts.map

package/dist/run-gateway.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GATEWAY_API_NAME = exports.GATEWAY_NAME = void 0;
+exports.default = runGateway;
+const agent_bff_1 = require("@forestadmin/agent-bff");
+const mcp_server_1 = require("@forestadmin/mcp-server");
+const gateway_env_1 = __importStar(require("./gateway-env"));
+const standalone_handler_1 = __importStar(require("./standalone-handler"));
+const version_1 = __importDefault(require("./version"));
+exports.GATEWAY_NAME = 'Forest Gateway';
+exports.GATEWAY_API_NAME = 'Gateway API';
+const MCP_REQUIRED_VARS = ['FOREST_ENV_SECRET', 'FOREST_AUTH_SECRET'];
+function missingMcpVars(env) {
+    return MCP_REQUIRED_VARS.filter(name => !env[name]?.trim());
+}
+async function buildMcpService(settings, gateway, logger) {
+    const { options, uploadStorageModule } = (0, mcp_server_1.parseMcpEnv)(settings.env, settings.labels);
+    const missing = missingMcpVars(settings.env);
+    if (missing.length > 0) {
+        logger('Error', 'The MCP service is not configured and answers 503 until restart', {
+            missing,
+        });
+        return { handler: (0, standalone_handler_1.createUnavailableMcpHandler)(gateway.basePath), health: 'degraded' };
+    }
+    const fileUploads = await (0, mcp_server_1.loadFileUploads)(uploadStorageModule);
+    const server = new mcp_server_1.ForestMCPServer({
+        ...options,
+        ...(fileUploads !== undefined && { fileUploads }),
+        basePath: gateway.basePath,
+        logger: (level, message) => logger(level, `[MCP] ${message}`),
+    });
+    const baseUrl = new URL(gateway.publicUrl ?? `http://localhost:${gateway.port}`);
+    return {
+        handler: {
+            matches: (0, mcp_server_1.makeIsMcpRoute)(gateway.basePath),
+            callback: await server.getHttpCallback(baseUrl),
+        },
+        health: 'ok',
+    };
+}
+async function buildApiService(settings, gateway, logger) {
+    const config = (0, agent_bff_1.parseConfig)(settings.env, settings.labels);
+    const bff = await (0, agent_bff_1.buildBff)({
+        config,
+        logger,
+        basePath: (0, gateway_env_1.apiBasePath)(gateway.basePath),
+        gatewayVersion: version_1.default,
+        labels: settings.labels,
+        name: exports.GATEWAY_API_NAME,
+        allowedOAuthClients: settings.allowedOAuthClients,
+    });
+    if (!bff.health().configured.oauth) {
+        logger('Warn', `API sign-in (${gateway.basePath}/oauth/*?service=api) is off`, {
+            ...(!config.tokenEncryptionKey && { set: settings.labels.BFF_TOKEN_ENCRYPTION_KEY }),
+        });
+    }
+    return {
+        handler: {
+            matches: pathname => (0, agent_bff_1.claimsBffPath)(pathname, { docs: config.openapiEnabled }),
+            callback: bff.callback,
+        },
+        bff,
+    };
+}
+function apiHealthOf(api) {
+    if (!api)
+        return 'disabled';
+    const { status, configured } = api.bff.health();
+    return { status, configured };
+}
+function logRoutes(gateway, mcp, api, logger) {
+    const prefix = gateway.basePath;
+    if (mcp) {
+        logger('Info', `MCP service on ${prefix}/mcp`, {
+            oauth: `${prefix}/oauth/*`,
+            discovery: `/.well-known/oauth-authorization-server${prefix}`,
+            status: mcp.health,
+        });
+    }
+    if (api) {
+        const apiPrefix = (0, gateway_env_1.apiBasePath)(prefix);
+        logger('Info', `API service on ${apiPrefix}/agent/*`, {
+            health: `${apiPrefix}/health`,
+            docs: `${apiPrefix}/docs`,
+            oauth: api.bff.health().configured.oauth ? `${prefix}/oauth/*?service=api` : 'API OAuth off',
+        });
+    }
+    logger('Info', 'Gateway health on /health');
+}
+async function runGateway(env, logger = (0, agent_bff_1.createConsoleLogger)()) {
+    const gateway = (0, gateway_env_1.default)(env);
+    gateway.warnings.forEach(warning => logger('Warn', warning));
+    const mcp = gateway.mcp ? await buildMcpService(gateway.mcp, gateway, logger) : undefined;
+    const api = gateway.api ? await buildApiService(gateway.api, gateway, logger) : undefined;
+    const gatewaySwitch = (0, mcp_server_1.createGatewaySwitch)({
+        basePath: gateway.basePath,
+        mcp: mcp?.handler,
+        api: api?.handler,
+    });
+    const callback = (0, standalone_handler_1.default)({
+        version: version_1.default,
+        gatewaySwitch,
+        health: () => (0, standalone_handler_1.describeGatewayHealth)(version_1.default, mcp?.health ?? 'disabled', apiHealthOf(api)),
+    });
+    const server = new agent_bff_1.BFFHttpServer({
+        port: gateway.port,
+        logger,
+        name: exports.GATEWAY_NAME,
+        callback,
+        drainActivityLogs: api?.bff.drainActivityLogs,
+    });
+    await server.start();
+    (0, agent_bff_1.installShutdownHandlers)(server, logger, { name: exports.GATEWAY_NAME });
+    logRoutes(gateway, mcp, api, logger);
+    return server;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVuLWdhdGV3YXkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcnVuLWdhdGV3YXkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBcUpBLDZCQW9DQztBQXBMRCxzREFPZ0M7QUFDaEMsd0RBTWlDO0FBRWpDLDZEQUE2RDtBQUM3RCwyRUFHOEI7QUFDOUIsd0RBQWdDO0FBRW5CLFFBQUEsWUFBWSxHQUFHLGdCQUFnQixDQUFDO0FBQ2hDLFFBQUEsZ0JBQWdCLEdBQUcsYUFBYSxDQUFDO0FBRTlDLE1BQU0saUJBQWlCLEdBQUcsQ0FBQyxtQkFBbUIsRUFBRSxvQkFBb0IsQ0FBVSxDQUFDO0FBWS9FLFNBQVMsY0FBYyxDQUFDLEdBQXVCO0lBQzdDLE9BQU8saUJBQWlCLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztBQUM5RCxDQUFDO0FBRUQsS0FBSyxVQUFVLGVBQWUsQ0FDNUIsUUFBcUIsRUFDckIsT0FBbUIsRUFDbkIsTUFBYztJQUVkLE1BQU0sRUFBRSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsR0FBRyxJQUFBLHdCQUFXLEVBQUMsUUFBUSxDQUFDLEdBQUcsRUFBRSxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDcEYsTUFBTSxPQUFPLEdBQUcsY0FBYyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUU3QyxJQUFJLE9BQU8sQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDdkIsTUFBTSxDQUFDLE9BQU8sRUFBRSxpRUFBaUUsRUFBRTtZQUNqRixPQUFPO1NBQ1IsQ0FBQyxDQUFDO1FBRUgsT0FBTyxFQUFFLE9BQU8sRUFBRSxJQUFBLGdEQUEyQixFQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsRUFBRSxNQUFNLEVBQUUsVUFBVSxF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

package/dist/standalone-handler.d.ts

@@ -0,0 +1,25 @@
+import type { BffHealth } from '@forestadmin/agent-bff';
+import type { GatewayHandler } from '@forestadmin/mcp-server';
+import type { IncomingMessage, ServerResponse } from 'http';
+export declare const GATEWAY_VERSION_HEADER = "X-Forest-Gateway-Version";
+export declare const HEALTH_PATH = "/health";
+export type McpHealth = 'ok' | 'degraded' | 'disabled';
+export type ApiHealth = Pick<BffHealth, 'status' | 'configured'> | 'disabled';
+export interface GatewayHealth {
+    healthy: boolean;
+    version: string;
+    services: {
+        mcp: McpHealth;
+        api: ApiHealth;
+    };
+}
+export interface StandaloneHandlerOptions {
+    version: string;
+    gatewaySwitch: GatewayHandler;
+    health: () => GatewayHealth;
+}
+export type StandaloneCallback = (req: IncomingMessage, res: ServerResponse) => void;
+export declare function describeGatewayHealth(version: string, mcp: McpHealth, api: ApiHealth): GatewayHealth;
+export declare function createUnavailableMcpHandler(basePath: string): GatewayHandler;
+export default function createStandaloneHandler({ version, gatewaySwitch, health, }: StandaloneHandlerOptions): StandaloneCallback;
+//# sourceMappingURL=standalone-handler.d.ts.map

package/dist/standalone-handler.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEALTH_PATH = exports.GATEWAY_VERSION_HEADER = void 0;
+exports.describeGatewayHealth = describeGatewayHealth;
+exports.createUnavailableMcpHandler = createUnavailableMcpHandler;
+exports.default = createStandaloneHandler;
+const mcp_server_1 = require("@forestadmin/mcp-server");
+exports.GATEWAY_VERSION_HEADER = 'X-Forest-Gateway-Version';
+exports.HEALTH_PATH = '/health';
+const HTTP_OK = 200;
+const HTTP_NOT_FOUND = 404;
+const HTTP_SERVICE_UNAVAILABLE = 503;
+function answerJson(res, status, body) {
+    res.statusCode = status;
+    res.setHeader('Content-Type', 'application/json');
+    res.end(JSON.stringify(body));
+}
+function isHealthRequest(req) {
+    const [pathname] = (req.url ?? '/').split(/[?#]/, 1);
+    return (req.method === 'GET' || req.method === 'HEAD') && pathname === exports.HEALTH_PATH;
+}
+function describeGatewayHealth(version, mcp, api) {
+    const apiDegraded = api !== 'disabled' && api.status === 'degraded';
+    return { healthy: mcp !== 'degraded' && !apiDegraded, version, services: { mcp, api } };
+}
+function createUnavailableMcpHandler(basePath) {
+    return {
+        matches: (0, mcp_server_1.makeIsMcpRoute)(basePath),
+        callback: (_req, res) => answerJson(res, HTTP_SERVICE_UNAVAILABLE, {
+            error: 'service_unavailable',
+            error_description: 'The MCP service is not configured on this Gateway.',
+        }),
+    };
+}
+function createStandaloneHandler({ version, gatewaySwitch, health, }) {
+    return (req, res) => {
+        res.setHeader(exports.GATEWAY_VERSION_HEADER, version);
+        if (isHealthRequest(req)) {
+            const report = health();
+            answerJson(res, report.healthy ? HTTP_OK : HTTP_SERVICE_UNAVAILABLE, report);
+            return;
+        }
+        gatewaySwitch.callback(req, res, () => answerJson(res, HTTP_NOT_FOUND, {
+            error: 'not_found',
+            error_description: 'No Gateway service serves this path.',
+        }));
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhbmRhbG9uZS1oYW5kbGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3N0YW5kYWxvbmUtaGFuZGxlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUEwQ0Esc0RBUUM7QUFFRCxrRUFTQztBQUVELDBDQXVCQztBQWxGRCx3REFBeUQ7QUFFNUMsUUFBQSxzQkFBc0IsR0FBRywwQkFBMEIsQ0FBQztBQUNwRCxRQUFBLFdBQVcsR0FBRyxTQUFTLENBQUM7QUFFckMsTUFBTSxPQUFPLEdBQUcsR0FBRyxDQUFDO0FBQ3BCLE1BQU0sY0FBYyxHQUFHLEdBQUcsQ0FBQztBQUMzQixNQUFNLHdCQUF3QixHQUFHLEdBQUcsQ0FBQztBQW1CckMsU0FBUyxVQUFVLENBQUMsR0FBbUIsRUFBRSxNQUFjLEVBQUUsSUFBYTtJQUNwRSxHQUFHLENBQUMsVUFBVSxHQUFHLE1BQU0sQ0FBQztJQUN4QixHQUFHLENBQUMsU0FBUyxDQUFDLGNBQWMsRUFBRSxrQkFBa0IsQ0FBQyxDQUFDO0lBQ2xELEdBQUcsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDO0FBQ2hDLENBQUM7QUFFRCxTQUFTLGVBQWUsQ0FBQyxHQUFvQjtJQUMzQyxNQUFNLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsR0FBRyxJQUFJLEdBQUcsQ0FBQyxDQUFDLEtBQUssQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFFckQsT0FBTyxDQUFDLEdBQUcsQ0FBQyxNQUFNLEtBQUssS0FBSyxJQUFJLEdBQUcsQ0FBQyxNQUFNLEtBQUssTUFBTSxDQUFDLElBQUksUUFBUSxLQUFLLG1CQUFXLENBQUM7QUFDckYsQ0FBQztBQUVELFNBQWdCLHFCQUFxQixDQUNuQyxPQUFlLEVBQ2YsR0FBYyxFQUNkLEdBQWM7SUFFZCxNQUFNLFdBQVcsR0FBRyxHQUFHLEtBQUssVUFBVSxJQUFJLEdBQUcsQ0FBQyxNQUFNLEtBQUssVUFBVSxDQUFDO0lBRXBFLE9BQU8sRUFBRSxPQUFPLEVBQUUsR0FBRyxLQUFLLFVBQVUsSUFBSSxDQUFDLFdBQVcsRUFBRSxPQUFPLEVBQUUsUUFBUSxFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxFQUFFLENBQUM7QUFDMUYsQ0FBQztBQUVELFNBQWdCLDJCQUEyQixDQUFDLFFBQWdCO0lBQzFELE9BQU87UUFDTCxPQUFPLEVBQUUsSUFBQSwyQkFBYyxFQUFDLFFBQVEsQ0FBQztRQUNqQyxRQUFRLEVBQUUsQ0FBQyxJQUFJLEVBQUUsR0FBRyxFQUFFLEVBQUUsQ0FDdEIsVUFBVSxDQUFDLEdBQUcsRUFBRSx3QkFBd0IsRUFBRTtZQUN4QyxLQUFLLEVBQUUscUJBQXFCO1lBQzVCLGlCQUFpQixFQUFFLG9EQUFvRDtTQUN4RSxDQUFDO0tBQ0wsQ0FBQztBQUNKLENBQUM7QUFFRCxTQUF3Qix1QkFBdUIsQ0FBQyxFQUM5QyxPQUFPLEVBQ1AsYUFBYSxFQUNiLE1BQU0sR0FDbUI7SUFDekIsT0FBTyxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsRUFBRTtRQUNsQixHQUFHLENBQUMsU0FBUyxDQUFDLDhCQUFzQixFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBRS9DLElBQUksZUFBZSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7WUFDekIsTUFBTSxNQUFNLEdBQUcsTUFBTSxFQUFFLENBQUM7WUFFeEIsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLHdCQUF3QixFQUFFLE1BQU0sQ0FBQyxDQUFDO1lBRTdFLE9BQU87UUFDVCxDQUFDO1FBRUQsYUFBYSxDQUFDLFFBQVEsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxDQUNwQyxVQUFVLENBQUMsR0FBRyxFQUFFLGNBQWMsRUFBRTtZQUM5QixLQUFLLEVBQUUsV0FBVztZQUNsQixpQkFBaUIsRUFBRSxzQ0FBc0M7U0FDMUQsQ0FBQyxDQUNILENBQUM7SUFDSixDQUFDLENBQUM7QUFDSixDQUFDIn0=

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+declare const version: string;
+export default version;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
+const { version } = require('../package.json');
+exports.default = version;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmVyc2lvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy92ZXJzaW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUEseUdBQXlHO0FBQ3pHLE1BQU0sRUFBRSxPQUFPLEVBQUUsR0FBRyxPQUFPLENBQUMsaUJBQWlCLENBQXdCLENBQUM7QUFFdEUsa0JBQWUsT0FBTyxDQUFDIn0=

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@forestadmin/gateway",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Serves the Forest Admin MCP and API services on one port, for agents that cannot embed them",
+  "main": "dist/index.js",
+  "bin": {
+    "forest-gateway": "dist/cli.js"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ForestAdmin/agent-nodejs.git",
+    "directory": "packages/gateway"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "start": "node dist/cli.js",
+    "clean": "rm -rf coverage dist",
+    "lint": "eslint src test",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@forestadmin/agent-bff": "1.41.0",
+    "@forestadmin/forestadmin-client": "1.44.0",
+    "@forestadmin/mcp-server": "1.29.0"
+  },
+  "devDependencies": {
+    "supertest": "^7.1.3"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.