@ratio-mcp/dev-server 1.2.0 → 1.4.0

package/dist/services/tool-guard.js

@@ -2,126 +2,124 @@ import { getSession, hasCompleted, hasCompletedAny } from './session-state.js';
 import { logger } from '../utils/logger.js';
 // ── Prerequisite rules ──────────────────────────────────────────────────
 const TOOL_PREREQUISITES = {
-    // ── Phase 1: App Creation (auth → categories → create_app) ──────────
-    get_categories: () => {
+    // ── Auth (entry points — no prerequisites) ────────────────────────────
+    // developer_login, developer_signup: no entry needed (always allowed)
+    developer_verify_otp: () => {
+        if (!hasCompleted('developer_signup')) {
+            return blocked('You must sign up first before verifying OTP.', ['developer_signup'], ['developer_signup', 'developer_verify_otp']);
+        }
+        return allowed();
+    },
+    // ── Read-only tools (no auth needed) ──────────────────────────────────
+    // get_categories: no entry needed (always allowed — read-only, anyone can browse)
+    // get_status: no entry needed (always allowed)
+    // get_app_lifecycle: no entry needed (always allowed)
+    // ── Hookdeck Setup (needs auth) ───────────────────────────────────────
+    setup_hookdeck: () => {
         if (!isAuthenticated()) {
-            return blocked('You must authenticate first. Call developer_login.', ['developer_login']);
+            return blocked('You must authenticate first. Call developer_login.', ['developer_login'], ['developer_login', 'setup_hookdeck']);
         }
         return allowed();
     },
+    // ── App Setup (needs auth) ────────────────────────────────────────────
     create_app: () => {
         if (!isAuthenticated()) {
-            return blocked('You must authenticate first. Call developer_login.', ['developer_login']);
-        }
-        if (!hasCompleted('get_categories')) {
-            return blocked('You must call get_categories first so the developer can choose app categories.', ['get_categories']);
+            return blocked('You must authenticate first. Call developer_login.', ['developer_login'], ['developer_login', 'create_app']);
         }
         return allowed();
     },
-    // ── Phase 2: Scope Selection (gather requirements → define scopes) ──
+    // ── Requirements (needs app) ──────────────────────────────────────────
     gather_requirements: () => {
         if (!getSession().context.appId) {
-            return blocked('You must create an app first (create_app) before gathering requirements.', ['get_categories', 'create_app']);
+            return blocked('You must create an app first before gathering requirements.', ['create_app'], ['developer_login', 'create_app', 'gather_requirements']);
         }
         return allowed();
     },
     define_app_requirements: () => {
-        if (!getSession().context.appId) {
-            return blocked('You must create an app first (create_app) before defining scopes.', ['get_categories', 'create_app']);
-        }
         if (!hasCompleted('gather_requirements')) {
             return blocked('You must call gather_requirements first to analyze what the developer wants to build, ' +
-                'then use the recommended scopes with define_app_requirements.', ['gather_requirements']);
+                'then use the recommended scopes with define_app_requirements.', ['gather_requirements'], ['gather_requirements', 'define_app_requirements']);
         }
         return allowed();
     },
-    // ── Phase 3: Webhooks (needs scopes confirmed) ─────────────────────
+    // ── Webhooks (needs scopes confirmed) ─────────────────────────────────
     get_webhook_topics: () => {
-        if (!isAuthenticated()) {
-            return blocked('You must authenticate first.', ['developer_login']);
-        }
-        if (!getSession().context.scopesConfirmed) {
-            return blocked('You must confirm scopes first (define_app_requirements) before configuring webhooks. ' +
-                'Webhook events are suggested based on the selected scopes.', ['define_app_requirements']);
-        }
+        // Read-only browsing of webhook topics — no prerequisites
         return allowed();
     },
     create_webhooks: () => {
         if (!getSession().context.appId) {
-            return blocked('You must create an app first before configuring webhooks.', ['create_app']);
+            return blocked('You must create an app first before configuring webhooks.', ['create_app'], ['developer_login', 'create_app', 'create_webhooks']);
         }
         if (!getSession().context.scopesConfirmed) {
-            return blocked('You must confirm scopes first. Webhook events are based on selected scopes.', ['define_app_requirements']);
+            return blocked('You must confirm scopes first (define_app_requirements) before configuring webhooks. ' +
+                'Webhook events should be based on the selected scopes.', ['define_app_requirements'], ['gather_requirements', 'define_app_requirements', 'create_webhooks']);
         }
         return allowed();
     },
-    // ── Phase 4: Scaffold & Build ───────────────────────────────────────
+    // ── Frontend Build Pipeline (needs scopes confirmed) ──────────────────
     scaffold_frontend: () => {
-        if (!getSession().context.appId) {
-            return blocked('You must create an app first before scaffolding.', ['create_app']);
-        }
         if (!getSession().context.scopesConfirmed) {
-            return blocked('You must define and confirm app scopes before scaffolding.', ['define_app_requirements']);
+            return blocked('You must define and confirm app scopes (define_app_requirements) before scaffolding the frontend.', ['define_app_requirements'], ['gather_requirements', 'define_app_requirements', 'scaffold_frontend']);
         }
         return allowed();
     },
     build_frontend: () => {
         if (!hasCompleted('scaffold_frontend')) {
-            return blocked('You must scaffold the frontend first before building.', ['scaffold_frontend']);
+            return blocked('You must scaffold the frontend first before building.', ['scaffold_frontend'], ['scaffold_frontend', 'build_frontend']);
         }
         return allowed();
     },
-    create_submission_zip: () => {
+    validate_build: () => {
         if (!hasCompleted('build_frontend')) {
-            return blocked('You must build the frontend first before creating a submission zip.', ['build_frontend']);
+            return blocked('You must build the frontend first before validating.', ['build_frontend'], ['scaffold_frontend', 'build_frontend', 'validate_build']);
+        }
+        return allowed();
+    },
+    create_submission_zip: () => {
+        if (!hasCompleted('validate_build')) {
+            return blocked('You must validate the build first before creating a submission zip.', ['validate_build'], ['scaffold_frontend', 'build_frontend', 'validate_build', 'create_submission_zip']);
         }
         return allowed();
     },
     upload_build: () => {
-        if (!hasCompleted('build_frontend')) {
-            return blocked('You must build the frontend first before uploading.', ['build_frontend']);
+        if (!hasCompleted('create_submission_zip')) {
+            return blocked('You must create a submission zip first before uploading.', ['create_submission_zip'], ['scaffold_frontend', 'build_frontend', 'validate_build', 'create_submission_zip', 'upload_build']);
         }
         return allowed();
     },
     submit_for_review: () => {
-        if (!getSession().context.buildUploaded && !hasCompleted('upload_build')) {
-            return blocked('You must upload the build first before submitting for review.', ['upload_build']);
+        if (!hasCompleted('upload_build')) {
+            return blocked('You must upload the build first before submitting for review.', ['upload_build'], ['upload_build', 'submit_for_review']);
         }
         return allowed();
     },
-    // ── Phase 5: Publish & OAuth ────────────────────────────────────────
+    // ── Review & Publish ──────────────────────────────────────────────────
+    get_app_status: () => requireAuth(),
     publish_app: () => {
         if (!getSession().context.appApproved) {
-            return blocked('The app must be approved by admin before publishing. Call get_app_status to check.', ['get_app_status']);
-        }
-        return allowed();
-    },
-    request_auth_code: () => {
-        if (!getSession().context.appPublished && !hasCompleted('publish_app')) {
-            return blocked('You must publish the app first before starting the OAuth flow.', ['publish_app']);
-        }
-        return allowed();
-    },
-    get_access_token: () => {
-        if (!hasCompleted('request_auth_code')) {
-            return blocked('You must request an authorization code first.', ['request_auth_code']);
+            return blocked('The app must be approved by admin before publishing. Call get_app_status to check review status.', ['get_app_status'], ['submit_for_review', 'get_app_status', 'publish_app']);
         }
         return allowed();
     },
-    // ── Phase 6: Backend Codegen ────────────────────────────────────────
+    // ── OAuth tools removed from main flow ────────────────────────────────
+    // request_auth_code and get_access_token no longer needed — OAuth happens
+    // via merchant install callback (Hookdeck → localhost → token exchange)
+    // ── Backend Codegen (needs app published) ─────────────────────────────
     scaffold_backend: () => {
-        if (!getSession().context.oauthCompleted) {
-            return blocked('You must complete the OAuth flow (get_access_token) before scaffolding the backend.', ['get_access_token']);
+        if (!getSession().context.appPublished && !hasCompleted('publish_app')) {
+            return blocked('You must publish the app first before scaffolding the backend. ' +
+                'The backend includes an OAuth callback handler that receives merchant install tokens automatically.', ['publish_app'], ['publish_app', 'scaffold_backend']);
         }
         return allowed();
     },
     generate_api_routes: () => {
         if (!hasCompleted('scaffold_backend')) {
-            return blocked('You must scaffold the backend first before generating API routes.', ['scaffold_backend']);
+            return blocked('You must scaffold the backend first before generating API routes.', ['scaffold_backend'], ['scaffold_backend', 'generate_api_routes']);
         }
         return allowed();
     },
-    // ── Management tools (auth only) ───────────────────────────────────
+    // ── Management tools (auth only) ──────────────────────────────────────
     update_app: () => requireAuth(),
     delete_app: () => requireAuth(),
     list_apps: () => requireAuth(),
@@ -129,36 +127,61 @@ const TOOL_PREREQUISITES = {
     list_webhooks: () => requireAuth(),
     toggle_webhook: () => requireAuth(),
     delete_webhook: () => requireAuth(),
-    get_app_status: () => requireAuth(),
     refresh_access_token: () => requireAuth(),
     check_token_status: () => requireAuth(),
-    validate_build: () => requireAuth(),
 };
 // ── Helpers ─────────────────────────────────────────────────────────────
 function allowed() {
     return { allowed: true };
 }
-function blocked(message, requiredTools) {
-    return { allowed: false, message, requiredTools };
+function blocked(message, requiredTools, chain) {
+    return {
+        allowed: false,
+        message,
+        requiredTools,
+        chain,
+        hint: `Please call ${requiredTools.join(' → ')} first, then retry.`,
+    };
 }
 function isAuthenticated() {
     return hasCompletedAny(['developer_login', 'developer_verify_otp']);
 }
 function requireAuth() {
     if (!isAuthenticated()) {
-        return blocked('You must authenticate first. Call developer_login or developer_signup.', ['developer_login']);
+        return blocked('You must authenticate first. Call developer_login or developer_signup + developer_verify_otp.', ['developer_login'], ['developer_login']);
     }
     return allowed();
 }
 // ── Public API ──────────────────────────────────────────────────────────
+/**
+ * Check whether a tool's prerequisites are met.
+ * Returns structured result with error details if blocked.
+ */
 export function checkToolPrerequisites(toolName) {
     const check = TOOL_PREREQUISITES[toolName];
     if (!check)
-        return allowed();
+        return allowed(); // No prerequisites defined → always allowed
     const result = check();
     if (!result.allowed) {
         logger.info(`GUARD BLOCKED: ${toolName} — ${result.message} (need: [${result.requiredTools?.join(', ')}])`);
     }
     return result;
 }
+/**
+ * Get the full prerequisite chain for a tool (for status display).
+ * Returns tool names that must be completed before this tool can run.
+ */
+export function getToolPrerequisiteNames(toolName) {
+    const check = TOOL_PREREQUISITES[toolName];
+    if (!check)
+        return [];
+    const result = check();
+    return result.chain || result.requiredTools || [];
+}
+/**
+ * Get all tool names that have prerequisites defined.
+ */
+export function getGuardedToolNames() {
+    return Object.keys(TOOL_PREREQUISITES);
+}
 //# sourceMappingURL=tool-guard.js.map

package/dist/services/tool-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-guard.js","sourceRoot":"","sources":["../../src/services/tool-guard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-guard.js","sourceRoot":"","sources":["../../src/services/tool-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA6B5C,2EAA2E;AAE3E,MAAM,kBAAkB,GAAsC;IAE5D,yEAAyE;IACzE,sEAAsE;IAEtE,oBAAoB,EAAE,GAAG,EAAE;QACzB,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACtC,OAAO,OAAO,CACZ,8CAA8C,EAC9C,CAAC,kBAAkB,CAAC,EACpB,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAC7C,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,kFAAkF;IAClF,+CAA+C;IAC/C,sDAAsD;IAEtD,yEAAyE;IACzE,cAAc,EAAE,GAAG,EAAE;QACnB,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;YACvB,OAAO,OAAO,CACZ,oDAAoD,EACpD,CAAC,iBAAiB,CAAC,EACnB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CACtC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,UAAU,EAAE,GAAG,EAAE;QACf,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;YACvB,OAAO,OAAO,CACZ,oDAAoD,EACpD,CAAC,iBAAiB,CAAC,EACnB,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAClC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,mBAAmB,EAAE,GAAG,EAAE;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,OAAO,CACZ,6DAA6D,EAC7D,CAAC,YAAY,CAAC,EACd,CAAC,iBAAiB,EAAE,YAAY,EAAE,qBAAqB,CAAC,CACzD,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,uBAAuB,EAAE,GAAG,EAAE;QAC5B,IAAI,CAAC,YAAY,CAAC,qBAAqB,CAAC,EAAE,CAAC;YACzC,OAAO,OAAO,CACZ,wFAAwF;gBACxF,+DAA+D,EAC/D,CAAC,qBAAqB,CAAC,EACvB,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CACnD,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,kBAAkB,EAAE,GAAG,EAAE;QACvB,0DAA0D;QAC1D,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,eAAe,EAAE,GAAG,EAAE;QACpB,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,OAAO,CACZ,2DAA2D,EAC3D,CAAC,YAAY,CAAC,EACd,CAAC,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,CAAC,CACrD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC1C,OAAO,OAAO,CACZ,uFAAuF;gBACvF,wDAAwD,EACxD,CAAC,yBAAyB,CAAC,EAC3B,CAAC,qBAAqB,EAAE,yBAAyB,EAAE,iBAAiB,CAAC,CACtE,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,iBAAiB,EAAE,GAAG,EAAE;QACtB,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC1C,OAAO,OAAO,CACZ,mGAAmG,EACnG,CAAC,yBAAyB,CAAC,EAC3B,CAAC,qBAAqB,EAAE,yBAAyB,EAAE,mBAAmB,CAAC,CACxE,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,cAAc,EAAE,GAAG,EAAE;QACnB,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACvC,OAAO,OAAO,CACZ,uDAAuD,EACvD,CAAC,mBAAmB,CAAC,EACrB,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CACxC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,cAAc,EAAE,GAAG,EAAE;QACnB,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpC,OAAO,OAAO,CACZ,sDAAsD,EACtD,CAAC,gBAAgB,CAAC,EAClB,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,qBAAqB,EAAE,GAAG,EAAE;QAC1B,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpC,OAAO,OAAO,CACZ,qEAAqE,EACrE,CAAC,gBAAgB,CAAC,EAClB,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,CAAC,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,YAAY,EAAE,GAAG,EAAE;QACjB,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAC3C,OAAO,OAAO,CACZ,0DAA0D,EAC1D,CAAC,uBAAuB,CAAC,EACzB,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,CAAC,CACnG,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,iBAAiB,EAAE,GAAG,EAAE;QACtB,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;YAClC,OAAO,OAAO,CACZ,+DAA+D,EAC/D,CAAC,cAAc,CAAC,EAChB,CAAC,cAAc,EAAE,mBAAmB,CAAC,CACtC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,cAAc,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IAEnC,WAAW,EAAE,GAAG,EAAE;QAChB,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACtC,OAAO,OAAO,CACZ,kGAAkG,EAClG,CAAC,gBAAgB,CAAC,EAClB,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,CAAC,CACvD,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IAExE,yEAAyE;IACzE,gBAAgB,EAAE,GAAG,EAAE;QACrB,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;YACvE,OAAO,OAAO,CACZ,iEAAiE;gBACjE,qGAAqG,EACrG,CAAC,aAAa,CAAC,EACf,CAAC,aAAa,EAAE,kBAAkB,CAAC,CACpC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,mBAAmB,EAAE,GAAG,EAAE;QACxB,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACtC,OAAO,OAAO,CACZ,mEAAmE,EACnE,CAAC,kBAAkB,CAAC,EACpB,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAC5C,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IACzE,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/B,SAAS,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5B,aAAa,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IAClC,cAAc,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IACnC,cAAc,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IACnC,oBAAoB,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,kBAAkB,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;CACxC,CAAC;AAEF,2EAA2E;AAE3E,SAAS,OAAO;IACd,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,OAAO,CAAC,OAAe,EAAE,aAAuB,EAAE,KAAgB;IACzE,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO;QACP,aAAa;QACb,KAAK;QACL,IAAI,EAAE,eAAe,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,eAAe,CAAC,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,WAAW;IAClB,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACvB,OAAO,OAAO,CACZ,+FAA+F,EAC/F,CAAC,iBAAiB,CAAC,EACnB,CAAC,iBAAiB,CAAC,CACpB,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,2EAA2E;AAE3E;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,EAAE,CAAC,CAAC,4CAA4C;IAE1E,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CACT,kBAAkB,QAAQ,MAAM,MAAM,CAAC,OAAO,YAAY,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAC/F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,OAAO,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AACzC,CAAC"}

package/dist/templates/backend/.env.example

@@ -20,3 +20,6 @@ RATIO_SCOPES=
 # JWT
 JWT_SECRET=your_jwt_secret_change_this
 JWT_EXPIRES_IN=7d
+
+# Hookdeck (managed by MCP — do not edit)
+HOOKDECK_URL=

package/dist/templates/backend/package.json

@@ -6,7 +6,8 @@
     "build": "nest build",
     "start": "nest start",
     "start:dev": "nest start --watch",
-    "start:prod": "node dist/main"
+    "start:prod": "node dist/main",
+    "dev": "nest start --watch"
   },
   "dependencies": {
     "@nestjs/common": "^10.3.0",

package/dist/templates/backend/src/app.module.ts

@@ -1,9 +1,11 @@
 import { Module } from '@nestjs/common';
 import { ConfigModule } from '@nestjs/config';
+import { OAuthCallbackModule } from './oauth/oauth-callback.module';
 
 @Module({
   imports: [
     ConfigModule.forRoot({ isGlobal: true }),
+    OAuthCallbackModule,
     // Resource modules will be added here by generate_api_routes
   ],
 })

package/dist/templates/backend/src/oauth/oauth-callback.controller.ts

@@ -0,0 +1,62 @@
+import { Controller, Get, Query, Logger, Res } from '@nestjs/common';
+import { Response } from 'express';
+import { OAuthCallbackService } from './oauth-callback.service';
+
+@Controller()
+export class OAuthCallbackController {
+  private readonly logger = new Logger(OAuthCallbackController.name);
+
+  constructor(private readonly oauthService: OAuthCallbackService) {}
+
+  /**
+   * OAuth callback endpoint.
+   * Receives the authorization code from the merchant store redirect:
+   *   GET /callback?code=xxx&state=yyy
+   *
+   * Exchanges the code for an access token and stores it per merchant.
+   */
+  @Get('callback')
+  async handleCallback(
+    @Query('code') code: string,
+    @Query('state') state: string,
+    @Res() res: Response,
+  ) {
+    this.logger.log(`OAuth callback received — code=${code?.substring(0, 12)}..., state=${state?.substring(0, 12)}...`);
+
+    if (!code) {
+      this.logger.warn('OAuth callback received without code');
+      return res.status(400).send(`
+        <html><body>
+          <h1>OAuth Error</h1>
+          <p>No authorization code received. The merchant may have denied the request.</p>
+        </body></html>
+      `);
+    }
+
+    try {
+      const result = await this.oauthService.exchangeCodeForToken(code);
+
+      this.logger.log(`App installed successfully for merchant: ${result.merchant_id}`);
+
+      return res.status(200).send(`
+        <html><body>
+          <h1>App Installed Successfully!</h1>
+          <p>Merchant <strong>${result.merchant_id}</strong> has installed your app.</p>
+          <p>Access token injected. Your API routes are now live.</p>
+          <p>Scopes granted: <code>${result.scopes}</code></p>
+          <p style="color: #666; font-size: 0.9em;">You can close this window.</p>
+        </body></html>
+      `);
+    } catch (error: any) {
+      this.logger.error(`OAuth callback failed: ${error.message}`);
+
+      return res.status(500).send(`
+        <html><body>
+          <h1>Installation Failed</h1>
+          <p>Error: ${error.message}</p>
+          <p>Please try installing the app again.</p>
+        </body></html>
+      `);
+    }
+  }
+}

package/dist/templates/backend/src/oauth/oauth-callback.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { OAuthCallbackController } from './oauth-callback.controller';
+import { OAuthCallbackService } from './oauth-callback.service';
+
+@Module({
+  controllers: [OAuthCallbackController],
+  providers: [OAuthCallbackService],
+  exports: [OAuthCallbackService],
+})
+export class OAuthCallbackModule {}

package/dist/templates/backend/src/oauth/oauth-callback.service.ts

@@ -0,0 +1,158 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import axios from 'axios';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+@Injectable()
+export class OAuthCallbackService {
+  private readonly logger = new Logger(OAuthCallbackService.name);
+  private readonly apiBaseUrl: string;
+  private readonly clientId: string;
+  private readonly clientSecret: string;
+  private readonly redirectUri: string;
+
+  constructor(private configService: ConfigService) {
+    this.apiBaseUrl = this.configService.get<string>('RATIO_API_BASE_URL');
+    this.clientId = this.configService.get<string>('RATIO_APP_ID', '');
+    this.clientSecret = this.configService.get<string>('RATIO_APP_SECRET', '');
+    this.redirectUri = this.configService.get<string>('RATIO_REDIRECT_URI', 'http://localhost:3000/callback');
+  }
+
+  /**
+   * Exchange authorization code for access token.
+   * Writes token to process.env (immediate) + .env file (persists across restarts).
+   */
+  async exchangeCodeForToken(code: string) {
+    this.logger.log(`Exchanging authorization code for access token...`);
+
+    try {
+      const response = await axios.post(`${this.apiBaseUrl}/api/v1/oauth/token`, {
+        grant_type: 'authorization_code',
+        code,
+        clientId: this.clientId,
+        clientSecret: this.clientSecret,
+        redirectUri: this.redirectUri,
+      });
+
+      const data = response.data;
+
+      // Update process.env immediately (hot-reload — no restart needed)
+      process.env.RATIO_ACCESS_TOKEN = data.access_token;
+      process.env.RATIO_REFRESH_TOKEN = data.refresh_token;
+      process.env.RATIO_MERCHANT_ID = data.merchant_id;
+      process.env.RATIO_SCOPES = data.scope;
+
+      // Persist to .env file so it survives restarts
+      this.writeToEnvFile({
+        RATIO_ACCESS_TOKEN: data.access_token,
+        RATIO_REFRESH_TOKEN: data.refresh_token,
+        RATIO_MERCHANT_ID: data.merchant_id,
+        RATIO_SCOPES: data.scope,
+      });
+
+      // Console output so the developer sees the token info
+      console.log('\n' + '='.repeat(60));
+      console.log('NEW MERCHANT INSTALLED YOUR APP!');
+      console.log('='.repeat(60));
+      console.log(`Merchant ID:    ${data.merchant_id}`);
+      console.log(`Access Token:   ${data.access_token}`);
+      console.log(`Refresh Token:  ${data.refresh_token}`);
+      console.log(`Scopes:         ${data.scope}`);
+      console.log('='.repeat(60));
+      console.log('Token injected into process.env and .env file.');
+      console.log('Your API routes are now live — no restart needed.');
+      console.log('='.repeat(60) + '\n');
+
+      this.logger.log(`Token obtained for merchant: ${data.merchant_id}`);
+
+      return {
+        access_token: data.access_token,
+        merchant_id: data.merchant_id,
+        scopes: data.scope,
+      };
+    } catch (error: any) {
+      const errMsg = error.response?.data?.message || error.message;
+      this.logger.error(`Token exchange failed: ${errMsg}`);
+      throw new Error(`OAuth token exchange failed: ${errMsg}`);
+    }
+  }
+
+  /**
+   * Refresh an expired access token using the refresh token from process.env.
+   */
+  async refreshToken(): Promise<void> {
+    const refreshToken = process.env.RATIO_REFRESH_TOKEN;
+    if (!refreshToken) {
+      throw new Error('No refresh token available. A merchant must install the app first.');
+    }
+
+    this.logger.log('Refreshing access token...');
+
+    const response = await axios.post(`${this.apiBaseUrl}/api/v1/oauth/token`, {
+      grant_type: 'refresh_token',
+      refresh_token: refreshToken,
+      clientId: this.clientId,
+      clientSecret: this.clientSecret,
+    });
+
+    const data = response.data;
+
+    // Update process.env immediately
+    process.env.RATIO_ACCESS_TOKEN = data.access_token;
+    process.env.RATIO_REFRESH_TOKEN = data.refresh_token;
+    if (data.merchant_id) process.env.RATIO_MERCHANT_ID = data.merchant_id;
+    if (data.scope) process.env.RATIO_SCOPES = data.scope;
+
+    // Persist to .env file
+    this.writeToEnvFile({
+      RATIO_ACCESS_TOKEN: data.access_token,
+      RATIO_REFRESH_TOKEN: data.refresh_token,
+      ...(data.merchant_id && { RATIO_MERCHANT_ID: data.merchant_id }),
+      ...(data.scope && { RATIO_SCOPES: data.scope }),
+    });
+
+    this.logger.log('Access token refreshed successfully.');
+  }
+
+  /**
+   * Get the current access token from process.env.
+   * Returns null if no merchant has installed yet.
+   */
+  getAccessToken(): string | null {
+    return process.env.RATIO_ACCESS_TOKEN || null;
+  }
+
+  /**
+   * Get the current merchant ID from process.env.
+   */
+  getMerchantId(): string | null {
+    return process.env.RATIO_MERCHANT_ID || null;
+  }
+
+  /**
+   * Write key-value pairs to the .env file. Updates existing keys, appends new ones.
+   */
+  private writeToEnvFile(values: Record<string, string>): void {
+    const envPath = join(process.cwd(), '.env');
+    if (!existsSync(envPath)) return;
+
+    try {
+      let envContent = readFileSync(envPath, 'utf-8');
+
+      for (const [key, value] of Object.entries(values)) {
+        const regex = new RegExp(`^${key}=.*$`, 'm');
+        if (regex.test(envContent)) {
+          envContent = envContent.replace(regex, `${key}=${value}`);
+        } else {
+          envContent += `\n${key}=${value}`;
+        }
+      }
+
+      writeFileSync(envPath, envContent);
+      this.logger.log('Updated .env file with new token values.');
+    } catch (error: any) {
+      this.logger.warn(`Failed to update .env file: ${error.message}`);
+    }
+  }
+}

package/dist/templates/frontend/.env.example

@@ -3,4 +3,4 @@ VITE_APP_NAME=My Ratio App
 VITE_APP_VERSION=1.0.0
 VITE_RATIO_CLIENT_ID=your_client_id
 VITE_RATIO_REDIRECT_URI=http://localhost:5173/callback
-VITE_RATIO_DASHBOARD_URL=https://adm-apps.gokwik.co
+VITE_RATIO_DASHBOARD_URL=https://dev-developers.dev.gokwik.in

package/dist/templates/frontend/README.md

@@ -0,0 +1,16 @@
+# React + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.

package/dist/templates/frontend/eslint.config.js

@@ -0,0 +1,29 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{js,jsx}'],
+    extends: [
+      js.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        ecmaFeatures: { jsx: true },
+        sourceType: 'module',
+      },
+    },
+    rules: {
+      'no-unused-vars': ['error', { varsIgnorePattern: '^[A-Z_]' }],
+    },
+  },
+])

package/dist/templates/frontend/index.html

@@ -1,13 +1,13 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Ratio App</title>
+    <title>frontend-template</title>
   </head>
   <body>
     <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
+    <script type="module" src="/src/main.jsx"></script>
   </body>
 </html>

package/dist/templates/frontend/jsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@components/*": ["./src/components/*"],
+      "@assets/*": ["./src/assets/*"],
+      "@hooks/*": ["./src/hooks/*"],
+      "@utils/*": ["./src/utils/*"],
+      "@pages/*": ["./src/pages/*"]
+    },
+    "jsx": "react-jsx",
+    "jsxImportSource": "react",
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true
+  },
+  "include": ["src"],
+  "references": [{ "path": "./tsconfig.app.json" }]
+}