rampkit-mcp-server 0.1.0

package/dist/resources/sdk-guide.js

@@ -0,0 +1,368 @@
+/**
+ * SDK Installation and Usage Guides
+ */
+export const EXPO_SDK_GUIDE = `# RampKit Expo SDK Guide
+
+## Minimum Requirements
+
+- **iOS 14.0+** (StoreKit 2 transactions automatically tracked on iOS 15+)
+- **Expo SDK 51+**
+
+## Installation
+
+\`\`\`bash
+npm install rampkit-expo-dev
+\`\`\`
+
+## Required Peer Dependencies
+
+Install these in your app:
+
+\`\`\`bash
+npx expo install react-native-webview react-native-pager-view react-native-root-siblings
+\`\`\`
+
+## Setup
+
+Wrap your app with RootSiblingParent (required for the overlay):
+
+\`\`\`tsx
+// App.tsx
+import { RootSiblingParent } from 'react-native-root-siblings';
+
+export default function App() {
+  return (
+    <RootSiblingParent>
+      {/* Your app content */}
+    </RootSiblingParent>
+  );
+}
+\`\`\`
+
+## Initialize the SDK
+
+\`\`\`typescript
+import { RampKit } from 'rampkit-expo-dev';
+
+// Call once at app startup (e.g., in useEffect or before rendering)
+await RampKit.configure({
+  appId: 'YOUR_APP_ID',
+  environment: 'production',        // or 'development'
+  autoShowOnboarding: false,        // true = show immediately after configure
+  appUserID: 'your-user-123',       // optional: link to your user system
+  verboseLogging: false,            // true for debug logs
+  onOnboardingFinished: (payload) => {
+    console.log('Onboarding finished', payload);
+  },
+  onShowPaywall: (payload) => {
+    // Called when onboarding triggers paywall
+    // Present your paywall here
+  },
+});
+\`\`\`
+
+## Show Onboarding Manually
+
+\`\`\`typescript
+RampKit.showOnboarding();
+
+// Or with custom paywall handler:
+RampKit.showOnboarding({
+  onShowPaywall: (payload) => { /* show paywall */ }
+});
+\`\`\`
+
+## Close Onboarding
+
+\`\`\`typescript
+RampKit.closeOnboarding();
+\`\`\`
+
+## Get User ID
+
+\`\`\`typescript
+const userId = RampKit.getUserId();
+\`\`\`
+
+## Get User Answers (from onboarding questions)
+
+\`\`\`typescript
+// All answers
+const answers = await RampKit.getAnswers();
+
+// Single answer
+const name = await RampKit.getAnswer('userName');
+\`\`\`
+
+## Set Custom User ID (after configure)
+
+\`\`\`typescript
+await RampKit.setAppUserID('user-abc-123');
+\`\`\`
+
+## Track Custom Events
+
+\`\`\`typescript
+RampKit.trackEvent('button_tapped', { buttonId: 'cta-1' });
+\`\`\`
+
+## Check Initialization
+
+\`\`\`typescript
+if (RampKit.isInitialized()) {
+  RampKit.showOnboarding();
+}
+\`\`\`
+
+## Reset SDK (logout/clear state)
+
+\`\`\`typescript
+await RampKit.reset();
+\`\`\`
+
+## Complete Example
+
+\`\`\`tsx
+// App.tsx
+import { useEffect, useState } from 'react';
+import { RootSiblingParent } from 'react-native-root-siblings';
+import { RampKit } from 'rampkit-expo-dev';
+
+export default function App() {
+  const [isReady, setIsReady] = useState(false);
+
+  useEffect(() => {
+    async function init() {
+      await RampKit.configure({
+        appId: 'YOUR_APP_ID',
+        environment: 'production',
+        autoShowOnboarding: true, // Show onboarding automatically
+        onOnboardingFinished: (payload) => {
+          console.log('User completed onboarding', payload);
+        },
+        onShowPaywall: (payload) => {
+          // Handle paywall presentation
+          console.log('Show paywall', payload);
+        },
+      });
+      setIsReady(true);
+    }
+    init();
+  }, []);
+
+  if (!isReady) return null;
+
+  return (
+    <RootSiblingParent>
+      {/* Your app content */}
+    </RootSiblingParent>
+  );
+}
+\`\`\`
+`;
+export const IOS_SDK_GUIDE = `# RampKit iOS SDK Guide
+
+## Requirements
+
+- **iOS 14.0+**
+- StoreKit 2 transactions are automatically tracked on iOS 15+
+
+## Installation (Swift Package Manager)
+
+In Xcode:
+1. File → Add Package Dependencies
+2. Enter: \`https://github.com/getrampkit/rampkit-ios.git\`
+3. Select version 1.0.0 or "Up to Next Major"
+4. Add to your target
+
+Or in Package.swift:
+
+\`\`\`swift
+dependencies: [
+    .package(url: "https://github.com/getrampkit/rampkit-ios.git", from: "1.0.0")
+]
+\`\`\`
+
+## Initialize the SDK
+
+\`\`\`swift
+import RampKit
+
+// Call once at app launch (e.g., in AppDelegate or @main App init)
+Task {
+    await RampKit.configure(config: RampKitConfig(
+        appId: "YOUR_APP_ID",
+        environment: "production",
+        autoShowOnboarding: false,
+        appUserID: "your-user-123",        // optional
+        verboseLogging: false,
+        onOnboardingFinished: { payload in
+            print("Onboarding finished", payload ?? "")
+        },
+        onShowPaywall: { payload in
+            // Present your paywall here
+        }
+    ))
+}
+\`\`\`
+
+## Show Onboarding
+
+\`\`\`swift
+RampKit.showOnboarding()
+
+// Or with custom paywall handler:
+RampKit.showOnboarding(options: ShowOnboardingOptions(
+    onShowPaywall: { payload in /* show paywall */ }
+))
+\`\`\`
+
+## Close Onboarding
+
+\`\`\`swift
+RampKit.closeOnboarding()
+\`\`\`
+
+## Get User ID
+
+\`\`\`swift
+let userId = RampKit.getUserId()
+\`\`\`
+
+## Get User Answers (from onboarding questions)
+
+\`\`\`swift
+// All answers
+let answers = RampKit.getAnswers()
+
+// Single answer
+let name = RampKit.getAnswer("userName")
+\`\`\`
+
+## Set Custom User ID (after configure)
+
+\`\`\`swift
+Task {
+    await RampKit.setAppUserID("user-abc-123")
+}
+\`\`\`
+
+## Reset SDK (logout/clear state)
+
+\`\`\`swift
+Task {
+    await RampKit.reset()
+}
+\`\`\`
+
+## Complete SwiftUI Example
+
+\`\`\`swift
+import SwiftUI
+import RampKit
+
+@main
+struct MyApp: App {
+    init() {
+        Task {
+            await RampKit.configure(config: RampKitConfig(
+                appId: "YOUR_APP_ID",
+                environment: "production",
+                autoShowOnboarding: true,
+                onOnboardingFinished: { payload in
+                    print("Onboarding finished", payload ?? "")
+                },
+                onShowPaywall: { payload in
+                    // Present your paywall
+                }
+            ))
+        }
+    }
+
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+        }
+    }
+}
+\`\`\`
+
+## Complete UIKit Example
+
+\`\`\`swift
+import UIKit
+import RampKit
+
+@main
+class AppDelegate: UIResponder, UIApplicationDelegate {
+    func application(
+        _ application: UIApplication,
+        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
+    ) -> Bool {
+        Task {
+            await RampKit.configure(config: RampKitConfig(
+                appId: "YOUR_APP_ID",
+                environment: "production",
+                autoShowOnboarding: false,
+                onOnboardingFinished: { payload in
+                    print("Onboarding finished", payload ?? "")
+                },
+                onShowPaywall: { payload in
+                    // Present your paywall
+                }
+            ))
+        }
+        return true
+    }
+}
+\`\`\`
+`;
+export const ANDROID_SDK_GUIDE = `# RampKit Android SDK Guide
+
+## Installation via Gradle
+
+Add to your app's build.gradle:
+
+\`\`\`gradle
+implementation "com.rampkit:sdk:1.0.0"
+\`\`\`
+
+## Initialize the SDK
+
+\`\`\`kotlin
+import com.rampkit.RampKit
+
+// In your Application class or MainActivity
+RampKit.configure(
+  context = this,
+  appId = "YOUR_APP_ID"
+)
+\`\`\`
+
+## Show Onboarding
+
+\`\`\`kotlin
+RampKit.showOnboarding(activity)
+\`\`\`
+
+## Configuration Options
+
+\`\`\`kotlin
+RampKit.configure(
+  context = this,
+  appId = "YOUR_APP_ID",
+  environment = RampKit.Environment.PRODUCTION,
+  autoShowOnboarding = false,
+  listener = object : RampKitListener {
+    override fun onOnboardingFinished(payload: Map<String, Any>) {
+      // Handle completion
+    }
+
+    override fun onPaywallRequested(payload: Map<String, Any>) {
+      // Present your paywall
+    }
+  }
+)
+\`\`\`
+`;
+//# sourceMappingURL=sdk-guide.js.map

package/dist/resources/sdk-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-guide.js","sourceRoot":"","sources":["../../src/resources/sdk-guide.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8J7B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4J5B,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+ChC,CAAC"}

package/dist/resources/templates.d.ts

@@ -0,0 +1,9 @@
+/**
+ * HTML Templates for Onboarding Screens
+ *
+ * Ready-to-use templates for common onboarding screen types.
+ * All elements have both data-ramp-id (unique identifier) and data-ramp-type (element type).
+ * Valid types: text, image, button, video, lottie, input
+ */
+export declare const HTML_TEMPLATES: Record<string, string>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/resources/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/resources/templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAs2BjD,CAAC"}