hyperdecks 0.1.10 → 0.2.0

package/README.md

@@ -79,16 +79,11 @@ and JSON stats distinguish narration started/finished from unknown legacy
 playback. Production is the default for login, import, share and statistics;
 `--dev` with an explicit backend is only for implementation testing.
 
-The 0.1.10 release is prepared here; npm publication remains a separate
-coordinated step after backend/frontend rollout. Both `hyperdecks` and `decks`
-resolve to the same implementation.
+Both `hyperdecks` and `decks` resolve to the same implementation.
 
-Existing published 0.1.9 supports production login, import and ordinary share
-creation; publishing 0.1.10 is not required for those flows.
+## Animated email previews (0.1.10+)
 
-## Animated email previews (prepared 0.1.10; publication pending)
-
-This command is implemented in the prepared CLI source. npm publication, deployment of the owner-only `previews:get` Convex query, and upgrading a global CLI are coordinated release steps still pending. Local-file export needs no login or backend deployment. Both `hyperdecks` and `decks` accept the same command; the canonical package is `@hypersocial/decks-cli`.
+Published in 0.1.10; the owner-only `previews:get` query is live in production. Local-file export needs no login. Both `hyperdecks` and `decks` accept the same command; the canonical package is `@hypersocial/decks-cli`.
 
 ```sh
 hyperdecks preview setup
@@ -101,7 +96,18 @@ Generate locally, select an existing same-deck recipient share, then explicitly
 
 Capture defaults to the initial slide, 4 seconds, 600px width and 10 fps, with a play/watch badge on GIF, PNG and silent MP4. `--duration` accepts 1–10 seconds, `--width` 240–1200 pixels (odd widths round up for MP4), `--delay` 0–10000 milliseconds (default 1000), and `--label "Watch · 2:41"` supplies an explicit label; no whole-deck narration duration is inferred. Aspect comes from `--aspect-ratio W:H`, `<meta name="preview-aspect-ratio" content="16:9">`, or the first slide/canvas bounds; otherwise 16:9. Output height rounds to an even pixel. Fonts get up to 5 seconds to settle. Inspect readiness warnings/poster for slow modules or media and increase the bounded delay if needed.
 
-`--json` prints one result on stdout; errors/progress use stderr and failures exit nonzero. `manifest.json` records source, status, absolute artifact paths, MIME types, bytes, dimensions, clip durations/fps, share URL, warnings and each completed upload. Files larger than 5 MiB warn: reduce duration/width for email. On upload failure local artifacts survive; inspect the manifest's URLs and `upload` records (an uploaded storage blob can exist even if saving its asset failed). Retry in a fresh directory; never overwrite an image already used in an email.
+`--json` prints one line on stdout, identical to `<out>/manifest.json`:
+
+```json
+{ "status": "exported | uploaded | failed", "shareUrl": "https://decks.hypersocial.ai/v/<token>",
+  "files": [{ "type": "gif | png | mp4", "path": "...", "url": "https://...convex.cloud/api/storage/...", "bytes": 74662, "width": 600, "height": 338 }],
+  "email": { "sendable": true, "path": "<out>/email.html", "html": "<a href=\"<shareUrl>\"><img src=\"<gif url>\" ...></a>" },
+  "warnings": [] }
+```
+
+`email.html` is the embed: drop it into any HTML email body or API send. `url` and `email` exist only after `--upload`.
+
+Errors/progress use stderr and failures exit nonzero. `manifest.json` records source, status, absolute artifact paths, MIME types, bytes, dimensions, clip durations/fps, share URL, warnings and each completed upload. Files larger than 5 MiB warn: reduce duration/width for email. On upload failure local artifacts survive; inspect the manifest's URLs and `upload` records (an uploaded storage blob can exist even if saving its asset failed). Retry in a fresh directory; never overwrite an image already used in an email.
 
 Only successful explicit uploads produce `email.html` and `email.sendable: true`, with the GIF wrapped in the exact recipient link. Use that HTML/GIF in your draft manually. Some email clients show only the first GIF frame: the PNG poster and the visible watch badge provide a static fallback. MP4 is for other channels; email video support varies. Local exports provide files to insert manually and a separate share URL when selected, with no claim of sendable remote-image HTML. Static image downloads do not open the deck, start narration, record engagement, or notify the owner.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperdecks",
-  "version": "0.1.10",
+  "version": "0.2.0",
   "description": "Friendly CLI for Hypersocial Decks live analytics and share management.",
   "type": "module",
   "license": "UNLICENSED",
@@ -16,7 +16,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@hypersocial/decks-cli": "^0.1.10"
+    "@hypersocial/decks-cli": "^0.2.0"
   },
   "publishConfig": {
     "access": "public"