collavre_notion 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 80b38ec1b831d76c7062b71483225adb5985e90ea4abb7d6b29023e53182c299
+  data.tar.gz: a57dd0b62793e9129f3a0190d4f42cf86c5687b7c39737ec220cd0e5fad90664
+SHA512:
+  metadata.gz: 19697a81efd966dc00d0290f4d827dc48a471dcf3e65d4d8e5b0e618830bf9ac237ac67181d74ee75a82ad648aa77d863521357183fbcebe318955f62dd38550
+  data.tar.gz: acbfc93ef56e9ac9955a988ed204cfb4f39230c096d555cef7f62115f908d9b53332dc4062914fe39ab939afc01f659c92c501d5994a0494efbe3aae4da061b8

data/README.md

@@ -0,0 +1,58 @@
+# Collavre Notion Engine
+
+Notion integration plugin engine for Collavre. Provides OAuth connection, page linking, and creative export/sync to Notion.
+
+## Documentation
+
+- [Setup Guide](docs/SETUP.md) - Step-by-step instructions for creating and configuring a Notion integration
+- [Architecture](docs/ARCHITECTURE.md) - Technical documentation about the integration
+
+## Installation
+
+### 1. Add to Gemfile
+
+```ruby
+# Gemfile
+gem "collavre_notion", path: "engines/collavre_notion"
+```
+
+### 2. Add JavaScript Import (Required)
+
+The JavaScript must be explicitly imported in your host application:
+
+```javascript
+// app/javascript/application.js
+import "collavre_notion"
+```
+
+This is required because the host app controls which integrations are loaded. Without this import, the Notion integration modal will not work.
+
+### 3. Configure Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `NOTION_CLIENT_ID` | Yes | OAuth Client ID |
+| `NOTION_CLIENT_SECRET` | Yes | OAuth Client Secret |
+
+### 4. Run Migrations
+
+```bash
+rails db:migrate
+```
+
+## Automatic Configuration
+
+The following are automatically configured by the engine:
+
+- **Routes**: Mounted at `/notion` (no manual `mount` needed in `routes.rb`)
+- **OAuth Callback**: Handles `/auth/notion/callback`
+- **Migrations**: Database migrations are automatically included
+- **i18n**: Locale files (en, ko) are automatically loaded
+- **Integration Registry**: Automatically registers with `Collavre::IntegrationRegistry`
+
+## Features
+
+- OAuth 2.0 connection to Notion workspaces
+- Export a creative tree to a Notion page
+- Sync linked pages with updated creative content
+- Manage linked page connections per creative

data/Rakefile

@@ -0,0 +1,3 @@
+require_relative "lib/collavre_notion"
+
+CollavreNotion::Engine.load_tasks

data/app/controllers/collavre_notion/application_controller.rb

@@ -0,0 +1,12 @@
+module CollavreNotion
+  class ApplicationController < ::ApplicationController
+    protect_from_forgery with: :exception
+
+    private
+
+    def notion_engine
+      CollavreNotion::Engine.routes.url_helpers
+    end
+    helper_method :notion_engine
+  end
+end

data/app/controllers/collavre_notion/creatives/notion_integrations_controller.rb

@@ -0,0 +1,196 @@
+module CollavreNotion
+  module Creatives
+    class NotionIntegrationsController < ApplicationController
+      before_action :set_creative
+      before_action :ensure_read_permission
+      before_action :ensure_admin_permission, only: [ :show, :update ]
+
+      def show
+        account = Current.user.notion_account
+        links = linked_page_links(account)
+
+        Rails.logger.info("Notion Integration: Showing status for user #{Current.user.id}, connected: #{account.present?}")
+
+        render json: {
+          connected: account.present?,
+          creative_title: helpers.strip_tags(@creative.description).strip.presence || "Untitled Creative",
+          account: account && {
+            workspace_name: account.workspace_name,
+            workspace_id: account.workspace_id,
+            bot_id: account.bot_id
+          },
+          linked_pages: links.map do |link|
+            {
+              page_id: link.page_id,
+              page_title: link.page_title,
+              page_url: link.page_url,
+              last_synced_at: link.last_synced_at
+            }
+          end,
+          available_pages: account.present? ? fetch_available_pages(account) : []
+        }
+      end
+
+      def update
+        account = Current.user.notion_account
+        unless account
+          render json: { error: "not_connected" }, status: :unprocessable_entity
+          return
+        end
+
+        Rails.logger.info("Notion Integration Update: Full params = #{params.to_unsafe_h}")
+
+        integration_attributes = integration_params
+        Rails.logger.info("Notion Integration Update: integration_params = #{integration_attributes}")
+
+        request_action = request.request_parameters[:action]
+        action = integration_attributes[:action]
+        if action.blank? || action.to_s == action_name
+          action = request_action.presence
+        end
+        parent_page_id = integration_attributes[:parent_page_id]
+
+        Rails.logger.info("Notion Integration Update: action=#{action}, parent_page_id=#{parent_page_id}")
+
+        begin
+          case action
+          when "export"
+            # Export creative to Notion
+            CollavreNotion::NotionExportJob.perform_later(@creative, account, parent_page_id)
+            render json: { success: true, message: "Export started" }
+          when "sync"
+            # Sync existing page
+            link = linked_page_links(account).first
+            if link
+              CollavreNotion::NotionSyncJob.perform_later(@creative, account, link.page_id)
+              render json: { success: true, message: "Sync started" }
+            else
+              render json: { error: "no_linked_page" }, status: :unprocessable_entity
+            end
+          else
+            render json: { error: "invalid_action" }, status: :unprocessable_entity
+          end
+        rescue StandardError => e
+          Rails.logger.error("Notion integration error: #{e.message}")
+          render json: { error: "operation_failed", message: e.message }, status: :internal_server_error
+        end
+      end
+
+      def destroy
+        unless @creative.has_permission?(Current.user, :write)
+          render json: { error: "forbidden" }, status: :forbidden
+          return
+        end
+
+        account = Current.user.notion_account
+        unless account
+          render json: { error: "not_connected" }, status: :unprocessable_entity
+          return
+        end
+
+        page_id = params[:page_id]
+
+        if page_id
+          # Remove specific page link
+          link = linked_page_links(account).find_by(page_id: page_id)
+          unless link
+            render json: { error: "not_found" }, status: :not_found
+            return
+          end
+
+          link.destroy!
+        else
+          # Remove all page links for this creative
+          linked_page_links(account).destroy_all
+        end
+
+        links = linked_page_links(account)
+        render json: {
+          success: true,
+          linked_pages: links.map do |link|
+            {
+              page_id: link.page_id,
+              page_title: link.page_title,
+              page_url: link.page_url,
+              last_synced_at: link.last_synced_at
+            }
+          end
+        }
+      end
+
+      private
+
+      def set_creative
+        @creative = Collavre::Creative.find(params[:creative_id])
+      end
+
+      def ensure_read_permission
+        return if @creative.has_permission?(Current.user, :read)
+
+        render json: { error: "forbidden" }, status: :forbidden
+      end
+
+      def ensure_admin_permission
+        return if @creative.has_permission?(Current.user, :admin)
+
+        render json: { error: "forbidden" }, status: :forbidden
+      end
+
+      def linked_page_links(account)
+        return CollavreNotion::NotionPageLink.none unless account
+
+        @creative.notion_page_links.where(notion_account: account)
+      end
+
+      def integration_params
+        permitted_keys = [ :action, :parent_page_id, :page_id ]
+
+        if params[:notion_integration].present?
+          params.require(:notion_integration).permit(*permitted_keys)
+        else
+          params.permit(*permitted_keys)
+        end
+      end
+
+      def fetch_available_pages(account)
+        Rails.logger.info("Notion Integration: Fetching available pages for account #{account.id}")
+
+        begin
+          service = CollavreNotion::NotionService.new(user: account.user)
+          pages_response = service.search_pages(page_size: 50)
+
+          Rails.logger.info("Notion Integration: Search pages response - #{pages_response["results"]&.length || 0} pages found")
+
+          pages = pages_response["results"]&.map do |page|
+            {
+              id: page["id"],
+              title: extract_page_title(page),
+              url: page["url"],
+              parent: page["parent"]
+            }
+          end || []
+
+          Rails.logger.info("Notion Integration: Returning #{pages.length} formatted pages")
+          pages
+        rescue StandardError => e
+          Rails.logger.error("Notion Integration: Error fetching pages - #{e.class}: #{e.message}")
+          Rails.logger.error(e.backtrace.join("\n"))
+          []
+        end
+      end
+
+      def extract_page_title(page)
+        # Handle different title property structures
+        title_property = page.dig("properties", "title")
+
+        if title_property && title_property["title"]
+          title_property["title"].map { |t| t.dig("text", "content") }.compact.join("")
+        elsif page["title"]
+          page["title"].map { |t| t.dig("text", "content") }.compact.join("")
+        else
+          "Untitled"
+        end
+      end
+    end
+  end
+end

data/app/controllers/collavre_notion/notion_auth_controller.rb

@@ -0,0 +1,48 @@
+module CollavreNotion
+  class NotionAuthController < ApplicationController
+    allow_unauthenticated_access only: :callback
+    before_action -> { enforce_auth_provider!(:notion) }, only: :callback
+
+    def callback
+      auth = request.env["omniauth.auth"]
+      notion = CollavreNotion::NotionAccount.find_or_initialize_by(notion_uid: auth.uid)
+
+      if notion.new_record?
+        unless Current.user
+          redirect_to collavre.new_session_path, alert: I18n.t("collavre_notion.notion_auth.login_first")
+          return
+        end
+        notion.user = Current.user
+      end
+
+      notion.token = auth.credentials.token
+      notion.workspace_name = auth.info.name
+      notion.save!
+
+      # If opened in popup, close it and notify parent window
+      if params[:popup] || request.referer&.include?("popup=true") || session[:oauth_popup]
+        session.delete(:oauth_popup)
+        render html: <<-HTML.html_safe
+          <!DOCTYPE html>
+          <html>
+          <head><title>Notion Connected</title></head>
+          <body>
+            <script>
+              if (window.opener) {
+                window.opener.postMessage({ type: 'notion_oauth_success', connected: true }, '*');
+                window.close();
+              } else {
+                window.location.href = '#{collavre.creatives_path}';
+              }
+            </script>
+            <p>#{I18n.t("collavre_notion.notion_auth.connected")}</p>
+            <p>This window should close automatically. If not, you can close it manually.</p>
+          </body>
+          </html>
+        HTML
+      else
+        redirect_to collavre.creatives_path, notice: I18n.t("collavre_notion.notion_auth.connected")
+      end
+    end
+  end
+end