@zsoltcsaszti/lens 0.2.0 → 0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # Lens SDK
 
-[![npm](https://img.shields.io/npm/v/@zsolt/lens)](https://www.npmjs.com/package/@zsolt/lens)
+[![npm](https://img.shields.io/npm/v/@zsoltcsaszti/lens)](https://www.npmjs.com/package/@zsoltcsaszti/lens)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 Reader intelligence for publishers. One script tag. Zero tracking cookies.
@@ -13,7 +13,7 @@ Reader intelligence for publishers. One script tag. Zero tracking cookies.
 
 ```html
 <script
-  src="https://unpkg.com/@zsolt/lens/dist/lens.umd.js"
+  src="https://unpkg.com/@zsoltcsaszti/lens/dist/lens.umd.js"
   data-site-id="YOUR_SITE_ID"
   data-api="https://your-lens-server.com"
   data-mode="emphasis">
@@ -25,14 +25,14 @@ Paste before `</body>` on every page. That's it — no API keys for readers, no
 **Via npm (for bundler-based setups):**
 
 ```bash
-npm install @zsolt/lens
+npm install @zsoltcsaszti/lens
 ```
 
 ```js
-import '@zsolt/lens' // side-effect import — auto-initialises from data-* attributes
+import '@zsoltcsaszti/lens' // side-effect import — auto-initialises from data-* attributes
 ```
 
-**WordPress:** copy [`wordpress/lens-analytics/`](wordpress/lens-analytics/) into `wp-content/plugins/`, activate, and configure under **Settings → Lens Analytics**.
+**WordPress:** the plugin is included in the npm package. After `npm install @zsoltcsaszti/lens`, copy `node_modules/@zsoltcsaszti/lens/wordpress/lens-analytics/` into `wp-content/plugins/`, activate, and configure under **Settings → Lens Analytics**.
 
 ---
 
@@ -172,7 +172,7 @@ Then point `data-api` in your script tag to your deployed URL.
 - [x] Section interest heatmap in dashboard
 - [x] WordPress plugin
 - [x] Multi-format demo (tech, news, magazine, tutorial)
-- [x] npm package (`@zsolt/lens`)
+- [x] npm package (`@zsoltcsaszti/lens`)
 - [ ] Multi-page interest graph (track topics across your whole publication)
 - [ ] A/B mode — adapted vs. non-adapted to 50/50 of visitors, measure engagement delta
 - [ ] Weekly publisher digest — "what your readers actually cared about this week"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zsoltcsaszti/lens",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Reader intelligence for publishers. One script tag. Zero tracking cookies.",
   "main": "dist/lens.umd.js",
   "module": "dist/lens.esm.js",
@@ -14,6 +14,7 @@
   "files": [
     "dist/",
     "sdk/lens.js",
+    "wordpress/",
     "README.md"
   ],
   "sideEffects": true,
@@ -34,13 +35,18 @@
     "build": "node build.js",
     "start": "node server/index.js",
     "dev": "node --watch server/index.js",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test": "jest"
   },
   "devDependencies": {
-    "esbuild": "^0.21.5"
+    "esbuild": "^0.21.5",
+    "jest": "^30.4.2"
   },
   "dependencies": {
     "cors": "^2.8.5",
     "express": "^4.19.2"
+  },
+  "jest": {
+    "testEnvironment": "node"
   }
 }

package/wordpress/lens-analytics/lens-analytics.php

@@ -0,0 +1,160 @@
+<?php
+/**
+ * Plugin Name:       Lens Analytics
+ * Plugin URI:        https://github.com/zsoltcsaszti/lens-sdk
+ * Description:       Reader intelligence for your WordPress site. No tracking cookies. No PII. One script tag.
+ * Version:           0.2.0
+ * Author:            Zsolt Csaszti
+ * License:           MIT
+ * Text Domain:       lens-analytics
+ */
+
+if ( ! defined( 'ABSPATH' ) ) exit;
+
+define( 'LENS_VERSION',    '0.2.0' );
+define( 'LENS_CDN_URL',    'https://unpkg.com/@zsoltcsaszti/lens@' . LENS_VERSION . '/dist/lens.umd.js' );
+define( 'LENS_OPTION_KEY', 'lens_analytics_settings' );
+
+function lens_defaults() {
+    return [
+        'site_id'      => '',
+        'api_endpoint' => '',
+        'mode'         => 'emphasis',
+    ];
+}
+
+// ── Inject SDK on all front-end pages ─────────────────────────────────────
+
+add_action( 'wp_footer', function() {
+    $opts = wp_parse_args( get_option( LENS_OPTION_KEY, [] ), lens_defaults() );
+    if ( empty( $opts['site_id'] ) ) return;
+
+    $valid_modes = [ 'emphasis', 'collapse', 'both', 'off' ];
+    $site_id     = esc_attr( $opts['site_id'] );
+    $api_url     = esc_attr( $opts['api_endpoint'] );
+    $mode        = esc_attr( in_array( $opts['mode'], $valid_modes ) ? $opts['mode'] : 'emphasis' );
+    $cdn         = esc_url( LENS_CDN_URL );
+
+    echo "\n<script src=\"{$cdn}\" data-site-id=\"{$site_id}\" data-api=\"{$api_url}\" data-mode=\"{$mode}\"></script>\n";
+}, 20 );
+
+// ── Admin settings page ────────────────────────────────────────────────────
+
+add_action( 'admin_menu', function() {
+    add_options_page(
+        'Lens Analytics',
+        'Lens Analytics',
+        'manage_options',
+        'lens-analytics',
+        'lens_settings_page'
+    );
+} );
+
+add_action( 'admin_init', function() {
+    register_setting( 'lens_analytics_group', LENS_OPTION_KEY, [
+        'sanitize_callback' => 'lens_sanitize_settings',
+    ] );
+} );
+
+function lens_sanitize_settings( $input ) {
+    $clean               = lens_defaults();
+    $clean['site_id']    = sanitize_text_field( $input['site_id']      ?? '' );
+    $clean['api_endpoint'] = esc_url_raw( $input['api_endpoint']       ?? '' );
+    $valid_modes         = [ 'emphasis', 'collapse', 'both', 'off' ];
+    $clean['mode']       = in_array( $input['mode'] ?? '', $valid_modes )
+                           ? $input['mode'] : 'emphasis';
+    return $clean;
+}
+
+function lens_settings_page() {
+    if ( ! current_user_can( 'manage_options' ) ) return;
+    $opts = wp_parse_args( get_option( LENS_OPTION_KEY, [] ), lens_defaults() );
+    $modes = [
+        'off'      => 'Off (analytics only)',
+        'emphasis' => 'Emphasis — highlight relevant sections (recommended)',
+        'collapse' => 'Collapse — hide low-relevance sections',
+        'both'     => 'Both — emphasise and collapse',
+    ];
+    ?>
+    <div class="wrap">
+      <h1>Lens Analytics</h1>
+      <p style="color:#666;max-width:520px;margin-bottom:24px;line-height:1.6">
+        Reader intelligence without the surveillance. Lens learns what each visitor cares about
+        and adapts your content locally — no accounts, no PII, no tracking cookies.
+        <a href="https://unpkg.com/@zsoltcsaszti/lens" target="_blank" rel="noopener">View SDK docs ↗</a>
+      </p>
+
+      <?php if ( empty( $opts['site_id'] ) ): ?>
+        <div class="notice notice-warning inline"><p>Enter a Site ID below to activate Lens on your site.</p></div>
+      <?php else: ?>
+        <div class="notice notice-success inline"><p>Lens is active on your site with site ID <strong><?= esc_html( $opts['site_id'] ) ?></strong>.</p></div>
+      <?php endif; ?>
+
+      <form method="post" action="options.php" style="margin-top:20px">
+        <?php settings_fields( 'lens_analytics_group' ); ?>
+        <table class="form-table" role="presentation">
+
+          <tr>
+            <th scope="row"><label for="lens_site_id">Site ID</label></th>
+            <td>
+              <input type="text" id="lens_site_id"
+                     name="<?= LENS_OPTION_KEY ?>[site_id]"
+                     value="<?= esc_attr( $opts['site_id'] ) ?>"
+                     class="regular-text"
+                     placeholder="e.g. my-blog" />
+              <p class="description">A short identifier for this site (letters, numbers, hyphens). Used to group analytics data.</p>
+            </td>
+          </tr>
+
+          <tr>
+            <th scope="row"><label for="lens_api">Analytics Server URL</label></th>
+            <td>
+              <input type="url" id="lens_api"
+                     name="<?= LENS_OPTION_KEY ?>[api_endpoint]"
+                     value="<?= esc_attr( $opts['api_endpoint'] ) ?>"
+                     class="regular-text"
+                     placeholder="https://your-lens-server.com" />
+              <p class="description">URL of your self-hosted Lens server. Leave blank to disable event sending (adaptation still works locally).</p>
+            </td>
+          </tr>
+
+          <tr>
+            <th scope="row"><label for="lens_mode">Adaptation Mode</label></th>
+            <td>
+              <select id="lens_mode" name="<?= LENS_OPTION_KEY ?>[mode]">
+                <?php foreach ( $modes as $value => $label ): ?>
+                  <option value="<?= esc_attr( $value ) ?>" <?php selected( $opts['mode'], $value ); ?>>
+                    <?= esc_html( $label ) ?>
+                  </option>
+                <?php endforeach; ?>
+              </select>
+              <p class="description">How Lens visually adapts the reading experience for each visitor.</p>
+            </td>
+          </tr>
+
+        </table>
+        <?php submit_button( 'Save Settings' ); ?>
+      </form>
+
+      <hr style="margin:32px 0 24px">
+
+      <h2 class="title">Manual installation snippet</h2>
+      <p style="color:#666;margin-bottom:12px">
+        If you prefer to add the script tag yourself (e.g. via a theme or another plugin):
+      </p>
+      <pre style="background:#1e1e1e;color:#d4d4d4;padding:16px 20px;border-radius:6px;font-size:12px;overflow-x:auto;line-height:1.6"><?php
+          $sid  = $opts['site_id']      ?: 'YOUR_SITE_ID';
+          $api  = $opts['api_endpoint'] ?: 'https://your-lens-server.com';
+          $mode = $opts['mode'];
+          echo esc_html(
+              '<script' . "\n" .
+              '  src="' . LENS_CDN_URL . '"' . "\n" .
+              '  data-site-id="' . $sid  . '"' . "\n" .
+              '  data-api="'     . $api  . '"' . "\n" .
+              '  data-mode="'    . $mode . '">' . "\n" .
+              '</script>'
+          );
+      ?></pre>
+    </div>
+    <?php
+}