@officexapp/vidfarm-devcli 0.21.63 → 0.21.65

package/marketplace.md

@@ -52,6 +52,12 @@ Both take `--json` on every subcommand, and both authenticate on the ordinary vi
 (`vidfarm login`, `VIDFARM_API_KEY`, or `--api-key`). The marketplace is paid-only, so a free key
 reaches the routes and is refused with `402`.
 
+**One shop-level rule cuts across both verbs: NEW SHOP.** The platform can mark a shop so every
+buyer's *first* order there is free — one pack, $0, one per shop. Those orders carry no deposit and
+never pay out, and **the buyer's approval is final and releases the files by itself** rather than
+waiting for a payout. Buyers: § *first order free* in `marketplace-buyer.md`. Vendors: § *a NEW SHOP
+order pays nothing* below. Either way, read `is_free` on the order — never `total_usd == 0`.
+
 **This document is the shared reference underneath both harnesses** — the keys, the REST surface,
 the machines, the proof rules, the payout rules. The harness tells you *what loop to run*; this file
 tells you *what each call does*. Read the harness for your side first, then use this as the manual.
@@ -1699,6 +1705,24 @@ dollar platoon task**, which is why the order page and the task thread are the s
 | you deliver | proof — watermarked evidence + **sealed note** |
 | the buyer's pack | `https://vidfarm.cc/delivery/<id>` |
 
+#### a NEW SHOP order pays nothing, and it is still real work
+
+if your shop is marked **new shop**, every buyer's **first order** at it is free — one pack, $0. the
+platform grants that, not you; `vidfarm shop` reports it and an operator changes it. what matters
+while you are working one:
+
+- **it carries no deposit and it never pays out.** `vidfarm shop orders` shows it as `FREE`, not as
+  `UNFUNDED` — those are different things, and the red one means *do not work this*. a free order is
+  an order the vendor agreed to take. work it normally.
+- **the buyer's approval is final and releases your files at once.** on a paid order the payout
+  unlocks the clean masters; here the approval does it alone, because there is no payout afterwards.
+  so there is no window in which to renegotiate — deliver what you would deliver for money.
+- **your earnings chart will show orders totalling $0.** that is the promotion, not a broken rollup.
+
+underneath it is a **separate dollar platoon gig** (`dpFreeGigId`) with `list_price: 0`. their API
+locks a gig's price mode at creation, so one gig cannot sell both free and paid — which is why a
+machine that does both owns two. you never choose which: the order lands in the right one.
+
 #### the delivery url — vidfarm mints it, you never invent it
 
 **you do not construct a `/delivery/` url.** it is minted when you fulfil the order, and it is the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@officexapp/vidfarm-devcli",
-  "version": "0.21.63",
+  "version": "0.21.65",
   "description": "Local bridge for the Vidfarm Trackpad Editor. `vidfarm serve <template_id>` boots the FULL editor on localhost (disk-backed records/storage, free in-process render); edit composition.html on disk (Claude Code, Codex, etc.) and the browser live-morphs it.",
   "type": "module",
   "bin": {
@@ -161,6 +161,8 @@
     "test:order-decision": "node --import tsx --test test/order-decision.test.ts",
     "test:reviews": "node --import tsx --test test/shop-reviews.test.ts",
     "test:marketplace-api": "node --import tsx --test test/marketplace-api.test.ts",
+    "test:marketplace-regressions": "node --import tsx --test test/marketplace-prod-regressions.test.ts",
+    "test:new-shop-free-order": "node --import tsx --test test/new-shop-free-order.test.ts",
     "test:notifications": "node --import tsx --test test/marketplace-notifications.test.ts",
     "test:delivery": "node --import tsx --test test/delivery-items.test.ts",
     "test:dporders": "node --import tsx --test test/dp-order-fee.test.ts",