@zackbart/connecta 0.30.0 → 0.31.0

package/dist/providers/notion/index.d.ts

@@ -1,19 +1,9 @@
 import type { ConnectorCallAdmissionPolicy } from "../../types.js";
-/** Notion's REST origin. Every tool below speaks to exactly this host. */
-export declare const NOTION_API_BASE_URL = "https://api.notion.com";
+export { NOTION_API_BASE_URL, NOTION_API_VERSION } from "./rest.js";
 /** Notion's official hosted MCP endpoint. */
 export declare const NOTION_MCP_ENDPOINT = "https://mcp.notion.com/mcp";
-/**
- * Pinned with no override. Notion's date-named versions keep working
- * indefinitely, which makes an override look harmless; it is not. `2026-03-11`
- * is where databases split into data sources, `archived` became `in_trash`, and
- * block append took a `position` object instead of an `after` string. Every
- * projection and write body here assumes those shapes, so an older version would
- * return quietly wrong results rather than fail loudly.
- */
-export declare const NOTION_API_VERSION = "2026-03-11";
 interface NotionCommonOptions {
-    /** Human-readable display name; defaults identify the selected interface. */
+    /** Human-readable display name; defaults identify the selected implementation. */
     title?: string;
     /** Downstream auth ownership. Defaults to one shared deployment grant. */
     authScope?: "shared" | "personal";
@@ -24,31 +14,45 @@ interface NotionCommonOptions {
     /** Connector-specific inline result limit; omit to inherit the deployment. */
     maxResultBytes?: number;
 }
-/** Connecta's maintained hand-written Notion REST interface. */
-export interface NotionApiOptions extends NotionCommonOptions {
-    /** Select integration-owned REST operations explicitly; hosted user MCP is the default. */
-    surface: "api";
+/**
+ * Notion's official hosted MCP server, acting as the OAuth-authorized user.
+ * OAuth only: no integration token reaches the hosted endpoint.
+ */
+export interface NotionOAuthOptions extends NotionCommonOptions {
+    auth: {
+        type: "oauth";
+    };
+    /** Optional per-runtime downstream call-admission policy. */
+    callAdmission?: ConnectorCallAdmissionPolicy;
+    /** Refused: the hosted server holds no operator credential. */
+    credentialLabel?: never;
+    /** Refused: hosted tools own their own paging. */
+    defaultPageSize?: never;
+}
+/**
+ * Connecta's REST connector to `api.notion.com`, acting as one internal
+ * integration with an operator-managed token pasted into the connection in
+ * the operator UI.
+ */
+export interface NotionTokenOptions extends NotionCommonOptions {
+    auth: {
+        type: "token";
+    };
     /** Operator-facing label for the integration token. */
     credentialLabel?: string;
     /**
-     * Default `page_size` for list-shaped tools when the caller omits one.
+     * Default `page_size` for the named list tools when the caller omits one.
      * Defaults to 25; Notion's maximum is 100.
      */
     defaultPageSize?: number;
 }
-/** Notion's official hosted MCP interface, authenticated through OAuth. */
-export interface NotionMcpOptions extends NotionCommonOptions {
-    surface?: "mcp";
-    /** Optional per-runtime downstream call-admission policy. */
-    callAdmission?: ConnectorCallAdmissionPolicy;
-}
-/** Explicit integration-owned REST options; use NotionConnectionOptions for either identity. */
-export interface NotionOptions extends NotionApiOptions {
-}
-/** Select one Notion interface when deployment configuration constructs it. */
-export type NotionConnectionOptions = NotionOptions | NotionMcpOptions;
-/** A maintained Notion connection using the selected provider interface. */
-export declare const notion: import("../../provider.js").ProviderFactory<NotionConnectionOptions>;
+/** `auth` selects the implementation: hosted MCP over OAuth, or REST with a token. */
+export type NotionOptions = NotionOAuthOptions | NotionTokenOptions;
+/**
+ * A maintained Notion connection. `auth` selects the implementation: OAuth
+ * reaches Notion's hosted MCP server as the authorizing user; an integration
+ * token reaches Connecta's REST connector to `api.notion.com` as that bot.
+ */
+export declare const notion: import("../../provider.js").ProviderFactory<NotionOptions>;
 /** @deprecated Read `notion.definition.classify` instead. Kept for existing imports. */
 export declare const NOTION_MCP_VETTED_CATALOG: import("../../catalog-drift.js").VettedCatalog;
-export {};