@momorail/gateway 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Momorail contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/chunk-PC2PDF2S.js

@@ -0,0 +1,197 @@
+// src/errors.ts
+import {
+  AuthError,
+  MomorailError,
+  ProviderUnavailableError,
+  RateLimitError,
+  TransactionNotFoundError,
+  ValidationError,
+  WebhookVerificationError
+} from "@momorail/core";
+function toHttpError(err) {
+  if (err instanceof MomorailError) {
+    return { status: statusForMomorailError(err), body: bodyFor(err.code, err.message, err) };
+  }
+  const statusCode = readStatusCode(err);
+  if (statusCode && statusCode >= 400 && statusCode < 500) {
+    const message = err instanceof Error ? err.message : "Bad request";
+    return { status: statusCode, body: bodyFor("bad_request", message, void 0) };
+  }
+  if (err instanceof Error) {
+    return { status: 500, body: bodyFor("internal_error", err.message, void 0) };
+  }
+  return { status: 500, body: bodyFor("internal_error", "Unknown error", void 0) };
+}
+function readStatusCode(err) {
+  if (err && typeof err === "object" && "statusCode" in err) {
+    const value = err.statusCode;
+    return typeof value === "number" ? value : void 0;
+  }
+  return void 0;
+}
+function statusForMomorailError(err) {
+  if (err instanceof ValidationError) return 400;
+  if (err instanceof WebhookVerificationError) return 400;
+  if (err instanceof TransactionNotFoundError) return 404;
+  if (err instanceof RateLimitError) return 429;
+  if (err instanceof ProviderUnavailableError) return 503;
+  if (err instanceof AuthError) return 502;
+  if (err.code === "not_supported") return 501;
+  return 502;
+}
+function bodyFor(code, message, err) {
+  const body = { error: { code, message, retryable: err?.retryable ?? false } };
+  if (err?.provider) body.error.provider = err.provider;
+  return body;
+}
+var UNAUTHORIZED = {
+  status: 401,
+  body: {
+    error: { code: "unauthorized", message: "Missing or invalid API key", retryable: false }
+  }
+};
+
+// src/app.ts
+import { TransactionNotFoundError as TransactionNotFoundError2, ValidationError as ValidationError2 } from "@momorail/core";
+import Fastify from "fastify";
+function createGatewayApp(options) {
+  const { client, apiKey } = options;
+  const app = Fastify({ logger: options.logger ?? false });
+  app.addHook("onRequest", async (request, reply) => {
+    const config = request.routeOptions.config;
+    if (config?.public) return;
+    if (readApiKey(request) !== apiKey) {
+      return reply.code(UNAUTHORIZED.status).send(UNAUTHORIZED.body);
+    }
+  });
+  app.setErrorHandler((err, _request, reply) => {
+    const mapped = toHttpError(err);
+    reply.code(mapped.status).send(mapped.body);
+  });
+  app.get("/healthz", { config: { public: true } }, async () => ({ status: "ok" }));
+  app.get(
+    "/v1/capabilities",
+    async () => client.providerIds.map((id) => ({ provider: id, ...client.provider(id).capabilities() }))
+  );
+  app.post("/v1/collections", async (request, reply) => {
+    const txn = await client.collection(requireObject(request.body));
+    return reply.code(201).send(txn);
+  });
+  app.post("/v1/disbursements", async (request, reply) => {
+    const txn = await client.disbursement(requireObject(request.body));
+    return reply.code(201).send(txn);
+  });
+  app.get("/v1/transactions/:reference", async (request) => {
+    const { reference } = request.params;
+    return client.getTransaction({ reference });
+  });
+  app.register(async (webhooks) => {
+    webhooks.removeAllContentTypeParsers();
+    webhooks.addContentTypeParser(
+      "*",
+      { parseAs: "string" },
+      (_req, body, done) => done(null, body)
+    );
+    webhooks.post(
+      "/v1/webhooks/:provider",
+      { config: { public: true } },
+      async (request) => {
+        const { provider } = request.params;
+        if (!client.providerIds.includes(provider)) {
+          throw new TransactionNotFoundError2(`No provider mounted with id "${provider}"`);
+        }
+        return client.parseWebhook(provider, {
+          headers: request.headers,
+          body: typeof request.body === "string" ? request.body : ""
+        });
+      }
+    );
+  });
+  return app;
+}
+function readApiKey(request) {
+  const auth = request.headers.authorization;
+  if (auth) {
+    const [scheme, token] = auth.split(" ");
+    if (scheme?.toLowerCase() === "bearer" && token) return token;
+  }
+  const header = request.headers["x-api-key"];
+  return Array.isArray(header) ? header[0] : header;
+}
+function requireObject(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new ValidationError2("Request body must be a JSON object");
+  }
+  return value;
+}
+
+// src/env.ts
+import { CinetpayProvider } from "@momorail/cinetpay";
+import { MomorailClient } from "@momorail/core";
+import { LigdicashProvider } from "@momorail/ligdicash";
+import { MockProvider } from "@momorail/mock";
+import { PawapayProvider } from "@momorail/pawapay";
+import { PaydunyaProvider } from "@momorail/paydunya";
+function gatewayFromEnv(env = process.env) {
+  const apiKey = env.MOMORAIL_GATEWAY_API_KEY;
+  if (!apiKey) throw new Error("MOMORAIL_GATEWAY_API_KEY is required");
+  const providerId = env.MOMORAIL_PROVIDER ?? "mock";
+  const provider = buildProvider(providerId, env);
+  return { client: new MomorailClient({ providers: [provider] }), apiKey };
+}
+function buildProvider(id, env) {
+  switch (id) {
+    case "mock":
+      return new MockProvider();
+    case "cinetpay":
+      return new CinetpayProvider({
+        apikey: required(env, "CINETPAY_APIKEY", id),
+        siteId: required(env, "CINETPAY_SITE_ID", id),
+        secretKey: required(env, "CINETPAY_SECRET_KEY", id),
+        notifyUrl: env.CINETPAY_NOTIFY_URL,
+        returnUrl: env.CINETPAY_RETURN_URL,
+        transferPassword: env.CINETPAY_TRANSFER_PASSWORD
+      });
+    case "ligdicash":
+      return new LigdicashProvider({
+        apiKey: required(env, "LIGDICASH_API_KEY", id),
+        apiToken: required(env, "LIGDICASH_API_TOKEN", id),
+        storeName: required(env, "LIGDICASH_STORE_NAME", id),
+        storeUrl: env.LIGDICASH_STORE_URL,
+        callbackUrl: env.LIGDICASH_CALLBACK_URL,
+        returnUrl: env.LIGDICASH_RETURN_URL,
+        cancelUrl: env.LIGDICASH_CANCEL_URL
+      });
+    case "pawapay":
+      return new PawapayProvider({
+        apiToken: required(env, "PAWAPAY_API_TOKEN", id),
+        mode: env.PAWAPAY_MODE === "live" ? "live" : "sandbox"
+      });
+    case "paydunya":
+      return new PaydunyaProvider({
+        masterKey: required(env, "PAYDUNYA_MASTER_KEY", id),
+        privateKey: required(env, "PAYDUNYA_PRIVATE_KEY", id),
+        token: required(env, "PAYDUNYA_TOKEN", id),
+        storeName: required(env, "PAYDUNYA_STORE_NAME", id),
+        mode: env.PAYDUNYA_MODE === "test" ? "test" : "live",
+        callbackUrl: env.PAYDUNYA_CALLBACK_URL,
+        returnUrl: env.PAYDUNYA_RETURN_URL,
+        cancelUrl: env.PAYDUNYA_CANCEL_URL
+      });
+    default:
+      throw new Error(`Unknown MOMORAIL_PROVIDER: ${id}`);
+  }
+}
+function required(env, key, providerId) {
+  const value = env[key];
+  if (!value) throw new Error(`${key} is required when MOMORAIL_PROVIDER=${providerId}`);
+  return value;
+}
+
+export {
+  toHttpError,
+  UNAUTHORIZED,
+  createGatewayApp,
+  gatewayFromEnv
+};
+//# sourceMappingURL=chunk-PC2PDF2S.js.map

package/dist/chunk-PC2PDF2S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/app.ts","../src/env.ts"],"sourcesContent":["import {\n  AuthError,\n  MomorailError,\n  ProviderUnavailableError,\n  RateLimitError,\n  TransactionNotFoundError,\n  ValidationError,\n  WebhookVerificationError,\n} from '@momorail/core';\n\nexport interface ErrorBody {\n  error: {\n    code: string;\n    message: string;\n    provider?: string;\n    retryable: boolean;\n  };\n}\n\nexport interface HttpError {\n  status: number;\n  body: ErrorBody;\n}\n\n/** Map any thrown value onto an HTTP status and the gateway's `Error` schema. */\nexport function toHttpError(err: unknown): HttpError {\n  if (err instanceof MomorailError) {\n    return { status: statusForMomorailError(err), body: bodyFor(err.code, err.message, err) };\n  }\n\n  const statusCode = readStatusCode(err);\n  if (statusCode && statusCode >= 400 && statusCode < 500) {\n    const message = err instanceof Error ? err.message : 'Bad request';\n    return { status: statusCode, body: bodyFor('bad_request', message, undefined) };\n  }\n\n  if (err instanceof Error) {\n    return { status: 500, body: bodyFor('internal_error', err.message, undefined) };\n  }\n  return { status: 500, body: bodyFor('internal_error', 'Unknown error', undefined) };\n}\n\nfunction readStatusCode(err: unknown): number | undefined {\n  if (err && typeof err === 'object' && 'statusCode' in err) {\n    const value = (err as { statusCode: unknown }).statusCode;\n    return typeof value === 'number' ? value : undefined;\n  }\n  return undefined;\n}\n\nfunction statusForMomorailError(err: MomorailError): number {\n  if (err instanceof ValidationError) return 400;\n  if (err instanceof WebhookVerificationError) return 400;\n  if (err instanceof TransactionNotFoundError) return 404;\n  if (err instanceof RateLimitError) return 429;\n  if (err instanceof ProviderUnavailableError) return 503;\n  if (err instanceof AuthError) return 502; // the *provider* rejected our keys\n  if (err.code === 'not_supported') return 501;\n  return 502;\n}\n\nfunction bodyFor(code: string, message: string, err: MomorailError | undefined): ErrorBody {\n  const body: ErrorBody = { error: { code, message, retryable: err?.retryable ?? false } };\n  if (err?.provider) body.error.provider = err.provider;\n  return body;\n}\n\nexport const UNAUTHORIZED: HttpError = {\n  status: 401,\n  body: {\n    error: { code: 'unauthorized', message: 'Missing or invalid API key', retryable: false },\n  },\n};\n","import { type MomorailClient, TransactionNotFoundError, ValidationError } from '@momorail/core';\nimport Fastify, { type FastifyInstance, type FastifyRequest } from 'fastify';\nimport { UNAUTHORIZED, toHttpError } from './errors.js';\n\nexport interface GatewayOptions {\n  /** A configured client. Its mounted adapters decide which providers the gateway serves. */\n  client: MomorailClient;\n  /** Static key required as `Authorization: Bearer <key>` (or `X-API-Key`) on non-public routes. */\n  apiKey: string;\n  /** Enable Fastify's request logger. Default false. */\n  logger?: boolean;\n}\n\ninterface RouteConfig {\n  public?: boolean;\n}\n\nexport function createGatewayApp(options: GatewayOptions): FastifyInstance {\n  const { client, apiKey } = options;\n  const app = Fastify({ logger: options.logger ?? false });\n\n  app.addHook('onRequest', async (request, reply) => {\n    const config = request.routeOptions.config as RouteConfig | undefined;\n    if (config?.public) return;\n    if (readApiKey(request) !== apiKey) {\n      return reply.code(UNAUTHORIZED.status).send(UNAUTHORIZED.body);\n    }\n  });\n\n  app.setErrorHandler((err, _request, reply) => {\n    const mapped = toHttpError(err);\n    reply.code(mapped.status).send(mapped.body);\n  });\n\n  app.get('/healthz', { config: { public: true } }, async () => ({ status: 'ok' as const }));\n\n  app.get('/v1/capabilities', async () =>\n    client.providerIds.map((id) => ({ provider: id, ...client.provider(id).capabilities() })),\n  );\n\n  app.post('/v1/collections', async (request, reply) => {\n    const txn = await client.collection(requireObject(request.body) as never);\n    return reply.code(201).send(txn);\n  });\n\n  app.post('/v1/disbursements', async (request, reply) => {\n    const txn = await client.disbursement(requireObject(request.body) as never);\n    return reply.code(201).send(txn);\n  });\n\n  app.get('/v1/transactions/:reference', async (request) => {\n    const { reference } = request.params as { reference: string };\n    return client.getTransaction({ reference });\n  });\n\n  app.register(async (webhooks) => {\n    webhooks.removeAllContentTypeParsers();\n    webhooks.addContentTypeParser('*', { parseAs: 'string' }, (_req, body, done) =>\n      done(null, body),\n    );\n    webhooks.post(\n      '/v1/webhooks/:provider',\n      { config: { public: true } },\n      async (request: FastifyRequest) => {\n        const { provider } = request.params as { provider: string };\n        if (!client.providerIds.includes(provider)) {\n          throw new TransactionNotFoundError(`No provider mounted with id \"${provider}\"`);\n        }\n        return client.parseWebhook(provider, {\n          headers: request.headers,\n          body: typeof request.body === 'string' ? request.body : '',\n        });\n      },\n    );\n  });\n\n  return app;\n}\n\nfunction readApiKey(request: FastifyRequest): string | undefined {\n  const auth = request.headers.authorization;\n  if (auth) {\n    const [scheme, token] = auth.split(' ');\n    if (scheme?.toLowerCase() === 'bearer' && token) return token;\n  }\n  const header = request.headers['x-api-key'];\n  return Array.isArray(header) ? header[0] : header;\n}\n\nfunction requireObject(value: unknown): Record<string, unknown> {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n    throw new ValidationError('Request body must be a JSON object');\n  }\n  return value as Record<string, unknown>;\n}\n","import { CinetpayProvider } from '@momorail/cinetpay';\nimport { MomorailClient, type PaymentProvider } from '@momorail/core';\nimport { LigdicashProvider } from '@momorail/ligdicash';\nimport { MockProvider } from '@momorail/mock';\nimport { PawapayProvider } from '@momorail/pawapay';\nimport { PaydunyaProvider } from '@momorail/paydunya';\n\nexport interface GatewayEnvConfig {\n  client: MomorailClient;\n  apiKey: string;\n}\n\ntype Env = Record<string, string | undefined>;\n\n/**\n * Build a gateway config from environment variables.\n *\n * - `MOMORAIL_GATEWAY_API_KEY` (required) — the static key clients must present.\n * - `MOMORAIL_PROVIDER` — `mock` (default), `cinetpay`, `paydunya`, `ligdicash`, or `pawapay`.\n * - CinetPay: `CINETPAY_APIKEY`, `CINETPAY_SITE_ID`, `CINETPAY_SECRET_KEY`\n *   (required); `CINETPAY_NOTIFY_URL`, `CINETPAY_RETURN_URL`,\n *   `CINETPAY_TRANSFER_PASSWORD` (enables disbursement) (optional).\n * - PayDunya: `PAYDUNYA_MASTER_KEY`, `PAYDUNYA_PRIVATE_KEY`, `PAYDUNYA_TOKEN`,\n *   `PAYDUNYA_STORE_NAME` (required); `PAYDUNYA_MODE` (`live` | `test`),\n *   `PAYDUNYA_CALLBACK_URL`, `PAYDUNYA_RETURN_URL`, `PAYDUNYA_CANCEL_URL` (optional).\n * - LigdiCash: `LIGDICASH_API_KEY`, `LIGDICASH_API_TOKEN`, `LIGDICASH_STORE_NAME`\n *   (required); `LIGDICASH_STORE_URL`, `LIGDICASH_CALLBACK_URL`,\n *   `LIGDICASH_RETURN_URL`, `LIGDICASH_CANCEL_URL` (optional).\n * - pawaPay: `PAWAPAY_API_TOKEN` (required); `PAWAPAY_MODE` (`live` | `sandbox`).\n */\nexport function gatewayFromEnv(env: Env = process.env): GatewayEnvConfig {\n  const apiKey = env.MOMORAIL_GATEWAY_API_KEY;\n  if (!apiKey) throw new Error('MOMORAIL_GATEWAY_API_KEY is required');\n\n  const providerId = env.MOMORAIL_PROVIDER ?? 'mock';\n  const provider = buildProvider(providerId, env);\n  return { client: new MomorailClient({ providers: [provider] }), apiKey };\n}\n\nfunction buildProvider(id: string, env: Env): PaymentProvider {\n  switch (id) {\n    case 'mock':\n      return new MockProvider();\n    case 'cinetpay':\n      return new CinetpayProvider({\n        apikey: required(env, 'CINETPAY_APIKEY', id),\n        siteId: required(env, 'CINETPAY_SITE_ID', id),\n        secretKey: required(env, 'CINETPAY_SECRET_KEY', id),\n        notifyUrl: env.CINETPAY_NOTIFY_URL,\n        returnUrl: env.CINETPAY_RETURN_URL,\n        transferPassword: env.CINETPAY_TRANSFER_PASSWORD,\n      });\n    case 'ligdicash':\n      return new LigdicashProvider({\n        apiKey: required(env, 'LIGDICASH_API_KEY', id),\n        apiToken: required(env, 'LIGDICASH_API_TOKEN', id),\n        storeName: required(env, 'LIGDICASH_STORE_NAME', id),\n        storeUrl: env.LIGDICASH_STORE_URL,\n        callbackUrl: env.LIGDICASH_CALLBACK_URL,\n        returnUrl: env.LIGDICASH_RETURN_URL,\n        cancelUrl: env.LIGDICASH_CANCEL_URL,\n      });\n    case 'pawapay':\n      return new PawapayProvider({\n        apiToken: required(env, 'PAWAPAY_API_TOKEN', id),\n        mode: env.PAWAPAY_MODE === 'live' ? 'live' : 'sandbox',\n      });\n    case 'paydunya':\n      return new PaydunyaProvider({\n        masterKey: required(env, 'PAYDUNYA_MASTER_KEY', id),\n        privateKey: required(env, 'PAYDUNYA_PRIVATE_KEY', id),\n        token: required(env, 'PAYDUNYA_TOKEN', id),\n        storeName: required(env, 'PAYDUNYA_STORE_NAME', id),\n        mode: env.PAYDUNYA_MODE === 'test' ? 'test' : 'live',\n        callbackUrl: env.PAYDUNYA_CALLBACK_URL,\n        returnUrl: env.PAYDUNYA_RETURN_URL,\n        cancelUrl: env.PAYDUNYA_CANCEL_URL,\n      });\n    default:\n      throw new Error(`Unknown MOMORAIL_PROVIDER: ${id}`);\n  }\n}\n\nfunction required(env: Env, key: string, providerId: string): string {\n  const value = env[key];\n  if (!value) throw new Error(`${key} is required when MOMORAIL_PROVIDER=${providerId}`);\n  return value;\n}\n"],"mappings":"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","names":["TransactionNotFoundError","ValidationError","TransactionNotFoundError","ValidationError"]}

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { MomorailClient } from '@momorail/core';
+import { FastifyInstance } from 'fastify';
+
+interface GatewayOptions {
+    /** A configured client. Its mounted adapters decide which providers the gateway serves. */
+    client: MomorailClient;
+    /** Static key required as `Authorization: Bearer <key>` (or `X-API-Key`) on non-public routes. */
+    apiKey: string;
+    /** Enable Fastify's request logger. Default false. */
+    logger?: boolean;
+}
+declare function createGatewayApp(options: GatewayOptions): FastifyInstance;
+
+interface GatewayEnvConfig {
+    client: MomorailClient;
+    apiKey: string;
+}
+type Env = Record<string, string | undefined>;
+/**
+ * Build a gateway config from environment variables.
+ *
+ * - `MOMORAIL_GATEWAY_API_KEY` (required) — the static key clients must present.
+ * - `MOMORAIL_PROVIDER` — `mock` (default), `cinetpay`, `paydunya`, `ligdicash`, or `pawapay`.
+ * - CinetPay: `CINETPAY_APIKEY`, `CINETPAY_SITE_ID`, `CINETPAY_SECRET_KEY`
+ *   (required); `CINETPAY_NOTIFY_URL`, `CINETPAY_RETURN_URL`,
+ *   `CINETPAY_TRANSFER_PASSWORD` (enables disbursement) (optional).
+ * - PayDunya: `PAYDUNYA_MASTER_KEY`, `PAYDUNYA_PRIVATE_KEY`, `PAYDUNYA_TOKEN`,
+ *   `PAYDUNYA_STORE_NAME` (required); `PAYDUNYA_MODE` (`live` | `test`),
+ *   `PAYDUNYA_CALLBACK_URL`, `PAYDUNYA_RETURN_URL`, `PAYDUNYA_CANCEL_URL` (optional).
+ * - LigdiCash: `LIGDICASH_API_KEY`, `LIGDICASH_API_TOKEN`, `LIGDICASH_STORE_NAME`
+ *   (required); `LIGDICASH_STORE_URL`, `LIGDICASH_CALLBACK_URL`,
+ *   `LIGDICASH_RETURN_URL`, `LIGDICASH_CANCEL_URL` (optional).
+ * - pawaPay: `PAWAPAY_API_TOKEN` (required); `PAWAPAY_MODE` (`live` | `sandbox`).
+ */
+declare function gatewayFromEnv(env?: Env): GatewayEnvConfig;
+
+interface ErrorBody {
+    error: {
+        code: string;
+        message: string;
+        provider?: string;
+        retryable: boolean;
+    };
+}
+interface HttpError {
+    status: number;
+    body: ErrorBody;
+}
+/** Map any thrown value onto an HTTP status and the gateway's `Error` schema. */
+declare function toHttpError(err: unknown): HttpError;
+declare const UNAUTHORIZED: HttpError;
+
+export { type ErrorBody, type GatewayEnvConfig, type GatewayOptions, type HttpError, UNAUTHORIZED, createGatewayApp, gatewayFromEnv, toHttpError };

package/dist/index.js

@@ -0,0 +1,13 @@
+import {
+  UNAUTHORIZED,
+  createGatewayApp,
+  gatewayFromEnv,
+  toHttpError
+} from "./chunk-PC2PDF2S.js";
+export {
+  UNAUTHORIZED,
+  createGatewayApp,
+  gatewayFromEnv,
+  toHttpError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server.js

@@ -0,0 +1,14 @@
+import {
+  createGatewayApp,
+  gatewayFromEnv
+} from "./chunk-PC2PDF2S.js";
+
+// src/server.ts
+var port = Number(process.env.PORT ?? 8080);
+var host = process.env.HOST ?? "0.0.0.0";
+var app = createGatewayApp({ ...gatewayFromEnv(), logger: true });
+app.listen({ port, host }).then((address) => app.log.info(`Momorail gateway listening on ${address}`)).catch((err) => {
+  app.log.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import { createGatewayApp } from './app.js';\nimport { gatewayFromEnv } from './env.js';\n\nconst port = Number(process.env.PORT ?? 8080);\nconst host = process.env.HOST ?? '0.0.0.0';\n\nconst app = createGatewayApp({ ...gatewayFromEnv(), logger: true });\n\napp\n  .listen({ port, host })\n  .then((address) => app.log.info(`Momorail gateway listening on ${address}`))\n  .catch((err) => {\n    app.log.error(err);\n    process.exit(1);\n  });\n"],"mappings":";;;;;;AAGA,IAAM,OAAO,OAAO,QAAQ,IAAI,QAAQ,IAAI;AAC5C,IAAM,OAAO,QAAQ,IAAI,QAAQ;AAEjC,IAAM,MAAM,iBAAiB,EAAE,GAAG,eAAe,GAAG,QAAQ,KAAK,CAAC;AAElE,IACG,OAAO,EAAE,MAAM,KAAK,CAAC,EACrB,KAAK,CAAC,YAAY,IAAI,IAAI,KAAK,iCAAiC,OAAO,EAAE,CAAC,EAC1E,MAAM,CAAC,QAAQ;AACd,MAAI,IAAI,MAAM,GAAG;AACjB,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@momorail/gateway",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Self-hostable Fastify REST facade over the Momorail library",
+  "keywords": [
+    "mobile-money",
+    "payments",
+    "west-africa",
+    "africa",
+    "orange-money",
+    "mtn-momo",
+    "wave",
+    "xof",
+    "byo-keys",
+    "typescript",
+    "gateway"
+  ],
+  "license": "MIT",
+  "author": "Boukymen <boukymen@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Boukymen/momorail.git",
+    "directory": "packages/gateway"
+  },
+  "homepage": "https://github.com/Boukymen/momorail/tree/main/packages/gateway#readme",
+  "bugs": "https://github.com/Boukymen/momorail/issues",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "fastify": "^5.2.0",
+    "@momorail/core": "0.1.0",
+    "@momorail/pawapay": "0.1.0",
+    "@momorail/paydunya": "0.1.0",
+    "@momorail/cinetpay": "0.1.0",
+    "@momorail/ligdicash": "0.1.0",
+    "@momorail/mock": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "start": "node dist/server.js"
+  }
+}