{
+ return new Promise((resolve, reject) => {
+ codegen.convert("curl", "cURL", request, CURL_OPTIONS, (err: any, snippet: string) => {
+ if (err) return reject(err);
+ resolve(snippet);
+ });
+ });
+}
+
+function injectSpan(mdxContent: string, curl: string): string | null {
+ // Curl text contains literal `{`/`}` (path templates, JSON bodies), which
+ // MDX would otherwise try to parse as JS expressions in raw text. Wrapping
+ // it as a JS string expression — {"..."} — sidesteps that entirely.
+ //
+ // , not : the MCP plugin converts page HTML to Markdown via
+ // rehype-remark/remark-stringify, which escapes `_` and `:` in plain text
+ // nodes (CommonMark rules) — turning `session_id` and `https://` into
+ // `session\_id` and `https\://` in the docs_fetch output. Code blocks are
+ // emitted verbatim, so keeps the curl copy-paste-safe.
+ const span = `${INJECTED_MARKER}{${JSON.stringify(curl)}}\n\n`;
+ const match = INJECTION_ANCHOR.exec(mdxContent);
+ if (!match) return null;
+ return mdxContent.slice(0, match.index) + span + mdxContent.slice(match.index);
+}
+
+interface SourceResult {
+ injected: number;
+ failures: string[];
+ // Set when the whole source couldn't be processed at all — distinct from
+ // `failures`, which are per-operation. One bad source means every
+ // operation in it was skipped, not "N operations failed."
+ error?: string;
+}
+
+async function processSource(enrichedSpecPath: string): Promise {
+ if (!fs.existsSync(enrichedSpecPath)) {
+ console.error(` ERROR: Enriched spec not found: ${enrichedSpecPath}`);
+ console.error(` Run "npm run enrich-api" first.`);
+ process.exit(1);
+ }
+
+ const spec = yaml.load(fs.readFileSync(enrichedSpecPath, "utf-8")) as any;
+ const baseUrl = spec.servers?.[0]?.url;
+ if (!baseUrl) {
+ return { injected: 0, failures: [], error: "Spec has no servers[0].url — skipping curl generation for all operations" };
+ }
+
+ // Dereferenced copy: operation matching and body example generation both
+ // need resolved $refs (sampleRequestFromSchema can't fake a bare $ref).
+ const dereferenced = await RefParser.dereference(JSON.parse(JSON.stringify(spec)), {
+ mutateInputSchema: false,
+ });
+ const matchers = buildOperationMatchers(dereferenced);
+ const collection = await buildPostmanCollection(spec);
+
+ let injected = 0;
+ const failures: string[] = [];
+
+ for (const item of collectionItems(collection)) {
+ const request = item.request;
+ const method = request.method.toLowerCase();
+ const requestPath = request.url.getPath({ unresolved: true });
+ const matcher = matchers.find((m) => m.method === method && m.pathRegex.test(requestPath));
+ if (!matcher) continue;
+
+ applyServerAndAuth(request, baseUrl);
+ applyJsonBody(request, matcher.operation);
+
+ let curl: string;
+ try {
+ curl = await generateCurl(request);
+ } catch (err) {
+ failures.push(`Failed to generate curl for ${matcher.operationId}: ${err}`);
+ continue;
+ }
+
+ const filename = operationIdToFilename(matcher.operationId);
+ const mdxPath = path.join(API_DOCS_DIR, filename);
+ if (!fs.existsSync(mdxPath)) {
+ failures.push(`No .api.mdx found for ${matcher.operationId} (expected ${filename})`);
+ continue;
+ }
+
+ const original = fs.readFileSync(mdxPath, "utf-8");
+ if (original.includes(INJECTED_MARKER)) continue;
+
+ const patched = injectSpan(original, curl);
+ if (patched === null) {
+ failures.push(`Injection anchor not found in ${filename}`);
+ continue;
+ }
+
+ fs.writeFileSync(mdxPath, patched, "utf-8");
+ console.log(` Injected curl example into ${filename}`);
+ injected++;
+ }
+
+ return { injected, failures };
+}
+
+async function main(): Promise {
+ console.log("\nMCP Curl Example Injector");
+
+ const config = yaml.load(fs.readFileSync(SOURCES_FILE, "utf-8")) as ApiSourcesConfig;
+ let total = 0;
+ const failures: string[] = [];
+ const sourceErrors: string[] = [];
+
+ for (const [name, source] of Object.entries(config.sources)) {
+ console.log(`\n ── ${name} ──`);
+ const enrichedSpecPath = path.resolve(ROOT, source.enrichedOutput);
+ const result = await processSource(enrichedSpecPath);
+ total += result.injected;
+ failures.push(...result.failures);
+ if (result.error) sourceErrors.push(`${name}: ${result.error}`);
+ }
+
+ if (sourceErrors.length > 0) {
+ console.error(`\n ${sourceErrors.length} source(s) could not be processed:`);
+ for (const error of sourceErrors) console.error(` - ${error}`);
+ }
+
+ if (failures.length > 0) {
+ console.error(`\n ${failures.length} curl example(s) failed to inject:`);
+ for (const failure of failures) console.error(` - ${failure}`);
+ }
+
+ if (sourceErrors.length > 0 || failures.length > 0) {
+ process.exit(1);
+ }
+
+ console.log(`\n Done — ${total} file(s) patched\n`);
+}
+
+main();
diff --git a/src/components/WalletDemo/WalletDemoInner.tsx b/src/components/WalletDemo/WalletDemoInner.tsx
index 8711e94..5396ef5 100644
--- a/src/components/WalletDemo/WalletDemoInner.tsx
+++ b/src/components/WalletDemo/WalletDemoInner.tsx
@@ -111,7 +111,7 @@ export default function WalletDemoInner() {
if (pgCodes.length === 0) {
dispatch({
type: "ERROR",
- message: `No wallet-capable gateways for ${WALLET_DEMO.currency} on the active merchant. Enable a PG with payment_services: ["wallet"] tagged "docs".`,
+ message: `No wallet-capable gateways for ${WALLET_DEMO.currency} on the active merchant. Enable a PG with payment_services: ["wallet"] tagged "demo".`,
});
return;
}
diff --git a/src/constants/api.ts b/src/constants/api.ts
index 2fe1b15..b7494b5 100644
--- a/src/constants/api.ts
+++ b/src/constants/api.ts
@@ -1,7 +1,6 @@
-// Base URL for all API code samples and interactive demos.
-// Points at Ottu's KSA dev environment (`ksa.ottu.dev`), which currently
-// hosts the full public API surface including wallet endpoints.
-export const OTTU_CONNECT_BASE_URL = "https://ksa.ottu.dev";
+// Base URL shown in all API code samples — the host developers copy.
+// docs.ottu.com advertises the public sandbox `sandbox.ottu.net` only.
+export const OTTU_CONNECT_BASE_URL = "https://sandbox.ottu.net";
// Backwards-compatible alias. Historically `OTTU_DEV_BASE_URL` pointed at
// `ksa.ottu.dev` for APIs not yet on the public sandbox; both constants now
diff --git a/src/theme/ApiExplorer/Authorization/index.tsx b/src/theme/ApiExplorer/Authorization/index.tsx
index 86776a2..1a8d8ce 100644
--- a/src/theme/ApiExplorer/Authorization/index.tsx
+++ b/src/theme/ApiExplorer/Authorization/index.tsx
@@ -9,12 +9,13 @@ import FormTextInput from "@theme/ApiExplorer/FormTextInput";
import { useTypedDispatch, useTypedSelector } from "@theme/ApiItem/hooks";
import { OPENAPI_AUTH } from "@theme/translationIds";
import React, { Fragment, useEffect } from "react";
+import { ACTIVE_CONNECT } from "@site/src/utils/sandbox";
const DEFAULT_USERNAME = "demo_user";
const DEFAULT_PASSWORD = "WY4Q9I1d5kHH3nJ";
-// Public demo key on ksa.ottu.dev. Bare key only — the explorer prepends
-// the "Api-Key " prefix when it builds the Authorization header.
-const DEFAULT_API_KEY = "uUjUqczM.P5PqlXx8zyuFUQVk19PLxfHBZu8rG4Uy";
+// Public sandbox demo key — tracks ACTIVE_CONNECT (sandbox.ottu.net). Bare key
+// only; the explorer prepends the "Api-Key " prefix for the Authorization header.
+const DEFAULT_API_KEY = ACTIVE_CONNECT.connectApiKey;
export default function Authorization(): React.JSX.Element | null {
const data = useTypedSelector((state: any) => state.auth.data);
diff --git a/src/utils/sandbox.ts b/src/utils/sandbox.ts
index d2bf9ef..19fe084 100644
--- a/src/utils/sandbox.ts
+++ b/src/utils/sandbox.ts
@@ -30,17 +30,13 @@ export const KSA: ConnectEnv = {
sdkApiKey: "88a460b42a0f8bec4011da23ce1d547bd04e8afc",
};
-// ⬇️ THE GLOBAL SWITCH — change this one line to retarget every demo on the site.
-// Both branches (dev → docs.ottu.dev, main → docs.ottu.com) currently use KSA:
-// it is the only environment that hosts the full public API surface + wallet,
-// so every demo and every code sample (via OTTU_CONNECT_BASE_URL) resolves the
-// host through here.
-//
-// Do NOT point main at SANDBOX — sandbox.ottu.net has no wallet PG, so the
-// WalletDemo and every wallet code sample would break in production. Move to a
-// per-branch ConnectEnv (or a build-time env override) only once a
-// production-grade sandbox also hosts wallet.
-export const ACTIVE_CONNECT: ConnectEnv = KSA;
+// ⬇️ THE GLOBAL SWITCH for the LIVE interactive demos (Checkout / Recurring /
+// PaymentJourney / Wallet) + the API-explorer "try it". docs.ottu.com
+// advertises only sandbox.ottu.net, so everything runs on SANDBOX.
+// The wallet gateway is live on sandbox.ottu.net for USD only — PG
+// `ottu-sandbox-usd`, payment_services `ottu-wallet`, tagged `demo` — so the
+// WalletDemo seeds and charges in USD (see walletDemoConfig.ts).
+export const ACTIVE_CONNECT: ConnectEnv = SANDBOX;
export interface CreateSessionOptions {
pg_codes: string[];
diff --git a/src/utils/walletDemoConfig.ts b/src/utils/walletDemoConfig.ts
index c977e7c..f28524a 100644
--- a/src/utils/walletDemoConfig.ts
+++ b/src/utils/walletDemoConfig.ts
@@ -7,9 +7,10 @@
* in `./sandbox` — flip that one global to retarget every demo on the site.
*/
export const WALLET_DEMO = {
- currency: "KWD",
- seedAmount: "10.000",
- sessionAmount: "8.000",
+ // Wallet on sandbox.ottu.net is enabled for USD only (PG `ottu-sandbox-usd`).
+ currency: "USD",
+ seedAmount: "10.00",
+ sessionAmount: "8.00",
pgFilter: {
plugin: "e_commerce",
type: "sandbox",
diff --git a/static/Ottu_API.yaml b/static/Ottu_API.yaml
index d4a4d7a..64c7dd0 100644
--- a/static/Ottu_API.yaml
+++ b/static/Ottu_API.yaml
@@ -9885,4 +9885,4 @@ components:
name: Authorization
description: Token-based authentication with required prefix "Token"
servers:
- - url: https://ksa.ottu.dev
+ - url: https://sandbox.ottu.net
diff --git a/static/api-enrichments/_variables.yaml b/static/api-enrichments/_variables.yaml
index f8e2275..7d1da06 100644
--- a/static/api-enrichments/_variables.yaml
+++ b/static/api-enrichments/_variables.yaml
@@ -6,4 +6,4 @@
apiBaseUrl: "/developers"
glossaryUrl: "/glossary"
-sandboxUrl: "https://ksa.ottu.dev"
+sandboxUrl: "https://sandbox.ottu.net"