more fixes

Author: wixysam

scripts/mintlify-post-processing/typedoc-plugin/typedoc-mintlify-linked-types.js

@@ -462,14 +462,29 @@ function extractPropertiesFromMarkdownFile(linkedTypeInfo, context) {
  */
 function parsePropertiesFromTypeFile(content) {
   const properties = [];
-  const lines = content.split("\n");
+  
+  // Strip YAML frontmatter if present
+  let contentWithoutFrontmatter = content;
+  if (content.startsWith("---")) {
+    const endIndex = content.indexOf("\n---", 3);
+    if (endIndex !== -1) {
+      contentWithoutFrontmatter = content.slice(endIndex + 4).trimStart();
+    }
+  }
+  
+  // Strip leading horizontal rule (***) that TypeDoc adds after frontmatter
+  if (contentWithoutFrontmatter.startsWith("***")) {
+    contentWithoutFrontmatter = contentWithoutFrontmatter.slice(3).trimStart();
+  }
+  
+  const lines = contentWithoutFrontmatter.split("\n");
 
   // Collect intro description until Properties section
   const introLines = [];
   let descriptionCaptured = false;
 
-  // Extract Indexable section if present
-  const indexSignature = parseIndexableSection(content);
+  // Extract Indexable section if present (use content without frontmatter)
+  const indexSignature = parseIndexableSection(contentWithoutFrontmatter);
 
   // Find the Properties section
   let inPropertiesSection = false;

src/client.types.ts

@@ -86,7 +86,10 @@ export interface Base44Client {
   agents: AgentsModule;
   /** {@link AppLogsModule | App logs module} for tracking app usage. */
   appLogs: AppLogsModule;
-  /** {@link AnalyticsModule | Analytics module} for tracking app usage. */
+  /**
+   * {@link AnalyticsModule | Analytics module} for tracking app usage.
+   * @internal
+   */
   analytics: AnalyticsModule;
   /** Cleanup function to disconnect WebSocket connections. Call when you're done with the client. */
   cleanup: () => void;

src/modules/custom-integrations.types.ts

@@ -8,7 +8,7 @@ export interface CustomIntegrationCallParams {
   payload?: Record<string, any>;
 
   /**
-   * Path parameters to substitute in the URL (e.g., `{ owner: "user", repo: "repo" }`).
+   * Path parameters to substitute in the URL. For example, `{ owner: "user", repo: "repo" }`.
    */
   pathParams?: Record<string, string>;
 
@@ -42,49 +42,7 @@ export interface CustomIntegrationCallResponse {
 /**
  * Module for calling custom workspace-level API integrations.
  *
- * Custom integrations allow workspace administrators to connect any external API
- * by importing an OpenAPI specification. Apps in the workspace can then call
- * these integrations using this module.
- *
- * Unlike the built-in integrations (like `Core`), custom integrations:
- * - Are defined per-workspace by importing OpenAPI specs
- * - Use a slug-based identifier instead of package names
- * - Proxy requests through Base44's backend (credentials never exposed to frontend)
- *
- * @example
- * ```typescript
- * // Call a custom CRM integration
- * const response = await base44.integrations.custom.call(
- *   "my-crm",         // integration slug (defined by workspace admin)
- *   "get:/contacts",  // endpoint: method:path format
- *   {
- *     queryParams: { limit: 10 }
- *   }
- * );
- *
- * if (response.success) {
- *   console.log("Contacts:", response.data);
- * } else {
- *   console.error("API returned error:", response.status_code);
- * }
- * ```
- *
- * @example
- * ```typescript
- * // Call with path params and request body payload
- * const response = await base44.integrations.custom.call(
- *   "github",
- *   "post:/repos/{owner}/{repo}/issues",
- *   {
- *     pathParams: { owner: "myorg", repo: "myrepo" },
- *     payload: {
- *       title: "Bug report",
- *       body: "Something is broken",
- *       labels: ["bug"]
- *     }
- *   }
- * );
- * ```
+ * Custom integrations allow workspace administrators to connect any external API by importing an OpenAPI specification. Apps in the workspace can then call these integrations using this module.
  */
 export interface CustomIntegrationsModule {
   /**
@@ -100,6 +58,36 @@ export interface CustomIntegrationsModule {
    * @throws {Base44Error} If the integration or operation is not found (404).
    * @throws {Base44Error} If the external API call fails (502).
    * @throws {Base44Error} If the request times out (504).
+   *
+   * @example
+   * ```typescript
+   * // Call a custom CRM integration
+   * const response = await base44.integrations.custom.call(
+   *   "my-crm",
+   *   "get:/contacts",
+   *   { queryParams: { limit: 10 } }
+   * );
+   *
+   * if (response.success) {
+   *   console.log("Contacts:", response.data);
+   * }
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Call with path params and request body
+   * const response = await base44.integrations.custom.call(
+   *   "github",
+   *   "post:/repos/{owner}/{repo}/issues",
+   *   {
+   *     pathParams: { owner: "myorg", repo: "myrepo" },
+   *     payload: {
+   *       title: "Bug report",
+   *       body: "Something is broken"
+   *     }
+   *   }
+   * );
+   * ```
    */
   call(
     slug: string,

src/modules/entities.types.ts

@@ -1,10 +1,12 @@
 /**
  * Event types for realtime entity updates.
+ * @internal
  */
 export type RealtimeEventType = "create" | "update" | "delete";
 
 /**
  * Payload received when a realtime event occurs.
+ * @internal
  */
 export interface RealtimeEvent {
   /** The type of change that occurred */
@@ -19,11 +21,13 @@ export interface RealtimeEvent {
 
 /**
  * Callback function invoked when a realtime event occurs.
+ * @internal
  */
 export type RealtimeCallback = (event: RealtimeEvent) => void;
 
 /**
  * Function returned from subscribe, call it to unsubscribe.
+ * @internal
  */
 export type Subscription = () => void;
 
@@ -309,6 +313,7 @@ export interface EntityHandler {
    * // Later, unsubscribe
    * unsubscribe();
    * ```
+   * @internal
    */
   subscribe(callback: RealtimeCallback): Subscription;
 }

src/modules/integrations.types.ts

@@ -351,22 +351,28 @@ export interface CoreIntegrations {
 }
 
 /**
- * Integrations module for calling integration endpoints.
+ * Integrations module for calling integration methods.
  *
- * This module provides access to integration endpoints for interacting with external
- * services. Integrations are organized into packages. Base44 provides built-in integrations
- * in the `Core` package.
+ * This module provides access to integration methods for interacting with external services. Unlike the connectors module that gives you raw OAuth tokens, integrations provide pre-built functions that Base44 executes on your behalf.
  *
- * Unlike the connectors module that gives you raw OAuth tokens, integrations provide
- * pre-built functions that Base44 executes on your behalf.
+ * There are two types of integrations:
  *
- * Integration endpoints are accessed dynamically using the pattern:
- * `base44.integrations.PackageName.EndpointName(params)`
+ * - **Built-in integrations** (`Core`): Pre-built functions provided by Base44 for common tasks such as AI-powered text generation, image creation, file uploads, and email. Access core integration methods using:
+ *   ```
+ *   base44.integrations.Core.FunctionName(params)
+ *   ```
+ *
+ * - **Custom integrations** (`custom`): Pre-configured external APIs. Custom integration calls are proxied through Base44's backend, so credentials are never exposed to the frontend. Access custom integration methods using:
+ *   ```
+ *   base44.integrations.custom.call(slug, operationId, params)
+ *   ```
+ *
+ *   <Info>To call a custom integration, it must be pre-configured by a workspace administrator who imports an OpenAPI specification.</Info>
  *
  * This module is available to use with a client in all authentication modes:
  *
- * - **Anonymous or User authentication** (`base44.integrations`): Integration endpoints are invoked with the current user's permissions. Anonymous users invoke endpoints without authentication, while authenticated users invoke endpoints with their authentication context.
- * - **Service role authentication** (`base44.asServiceRole.integrations`): Integration endpoints are invoked with elevated admin-level permissions. The endpoints execute with admin authentication context.
+ * - **Anonymous or User authentication** (`base44.integrations`): Integration methods are invoked with the current user's permissions. Anonymous users invoke methods without authentication, while authenticated users invoke methods with their authentication context.
+ * - **Service role authentication** (`base44.asServiceRole.integrations`): Integration methods are invoked with elevated admin-level permissions. The methods execute with admin authentication context.
  */
 export type IntegrationsModule = {
   /**
@@ -375,22 +381,7 @@ export type IntegrationsModule = {
   Core: CoreIntegrations;
 
   /**
-   * Custom integrations module for calling workspace-level API integrations.
-   *
-   * Allows calling external APIs that workspace admins have configured
-   * by importing OpenAPI specifications.
-   *
-   * @example
-   * ```typescript
-   * const response = await base44.integrations.custom.call(
-   *   "github",        // integration slug
-   *   "listIssues",    // operation ID
-   *   {
-   *     pathParams: { owner: "myorg", repo: "myrepo" },
-   *     queryParams: { state: "open" }
-   *   }
-   * );
-   * ```
+   * Custom integrations module for calling pre-configured external APIs.
    */
   custom: CustomIntegrationsModule;
 } & {