@wrangled/cli 0.3.158 → 0.3.160

package/dist/guide.js

@@ -120,7 +120,7 @@ To find content, such as "the 10 emails with the best click rate", "our 5 best v
 
 - \`--text "<words>"\` finds words in the current version's subject, headline and body, or in a video's or call recording's transcript. Words are stemmed ("guarantee" finds "guaranteed"); use "quotes" for a phrase and -word to leave a word out.
 - \`--mode meaning\` finds content that means something close to \`--text\`, even in other words: \`--text "saves time"\` also finds "done in five minutes". Results come nearest first, each with its distance (0 is the same meaning) and the closest passage as its words. It takes no \`--sort\` or \`--order\`, and finds only content embedded so far (each hour, new versions and transcripts are embedded).
-- \`--kind\` (ad, email, sms, landing_page, video, social_post, article, conversation, document, collection_item), \`--platform\` (meta, ghl, klaviyo, roezan, bayengage, activecampaign, mailchimp, hubspot, kit, instantly, kajabi, omnisend, google_ads, tiktok, microsoft_ads, pinterest, linkedin, web, wordpress, webflow, strapi, youtube, instagram, facebook_page, callrail, zoom, fathom, fireflies, gong, granola, tldv, google_drive, ad_library, workspace, upload) and \`--origin\` (discovered or made) narrow it, and \`--collection <slug>\` keeps one collection's items, each with its details. \`--from\` and \`--to\` keep content live on those days: from its first day with numbers (or the day the library first saw it) to its last.
+- \`--kind\` (ad, email, sms, landing_page, video, social_post, article, conversation, document, collection_item), \`--platform\` (meta, ghl, klaviyo, roezan, bayengage, activecampaign, mailchimp, hubspot, kit, instantly, kajabi, omnisend, mailgun, google_ads, tiktok, microsoft_ads, pinterest, linkedin, web, wordpress, webflow, strapi, youtube, instagram, facebook_page, callrail, zoom, fathom, fireflies, gong, granola, tldv, google_drive, ad_library, workspace, upload) and \`--origin\` (discovered or made) narrow it, and \`--collection <slug>\` keeps one collection's items, each with its details. \`--from\` and \`--to\` keep content live on those days: from its first day with numbers (or the day the library first saw it) to its last.
 - \`--sort\` is \`recent\` (the default, newest first) or any number in the \`content_scorecard\` view, such as \`click_rate\`, \`open_rate\`, \`roas\`, \`spend\` or their \`_30d\` twins for the last 30 days. Content with money in several currencies has a number per currency and sorts by its best. Content without that number comes last. \`--order asc\` turns it around; \`--limit\` is 1 to 50 (default 10).
 - Each result has the item's id or SKU, its words, how many files it has, whether it has a transcript, and its scorecard numbers. \`${cli} content show <sku | item-id>\` prints one item in full: its words, how many versions it has, its transcript and every number; \`--format json\` adds every version, and links to its files.
 - To add marketing that lives somewhere no source connects to, such as a sales video, a webinar recording, a script or an email from another tool, run \`${cli} content capture --kind <kind> --name <name>\` with \`--body\`, \`--file\`, \`--source\` (where it came from) and \`--url\`. It is kept as found, with no SKU, so it is never approved or published; \`--platform upload\` finds these. Videos and audio are transcribed on their own; give \`--transcript @file\` when you already have one, so none is paid for.

package/dist/main.js

@@ -1681,10 +1681,10 @@ const commands = {
         },
     },
     winners: {
-        usage: "winners [--week <YYYY-MM-DD> | --days <n> | --from <YYYY-MM-DD> --to <YYYY-MM-DD>] [--top <n>] [--ad-format image|video|carousel] [--offer <offer key>]   (which Facebook ads and landing pages won and flopped, judged on each client's goal; see winners goals)",
+        usage: "winners [--week <YYYY-MM-DD> | --days <n> | --from <YYYY-MM-DD> --to <YYYY-MM-DD>] [--top <n>] [--ad-format image|video|carousel] [--offer <offer key or name>]   (which Facebook ads and landing pages won and flopped, judged on each client's goal; see winners goals)",
         async run(args, options) {
             if (args.length > 0)
-                throw new CliError("Usage: winners [--week <date> | --days <n> | --from <date> --to <date>] [--top <n>] [--ad-format image|video|carousel] [--offer <offer key>]", exitCodes.usage);
+                throw new CliError("Usage: winners [--week <date> | --days <n> | --from <date> --to <date>] [--top <n>] [--ad-format image|video|carousel] [--offer <offer key or name>]", exitCodes.usage);
             const query = new URLSearchParams();
             for (const [name, value] of Object.entries({ ...winnersPeriod(options), top: options.top, format: options.entryTags.format, offer: options.offer }))
                 if (value !== undefined)
@@ -4568,6 +4568,7 @@ function salesRows(label, sales, calls) {
 const messageLabel = (m) => excerpt(m.name ?? m.subject ?? (m.realSales === "available" ? m.messageKey : (m.itemId ?? "")), 40);
 const messageSubject = (m) => (m.subject === null ? "" : excerpt(m.subject, 40));
 const MESSAGE_WORDS_CHARS = 400;
+const MAILGUN_NO_WORDS = "No words on file: Mailgun's events carry the subject line but not the email's words, and Mailgun's stored copy is not read. Read them in the tool that sent it (GoHighLevel, for an et_ tag).";
 /** Each message's subject and words, cut short, under its label and item id, in the tables' order. */
 function printMessageWords(messages) {
     if (messages.length === 0)
@@ -4575,8 +4576,9 @@ function printMessageWords(messages) {
     console.log("\nWords of each message, in the order above:");
     for (const m of messages) {
         const lines = [...(m.subject === null ? [] : [`Subject: ${m.subject}`]), ...(m.bodyText === null ? [] : excerpt(m.bodyText, MESSAGE_WORDS_CHARS, { flat: false }).split("\n"))];
+        const missing = m.bodyText !== null ? [] : m.platform === "mailgun" ? [MAILGUN_NO_WORDS] : lines.length === 0 ? ["No words on file."] : [];
         console.log(`\n${messageLabel(m)}${m.itemId === null ? "" : `, item ${m.itemId}`}`);
-        console.log((lines.length === 0 ? ["No words on file."] : lines).map((line) => `  ${line}`.trimEnd()).join("\n"));
+        console.log([...lines, ...missing].map((line) => `  ${line}`.trimEnd()).join("\n"));
     }
     console.log("\n--format json gives every message's full words.");
 }
@@ -5232,8 +5234,9 @@ Options:
                         your own ads tagged the same way with their results; with knowledge tag, the tags to put on an entry;
                         with winners, --ad-format ranks only ads whose format tag is that one (run ads tag-formats first);
                         with meta ad create, the new ad's angle, hook kind and format, which its name is written from
-  --offer <key>         with winners, rank ads on first-touch sales of this offer in the funnel map only (landing pages
-                        still count every sale); with profile messaging, that offer's outcome map, segments and personas
+  --offer <key>         with winners, rank ads on first-touch sales of this offer in the funnel map only, by its key or
+                        name (landing pages still count every sale); with profile messaging, that offer's outcome map,
+                        segments and personas
   --concept <key>       meta ad create: the new ad's concept, a key on the client's concept list
   --style <style>       meta ad create: the new ad's style, if it has one
   --confidence high|medium|low   with knowledge tag, how sure you are of the tags

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrangled/cli",
-  "version": "0.3.158",
+  "version": "0.3.160",
   "description": "Command-line access to your marketing data warehouse, for people and coding agents",
   "type": "module",
   "bin": {