@squadbase/vite-server 0.1.3-dev.0 → 0.1.3-dev.2

package/dist/connectors/notion.js

@@ -0,0 +1,580 @@
+// ../connectors/src/parameter-definition.ts
+var ParameterDefinition = class {
+  slug;
+  name;
+  description;
+  envVarBaseKey;
+  type;
+  secret;
+  required;
+  constructor(config) {
+    this.slug = config.slug;
+    this.name = config.name;
+    this.description = config.description;
+    this.envVarBaseKey = config.envVarBaseKey;
+    this.type = config.type;
+    this.secret = config.secret;
+    this.required = config.required;
+  }
+  /**
+   * Get the parameter value from a ConnectorConnectionObject.
+   */
+  getValue(connection2) {
+    const param = connection2.parameters.find(
+      (p) => p.parameterSlug === this.slug
+    );
+    if (!param || param.value == null) {
+      throw new Error(
+        `Parameter "${this.slug}" not found or has no value in connection "${connection2.id}"`
+      );
+    }
+    return param.value;
+  }
+  /**
+   * Try to get the parameter value. Returns undefined if not found (for optional params).
+   */
+  tryGetValue(connection2) {
+    const param = connection2.parameters.find(
+      (p) => p.parameterSlug === this.slug
+    );
+    if (!param || param.value == null) return void 0;
+    return param.value;
+  }
+};
+
+// ../connectors/src/connectors/notion/parameters.ts
+var parameters = {
+  apiKey: new ParameterDefinition({
+    slug: "api-key",
+    name: "Notion Internal Integration Token",
+    description: "The Internal Integration Token from your Notion integration settings (starts with ntn_ or secret_).",
+    envVarBaseKey: "NOTION_API_KEY",
+    type: "text",
+    secret: true,
+    required: true
+  })
+};
+
+// ../connectors/src/connectors/notion/sdk/index.ts
+var BASE_URL = "https://api.notion.com/v1";
+var NOTION_VERSION = "2022-06-28";
+function createClient(params) {
+  const apiKey = params[parameters.apiKey.slug];
+  if (!apiKey) {
+    throw new Error(
+      `notion: missing required parameter: ${parameters.apiKey.slug}`
+    );
+  }
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("Authorization", `Bearer ${apiKey}`);
+    headers.set("Notion-Version", NOTION_VERSION);
+    headers.set("Content-Type", "application/json");
+    return headers;
+  }
+  async function assertOk(res, label) {
+    if (!res.ok) {
+      const body = await res.text().catch(() => "(unreadable body)");
+      throw new Error(
+        `notion ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  return {
+    request(path2, init) {
+      const url = `${BASE_URL}${path2.startsWith("/") ? "" : "/"}${path2}`;
+      const headers = new Headers(init?.headers);
+      headers.set("Authorization", `Bearer ${apiKey}`);
+      headers.set("Notion-Version", NOTION_VERSION);
+      headers.set("Content-Type", "application/json");
+      return fetch(url, { ...init, headers });
+    },
+    async search(options) {
+      const body = {};
+      if (options?.query) body.query = options.query;
+      if (options?.filter) body.filter = options.filter;
+      if (options?.sort) body.sort = options.sort;
+      if (options?.start_cursor) body.start_cursor = options.start_cursor;
+      if (options?.page_size) body.page_size = options.page_size;
+      const res = await fetch(`${BASE_URL}/search`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify(body)
+      });
+      await assertOk(res, "search");
+      return await res.json();
+    },
+    async queryDatabase(databaseId, options) {
+      const body = {};
+      if (options?.filter) body.filter = options.filter;
+      if (options?.sorts) body.sorts = options.sorts;
+      if (options?.start_cursor) body.start_cursor = options.start_cursor;
+      if (options?.page_size) body.page_size = options.page_size;
+      const res = await fetch(
+        `${BASE_URL}/databases/${encodeURIComponent(databaseId)}/query`,
+        {
+          method: "POST",
+          headers: authHeaders(),
+          body: JSON.stringify(body)
+        }
+      );
+      await assertOk(res, "queryDatabase");
+      return await res.json();
+    },
+    async getPage(pageId) {
+      const res = await fetch(
+        `${BASE_URL}/pages/${encodeURIComponent(pageId)}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getPage");
+      return await res.json();
+    },
+    async getDatabase(databaseId) {
+      const res = await fetch(
+        `${BASE_URL}/databases/${encodeURIComponent(databaseId)}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getDatabase");
+      return await res.json();
+    },
+    async getBlockChildren(blockId, options) {
+      const params2 = new URLSearchParams();
+      if (options?.start_cursor)
+        params2.set("start_cursor", options.start_cursor);
+      if (options?.page_size)
+        params2.set("page_size", String(options.page_size));
+      const qs = params2.toString();
+      const url = `${BASE_URL}/blocks/${encodeURIComponent(blockId)}/children${qs ? `?${qs}` : ""}`;
+      const res = await fetch(url, { method: "GET", headers: authHeaders() });
+      await assertOk(res, "getBlockChildren");
+      return await res.json();
+    },
+    async listUsers(options) {
+      const params2 = new URLSearchParams();
+      if (options?.start_cursor)
+        params2.set("start_cursor", options.start_cursor);
+      if (options?.page_size)
+        params2.set("page_size", String(options.page_size));
+      const qs = params2.toString();
+      const url = `${BASE_URL}/users${qs ? `?${qs}` : ""}`;
+      const res = await fetch(url, { method: "GET", headers: authHeaders() });
+      await assertOk(res, "listUsers");
+      return await res.json();
+    }
+  };
+}
+
+// ../connectors/src/connector-onboarding.ts
+var ConnectorOnboarding = class {
+  /** Phase 1: Connection setup instructions (optional — some connectors don't need this) */
+  connectionSetupInstructions;
+  /** Phase 2: Data overview instructions */
+  dataOverviewInstructions;
+  constructor(config) {
+    this.connectionSetupInstructions = config.connectionSetupInstructions;
+    this.dataOverviewInstructions = config.dataOverviewInstructions;
+  }
+  getConnectionSetupPrompt(language) {
+    return this.connectionSetupInstructions?.[language] ?? null;
+  }
+  getDataOverviewInstructions(language) {
+    return this.dataOverviewInstructions[language];
+  }
+};
+
+// ../connectors/src/connector-tool.ts
+var ConnectorTool = class {
+  name;
+  description;
+  inputSchema;
+  outputSchema;
+  _execute;
+  constructor(config) {
+    this.name = config.name;
+    this.description = config.description;
+    this.inputSchema = config.inputSchema;
+    this.outputSchema = config.outputSchema;
+    this._execute = config.execute;
+  }
+  createTool(connections, config) {
+    return {
+      description: this.description,
+      inputSchema: this.inputSchema,
+      outputSchema: this.outputSchema,
+      execute: (input) => this._execute(input, connections, config)
+    };
+  }
+};
+
+// ../connectors/src/connector-plugin.ts
+var ConnectorPlugin = class _ConnectorPlugin {
+  slug;
+  authType;
+  name;
+  description;
+  iconUrl;
+  parameters;
+  releaseFlag;
+  proxyPolicy;
+  experimentalAttributes;
+  onboarding;
+  systemPrompt;
+  tools;
+  query;
+  checkConnection;
+  constructor(config) {
+    this.slug = config.slug;
+    this.authType = config.authType;
+    this.name = config.name;
+    this.description = config.description;
+    this.iconUrl = config.iconUrl;
+    this.parameters = config.parameters;
+    this.releaseFlag = config.releaseFlag;
+    this.proxyPolicy = config.proxyPolicy;
+    this.experimentalAttributes = config.experimentalAttributes;
+    this.onboarding = config.onboarding;
+    this.systemPrompt = config.systemPrompt;
+    this.tools = config.tools;
+    this.query = config.query;
+    this.checkConnection = config.checkConnection;
+  }
+  get connectorKey() {
+    return _ConnectorPlugin.deriveKey(this.slug, this.authType);
+  }
+  /**
+   * Create tools for connections that belong to this connector.
+   * Filters connections by connectorKey internally.
+   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   */
+  createTools(connections, config) {
+    const myConnections = connections.filter(
+      (c) => _ConnectorPlugin.deriveKey(c.connector.slug, c.connector.authType) === this.connectorKey
+    );
+    const result = {};
+    for (const t of Object.values(this.tools)) {
+      result[`${this.connectorKey}_${t.name}`] = t.createTool(
+        myConnections,
+        config
+      );
+    }
+    return result;
+  }
+  static deriveKey(slug, authType) {
+    return authType ? `${slug}-${authType}` : slug;
+  }
+};
+
+// ../connectors/src/connectors/notion/setup.ts
+var notionOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call notion_request with POST /search and { "page_size": 5 } to discover available pages and databases
+2. For each database found, call notion_request with POST /databases/{database_id}/query and { "page_size": 5 } to sample records and understand the schema
+3. Call notion_request with GET /users to list workspace members
+4. Explore page content with GET /blocks/{page_id}/children as needed`,
+    ja: `1. notion_request \u3067 POST /search \u3092 { "page_size": 5 } \u3067\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30DA\u30FC\u30B8\u3068\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u3092\u691C\u51FA
+2. \u898B\u3064\u304B\u3063\u305F\u5404\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u306B\u3064\u3044\u3066\u3001notion_request \u3067 POST /databases/{database_id}/query \u3092 { "page_size": 5 } \u3067\u547C\u3073\u51FA\u3057\u3001\u30EC\u30B3\u30FC\u30C9\u306E\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0\u3068\u30B9\u30AD\u30FC\u30DE\u306E\u628A\u63E1\u3092\u884C\u3046
+3. notion_request \u3067 GET /users \u3092\u547C\u3073\u51FA\u3057\u3001\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u30E1\u30F3\u30D0\u30FC\u3092\u4E00\u89A7\u8868\u793A
+4. \u5FC5\u8981\u306B\u5FDC\u3058\u3066 GET /blocks/{page_id}/children \u3067\u30DA\u30FC\u30B8\u30B3\u30F3\u30C6\u30F3\u30C4\u3092\u63A2\u7D22`
+  }
+});
+
+// ../connectors/src/connectors/notion/tools/request.ts
+import { z } from "zod";
+var BASE_URL2 = "https://api.notion.com/v1";
+var NOTION_VERSION2 = "2022-06-28";
+var REQUEST_TIMEOUT_MS = 6e4;
+var inputSchema = z.object({
+  toolUseIntent: z.string().optional().describe(
+    "Brief description of what you intend to accomplish with this tool call"
+  ),
+  connectionId: z.string().describe("ID of the Notion connection to use"),
+  method: z.enum(["GET", "POST", "PATCH", "DELETE"]).describe(
+    "HTTP method. GET for reading resources, POST for searching/querying/creating, PATCH for updating, DELETE for deleting."
+  ),
+  path: z.string().describe(
+    "API path (e.g., '/search', '/databases/{id}/query', '/pages/{id}', '/blocks/{id}/children')"
+  ),
+  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST/PATCH requests")
+});
+var outputSchema = z.discriminatedUnion("success", [
+  z.object({
+    success: z.literal(true),
+    status: z.number(),
+    data: z.record(z.string(), z.unknown())
+  }),
+  z.object({
+    success: z.literal(false),
+    error: z.string()
+  })
+]);
+var requestTool = new ConnectorTool({
+  name: "request",
+  description: `Send authenticated requests to the Notion API.
+Authentication (Bearer token) and Notion-Version header are configured automatically.
+Use this tool for all Notion API interactions: searching pages/databases, querying databases, retrieving pages and blocks, managing content.
+Pagination uses cursor-based start_cursor and page_size (max 100).`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, method, path: path2, body }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] notion/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      const apiKey = parameters.apiKey.getValue(connection2);
+      const url = `${BASE_URL2}${path2.startsWith("/") ? "" : "/"}${path2}`;
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Notion-Version": NOTION_VERSION2,
+            "Content-Type": "application/json"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        const data = await response.json();
+        if (!response.ok) {
+          const errorMessage = typeof data?.message === "string" ? data.message : typeof data?.code === "string" ? data.code : `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: errorMessage };
+        }
+        return { success: true, status: response.status, data };
+      } finally {
+        clearTimeout(timeout);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { success: false, error: msg };
+    }
+  }
+});
+
+// ../connectors/src/connectors/notion/index.ts
+var tools = { request: requestTool };
+var notionConnector = new ConnectorPlugin({
+  slug: "notion",
+  authType: null,
+  name: "Notion",
+  description: "Connect to Notion to query databases, pages, and workspace content using an Internal Integration Token.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/797V5GDDTA8bsfKUHBCoQO/290ec49b70b68ddb4acd3bf0a6ab8bda/notion-icon.webp",
+  parameters,
+  releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: notionOnboarding,
+  systemPrompt: {
+    en: `### Tools
+
+- \`notion_request\`: The only way to call the Notion REST API. Use it to search pages and databases, query database records, retrieve page content and blocks, and manage workspace data. Authentication (Bearer token) and Notion-Version header are configured automatically. Pagination uses cursor-based \`start_cursor\` and \`page_size\` (max 100) with \`has_more\` and \`next_cursor\` in the response.
+
+### Business Logic
+
+The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT read credentials from environment variables.
+
+SDK methods (client created via \`connection(connectionId)\`):
+- \`client.request(path, init?)\` \u2014 low-level authenticated fetch
+- \`client.search(options?)\` \u2014 search pages and databases by title
+- \`client.queryDatabase(databaseId, options?)\` \u2014 query database records with filter/sorts/pagination
+- \`client.getPage(pageId)\` \u2014 retrieve a page
+- \`client.getDatabase(databaseId)\` \u2014 retrieve a database schema
+- \`client.getBlockChildren(blockId, options?)\` \u2014 retrieve child blocks of a page or block
+- \`client.listUsers(options?)\` \u2014 list workspace users
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/notion";
+
+const notion = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { databaseId, pageSize = 25 } = await c.req.json<{
+    databaseId: string;
+    pageSize?: number;
+  }>();
+
+  const { results } = await notion.queryDatabase(databaseId, {
+    page_size: pageSize,
+  });
+
+  return c.json({ records: results });
+}
+\`\`\`
+
+### Notion REST API Reference
+
+- Base URL: \`https://api.notion.com/v1\`
+- Authentication: Bearer token (handled automatically)
+- Notion-Version: 2022-06-28 (set automatically)
+- Pagination: Cursor-based with \`start_cursor\`, \`page_size\` (max 100), \`has_more\`, \`next_cursor\`
+
+#### Common Endpoints
+- POST \`/search\` \u2014 Search pages and databases by title. Body: \`{ query, filter: { property: "object", value: "page"|"database" }, sort, start_cursor, page_size }\`
+- GET \`/databases/{id}\` \u2014 Retrieve a database (schema, properties)
+- POST \`/databases/{id}/query\` \u2014 Query a database. Body: \`{ filter, sorts, start_cursor, page_size }\`
+- GET \`/pages/{id}\` \u2014 Retrieve a page (properties, metadata)
+- GET \`/pages/{id}/properties/{property_id}\` \u2014 Retrieve a specific page property (for large properties)
+- GET \`/blocks/{id}/children\` \u2014 List child blocks (page content). Query: \`start_cursor\`, \`page_size\`
+- GET \`/blocks/{id}\` \u2014 Retrieve a single block
+- PATCH \`/blocks/{id}/children\` \u2014 Append block children
+- GET \`/users\` \u2014 List workspace users. Query: \`start_cursor\`, \`page_size\`
+- GET \`/users/{id}\` \u2014 Retrieve a user
+- GET \`/users/me\` \u2014 Get the bot user
+- POST \`/pages\` \u2014 Create a page (in a database or as a child of a page)
+- PATCH \`/pages/{id}\` \u2014 Update page properties
+- POST \`/databases\` \u2014 Create a database
+- PATCH \`/databases/{id}\` \u2014 Update a database
+- PATCH \`/blocks/{id}\` \u2014 Update a block
+- DELETE \`/blocks/{id}\` \u2014 Delete a block
+- GET \`/comments?block_id={id}\` \u2014 Retrieve comments on a block or page
+- POST \`/comments\` \u2014 Create a comment
+
+#### Tips
+- Use POST /search to discover databases and pages shared with the integration
+- Database queries return page objects with properties matching the database schema
+- Block children are only first-level; recurse for nested content
+- Properties with more than 25 items (e.g., people, relation) need the property endpoint for full data`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`notion_request\`: Notion REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30DA\u30FC\u30B8\u3084\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u306E\u691C\u7D22\u3001\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u30EC\u30B3\u30FC\u30C9\u306E\u30AF\u30A8\u30EA\u3001\u30DA\u30FC\u30B8\u30B3\u30F3\u30C6\u30F3\u30C4\u3084\u30D6\u30ED\u30C3\u30AF\u306E\u53D6\u5F97\u3001\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u30C7\u30FC\u30BF\u306E\u7BA1\u7406\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08Bearer\u30C8\u30FC\u30AF\u30F3\uFF09\u3068Notion-Version\u30D8\u30C3\u30C0\u30FC\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u306F\u30EC\u30B9\u30DD\u30F3\u30B9\u306E \`has_more\` \u3068 \`next_cursor\` \u306B\u3088\u308B\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u3067\u3001\`start_cursor\` \u3068 \`page_size\`\uFF08\u6700\u5927100\uFF09\u3092\u4F7F\u7528\u3057\u307E\u3059\u3002
+
+### Business Logic
+
+\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u30B3\u30CD\u30AF\u30BFSDK\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u8A8D\u8A3C\u60C5\u5831\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+
+SDK\u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
+- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304Dfetch
+- \`client.search(options?)\` \u2014 \u30BF\u30A4\u30C8\u30EB\u3067\u30DA\u30FC\u30B8\u3068\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u3092\u691C\u7D22
+- \`client.queryDatabase(databaseId, options?)\` \u2014 \u30D5\u30A3\u30EB\u30BF/\u30BD\u30FC\u30C8/\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u4ED8\u304D\u3067\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u30EC\u30B3\u30FC\u30C9\u3092\u30AF\u30A8\u30EA
+- \`client.getPage(pageId)\` \u2014 \u30DA\u30FC\u30B8\u3092\u53D6\u5F97
+- \`client.getDatabase(databaseId)\` \u2014 \u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u30B9\u30AD\u30FC\u30DE\u3092\u53D6\u5F97
+- \`client.getBlockChildren(blockId, options?)\` \u2014 \u30DA\u30FC\u30B8\u307E\u305F\u306F\u30D6\u30ED\u30C3\u30AF\u306E\u5B50\u30D6\u30ED\u30C3\u30AF\u3092\u53D6\u5F97
+- \`client.listUsers(options?)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u30E6\u30FC\u30B6\u30FC\u3092\u4E00\u89A7\u8868\u793A
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/notion";
+
+const notion = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { databaseId, pageSize = 25 } = await c.req.json<{
+    databaseId: string;
+    pageSize?: number;
+  }>();
+
+  const { results } = await notion.queryDatabase(databaseId, {
+    page_size: pageSize,
+  });
+
+  return c.json({ records: results });
+}
+\`\`\`
+
+### Notion REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30D9\u30FC\u30B9URL: \`https://api.notion.com/v1\`
+- \u8A8D\u8A3C: Bearer\u30C8\u30FC\u30AF\u30F3\uFF08\u81EA\u52D5\u8A2D\u5B9A\uFF09
+- Notion-Version: 2022-06-28\uFF08\u81EA\u52D5\u8A2D\u5B9A\uFF09
+- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3: \u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\uFF08\`start_cursor\`, \`page_size\`\uFF08\u6700\u5927100\uFF09, \`has_more\`, \`next_cursor\`\uFF09
+
+#### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+- POST \`/search\` \u2014 \u30DA\u30FC\u30B8\u3068\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u3092\u30BF\u30A4\u30C8\u30EB\u3067\u691C\u7D22\u3002Body: \`{ query, filter: { property: "object", value: "page"|"database" }, sort, start_cursor, page_size }\`
+- GET \`/databases/{id}\` \u2014 \u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u3092\u53D6\u5F97\uFF08\u30B9\u30AD\u30FC\u30DE\u3001\u30D7\u30ED\u30D1\u30C6\u30A3\uFF09
+- POST \`/databases/{id}/query\` \u2014 \u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u3092\u30AF\u30A8\u30EA\u3002Body: \`{ filter, sorts, start_cursor, page_size }\`
+- GET \`/pages/{id}\` \u2014 \u30DA\u30FC\u30B8\u3092\u53D6\u5F97\uFF08\u30D7\u30ED\u30D1\u30C6\u30A3\u3001\u30E1\u30BF\u30C7\u30FC\u30BF\uFF09
+- GET \`/pages/{id}/properties/{property_id}\` \u2014 \u7279\u5B9A\u306E\u30DA\u30FC\u30B8\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u53D6\u5F97\uFF08\u5927\u304D\u306A\u30D7\u30ED\u30D1\u30C6\u30A3\u7528\uFF09
+- GET \`/blocks/{id}/children\` \u2014 \u5B50\u30D6\u30ED\u30C3\u30AF\u3092\u4E00\u89A7\u8868\u793A\uFF08\u30DA\u30FC\u30B8\u30B3\u30F3\u30C6\u30F3\u30C4\uFF09\u3002Query: \`start_cursor\`, \`page_size\`
+- GET \`/blocks/{id}\` \u2014 \u5358\u4E00\u30D6\u30ED\u30C3\u30AF\u3092\u53D6\u5F97
+- PATCH \`/blocks/{id}/children\` \u2014 \u5B50\u30D6\u30ED\u30C3\u30AF\u3092\u8FFD\u52A0
+- GET \`/users\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u30E6\u30FC\u30B6\u30FC\u3092\u4E00\u89A7\u8868\u793A\u3002Query: \`start_cursor\`, \`page_size\`
+- GET \`/users/{id}\` \u2014 \u30E6\u30FC\u30B6\u30FC\u3092\u53D6\u5F97
+- GET \`/users/me\` \u2014 \u30DC\u30C3\u30C8\u30E6\u30FC\u30B6\u30FC\u3092\u53D6\u5F97
+- POST \`/pages\` \u2014 \u30DA\u30FC\u30B8\u3092\u4F5C\u6210\uFF08\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u5185\u307E\u305F\u306F\u30DA\u30FC\u30B8\u306E\u5B50\u3068\u3057\u3066\uFF09
+- PATCH \`/pages/{id}\` \u2014 \u30DA\u30FC\u30B8\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u66F4\u65B0
+- POST \`/databases\` \u2014 \u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u3092\u4F5C\u6210
+- PATCH \`/databases/{id}\` \u2014 \u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u3092\u66F4\u65B0
+- PATCH \`/blocks/{id}\` \u2014 \u30D6\u30ED\u30C3\u30AF\u3092\u66F4\u65B0
+- DELETE \`/blocks/{id}\` \u2014 \u30D6\u30ED\u30C3\u30AF\u3092\u524A\u9664
+- GET \`/comments?block_id={id}\` \u2014 \u30D6\u30ED\u30C3\u30AF\u307E\u305F\u306F\u30DA\u30FC\u30B8\u306E\u30B3\u30E1\u30F3\u30C8\u3092\u53D6\u5F97
+- POST \`/comments\` \u2014 \u30B3\u30E1\u30F3\u30C8\u3092\u4F5C\u6210
+
+#### \u30D2\u30F3\u30C8
+- POST /search \u3092\u4F7F\u7528\u3057\u3066\u30A4\u30F3\u30C6\u30B0\u30EC\u30FC\u30B7\u30E7\u30F3\u3068\u5171\u6709\u3055\u308C\u305F\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u3084\u30DA\u30FC\u30B8\u3092\u691C\u51FA\u3057\u307E\u3059
+- \u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u30AF\u30A8\u30EA\u306F\u30C7\u30FC\u30BF\u30D9\u30FC\u30B9\u30B9\u30AD\u30FC\u30DE\u306B\u4E00\u81F4\u3059\u308B\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u6301\u3064\u30DA\u30FC\u30B8\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u3092\u8FD4\u3057\u307E\u3059
+- \u30D6\u30ED\u30C3\u30AF\u306E\u5B50\u306F\u6700\u521D\u306E\u30EC\u30D9\u30EB\u306E\u307F\u3067\u3059\u3002\u30CD\u30B9\u30C8\u3055\u308C\u305F\u30B3\u30F3\u30C6\u30F3\u30C4\u306B\u306F\u518D\u5E30\u304C\u5FC5\u8981\u3067\u3059
+- 25\u4EF6\u4EE5\u4E0A\u306E\u30A2\u30A4\u30C6\u30E0\u3092\u6301\u3064\u30D7\u30ED\u30D1\u30C6\u30A3\uFF08people\u3001relation\u306A\u3069\uFF09\u306F\u5B8C\u5168\u306A\u30C7\u30FC\u30BF\u53D6\u5F97\u306B\u30D7\u30ED\u30D1\u30C6\u30A3\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u304C\u5FC5\u8981\u3067\u3059`
+  },
+  tools
+});
+
+// src/connectors/create-connector-sdk.ts
+import { readFileSync } from "fs";
+import path from "path";
+
+// src/connector-client/env.ts
+function resolveEnvVar(entry, key, connectionId) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) {
+    throw new Error(`Connection "${connectionId}" is missing envVars mapping for key "${key}"`);
+  }
+  const value = process.env[envVarName];
+  if (!value) {
+    throw new Error(`Environment variable "${envVarName}" (for connection "${connectionId}", key "${key}") is not set`);
+  }
+  return value;
+}
+function resolveEnvVarOptional(entry, key) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) return void 0;
+  return process.env[envVarName] || void 0;
+}
+
+// src/connectors/create-connector-sdk.ts
+function loadConnectionsSync() {
+  const filePath = process.env.CONNECTIONS_PATH ?? path.join(process.cwd(), ".squadbase/connections.json");
+  try {
+    const raw = readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function createConnectorSdk(plugin, createClient2) {
+  return (connectionId) => {
+    const connections = loadConnectionsSync();
+    const entry = connections[connectionId];
+    if (!entry) {
+      throw new Error(
+        `Connection "${connectionId}" not found in .squadbase/connections.json`
+      );
+    }
+    if (entry.connector.slug !== plugin.slug) {
+      throw new Error(
+        `Connection "${connectionId}" is not a ${plugin.slug} connection (got "${entry.connector.slug}")`
+      );
+    }
+    const params = {};
+    for (const param of Object.values(plugin.parameters)) {
+      if (param.required) {
+        params[param.slug] = resolveEnvVar(entry, param.slug, connectionId);
+      } else {
+        const val = resolveEnvVarOptional(entry, param.slug);
+        if (val !== void 0) params[param.slug] = val;
+      }
+    }
+    return createClient2(params);
+  };
+}
+
+// src/connectors/entries/notion.ts
+var connection = createConnectorSdk(notionConnector, createClient);
+export {
+  connection
+};

package/dist/connectors/zendesk-oauth.d.ts

@@ -0,0 +1,5 @@
+import * as _squadbase_connectors_sdk from '@squadbase/connectors/sdk';
+
+declare const connection: (connectionId: string) => _squadbase_connectors_sdk.ZendeskOauthConnectorSdk;
+
+export { connection };