@methacore/sdk

Für externe Methacore-Apps (eigene Domain, eigenes Hosting).

Gehostete Apps aus dem Methacore Studio (Builder und main.js) brauchen dieses SDK nicht. Sie laufen in der Methacore-Runtime, und ihre Handler bekommen einen Kontext mit data, storage, exportRows, toast und navigate.

Was das SDK kann

• Anmeldung (OAuth mit PKCE) für Apps auf eigener Domain: beginLogin, login, handleRedirect, Token erneuern. Fehlt einem Token eine Berechtigung, startet das SDK die Anmeldung mit der zusätzlichen Berechtigung neu.
• Host-Bridge: Läuft eine externe App als Iframe im Dashboard oder in der Mitglieder-App, holt das SDK Token, Kontext, Hinweise und Navigation über die Bridge des Hosts. Fehlt eine Berechtigung, fragt es einmal mit reauthorize nach und wiederholt den Aufruf einmal.
• API-Client für die Methacore-APIs (apps-Bereich und weitere Bereiche über request).
• App-Speicher pro Organisation oder Mitglied.
• Exporte als CSV, XLSX und PDF (xlsx und pdf-lib werden erst beim Export geladen).

Einstieg

import { createMethacore } from "@methacore/sdk";

const mc = createMethacore({ clientId: "<deine Client-ID>", scopes: ["mc.me.profile:read"] });
const profile = await mc.api.apps.me.profile();

Außerhalb eines Hosts leitet mc.auth.login() zur Anmeldung weiter; nach der Rückkehr verarbeitet mc.auth.handleRedirect() den Code.

Build

ESM (dist/index.js) und CommonJS (dist/index.cjs), Typen in dist/index.d.ts.