// Generated by notion tool-core codegen-script-types --connections. Do not edit.
import type { ConnectionActionInvoker } from "./connection-actions.js"
/**
 * Script input for the "Query Confluence with CQL" effect (`confluence.cqlQuery`),
 * derived from its Tool Core definition's call_function input projection.
 *
 * Run a CQL query and return results.
 */
export type CqlQueryScriptInput = {
	/**
	 * CQL query string. Only read-only queries are supported. Example: type=page AND space=DEV AND text~"deployment"
	 */
	query: string
	/**
	 * Maximum number of results to return. Defaults to 20.
	 */
	maxResults?: number
}

/**
 * Canonical Tool Core output for the "Query Confluence with CQL" effect (`confluence.cqlQuery`).
 * This is the definition's output schema; the effect's script surface may
 * re-encode it before returning.
 */
export type CqlQueryScriptOutput = {
	results: Array<{
		id: string
		title: string
		blocks: Array<string>
	}>
	query: string
	baseUrl: string
}

/**
 * Script input for the "Load Confluence page" effect (`confluence.loadPage`),
 * derived from its Tool Core definition's call_function input projection.
 *
 * Load a Confluence page by ID.
 */
export type LoadPageScriptInput = {
	/**
	 * The Confluence page ID to load.
	 */
	pageId: string
}

/**
 * Canonical Tool Core output for the "Load Confluence page" effect (`confluence.loadPage`).
 * This is the definition's output schema; the effect's script surface may
 * re-encode it before returning.
 */
export type LoadPageScriptOutput = {
	type: "confluence-page"
	title: string
	blocks: Array<string>
	pageId: string
}

/**
 * Script input for the "Search Confluence" effect (`confluence.search`),
 * derived from its Tool Core definition's call_function input projection.
 *
 * Search Confluence via the configured connector.
 */
export type SearchScriptInput = {
	/**
	 * A single, focused question to search for.
	 */
	question: string
	/**
	 * Brief keywords capturing the core entities.
	 */
	keywords?: string
	/**
	 * Optional time window. Use only "default", "all_time", a duration matching /^\d+[dwmy]$/ (for example, "7d", "2w", "3m", or "1y"), or a date in "YYYY-MM-DD" format. Do not use natural-language durations or combine units.
	 */
	lookback?: string
}

/**
 * Canonical Tool Core output for the "Search Confluence" effect (`confluence.search`).
 * This is the definition's output schema; the effect's script surface may
 * re-encode it before returning.
 */
export type SearchScriptOutput = {
	results: Array<{
		id: string
		title: string
		path: string
		text: string
		lastEdited: string
		isPrivate: boolean
		pageId: string
	}>
}

export class ConfluenceConnectionClient {
	constructor(private readonly invoke: ConnectionActionInvoker) {}
	cqlQuery(args: CqlQueryScriptInput): Promise<CqlQueryScriptOutput> {
		return this.invoke<CqlQueryScriptOutput>("cqlQuery", args)
	}
	loadPage(args: LoadPageScriptInput): Promise<LoadPageScriptOutput> {
		return this.invoke<LoadPageScriptOutput>("loadPage", args)
	}
	search(args: SearchScriptInput): Promise<SearchScriptOutput> {
		return this.invoke<SearchScriptOutput>("search", args)
	}
}