@catafal/notion-cli 5.9.0

package/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "@catafal/notion-cli",
+  "version": "5.9.0",
+  "description": "Unofficial Notion CLI optimized for automation and AI agents. Non-interactive interface for Notion API v5.2.1 with intelligent caching, retry logic, structured error handling, and comprehensive testing.",
+  "author": "Jake Schepis <jake@coastalprograms.com>",
+  "bin": {
+    "notion-cli": "./bin/run"
+  },
+  "homepage": "https://github.com/Catafal/notion-cli#readme",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Catafal/notion-cli.git"
+  },
+  "files": [
+    "/bin",
+    "/dist",
+    "/scripts",
+    "/oclif.manifest.json"
+  ],
+  "dependencies": {
+    "@inquirer/select": "^5.0.7",
+    "@notionhq/client": "^5.9.0",
+    "@oclif/core": "^4.8.0",
+    "@oclif/plugin-help": "^6.2.37",
+    "cli-table3": "^0.6.5",
+    "dayjs": "^1.11.19",
+    "notion-to-md": "^3.1.6",
+    "undici": "^7.20.0",
+    "update-notifier": "^7.3.1"
+  },
+  "devDependencies": {
+    "@oclif/test": "^3.2.15",
+    "@types/chai": "^4",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.19.8",
+    "@types/sinon": "^21.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "chai": "^4",
+    "eslint": "^9.39.2",
+    "eslint-config-oclif": "^6.0.137",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-mocha": "^11.2.0",
+    "eslint-plugin-n": "^17.23.2",
+    "eslint-plugin-unicorn": "^62.0.0",
+    "globby": "^11",
+    "mocha": "^11.7.5",
+    "nock": "^13.5.6",
+    "node-fetch": "^2.7.0",
+    "nyc": "^17.1.0",
+    "oclif": "^4.22.73",
+    "prettier": "^3.8.1",
+    "shx": "^0.4.0",
+    "sinon": "^21.0.1",
+    "ts-node": "^10.9.2",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
+  },
+  "oclif": {
+    "bin": "notion-cli",
+    "dirname": "notion-cli",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "hello": {
+        "description": "Say hello to the world and others"
+      }
+    }
+  },
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -b",
+    "lint": "eslint .",
+    "postpack": "node -e \"try{require('fs').unlinkSync('oclif.manifest.json')}catch{}\" || true",
+    "postinstall": "node scripts/postinstall.js",
+    "prepack": "(npm run build && oclif manifest) || true",
+    "test": "TS_NODE_PROJECT=tsconfig.test.json mocha --forbid-only \"test/**/*.test.ts\"",
+    "readme": "oclif readme --multi --no-aliases && shx sed -i \"s/^_See code:.*$//g\" docs/*.md > /dev/null",
+    "test:coverage": "nyc --reporter=lcov --reporter=text npm test"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "overrides": {
+    "minimatch": ">=10.2.1"
+  },
+  "bugs": {
+    "url": "https://github.com/Catafal/notion-cli/issues",
+    "email": "jake@coastalprograms.com"
+  },
+  "keywords": [
+    "notion",
+    "cli",
+    "notion-api",
+    "notion-cli",
+    "ai-agents",
+    "automation",
+    "productivity",
+    "database",
+    "workspace",
+    "schema-discovery",
+    "workspace-cache",
+    "database-sync",
+    "simple-properties",
+    "json-envelope",
+    "typescript",
+    "oclif",
+    "notion-integration",
+    "command-line",
+    "developer-tools"
+  ],
+  "types": "dist/index.d.ts"
+}

package/scripts/banner.js

@@ -0,0 +1,38 @@
+/**
+ * Terminal banner and color utilities for consistent branding
+ * Shared between postinstall script and TypeScript source
+ */
+
+/**
+ * ANSI color codes for cross-platform terminal compatibility
+ */
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+  yellow: '\x1b[33m',
+  magenta: '\x1b[35m',
+}
+
+/**
+ * ASCII art banner for Notion CLI
+ * Displayed during install and setup
+ * Uses terminal's default color (black/white depending on theme)
+ */
+const ASCII_BANNER = `
+███╗   ██╗ ██████╗ ████████╗██╗ ██████╗ ███╗   ██╗     ██████╗██╗     ██╗
+████╗  ██║██╔═══██╗╚══██╔══╝██║██╔═══██╗████╗  ██║    ██╔════╝██║     ██║
+██╔██╗ ██║██║   ██║   ██║   ██║██║   ██║██╔██╗ ██║    ██║     ██║     ██║
+██║╚██╗██║██║   ██║   ██║   ██║██║   ██║██║╚██╗██║    ██║     ██║     ██║
+██║ ╚████║╚██████╔╝   ██║   ██║╚██████╔╝██║ ╚████║    ╚██████╗███████╗██║
+╚═╝  ╚═══╝ ╚═════╝    ╚═╝   ╚═╝ ╚═════╝ ╚═╝  ╚═══╝     ╚═════╝╚══════╝╚═╝
+`
+
+module.exports = {
+  colors,
+  ASCII_BANNER,
+}

package/scripts/postinstall.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for @catafal/notion-cli
+ * Shows welcome message and next steps after installation
+ */
+
+// Respect npm's --silent flag
+const isSilent = process.env.npm_config_loglevel === 'silent';
+if (isSilent) {
+  process.exit(0);
+}
+
+// Import shared banner and colors
+const { colors, ASCII_BANNER } = require('./banner');
+
+// Graceful error handling - don't break installation
+try {
+  const packageJson = require('../package.json');
+  const version = packageJson.version;
+
+  // Welcome message with banner and clear next steps
+  console.log(ASCII_BANNER);
+  console.log(`${colors.green}✓${colors.reset} Version ${colors.bright}${version}${colors.reset} installed successfully!\n`);
+  console.log(`${colors.blue}Quick Start:${colors.reset}`);
+  console.log(`  ${colors.cyan}notion-cli init${colors.reset}          ${colors.dim}# Interactive setup wizard${colors.reset}`);
+  console.log(`  ${colors.cyan}notion-cli --help${colors.reset}        ${colors.dim}# View all commands${colors.reset}\n`);
+  console.log(`${colors.blue}Resources:${colors.reset}`);
+  console.log(`  ${colors.gray}•${colors.reset} Documentation: ${colors.dim}https://github.com/Catafal/notion-cli${colors.reset}`);
+  console.log(`  ${colors.gray}•${colors.reset} Get API Token:  ${colors.dim}https://developers.notion.com/docs/create-a-notion-integration${colors.reset}`);
+  console.log(`  ${colors.gray}•${colors.reset} Report Issues:  ${colors.dim}https://github.com/Catafal/notion-cli/issues${colors.reset}`);
+  console.log('');
+} catch (error) {
+  // Fallback to simple message if anything goes wrong
+  console.log(`
+Notion CLI installed successfully!
+
+Quick Start:
+  notion-cli init          # Interactive setup wizard
+  notion-cli --help        # View all commands
+
+Get help: https://github.com/Catafal/notion-cli
+`);
+}