droppage 0.2.0 → 0.2.1

package/README.md

@@ -56,6 +56,10 @@ Open the printed link in any browser. That's it.
 
 Run `droppage <command> --help` for full option details.
 
+Slugs from 0.2.1 on never start with `-`. If an older page's slug does (say `-AbC12xYz9`), put `--` in front of
+it, with any options before the `--`: `droppage expire -- -AbC12xYz9 never` or
+`droppage update --expires 7d -- -AbC12xYz9 report.html`. The CLI prints the same hint when it happens.
+
 ## Access modes
 
 | Upload flag | Mode | Who can open the link |
@@ -128,6 +132,25 @@ its images stop working. A daily cleanup then deletes the page and its images fo
 `droppage list` shows an EXPIRES column (`never` or a date); `list --json` rows have `expires_at`
 (`null` means never).
 
+## Sharing reports and dashboards
+
+droppage is a quick way to send an analysis to people who don't have your tools: a dashboard for your
+team, a weekly KPI or stakeholder report, a client deliverable, a notebook export. They open a link.
+
+- **Export one HTML file**, up to 5 MB, with the data inside it: `jupyter nbconvert --to html
+  analysis.ipynb`, Plotly's `fig.write_html("report.html", include_plotlyjs="cdn")`, Altair's
+  `chart.save("report.html")`, or your own Chart.js / ECharts page. Scripts run, so interactive
+  charts work, and chart libraries can load from a CDN.
+- **Pages run in a sandbox**: `localStorage`, cookies, and same-origin requests are not available, so
+  keep the data in the file rather than fetching it.
+- **Pick who sees it.** `--email cfo@example.com,ops@example.com` for named people (Builder; manage
+  them later with `droppage recipients`), `--password` for a group link (Starter and Builder),
+  `--private` for a draft. On the Free plan, pages can be public or private, without a password or email list.
+- **Same link every week.** `droppage update <slug> report.html` replaces the report and keeps the
+  link and its access settings (Starter and Builder). Use `--expires 30d` for one-off deliverables.
+- **Views are people.** `droppage list --json` shows `view_count` (unique visitors) and
+  `last_viewed_at` for each report.
+
 ## For agents and scripts
 
 droppage keeps a strict stream contract so it is safe to call from automation:

package/dist/cli.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "droppage",
-      version: "0.2.0",
+      version: "0.2.1",
       description: "Publish HTML files as shareable, access-controlled live pages",
       type: "module",
       license: "Apache-2.0",
@@ -728,15 +728,26 @@ var init_page_images = __esm({
 // src/lib/slug.ts
 import { customAlphabet } from "nanoid";
 function createSlug() {
-  return generate();
+  return first() + rest();
 }
-var SLUG_LENGTH, alphabet, generate;
+function dashSlugHint(error) {
+  const slug = DASH_SLUG_ERROR.exec(error)?.[1];
+  if (!slug) return "";
+  return `droppage: if ${slug} is a page, put -- in front of it (options go before the --), for example:
+  droppage expire -- ${slug} never
+  droppage update --expires 7d -- ${slug} report.html
+`;
+}
+var SLUG_LENGTH, alphanumeric, alphabet, first, rest, DASH_SLUG_ERROR;
 var init_slug = __esm({
   "src/lib/slug.ts"() {
     "use strict";
     SLUG_LENGTH = 10;
-    alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-";
-    generate = customAlphabet(alphabet, SLUG_LENGTH);
+    alphanumeric = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    alphabet = `${alphanumeric}_-`;
+    first = customAlphabet(alphanumeric, 1);
+    rest = customAlphabet(alphabet, SLUG_LENGTH - 1);
+    DASH_SLUG_ERROR = new RegExp(`unknown option '(-[A-Za-z0-9_][A-Za-z0-9_-]{${SLUG_LENGTH - 2}})'`);
   }
 });
 
@@ -1934,7 +1945,7 @@ import { Command } from "commander";
 function createProgram() {
   const program2 = new Command().name("droppage").description(
     "Publish HTML files as shareable, access-controlled live pages"
-  ).version(package_default.version);
+  ).version(package_default.version).configureOutput({ outputError: (str, write) => write(str + dashSlugHint(str)) });
   registerLogin(program2);
   registerLogout(program2);
   registerUpload(program2);
@@ -1963,6 +1974,7 @@ var init_index = __esm({
     init_feedback2();
     init_upgrade();
     init_image();
+    init_slug();
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "droppage",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Publish HTML files as shareable, access-controlled live pages",
   "type": "module",
   "license": "Apache-2.0",