@smartkomm/plexus-cli 0.1.1 → 0.1.2

package/dist/skill/.managed-by-plexus-cli

@@ -1 +1 @@
-c85cbb64210eee51b7fb7b63351875bd6bd41699707b60bf736268722b6ebec1
+7d33c7c7f6e3bd7b3ba26910eaed2d3df2af5d707d4c83250c0b9edfef8530d2

package/dist/skill/references/marketing/demo-video-links.md

@@ -1,8 +1,8 @@
 # Personalised demo video links with viewing statistics
 
 **When to use:** send a named person a link to the public demo video page — to one
-video or to the whole page — and later see whether they opened it, when, how often
-and how long they watched each video. One sentence such as "Link für Erika
+video or to the whole page — and later see whether they opened it, when, how often,
+how long they watched each video and which demo pages they looked at for how long. One sentence such as "Link für Erika
 Mustermann zum Video Vorlagen" becomes one `demo link create`.
 
 ## Prerequisites
@@ -39,7 +39,10 @@ plexus-cli --env prod demo link create --allow-prod --to "Erika Mustermann" --js
 ```
 
 Send each recipient **their own** URL. The link's `?r=<code>` names the recipient;
-the rest of the URL is the page's usual jump to the video.
+the rest of the URL is the page's usual jump to the video. The code travels along
+when the recipient follows a link to another demo page (`/demo/ihre-schule`,
+`/demo/ihr-traeger`), so those page views count for the same link; it is dropped
+when they leave the demo pages (e.g. the apply button to the portal).
 
 The recipient CSV must be **UTF-8**: in Excel, *Save as → „CSV UTF-8 (durch
 Trennzeichen getrennt) (*.csv)"*. A file in the older „CSV (Trennzeichen-getrennt)"
@@ -58,7 +61,12 @@ plexus-cli --env prod demo link stats --campaign herbst   # or: demo link stats
 - `gesehen` — seconds actually played, summed over all visits, / video length,
 - `%` — how much of the video the best single visit actually played. Skipping ahead
   to the end does not count: someone who drags the slider to the end and stops shows
-  a few seconds and a low `%`.
+  a few seconds and a low `%`,
+- `seiten` — the demo pages looked at: per page the time it was visible, summed over
+  all visits (mm:ss), and how many visits viewed it, e.g.
+  `Videos 3:10 (2×) · Ihre Schule 0:45 (1×)`. A page counts once it was visible 5 s
+  or the visitor interacted on it. Platform → „Demo-Links" shows the same in the
+  column „Seiten" (without the count).
 
 A recipient who never opened the link shows `0` and `—`.
 
@@ -83,13 +91,16 @@ plexus-cli --env prod demo link delete --allow-prod <code> --confirm  # deletes,
 - **A forwarded link counts for the original recipient.** The link knows only whom it
   was created for; if they forward it, the colleague's viewing is counted under their
   name. Create a separate link per person.
-- **Every page load is a visit**, a reload too. Switching view or video on the page
-  is not a new visit.
+- **Every page load is a visit**, a reload too. Switching view or video on the page,
+  or following a link to another demo page, is not a new visit.
 - **Watching time is counted from playback**, every 10 seconds and when the viewer
   pauses or leaves: closing the tab abruptly can lose up to 10 seconds.
+- **Page time is time visible**: a page in a background tab or a minimised window does
+  not count; reported every 10 seconds, so up to 10 seconds can get lost on leaving.
 - **No cookie, nothing stored in the browser, no session replay** for pages opened
-  through such a link. Visits and playback are deleted after 12 months; the link
-  itself (name, address) stays until `demo link delete`.
+  through such a link; the code travels only in the address. Visits, playback and
+  page views are deleted after 12 months; the link itself (name, address) stays until
+  `demo link delete`.
 - `create` is not idempotent: running it twice gives the same person two links.
   `revoke` is: revoking twice keeps the first time.
 - An unknown video id is refused, and the error lists every valid id. A CSV batch is

package/dist/spec.snapshot.json

@@ -58220,6 +58220,35 @@
               },
               "optional": true
             },
+            "pages": {
+              "fieldType": {
+                "type": "array",
+                "value": {
+                  "type": "object",
+                  "value": {
+                    "activeSeconds": {
+                      "fieldType": {
+                        "type": "number"
+                      },
+                      "optional": false
+                    },
+                    "path": {
+                      "fieldType": {
+                        "type": "string"
+                      },
+                      "optional": false
+                    },
+                    "views": {
+                      "fieldType": {
+                        "type": "number"
+                      },
+                      "optional": false
+                    }
+                  }
+                }
+              },
+              "optional": false
+            },
             "recipientEmail": {
               "fieldType": {
                 "type": "string"
@@ -58380,6 +58409,35 @@
             },
             "optional": true
           },
+          "pages": {
+            "fieldType": {
+              "type": "array",
+              "value": {
+                "type": "object",
+                "value": {
+                  "activeSeconds": {
+                    "fieldType": {
+                      "type": "number"
+                    },
+                    "optional": false
+                  },
+                  "path": {
+                    "fieldType": {
+                      "type": "string"
+                    },
+                    "optional": false
+                  },
+                  "views": {
+                    "fieldType": {
+                      "type": "number"
+                    },
+                    "optional": false
+                  }
+                }
+              }
+            },
+            "optional": false
+          },
           "recipientEmail": {
             "fieldType": {
               "type": "string"
@@ -58454,6 +58512,20 @@
         }
       }
     },
+    {
+      "identifier": "demoLinks.js:listCampaigns",
+      "functionType": "Query",
+      "args": {
+        "type": "object",
+        "value": {}
+      },
+      "returns": {
+        "type": "array",
+        "value": {
+          "type": "string"
+        }
+      }
+    },
     {
       "identifier": "demoLinks.js:listLinks",
       "functionType": "Query",
@@ -58585,6 +58657,35 @@
                     },
                     "optional": true
                   },
+                  "pages": {
+                    "fieldType": {
+                      "type": "array",
+                      "value": {
+                        "type": "object",
+                        "value": {
+                          "activeSeconds": {
+                            "fieldType": {
+                              "type": "number"
+                            },
+                            "optional": false
+                          },
+                          "path": {
+                            "fieldType": {
+                              "type": "string"
+                            },
+                            "optional": false
+                          },
+                          "views": {
+                            "fieldType": {
+                              "type": "number"
+                            },
+                            "optional": false
+                          }
+                        }
+                      }
+                    },
+                    "optional": false
+                  },
                   "recipientEmail": {
                     "fieldType": {
                       "type": "string"
@@ -58850,6 +58951,30 @@
                       "optional": false
                     }
                   }
+                },
+                {
+                  "type": "object",
+                  "value": {
+                    "activeSeconds": {
+                      "fieldType": {
+                        "type": "number"
+                      },
+                      "optional": false
+                    },
+                    "kind": {
+                      "fieldType": {
+                        "type": "literal",
+                        "value": "page"
+                      },
+                      "optional": false
+                    },
+                    "path": {
+                      "fieldType": {
+                        "type": "string"
+                      },
+                      "optional": false
+                    }
+                  }
                 }
               ]
             },
@@ -58946,6 +59071,35 @@
             },
             "optional": true
           },
+          "pages": {
+            "fieldType": {
+              "type": "array",
+              "value": {
+                "type": "object",
+                "value": {
+                  "activeSeconds": {
+                    "fieldType": {
+                      "type": "number"
+                    },
+                    "optional": false
+                  },
+                  "path": {
+                    "fieldType": {
+                      "type": "string"
+                    },
+                    "optional": false
+                  },
+                  "views": {
+                    "fieldType": {
+                      "type": "number"
+                    },
+                    "optional": false
+                  }
+                }
+              }
+            },
+            "optional": false
+          },
           "recipientEmail": {
             "fieldType": {
               "type": "string"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartkomm/plexus-cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Unified Plexus admin + admission-offer config CLI (Convex backend).",
   "license": "UNLICENSED",
   "type": "module",