custom integration docs (#70)

* custom integration docs

* Exclude README.mdx from sync, fix App ID wording in agents

* update post processing

* address review

* minor fix

* more fixes

* Update SDK documentation

* Make subscribe() method public in docs

* Fix docs: hide loginWithProvider, show realtime types, remove README.mdx

* Remove unused Subscription type

Author: wixysam

scripts/mintlify-post-processing/appended-articles.json

@@ -1,4 +1,7 @@
 {
   "interfaces/EntitiesModule": "interfaces/EntityHandler",
-  "type-aliases/integrations": "interfaces/CoreIntegrations"
+  "type-aliases/integrations": [
+    "interfaces/CoreIntegrations",
+    "interfaces/CustomIntegrationsModule"
+  ]
 }

scripts/mintlify-post-processing/copy-to-local-docs.js

@@ -248,6 +248,12 @@ function main() {
     console.log(`Copying docs to ${sdkDocsTarget}...`);
     fs.cpSync(DOCS_SOURCE_PATH, sdkDocsTarget, { recursive: true });
 
+    // Remove README.mdx - it's not used in the docs navigation
+    const readmePath = path.join(sdkDocsTarget, "README.mdx");
+    if (fs.existsSync(readmePath)) {
+      fs.rmSync(readmePath, { force: true });
+    }
+
     // Scan the sdk-docs directory
     const sdkFiles = scanSdkDocs(sdkDocsTarget);
     console.debug(`SDK files: ${JSON.stringify(sdkFiles, null, 2)}`);