@itznexus/itznexus-cli 1.135.0 → 1.137.0

package/dist/commands/api/seo-backlinks.js

@@ -0,0 +1,132 @@
+import { Command } from "commander";
+import { api } from "../../lib/api.js";
+import { handleError, printList } from "../../lib/format.js";
+import { compact, csv, done, nullable, nullableInt, qs, } from "./seo-shared.js";
+const ORIGINS = "directory | launch-platform | expert-quote | podcast | press-release | event | linkable-asset | organic";
+const STATUSES = "planned | submitted | live | rejected | lost";
+function withFieldOptions(cmd, required) {
+    const origin = "--origin <origin>";
+    const platform = "--platform <name>";
+    if (required) {
+        cmd
+            .requiredOption(origin, ORIGINS)
+            .requiredOption(platform, "Where the link lives (directory or site name)");
+    }
+    else {
+        cmd.option(origin, ORIGINS).option(platform, "Where the link lives");
+    }
+    return cmd
+        .option("--platform-url <url>", 'Platform URL ("null" to clear)')
+        .option("--account <login>", 'Login used, never a password ("null" to clear)')
+        .option("--listing-name <name>", "Submission name")
+        .option("--tagline <text>", "Submission tagline")
+        .option("--description <text>", "Submission description, in our keyword wording")
+        .option("--topics <list>", "Comma-separated topics or categories")
+        .option("--source-url <url>", "Page carrying the link")
+        .option("--target-url <url>", "Our page it links to")
+        .option("--anchor-text <text>", "Anchor text")
+        .option("--rel <rel>", "follow | nofollow | ugc | sponsored")
+        .option("--domain-authority <n>", "Moz DA of the linking site")
+        .option("--notes <text>", 'Notes ("null" to clear)');
+}
+function fieldPayload(opts) {
+    return compact({
+        origin: opts.origin,
+        platform: opts.platform,
+        platformUrl: nullable(opts.platformUrl),
+        account: nullable(opts.account),
+        listingName: nullable(opts.listingName),
+        tagline: nullable(opts.tagline),
+        description: nullable(opts.description),
+        topics: opts.topics !== undefined ? csv(opts.topics) : undefined,
+        sourceUrl: nullable(opts.sourceUrl),
+        targetUrl: nullable(opts.targetUrl),
+        anchorText: nullable(opts.anchorText),
+        rel: nullable(opts.rel),
+        domainAuthority: nullableInt(opts.domainAuthority, "domain-authority"),
+        notes: nullable(opts.notes),
+    });
+}
+const listCmd = new Command("list")
+    .description("List backlinks and submissions")
+    .option("--status <status>", STATUSES)
+    .option("--origin <origin>", ORIGINS)
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const data = await api.get(`/seo/backlinks${qs({ status: opts.status, origin: opts.origin })}`);
+        printList(data, [
+            { key: "platform", label: "Platform", width: 24 },
+            { key: "origin", label: "Origin", width: 15 },
+            { key: "status", label: "Status", width: 10 },
+            { key: "rel", label: "Rel", width: 9 },
+            { key: "domainAuthority", label: "DA", width: 4 },
+            { key: "targetUrl", label: "Target", width: 32 },
+            { key: "id", label: "Id", width: 36 },
+        ], opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const addCmd = withFieldOptions(new Command("add").description("Record a link to pursue or one already earned"), true)
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const data = await api.post("/seo/backlinks", fieldPayload(opts));
+        done(data, opts, `Backlink added: ${data.platform} (${data.id})`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const updateCmd = withFieldOptions(new Command("update")
+    .description("Update a backlink's fields (status has its own command)")
+    .argument("<id>", "Backlink id"), false)
+    .option("--json", "Output as JSON")
+    .action(async (id, opts) => {
+    try {
+        const data = await api.post(`/seo/backlinks/${id}`, fieldPayload(opts));
+        done(data, opts, `Backlink updated: ${data.platform}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const statusCmd = new Command("status")
+    .description("Move a backlink through planned, submitted, live, rejected, lost")
+    .argument("<id>", "Backlink id")
+    .argument("<status>", STATUSES)
+    .option("--json", "Output as JSON")
+    .action(async (id, status, opts) => {
+    try {
+        const data = await api.post(`/seo/backlinks/${id}/status`, {
+            status,
+        });
+        done(data, opts, `Backlink ${data.platform}: ${data.status}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const deleteCmd = new Command("delete")
+    .description("Delete a backlink record")
+    .argument("<id>", "Backlink id")
+    .option("--json", "Output as JSON")
+    .action(async (id, opts) => {
+    try {
+        const data = await api.delete(`/seo/backlinks/${id}`);
+        done(data, opts, `Backlink deleted: ${id}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+export const seoBacklinkCommand = new Command("backlink")
+    .description("Backlinks and off-site submissions (directories, launches, quotes)")
+    .addCommand(listCmd)
+    .addCommand(addCmd)
+    .addCommand(updateCmd)
+    .addCommand(statusCmd)
+    .addCommand(deleteCmd);
+//# sourceMappingURL=seo-backlinks.js.map

package/dist/commands/api/seo-backlinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-backlinks.js","sourceRoot":"","sources":["../../../src/commands/api/seo-backlinks.ts"],"names":[],"mappings":"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"}

package/dist/commands/api/seo-catalog.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const seoCatalogCommands: Command[];

package/dist/commands/api/seo-catalog.js

@@ -0,0 +1,184 @@
+import { Command } from "commander";
+import { api } from "../../lib/api.js";
+import { handleError, printList } from "../../lib/format.js";
+import { compact, csv, done, nullable, nullableInt, parseBool, toInt, } from "./seo-shared.js";
+function listCommand(path, description, columns, shape = (row) => row) {
+    return new Command("list")
+        .description(description)
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            const data = await api.get(path);
+            printList(opts.json ? data : data.map(shape), columns, opts);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+function archiveCommand(base, noun, argName) {
+    return new Command("archive")
+        .description(`Archive a ${noun} (never deleted; history keeps it)`)
+        .argument(`<${argName}>`, `The ${noun}'s ${argName}`)
+        .option("--json", "Output as JSON")
+        .action(async (ref, opts) => {
+        try {
+            const data = await api.post(`${base}/${encodeURIComponent(ref)}/archive`, {});
+            done(data, opts, `Archived ${noun} ${ref}`);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+const marketSet = new Command("set")
+    .description("Create or update a market keyed by code (every option required on create)")
+    .argument("<code>", "Lowercase ISO 3166-1 alpha-2 code (us, gb, fr)")
+    .option("--name <name>", "Display name (United States)")
+    .option("--language <lang>", "Site language: en | fr")
+    .option("--country-code <code>", "ISO 3166-1 alpha-2, the hreflang region (US)")
+    .option("--search-console-country <code>", "ISO 3166-1 alpha-3 as Search Console reports it (usa)")
+    .option("--dataforseo-location-code <n>", "DataForSEO location code (2840)")
+    .option("--position <n>", "Sort position")
+    .option("--json", "Output as JSON")
+    .action(async (code, opts) => {
+    try {
+        const data = await api.post("/seo/markets", compact({
+            code,
+            name: opts.name,
+            language: opts.language,
+            countryCode: opts.countryCode,
+            searchConsoleCountry: opts.searchConsoleCountry,
+            dataforseoLocationCode: opts.dataforseoLocationCode !== undefined
+                ? toInt(opts.dataforseoLocationCode, "dataforseo-location-code")
+                : undefined,
+            position: opts.position !== undefined
+                ? toInt(opts.position, "position")
+                : undefined,
+        }));
+        done(data, opts, `Market set: ${code}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const marketCommand = new Command("market")
+    .description("Markets: a language plus a country, with its provider codes")
+    .addCommand(listCommand("/seo/markets", "List markets", [
+    { key: "code", label: "Code", width: 5 },
+    { key: "name", label: "Name", width: 16 },
+    { key: "language", label: "Lang", width: 5 },
+    { key: "countryCode", label: "Country", width: 8 },
+    { key: "searchConsoleCountry", label: "GSC", width: 5 },
+    { key: "dataforseoLocationCode", label: "DataForSEO", width: 10 },
+    { key: "archivedAt", label: "Archived", width: 24 },
+]))
+    .addCommand(marketSet)
+    .addCommand(archiveCommand("/seo/markets", "market", "code"));
+const domainSet = new Command("set")
+    .description("Create or update a domain (ours or a competitor), keyed by domain")
+    .argument("<domain>", "Domain or URL (normalized to the host without www.)")
+    .option("--role <role>", "own | competitor (required on create)")
+    .option("--name <name>", 'Display name ("null" to clear)')
+    .option("--markets <codes>", "Comma-separated market codes it is mined in (empty: every market)")
+    .option("--notes <text>", 'Notes ("null" to clear)')
+    .option("--json", "Output as JSON")
+    .action(async (domain, opts) => {
+    try {
+        const data = await api.post("/seo/domains", compact({
+            domain,
+            role: opts.role,
+            name: nullable(opts.name),
+            marketCodes: opts.markets !== undefined ? csv(opts.markets) : undefined,
+            notes: nullable(opts.notes),
+        }));
+        done(data, opts, `Domain set: ${String(data.domain)}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const domainMetrics = new Command("metrics")
+    .description("Stamp a domain's Moz link metrics")
+    .argument("<domain>", "Domain")
+    .option("--domain-authority <n>", "Moz Domain Authority (0-100)")
+    .option("--page-authority <n>", "Moz Page Authority of the home page")
+    .option("--linking-root-domains <n>", "Linking root domains")
+    .option("--spam-score <n>", "Moz spam score")
+    .option("--checked-at <iso>", "When the metrics were read (defaults to now)")
+    .option("--json", "Output as JSON")
+    .action(async (domain, opts) => {
+    try {
+        const data = await api.post(`/seo/domains/${encodeURIComponent(domain)}/metrics`, compact({
+            domainAuthority: nullableInt(opts.domainAuthority, "domain-authority"),
+            pageAuthority: nullableInt(opts.pageAuthority, "page-authority"),
+            linkingRootDomains: nullableInt(opts.linkingRootDomains, "linking-root-domains"),
+            spamScore: nullableInt(opts.spamScore, "spam-score"),
+            checkedAt: opts.checkedAt,
+        }));
+        done(data, opts, `Metrics stamped on ${domain}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const domainCommand = new Command("domain")
+    .description("Our domain and the tracked competitors, with Moz metrics")
+    .addCommand(listCommand("/seo/domains", "List domains (ours first)", [
+    { key: "domain", label: "Domain", width: 28 },
+    { key: "role", label: "Role", width: 11 },
+    { key: "domainAuthority", label: "DA", width: 4 },
+    { key: "pageAuthority", label: "PA", width: 4 },
+    { key: "linkingRootDomains", label: "LRD", width: 6 },
+    { key: "markets", label: "Markets", width: 16 },
+    { key: "archivedAt", label: "Archived", width: 24 },
+], (row) => ({
+    ...row,
+    markets: row.marketCodes.join(",") || "all",
+})))
+    .addCommand(domainSet)
+    .addCommand(domainMetrics)
+    .addCommand(archiveCommand("/seo/domains", "domain", "domain"));
+const hubSet = new Command("set")
+    .description("Create or update a hub page keyed by slug (/services/)")
+    .argument("<slug>", "Hub URL segment, kebab-case, immutable")
+    .option("--title-en <title>", "English hub title")
+    .option("--title-fr <title>", "French hub title")
+    .option("--in-footer <bool>", "Linked from the footer: true | false")
+    .option("--position <n>", "Sort position")
+    .option("--json", "Output as JSON")
+    .action(async (slug, opts) => {
+    try {
+        const titles = compact({ en: opts.titleEn, fr: opts.titleFr });
+        const data = await api.post("/seo/hubs", compact({
+            slug,
+            titles: Object.keys(titles).length ? titles : undefined,
+            inFooter: opts.inFooter !== undefined
+                ? parseBool(opts.inFooter, "in-footer")
+                : undefined,
+            position: opts.position !== undefined
+                ? toInt(opts.position, "position")
+                : undefined,
+        }));
+        done(data, opts, `Hub set: ${slug}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const hubCommand = new Command("hub")
+    .description("Hub pages grouping landing pages (/services/, /alternatives/)")
+    .addCommand(listCommand("/seo/hubs", "List hubs", [
+    { key: "slug", label: "Slug", width: 16 },
+    { key: "titleEn", label: "Title (en)", width: 24 },
+    { key: "titleFr", label: "Title (fr)", width: 24 },
+    { key: "inFooter", label: "Footer", width: 7 },
+    { key: "archivedAt", label: "Archived", width: 24 },
+], (row) => {
+    const titles = row.titles;
+    return { ...row, titleEn: titles.en, titleFr: titles.fr };
+}))
+    .addCommand(hubSet)
+    .addCommand(archiveCommand("/seo/hubs", "hub", "slug"));
+export const seoCatalogCommands = [marketCommand, domainCommand, hubCommand];
+//# sourceMappingURL=seo-catalog.js.map

package/dist/commands/api/seo-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-catalog.js","sourceRoot":"","sources":["../../../src/commands/api/seo-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,OAAO,EACP,GAAG,EACH,IAAI,EAEJ,QAAQ,EACR,WAAW,EACX,SAAS,EACT,KAAK,GACN,MAAM,iBAAiB,CAAC;AAIzB,SAAS,WAAW,CAClB,IAAY,EACZ,WAAmB,EACnB,OAAyD,EACzD,QAA2B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;IAEvC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;SACvB,WAAW,CAAC,WAAW,CAAC;SACxB,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,IAAa,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAQ,IAAI,CAAC,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe;IACjE,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CAAC,aAAa,IAAI,oCAAoC,CAAC;SAClE,QAAQ,CAAC,IAAI,OAAO,GAAG,EAAE,OAAO,IAAI,MAAM,OAAO,EAAE,CAAC;SACpD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,IAAa,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,GAAG,IAAI,IAAI,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAC5C,EAAE,CACH,CAAC;YACF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACjC,WAAW,CACV,2EAA2E,CAC5E;KACA,QAAQ,CAAC,QAAQ,EAAE,gDAAgD,CAAC;KACpE,MAAM,CAAC,eAAe,EAAE,8BAA8B,CAAC;KACvD,MAAM,CAAC,mBAAmB,EAAE,wBAAwB,CAAC;KACrD,MAAM,CACL,uBAAuB,EACvB,8CAA8C,CAC/C;KACA,MAAM,CACL,iCAAiC,EACjC,uDAAuD,CACxD;KACA,MAAM,CAAC,gCAAgC,EAAE,iCAAiC,CAAC;KAC3E,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC;KACzC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CACL,KAAK,EACH,IAAY,EACZ,IAOC,EACD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,EACd,OAAO,CAAC;YACN,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,sBAAsB,EACpB,IAAI,CAAC,sBAAsB,KAAK,SAAS;gBACvC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;gBAChE,CAAC,CAAC,SAAS;YACf,QAAQ,EACN,IAAI,CAAC,QAAQ,KAAK,SAAS;gBACzB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAClC,CAAC,CAAC,SAAS;SAChB,CAAC,CACH,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CACF,CAAC;AAEJ,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KACxC,WAAW,CAAC,6DAA6D,CAAC;KAC1E,UAAU,CACT,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE;IAC1C,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;IACxC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;IACzC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;IAC5C,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE;IAClD,EAAE,GAAG,EAAE,sBAAsB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;IACvD,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE;IACjE,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;CACpD,CAAC,CACH;KACA,UAAU,CAAC,SAAS,CAAC;KACrB,UAAU,CAAC,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACjC,WAAW,CACV,mEAAmE,CACpE;KACA,QAAQ,CAAC,UAAU,EAAE,qDAAqD,CAAC;KAC3E,MAAM,CAAC,eAAe,EAAE,uCAAuC,CAAC;KAChE,MAAM,CAAC,eAAe,EAAE,gCAAgC,CAAC;KACzD,MAAM,CACL,mBAAmB,EACnB,mEAAmE,CACpE;KACA,MAAM,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;KACnD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CACL,KAAK,EACH,MAAc,EACd,IAKC,EACD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,EACd,OAAO,CAAC;YACN,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,WAAW,EACT,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5D,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;SAC5B,CAAC,CACH,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CACF,CAAC;AAEJ,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KACzC,WAAW,CAAC,mCAAmC,CAAC;KAChD,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;KAC9B,MAAM,CAAC,wBAAwB,EAAE,8BAA8B,CAAC;KAChE,MAAM,CAAC,sBAAsB,EAAE,qCAAqC,CAAC;KACrE,MAAM,CAAC,4BAA4B,EAAE,sBAAsB,CAAC;KAC5D,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;KAC5C,MAAM,CAAC,oBAAoB,EAAE,8CAA8C,CAAC;KAC5E,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CACL,KAAK,EACH,MAAc,EACd,IAMC,EACD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,UAAU,EACpD,OAAO,CAAC;YACN,eAAe,EAAE,WAAW,CAC1B,IAAI,CAAC,eAAe,EACpB,kBAAkB,CACnB;YACD,aAAa,EAAE,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC;YAChE,kBAAkB,EAAE,WAAW,CAC7B,IAAI,CAAC,kBAAkB,EACvB,sBAAsB,CACvB;YACD,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC;YACpD,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CACH,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,sBAAsB,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CACF,CAAC;AAEJ,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KACxC,WAAW,CAAC,0DAA0D,CAAC;KACvE,UAAU,CACT,WAAW,CACT,cAAc,EACd,2BAA2B,EAC3B;IACE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;IAC7C,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;IACzC,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE;IACjD,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE;IAC/C,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;IACrD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;IAC/C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;CACpD,EACD,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACR,GAAG,GAAG;IACN,OAAO,EAAG,GAAG,CAAC,WAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK;CAC1D,CAAC,CACH,CACF;KACA,UAAU,CAAC,SAAS,CAAC;KACrB,UAAU,CAAC,aAAa,CAAC;KACzB,UAAU,CAAC,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAElE,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KAC9B,WAAW,CAAC,wDAAwD,CAAC;KACrE,QAAQ,CAAC,QAAQ,EAAE,wCAAwC,CAAC;KAC5D,MAAM,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;KACjD,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;KAChD,MAAM,CAAC,oBAAoB,EAAE,sCAAsC,CAAC;KACpE,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC;KACzC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CACL,KAAK,EACH,IAAY,EACZ,IAKC,EACD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,WAAW,EACX,OAAO,CAAC;YACN,IAAI;YACJ,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACvD,QAAQ,EACN,IAAI,CAAC,QAAQ,KAAK,SAAS;gBACzB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;gBACvC,CAAC,CAAC,SAAS;YACf,QAAQ,EACN,IAAI,CAAC,QAAQ,KAAK,SAAS;gBACzB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAClC,CAAC,CAAC,SAAS;SAChB,CAAC,CACH,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CACF,CAAC;AAEJ,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KAClC,WAAW,CAAC,+DAA+D,CAAC;KAC5E,UAAU,CACT,WAAW,CACT,WAAW,EACX,WAAW,EACX;IACE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;IACzC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE;IAClD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE;IAClD,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE;IAC9C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;CACpD,EACD,CAAC,GAAG,EAAE,EAAE;IACN,MAAM,MAAM,GAAG,GAAG,CAAC,MAAsC,CAAC;IAC1D,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;AAC5D,CAAC,CACF,CACF;KACA,UAAU,CAAC,MAAM,CAAC;KAClB,UAAU,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC"}

package/dist/commands/api/seo-changes.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const seoChangeCommand: Command;

package/dist/commands/api/seo-changes.js

@@ -0,0 +1,101 @@
+import { Command } from "commander";
+import { api } from "../../lib/api.js";
+import { handleError, printList } from "../../lib/format.js";
+import { compact, done, nullable, qs, readJsonObject, } from "./seo-shared.js";
+const REASONS = "weak-hook | low-ctr | over-optimized | awkward-keyword | spelling | internal-links | mixed-intent | technical | other";
+const listCmd = new Command("list")
+    .description("List page changes (one page, or every page by verdict)")
+    .option("--page-id <id>", "Changes of one page")
+    .option("--verdict <verdict>", "Cross-page filter: pending | improved | no-change | worse")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const data = opts.pageId
+            ? await api.get(`/seo/pages/${opts.pageId}/changes`)
+            : await api.get(`/seo/changes${qs({ verdict: opts.verdict })}`);
+        printList(data, [
+            { key: "changedAt", label: "Changed at", width: 24 },
+            { key: "pagePath", label: "Page", width: 28 },
+            { key: "reason", label: "Reason", width: 16 },
+            { key: "verdict", label: "Verdict", width: 10 },
+            { key: "change", label: "Change", width: 40 },
+            { key: "id", label: "Id", width: 36 },
+        ], opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const addCmd = new Command("add")
+    .description("Log a change made to a page (date, reason, exactly what changed)")
+    .argument("<pageId>", "Page id")
+    .requiredOption("--reason <reason>", REASONS)
+    .requiredOption("--change <text>", "Exactly what changed")
+    .option("--changed-at <iso>", "When it changed (defaults to now)")
+    .option("--resubmitted-at <iso>", "When the URL was resubmitted for indexing")
+    .option("--json", "Output as JSON")
+    .action(async (pageId, opts) => {
+    try {
+        const data = await api.post(`/seo/pages/${pageId}/changes`, compact({
+            reason: opts.reason,
+            change: opts.change,
+            changedAt: opts.changedAt,
+            resubmittedAt: opts.resubmittedAt,
+        }));
+        done(data, opts, `Change logged (${data.id})`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const updateCmd = new Command("update")
+    .description("Correct a logged change or stamp its resubmission")
+    .argument("<pageId>", "Page id")
+    .argument("<changeId>", "Change id")
+    .option("--reason <reason>", REASONS)
+    .option("--change <text>", "Exactly what changed")
+    .option("--changed-at <iso>", "When it changed")
+    .option("--resubmitted-at <iso>", 'When the URL was resubmitted ("null" to clear)')
+    .option("--json", "Output as JSON")
+    .action(async (pageId, changeId, opts) => {
+    try {
+        const data = await api.post(`/seo/pages/${pageId}/changes/${changeId}`, compact({
+            reason: opts.reason,
+            change: opts.change,
+            changedAt: opts.changedAt,
+            resubmittedAt: nullable(opts.resubmittedAt),
+        }));
+        done(data, opts, `Change updated (${data.id})`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const verdictCmd = new Command("verdict")
+    .description("Record whether a change worked, with the windows it was judged on")
+    .argument("<pageId>", "Page id")
+    .argument("<changeId>", "Change id")
+    .argument("<verdict>", "improved | no-change | worse")
+    .option("--comparison-file <path>", "JSON {before, after}, each {from, to, clicks, impressions, ctr, position}")
+    .option("--json", "Output as JSON")
+    .action(async (pageId, changeId, verdict, opts) => {
+    try {
+        const data = await api.post(`/seo/pages/${pageId}/changes/${changeId}/verdict`, compact({
+            verdict,
+            comparison: opts.comparisonFile
+                ? readJsonObject(opts.comparisonFile)
+                : undefined,
+        }));
+        done(data, opts, `Verdict recorded: ${verdict}`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+export const seoChangeCommand = new Command("change")
+    .description("Per-page change log: what changed, why, and whether it worked")
+    .addCommand(listCmd)
+    .addCommand(addCmd)
+    .addCommand(updateCmd)
+    .addCommand(verdictCmd);
+//# sourceMappingURL=seo-changes.js.map

package/dist/commands/api/seo-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-changes.js","sourceRoot":"","sources":["../../../src/commands/api/seo-changes.ts"],"names":[],"mappings":"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"}

package/dist/commands/api/seo-data.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const seoDataCommands: Command[];

package/dist/commands/api/seo-data.js

@@ -0,0 +1,175 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { api } from "../../lib/api.js";
+import { handleError, printList } from "../../lib/format.js";
+import { done, printJson, qs, readJsonRows, } from "./seo-shared.js";
+// The API's per-request caps on bulk imports; larger files are chunked here.
+const RANKINGS_PER_REQUEST = 1000;
+const SEARCH_ANALYTICS_PER_REQUEST = 5000;
+async function importInChunks(path, rows, size) {
+    let imported = 0;
+    for (let i = 0; i < rows.length; i += size) {
+        const res = await api.post(path, {
+            rows: rows.slice(i, i + size),
+        });
+        imported += res.imported;
+    }
+    return imported;
+}
+const rankingList = new Command("list")
+    .description("List tracked positions per keyword, market, and date")
+    .option("--keyword-id <id>", "One keyword")
+    .option("--market <code>", "Market code")
+    .option("--device <device>", "desktop | mobile | tablet")
+    .option("--from <date>", "From date (YYYY-MM-DD)")
+    .option("--to <date>", "To date (YYYY-MM-DD)")
+    .option("--page <n>", "Page number (default 1)")
+    .option("--page-size <n>", "Page size (default 100, max 1000)")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const { data, meta } = await api.getWithMeta(`/seo/rankings${qs({
+            keywordId: opts.keywordId,
+            market: opts.market,
+            device: opts.device,
+            from: opts.from,
+            to: opts.to,
+            page: opts.page,
+            pageSize: opts.pageSize,
+        })}`);
+        if (opts.json) {
+            printJson({ data, meta });
+            return;
+        }
+        printList(data, [
+            { key: "date", label: "Date", width: 10 },
+            { key: "market", label: "Mkt", width: 4 },
+            { key: "keyword", label: "Keyword", width: 36 },
+            { key: "device", label: "Device", width: 7 },
+            { key: "position", label: "Pos.", width: 5 },
+            { key: "url", label: "URL", width: 48 },
+        ], opts);
+        if (meta) {
+            console.log(chalk.dim(`page ${meta.page}/${meta.totalPages}, ${meta.total} total`));
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const rankingImport = new Command("import")
+    .description("Upsert rank-tracking rows from a JSON file (safe to rerun)")
+    .requiredOption("--file <path>", "JSON array (or {rows}) of {keywordId, market, date, device?, position|null, url?}")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const rows = readJsonRows(opts.file);
+        const imported = await importInChunks("/seo/rankings", rows, RANKINGS_PER_REQUEST);
+        done({ imported }, opts, `Imported ${imported} ranking rows`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const rankingCommand = new Command("ranking")
+    .description("Weekly rank tracking per keyword and market")
+    .addCommand(rankingList)
+    .addCommand(rankingImport);
+const analyticsQuery = new Command("query")
+    .description("Aggregate Search Console data by dimensions (clicks, impressions, CTR, position)")
+    .option("--from <date>", "From date (default: start of the last 28 days)")
+    .option("--to <date>", "To date (default: latest complete day)")
+    .option("--dimensions <list>", "Comma-separated: date, path, page, query, country, device (default path)")
+    .option("--path <path>", "Only this page path")
+    .option("--query <text>", "Query contains")
+    .option("--country <code>", "Alpha-3 country (usa, fra)")
+    .option("--device <device>", "desktop | mobile | tablet")
+    .option("--row-limit <n>", "Max rows (default 1000, max 25000)")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const { data, meta } = await api.getWithMeta(`/seo/search-analytics${qs({
+            from: opts.from,
+            to: opts.to,
+            dimensions: opts.dimensions,
+            path: opts.path,
+            query: opts.query,
+            country: opts.country,
+            device: opts.device,
+            rowLimit: opts.rowLimit,
+        })}`);
+        if (opts.json) {
+            printJson({ data, meta });
+            return;
+        }
+        const dims = meta?.dimensions ?? ["path"];
+        printList(data.map((r) => ({
+            ...r,
+            ctr: `${(r.ctr * 100).toFixed(1)}%`,
+            position: r.position != null ? r.position.toFixed(1) : null,
+        })), [
+            ...dims.map((d) => ({
+                key: d,
+                label: d,
+                width: d === "query" || d === "page" ? 40 : 24,
+            })),
+            { key: "clicks", label: "Clicks", width: 7 },
+            { key: "impressions", label: "Impr.", width: 7 },
+            { key: "ctr", label: "CTR", width: 6 },
+            { key: "position", label: "Pos.", width: 5 },
+        ], opts);
+        if (meta)
+            console.log(chalk.dim(`${meta.from} to ${meta.to}`));
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const analyticsImport = new Command("import")
+    .description("Upsert Search Console rows from a JSON file (safe to rerun)")
+    .requiredOption("--file <path>", "JSON array (or {rows}) of {date, page, query, country, device, clicks, impressions, ctr, position}")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const rows = readJsonRows(opts.file);
+        const imported = await importInChunks("/seo/search-analytics", rows, SEARCH_ANALYTICS_PER_REQUEST);
+        done({ imported }, opts, `Imported ${imported} Search Console rows`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const searchAnalyticsCommand = new Command("search-analytics")
+    .description("Search Console performance at daily grain (page, query, country, device)")
+    .addCommand(analyticsQuery)
+    .addCommand(analyticsImport);
+const conversionsCommand = new Command("conversions")
+    .description("Captures, Forge sessions, and leads per landing path over a window")
+    .option("--days <n>", "Window in days ending now (default 28)")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        const { data, meta } = await api.getWithMeta(`/seo/conversions${qs({ days: opts.days })}`);
+        if (opts.json) {
+            printJson({ data, meta });
+            return;
+        }
+        printList(data, [
+            { key: "path", label: "Landing path", width: 40 },
+            { key: "captures", label: "Captures", width: 8 },
+            { key: "forgeSessions", label: "Forge", width: 6 },
+            { key: "leads", label: "Leads", width: 6 },
+        ], opts);
+        if (meta)
+            console.log(chalk.dim(`${meta.window.from} to ${meta.window.to}`));
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+export const seoDataCommands = [
+    rankingCommand,
+    searchAnalyticsCommand,
+    conversionsCommand,
+];
+//# sourceMappingURL=seo-data.js.map