Block editor integration: pre-publish panel + per-post share toggle (#139)

Author: pfefferle

.github/changelog/add-per-post-share-toggle

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+The editor's Bluesky panel now has a switch to turn sharing on or off for an individual post; switching it off after a post was shared removes it from Bluesky.

.github/changelog/add-pre-publish-panel

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Before publishing, the editor now shows whether a post will be shared to Bluesky, how it will appear, and how its text measures against Bluesky’s character limit.

atmosphere.php

@@ -24,6 +24,15 @@
 \define( 'ATMOSPHERE_PLUGIN_URL', \plugin_dir_url( __FILE__ ) );
 \define( 'ATMOSPHERE_PLUGIN_FILE', __FILE__ );
 
+/**
+ * Post meta key: per-post opt-out from sharing to Bluesky.
+ *
+ * Stored as a registered, REST-exposed boolean so the block-editor panel
+ * can bind a toggle to it. '1' (true) means the author switched sharing
+ * off for this post; absent/empty means the default — sharing is on.
+ */
+\define( 'ATMOSPHERE_META_DISABLED', 'atmosphere_disabled' );
+
 /*
  * Custom autoloader for Atmosphere classes — maps the Atmosphere
  * namespace to includes/ using WordPress filename conventions.

build/editor-plugin/block.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://schemas.wp.org/trunk/block.json",
+  "apiVersion": 3,
+  "name": "atmosphere/editor-plugin",
+  "title": "ATmosphere Editor Panel",
+  "category": "widgets",
+  "description": "Document sidebar panel to control whether a post is shared to Bluesky.",
+  "icon": "share",
+  "textdomain": "atmosphere",
+  "editorScript": "file:./plugin.js"
+}

build/editor-plugin/plugin.asset.php

@@ -0,0 +1 @@
+<?php return array('dependencies' => array('react-jsx-runtime', 'wp-components', 'wp-core-data', 'wp-data', 'wp-edit-post', 'wp-editor', 'wp-i18n', 'wp-plugins'), 'version' => '8cd5c929567d05cbfdf7');

build/editor-plugin/plugin.js

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://schemas.wp.org/trunk/block.json",
+  "apiVersion": 3,
+  "name": "atmosphere/pre-publish-panel",
+  "title": "ATmosphere Pre-Publish Panel",
+  "category": "widgets",
+  "description": "Shows whether a post will publish to Bluesky, the strategy, and the character count before publishing.",
+  "icon": "share",
+  "textdomain": "atmosphere",
+  "editorScript": "file:./plugin.js"
+}

build/pre-publish-panel/block.json

@@ -0,0 +1 @@
+<?php return array('dependencies' => array('react-jsx-runtime', 'wp-api-fetch', 'wp-components', 'wp-core-data', 'wp-data', 'wp-editor', 'wp-element', 'wp-i18n', 'wp-plugins'), 'version' => '8fa0d7dd1bccedfa1d37');

build/pre-publish-panel/plugin.asset.php

@@ -20,6 +20,7 @@ wordpress-atmosphere/
 │   ├── class-api.php               # DPoP-authenticated PDS request layer with nonce retry.
 │   ├── class-autoloader.php        # Custom WordPress-style autoloader.
 │   ├── class-backfill.php          # Bulk re-sync of existing posts.
+│   ├── class-block-editor.php      # Enqueues the block-editor panels (share toggle + pre-publish).
 │   ├── class-handle.php            # Domain-handle setup helper (writes /.well-known/atproto-did).
 │   ├── class-post-types.php        # Supported post-type discovery and option storage.
 │   ├── class-publisher.php         # Atomic applyWrites for both Bluesky post + standard.site document.
@@ -42,6 +43,11 @@ wordpress-atmosphere/
 │   │   ├── class-nonce-storage.php # DPoP nonce persistence.
 │   │   └── class-resolver.php      # handle → DID → PDS → auth server resolution chain.
 │   │
+│   ├── rest/                       # REST API controllers (WP_REST_Controller subclasses).
+│   │   ├── class-client-metadata-controller.php  # Public OAuth client-metadata endpoint.
+│   │   └── admin/                  # Authenticated, editor-only controllers.
+│   │       └── class-pre-publish-controller.php   # Pre-publish projection for the editor panel.
+│   │
 │   ├── transformer/                # WordPress → AT Protocol record transformers.
 │   │   ├── class-base.php          # Abstract base.
 │   │   ├── class-comment.php       # Comment → app.bsky.feed.post (reply).
@@ -51,8 +57,9 @@ wordpress-atmosphere/
 │   │   ├── class-publication.php   # Site → site.standard.publication.
 │   │   └── class-tid.php           # AT Protocol Timestamp ID generation.
 │   │
-│   └── wp-admin/                   # Admin functionality.
-│       └── class-admin.php         # Settings page, sidebar panel, REST handlers.
+│   └── wp-admin/                   # Admin screens.
+│       ├── class-admin.php         # Settings page, OAuth callback, menu wiring.
+│       └── class-settings-fields.php  # Settings API field rendering.
 │
 ├── integrations/                   # Third-party plugin integrations.
 │   └── class-load.php              # Integration loader stub.
@@ -162,6 +169,8 @@ namespace Atmosphere\OAuth;
 namespace Atmosphere\Transformer;
 namespace Atmosphere\Content_Parser;
 namespace Atmosphere\Integrations;
+namespace Atmosphere\Rest;        // Public REST controllers.
+namespace Atmosphere\Rest\Admin;  // Authenticated, editor-only REST controllers.
 namespace Atmosphere\WP_Admin;
 namespace Atmosphere\Tests;
 ```
@@ -212,7 +221,9 @@ class Publisher {
 | AT Protocol record transformers | `includes/transformer/` | `Atmosphere\Transformer` |
 | OAuth flow components | `includes/oauth/` | `Atmosphere\OAuth` |
 | Content parsers (NSID-typed `content` producers) | `includes/content-parser/` | `Atmosphere\Content_Parser` |
-| Admin screens / REST handlers | `includes/wp-admin/` | `Atmosphere\WP_Admin` |
+| Public REST controllers (`WP_REST_Controller`) | `includes/rest/` | `Atmosphere\Rest` |
+| Authenticated/editor-only REST controllers | `includes/rest/admin/` | `Atmosphere\Rest\Admin` |
+| Admin screens | `includes/wp-admin/` | `Atmosphere\WP_Admin` |
 | Third-party plugin integrations | `integrations/` | `Atmosphere\Integrations` |
 
 ### Creating a New Subdirectory
@@ -227,6 +238,24 @@ After adding or renaming a class file under the `Atmosphere` namespace, no Compo
 
 ## Architectural Patterns
 
+### REST Controllers
+
+Every REST endpoint is a `WP_REST_Controller` subclass under `includes/rest/`
+(public) or `includes/rest/admin/` (authenticated / editor-only), mirroring
+the wordpress-activitypub plugin's layout. Each controller declares its route
+via `register_routes()`; they are all instantiated together in
+`Atmosphere::register_rest_controllers()` on `rest_api_init`.
+
+Route namespaces are versioned deliberately:
+
+- **`atmosphere/v1`** — the public OAuth `client-metadata` endpoint. Its URL is
+  the OAuth `client_id`, an external contract, so the version string is frozen
+  and must not change.
+- **`atmosphere/1.0`** — admin/editor routes (e.g. the pre-publish preview).
+
+New admin routes should use `atmosphere/1.0`, set `show_in_index => false`, and
+gate access with a `permission_callback`.
+
 ### Transformer Pattern
 
 The transformer pattern (`includes/transformer/`) is the canonical way to add a new AT Protocol record type: