safe-notion 0.1.4 → 0.2.0

package/dist/commands/search.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function createSearchCommand(): Command;

package/dist/index.js

@@ -2,7 +2,7 @@
 // @bun
 
 // src/index.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 
 // src/commands/page.ts
 import { Command } from "commander";
@@ -450,6 +450,17 @@ class NotionSafeClient {
     await this.ensurePermission(blockId, "block:delete");
     return this.client.blocks.delete({ block_id: blockId });
   }
+  async search(params) {
+    const hasReadPermission = this.config.defaultPermission === "read" || this.config.rules.some((rule) => rule.permissions.some((p) => ["page:read", "database:read", "block:read"].includes(p)));
+    if (!hasReadPermission) {
+      const error = {
+        error: "Search not allowed: no read permissions configured",
+        code: "PERMISSION_DENIED"
+      };
+      throw error;
+    }
+    return this.client.search(params);
+  }
   clearCache() {
     clearCache();
   }
@@ -695,6 +706,54 @@ function createConfigCommand() {
   return config;
 }
 
+// src/commands/search.ts
+import { Command as Command5 } from "commander";
+function createSearchCommand() {
+  const search = new Command5("search").description("Search pages and databases");
+  search.argument("[query]", "Search query string").option("--filter <type>", "Filter by object type: page or database").option("--sort <direction>", "Sort by last_edited_time: ascending or descending").option("--start-cursor <cursor>", "Pagination cursor").option("--page-size <size>", "Number of results per page", "100").action(async (query, options) => {
+    try {
+      const client = getClient();
+      const params = {};
+      if (query) {
+        params.query = query;
+      }
+      if (options.filter) {
+        const filterValue = options.filter === "database" ? "data_source" : options.filter;
+        if (filterValue !== "page" && filterValue !== "data_source") {
+          throw {
+            error: "Invalid filter value. Must be 'page' or 'database'",
+            code: "INVALID_ARGUMENT"
+          };
+        }
+        params.filter = { property: "object", value: filterValue };
+      }
+      if (options.sort) {
+        if (options.sort !== "ascending" && options.sort !== "descending") {
+          throw {
+            error: "Invalid sort value. Must be 'ascending' or 'descending'",
+            code: "INVALID_ARGUMENT"
+          };
+        }
+        params.sort = {
+          direction: options.sort,
+          timestamp: "last_edited_time"
+        };
+      }
+      if (options.startCursor) {
+        params.start_cursor = options.startCursor;
+      }
+      if (options.pageSize) {
+        params.page_size = parseInt(options.pageSize, 10);
+      }
+      const result = await client.search(params);
+      outputJson(result);
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  return search;
+}
+
 // src/notion-client.ts
 import { Client as Client2 } from "@notionhq/client";
 import { LogLevel as LogLevel2 } from "@notionhq/client/build/src/logging";
@@ -706,7 +765,7 @@ function setDebugMode(enabled) {
 var clientInstance2 = null;
 
 // src/index.ts
-var program = new Command5;
+var program = new Command6;
 program.name("notion-safe").description("A safe Notion API wrapper CLI for AI agents").version("0.1.0").option("--debug", "Enable debug output including API warnings").hook("preAction", () => {
   const opts = program.opts();
   if (opts.debug) {
@@ -717,4 +776,5 @@ program.addCommand(createPageCommand());
 program.addCommand(createDbCommand());
 program.addCommand(createBlockCommand());
 program.addCommand(createConfigCommand());
+program.addCommand(createSearchCommand());
 program.parse();

package/dist/notion-client.d.ts

@@ -24,6 +24,19 @@ export declare class NotionSafeClient {
     getBlockChildren(blockId: string, startCursor?: string, pageSize?: number): Promise<unknown>;
     appendBlockChildren(blockId: string, children: AppendBlockChildrenParams["children"]): Promise<unknown>;
     deleteBlock(blockId: string): Promise<unknown>;
+    search(params: {
+        query?: string;
+        filter?: {
+            property: "object";
+            value: "page" | "data_source";
+        };
+        sort?: {
+            direction: "ascending" | "descending";
+            timestamp: "last_edited_time";
+        };
+        start_cursor?: string;
+        page_size?: number;
+    }): Promise<unknown>;
     clearCache(): void;
 }
 export declare function getClient(): NotionSafeClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "safe-notion",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "A safe Notion API wrapper CLI for AI agents with granular permission control",
   "license": "MIT",
   "author": "shoppingjaws",