npm - @jackwener/opencli - Versions diffs - 1.8.0 → 1.8.1 - Mend

@jackwener/opencli 1.8.0 → 1.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (153) hide show

package/README.md +8 -49
package/README.zh-CN.md +8 -52
package/cli-manifest.json +1796 -191
package/clis/_atlassian/shared.js +577 -0
package/clis/_atlassian/shared.test.js +170 -0
package/clis/bilibili/comment.js +125 -0
package/clis/bilibili/comment.test.js +153 -0
package/clis/bilibili/comments.js +116 -21
package/clis/bilibili/comments.test.js +77 -18
package/clis/bilibili/subtitle.js +76 -31
package/clis/bilibili/subtitle.test.js +156 -9
package/clis/bilibili/utils.js +63 -5
package/clis/bilibili/utils.test.js +45 -1
package/clis/chess/analyze.js +35 -0
package/clis/chess/analyze.test.js +79 -0
package/clis/chess/game.js +114 -0
package/clis/chess/game.test.js +178 -0
package/clis/chess/games.js +67 -0
package/clis/chess/games.test.js +164 -0
package/clis/chess/stats.js +32 -0
package/clis/chess/stats.test.js +79 -0
package/clis/chess/utils.js +170 -0
package/clis/chess/utils.test.js +230 -0
package/clis/confluence/commands.test.js +195 -0
package/clis/confluence/create.js +39 -0
package/clis/confluence/page.js +23 -0
package/clis/confluence/search.js +34 -0
package/clis/confluence/shared.js +173 -0
package/clis/confluence/update.js +38 -0
package/clis/douyin/hashtag.js +84 -23
package/clis/douyin/hashtag.test.js +113 -0
package/clis/geogebra/add-circle.js +46 -0
package/clis/geogebra/add-line.js +35 -0
package/clis/geogebra/add-point.js +27 -0
package/clis/geogebra/add-polygon.js +25 -0
package/clis/geogebra/eval.js +35 -0
package/clis/geogebra/geogebra.test.js +175 -0
package/clis/geogebra/hexagon.js +62 -0
package/clis/geogebra/info.js +72 -0
package/clis/geogebra/list.js +35 -0
package/clis/geogebra/triangle.js +60 -0
package/clis/geogebra/utils.js +271 -0
package/clis/jira/attachments.js +28 -0
package/clis/jira/commands.test.js +287 -0
package/clis/jira/comments.js +28 -0
package/clis/jira/issue.js +28 -0
package/clis/jira/links.js +28 -0
package/clis/jira/search.js +47 -0
package/clis/jira/shared.js +256 -0
package/clis/linkedin/job-detail.js +167 -0
package/clis/linkedin/job-detail.test.js +38 -0
package/clis/linkedin/jobs-preferences.js +113 -0
package/clis/linkedin/jobs-preferences.test.js +43 -0
package/clis/linkedin/post-analytics.js +74 -0
package/clis/linkedin/post-analytics.test.js +40 -0
package/clis/linkedin/posts-core.js +241 -0
package/clis/linkedin/posts.js +22 -0
package/clis/linkedin/posts.test.js +40 -0
package/clis/linkedin/profile-analytics.js +104 -0
package/clis/linkedin/profile-analytics.test.js +67 -0
package/clis/linkedin/profile-experience.js +671 -0
package/clis/linkedin/profile-experience.test.js +152 -0
package/clis/linkedin/profile-projects.js +311 -0
package/clis/linkedin/profile-projects.test.js +111 -0
package/clis/linkedin/profile-read.js +148 -0
package/clis/linkedin/profile-read.test.js +77 -0
package/clis/linkedin/services-read.js +213 -0
package/clis/linkedin/services-read.test.js +105 -0
package/clis/linkedin/shared.js +124 -0
package/clis/linkedin/timeline.js +14 -7
package/clis/notebooklm/add-source.js +269 -0
package/clis/notebooklm/add-source.test.js +97 -0
package/clis/notebooklm/create.js +76 -0
package/clis/notebooklm/create.test.js +58 -0
package/clis/notebooklm/generate-audio.js +91 -0
package/clis/notebooklm/generate-audio.test.js +63 -0
package/clis/notebooklm/generate-slides.js +106 -0
package/clis/notebooklm/generate-slides.test.js +75 -0
package/clis/notebooklm/open.test.js +10 -10
package/clis/notebooklm/rpc.js +20 -6
package/clis/notebooklm/rpc.test.js +27 -1
package/clis/notebooklm/utils.js +100 -24
package/clis/notebooklm/utils.test.js +60 -1
package/clis/notebooklm/write-note.js +103 -0
package/clis/notebooklm/write-note.test.js +70 -0
package/clis/pixiv/detail.js +41 -34
package/clis/pixiv/detail.test.js +93 -0
package/clis/pixiv/user.js +36 -31
package/clis/pixiv/user.test.js +100 -0
package/clis/pixiv/utils.js +56 -7
package/clis/suno/generate.js +5 -0
package/clis/suno/generate.test.js +9 -0
package/clis/suno/status.js +3 -2
package/clis/suno/utils.js +33 -24
package/clis/suno/utils.test.js +106 -0
package/clis/twitter/followers.js +6 -2
package/clis/twitter/followers.test.js +19 -1
package/clis/twitter/following.js +14 -5
package/clis/twitter/following.test.js +29 -0
package/clis/twitter/likes.js +12 -4
package/clis/twitter/likes.test.js +26 -1
package/clis/twitter/list-add.js +1 -1
package/clis/twitter/list-remove.js +1 -1
package/clis/twitter/notifications.js +4 -4
package/clis/twitter/post.js +62 -4
package/clis/twitter/post.test.js +35 -3
package/clis/twitter/profile.js +81 -28
package/clis/twitter/profile.test.js +113 -2
package/clis/twitter/quote.js +9 -4
package/clis/twitter/reply.js +13 -10
package/clis/twitter/reply.test.js +41 -0
package/clis/twitter/search.js +1 -1
package/clis/twitter/search.test.js +35 -0
package/clis/twitter/shared.js +11 -0
package/clis/twitter/shared.test.js +37 -1
package/clis/twitter/utils.js +53 -16
package/clis/upwork/detail.js +132 -0
package/clis/upwork/feed.js +109 -0
package/clis/upwork/search.js +115 -0
package/clis/upwork/upwork.test.js +566 -0
package/clis/upwork/utils.js +323 -0
package/clis/weread/book-search.js +438 -0
package/clis/weread/book-search.test.js +242 -0
package/clis/weread/search-regression.test.js +80 -0
package/clis/weread/search.js +17 -2
package/clis/xiaohongshu/creator-note-detail.js +165 -28
package/clis/xiaohongshu/creator-note-detail.test.js +186 -37
package/clis/xiaohongshu/creator-notes.js +251 -2
package/clis/xiaohongshu/creator-notes.test.js +79 -2
package/clis/xiaohongshu/download.js +97 -39
package/clis/xiaohongshu/download.test.js +201 -0
package/clis/zhihu/answer-comments.js +2 -21
package/clis/zhihu/answer-detail.js +2 -31
package/clis/zhihu/collection.js +2 -14
package/clis/zhihu/collection.test.js +4 -3
package/clis/zhihu/question.js +1 -9
package/clis/zhihu/question.test.js +2 -2
package/clis/zhihu/search.js +1 -12
package/clis/zhihu/search.test.js +2 -2
package/clis/zhihu/text.js +29 -0
package/clis/zhihu/text.test.js +24 -0
package/dist/src/browser/network-cache.js +13 -1
package/dist/src/browser/network-cache.test.js +17 -0
package/dist/src/download/index.js +13 -1
package/dist/src/download/index.test.js +23 -1
package/dist/src/download/media-download.test.js +3 -1
package/dist/src/download/progress.js +2 -2
package/dist/src/download/progress.test.js +12 -1
package/dist/src/output.js +11 -1
package/dist/src/output.test.js +6 -0
package/dist/src/registry.js +1 -0
package/dist/src/registry.test.js +11 -0
package/package.json +1 -1

package/clis/twitter/reply.js CHANGED Viewed

@@ -90,19 +90,22 @@ async function insertReplyText(page, text) {
 }
 async function clickReplyButton(page) {
-    return page.evaluate(`(() => {
+    const iterations = Math.ceil(SUBMIT_TIMEOUT_MS / SUBMIT_POLL_MS);
+    return page.evaluate(`(async () => {
       try {
           const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
-          const buttons = Array.from(
-              document.querySelectorAll('[data-testid="tweetButton"], [data-testid="tweetButtonInline"]')
-          );
-          const btn = buttons.find((el) => visible(el) && !el.disabled && el.getAttribute('aria-disabled') !== 'true');
-          if (!btn) {
-              return { ok: false, message: 'Reply button is disabled or not found.' };
+          for (let i = 0; i < ${JSON.stringify(iterations)}; i++) {
+              const buttons = Array.from(
+                  document.querySelectorAll('[data-testid="tweetButton"], [data-testid="tweetButtonInline"]')
+              );
+              const btn = buttons.find((el) => visible(el) && !el.disabled && el.getAttribute('aria-disabled') !== 'true');
+              if (btn) {
+                  btn.click();
+                  return { ok: true };
+              }
+              await new Promise(r => setTimeout(r, ${JSON.stringify(SUBMIT_POLL_MS)}));
           }
-          btn.click();
-          return { ok: true };
+          return { ok: false, message: 'Reply button is disabled or not found.' };
       } catch (e) {
           return { ok: false, message: e.toString() };
       }

package/clis/twitter/reply.test.js CHANGED Viewed

@@ -1,6 +1,7 @@
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
+import { JSDOM } from 'jsdom';
 import { describe, expect, it, vi } from 'vitest';
 import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
 import { getRegistry } from '@jackwener/opencli/registry';
@@ -193,4 +194,44 @@ describe('twitter image helpers (utils.js)', () => {
         expect(utilsTest.resolveImageExtension('https://example.com/no-ext', 'image/webp')).toBe('.webp');
         expect(utilsTest.resolveImageExtension('https://example.com/a.jpeg?x=1', null)).toBe('.jpeg');
     });
+    it('classifies CDP NotAllowed file-input failures as recoverable', () => {
+        expect(utilsTest.isRecoverableFileInputError(new Error('NotAllowedError: Not allowed'))).toBe(true);
+        expect(utilsTest.isRecoverableFileInputError(new Error('ProtocolError: not-allowed'))).toBe(true);
+        expect(utilsTest.isRecoverableFileInputError(new Error('Permission denied'))).toBe(false);
+    });
+    it('fails closed when a composer image preview never appears', async () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-twitter-helper-'));
+        const imagePath = path.join(tempDir, 'missing-preview.png');
+        fs.writeFileSync(imagePath, Buffer.from([0x89, 0x50, 0x4e, 0x47]));
+        const page = createPageMock([{ ok: false, message: 'Image upload timed out (30s).' }], {
+            setFileInput: vi.fn().mockResolvedValue(undefined),
+        });
+        await expect(utilsTest.attachComposerImage(page, imagePath)).rejects.toThrow('Image upload timed out');
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('does not treat an empty attachments container as uploaded media', async () => {
+        const runMediaReadyProbe = async (html) => {
+            const dom = new JSDOM(`<!doctype html><body>${html}</body>`, {
+                url: 'https://x.com/compose/post',
+                runScripts: 'outside-only',
+            });
+            dom.window.setTimeout = (callback) => {
+                callback();
+                return 0;
+            };
+            const page = {
+                evaluate: vi.fn(async (script) => dom.window.eval(script)),
+            };
+            return utilsTest.waitForComposerMediaReady(page, 1);
+        };
+        await expect(runMediaReadyProbe('<div data-testid="attachments"></div>'))
+            .resolves.toMatchObject({ ok: false });
+        await expect(runMediaReadyProbe('<div data-testid="attachments"><img src="blob:https://x.com/1"></div>'))
+            .resolves.toMatchObject({ ok: true, previewCount: 1 });
+    });
 });

package/clis/twitter/search.js CHANGED Viewed

@@ -215,7 +215,7 @@ function tweetToRow(result, seen) {
     const bio = tweetUser?.legacy?.description || '';
     return {
         id: tweet.rest_id,
-        author: tweetUser?.core?.screen_name || tweetUser?.legacy?.screen_name || 'unknown',
+        author: tweetUser?.core?.screen_name || tweetUser?.legacy?.screen_name || '',
         bio,
         text: tweet.note_tweet?.note_tweet_results?.result?.text || tweet.legacy?.full_text || '',
         created_at: tweet.legacy?.created_at || '',

package/clis/twitter/search.test.js CHANGED Viewed

@@ -154,6 +154,40 @@ describe('twitter search command', () => {
         expect(result.map((row) => row.id)).toEqual(['1', '2', '3', '4', '5', '6', '7']);
         expect(page.evaluate).toHaveBeenCalledTimes(8);
     });
+    it('surfaces empty author when the tweet has no user screen_name', () => {
+        const payload = {
+            data: {
+                search_by_raw_query: {
+                    search_timeline: {
+                        timeline: {
+                            instructions: [{
+                                type: 'TimelineAddEntries',
+                                entries: [{
+                                    entryId: 'tweet-2',
+                                    content: {
+                                        itemContent: {
+                                            tweet_results: {
+                                                result: {
+                                                    rest_id: '2',
+                                                    legacy: { full_text: 'no author here', favorite_count: 0, created_at: '' },
+                                                    core: { user_results: { result: {} } },
+                                                },
+                                            },
+                                        },
+                                    },
+                                }],
+                            }],
+                        },
+                    },
+                },
+            },
+        };
+        const { rows } = parseSearchTimeline(payload, new Set());
+        expect(rows).toHaveLength(1);
+        expect(rows[0].author).toBe('');
+        expect(rows[0].id).toBe('2');
+    });
 });
 describe('twitter search filter helpers', () => {
@@ -346,4 +380,5 @@ describe('twitter search end-to-end with new filters', () => {
         const searchFetch = evaluate.mock.calls[1][0];
         expect(searchFetch).toContain('\\"rawQuery\\":\\"from:alice\\"');
     });
 });

package/clis/twitter/shared.js CHANGED Viewed

@@ -155,6 +155,16 @@ export function unwrapBrowserResult(value) {
     return value;
 }
+function isEmptyObject(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === 0;
+}
+export function looksLikePrivateTwitterTimeline(data) {
+    const result = data?.data?.user?.result;
+    if (!result || typeof result !== 'object') return false;
+    return Boolean(isEmptyObject(result.timeline) || isEmptyObject(result.timeline_v2?.timeline));
+}
 export function normalizeTwitterGraphqlPayload(value) {
     const unwrapped = unwrapBrowserResult(value);
     if (unwrapped?.data && typeof unwrapped.data === 'object') return unwrapped;
@@ -441,4 +451,5 @@ export const __test__ = {
     extractQuotedTweet,
     parseTweetUrl,
     buildTwitterArticleScopeSource,
+    looksLikePrivateTwitterTimeline,
 };

package/clis/twitter/shared.test.js CHANGED Viewed

@@ -3,7 +3,7 @@ import { JSDOM } from 'jsdom';
 import { __test__ } from './shared.js';
 import { ArgumentError } from '@jackwener/opencli/errors';
-const { extractMedia, extractCard, extractQuotedTweet, parseTweetUrl, buildTwitterArticleScopeSource, unwrapBrowserResult, normalizeTwitterGraphqlPayload, normalizeTwitterScreenName, sanitizeTwitterOperationMetadata } = __test__;
+const { extractMedia, extractCard, extractQuotedTweet, parseTweetUrl, buildTwitterArticleScopeSource, unwrapBrowserResult, normalizeTwitterGraphqlPayload, normalizeTwitterScreenName, sanitizeTwitterOperationMetadata, looksLikePrivateTwitterTimeline } = __test__;
 function makeCardTweet({ name, bindings, expandedUrl, urls }) {
     const tweet = {
@@ -756,3 +756,39 @@ describe('twitter extractQuotedTweet', () => {
         expect(q).not.toHaveProperty('quoted_tweet');
     });
 });
+describe('looksLikePrivateTwitterTimeline', () => {
+    it('returns true when result.timeline is an empty object', () => {
+        expect(looksLikePrivateTwitterTimeline({
+            data: { user: { result: { __typename: 'User', timeline: {} } } },
+        })).toBe(true);
+    });
+    it('returns false when timeline.timeline.instructions is present', () => {
+        expect(looksLikePrivateTwitterTimeline({
+            data: { user: { result: { timeline: { timeline: { instructions: [] } } } } },
+        })).toBe(false);
+    });
+    it('returns false when timeline_v2.timeline.instructions is present', () => {
+        expect(looksLikePrivateTwitterTimeline({
+            data: { user: { result: { timeline_v2: { timeline: { instructions: [] } } } } },
+        })).toBe(false);
+    });
+    it('returns false when result is missing entirely', () => {
+        expect(looksLikePrivateTwitterTimeline({})).toBe(false);
+        expect(looksLikePrivateTwitterTimeline(null)).toBe(false);
+        expect(looksLikePrivateTwitterTimeline({ data: { user: {} } })).toBe(false);
+    });
+    it('returns false for non-empty malformed timeline objects', () => {
+        expect(looksLikePrivateTwitterTimeline({
+            data: { user: { result: { timeline: { unexpected: true } } } },
+        })).toBe(false);
+        expect(looksLikePrivateTwitterTimeline({
+            data: { user: { result: { timeline: { timeline: {} } } } },
+        })).toBe(false);
+    });
+    it('returns true when timeline_v2.timeline is an empty object', () => {
+        expect(looksLikePrivateTwitterTimeline({
+            data: { user: { result: { timeline_v2: { timeline: {} } } } },
+        })).toBe(true);
+    });
+});

package/clis/twitter/utils.js CHANGED Viewed

@@ -19,6 +19,8 @@ export const SUPPORTED_IMAGE_EXTENSIONS = new Set(['.jpg', '.jpeg', '.png', '.gi
 /** 20 MB hard cap. Twitter allows ~5MB images / 15MB GIFs; 20MB is a safety net. */
 export const MAX_IMAGE_SIZE_BYTES = 20 * 1024 * 1024;
+const MEDIA_UPLOAD_POLL_MS = 500;
+const MEDIA_UPLOAD_TIMEOUT_MS = 30_000;
 const CONTENT_TYPE_TO_EXTENSION = {
     'image/jpeg': '.jpg',
@@ -133,7 +135,7 @@ export async function attachComposerImage(page, absImagePath, fileInputSelector
             uploaded = true;
         } catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            if (!msg.includes('Unknown action') && !msg.includes('not supported')) {
+            if (!isRecoverableFileInputError(msg)) {
                 throw new Error(`Image upload failed: ${msg}`);
             }
             // setFileInput not supported by extension — fall through to base64 fallback.
@@ -167,7 +169,21 @@ export async function attachComposerImage(page, absImagePath, fileInputSelector
         const blob = new Blob([bytes], { type: ${JSON.stringify(mimeType)} });
         dt.items.add(new File([blob], ${JSON.stringify(path.basename(absImagePath))}, { type: ${JSON.stringify(mimeType)} }));
-        Object.defineProperty(input, 'files', { value: dt.files, writable: false });
+        let assigned = false;
+        try {
+          Object.defineProperty(input, 'files', { value: dt.files, writable: false, configurable: true });
+          assigned = input.files && input.files.length > 0;
+        } catch(e) {
+          // files property not redefinable — use nativeInputValueSetter trick
+          try {
+            const nativeInputFileSetter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'files');
+            if (nativeInputFileSetter && nativeInputFileSetter.set) {
+              nativeInputFileSetter.set.call(input, dt.files);
+              assigned = input.files && input.files.length > 0;
+            }
+          } catch(e2) { /* ignore */ }
+        }
+        if (!assigned) return { ok: false, error: 'Could not assign files to input' };
         input.dispatchEvent(new Event('change', { bubbles: true }));
         input.dispatchEvent(new Event('input', { bubbles: true }));
         return { ok: true };
@@ -177,23 +193,42 @@ export async function attachComposerImage(page, absImagePath, fileInputSelector
             throw new Error(`Image upload failed: ${upload?.error ?? 'unknown error'}`);
         }
     }
-    await page.wait(2);
-    const uploadState = await page.evaluate(`
-    (() => {
-      const previewCount = document.querySelectorAll(
-        '[data-testid="attachments"] img, [data-testid="attachments"] video, [data-testid="tweetPhoto"]'
-      ).length;
-      const hasMedia = previewCount > 0
-        || !!document.querySelector('[data-testid="attachments"]')
-        || !!Array.from(document.querySelectorAll('button,[role="button"]')).find((el) =>
-          /remove media|remove image|remove/i.test((el.getAttribute('aria-label') || '') + ' ' + (el.textContent || ''))
+    const uploadState = await waitForComposerMediaReady(page, 1);
+    if (!uploadState?.ok) {
+        throw new Error(uploadState?.message ?? 'Image upload failed: preview did not appear.');
+    }
+}
+export function isRecoverableFileInputError(error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return /unknown action|not supported|not[-\s]?allowed|notallowederror/i.test(msg);
+}
+export async function waitForComposerMediaReady(page, expectedCount = 1) {
+    const iterations = Math.ceil(MEDIA_UPLOAD_TIMEOUT_MS / MEDIA_UPLOAD_POLL_MS);
+    return page.evaluate(`
+    (async () => {
+      const expected = ${JSON.stringify(expectedCount)};
+      for (let i = 0; i < ${JSON.stringify(iterations)}; i++) {
+        await new Promise(r => setTimeout(r, ${JSON.stringify(MEDIA_UPLOAD_POLL_MS)}));
+        const previewCount = document.querySelectorAll(
+          '[data-testid="attachments"] img, [data-testid="attachments"] video, [data-testid="attachments"] [role="group"], [data-testid="tweetPhoto"]'
+        ).length;
+        const blobCount = document.querySelectorAll('img[src^="blob:"], video[src^="blob:"]').length;
+        const removeButtonCount = Array.from(document.querySelectorAll('button,[role="button"]')).filter((el) =>
+          /remove media|remove image|remove|编辑/i.test((el.getAttribute('aria-label') || '') + ' ' + (el.textContent || ''))
+        ).length;
+        const explicitPreviewCount = Math.max(
+          previewCount,
+          blobCount,
+          removeButtonCount,
+          document.querySelectorAll('[data-testid="media-upload-preview"], [data-testid="card.layoutLarge.media"]').length
         );
-      return { ok: hasMedia, previewCount };
+        if (explicitPreviewCount >= expected) return { ok: true, previewCount: explicitPreviewCount };
+      }
+      return { ok: false, message: 'Image upload timed out (${MEDIA_UPLOAD_TIMEOUT_MS / 1000}s).' };
     })()
   `);
-    if (!uploadState?.ok) {
-        throw new Error('Image upload failed: preview did not appear.');
-    }
 }
 // ── Engagement scoring (P3) ────────────────────────────────────────────
@@ -280,6 +315,8 @@ export const __test__ = {
     resolveImageExtension,
     downloadRemoteImage,
     attachComposerImage,
+    isRecoverableFileInputError,
+    waitForComposerMediaReady,
     computeEngagementScore,
     applyTopByEngagement,
     ENGAGEMENT_WEIGHTS,

package/clis/upwork/detail.js ADDED Viewed

@@ -0,0 +1,132 @@
+/**
+ * Upwork job detail.
+ *
+ * Reads the full job posting (title, description, budget, experience
+ * level, workload, client stats, applicant count) for a given
+ * ciphertext id (the `~02…` form surfaced by `upwork search` /
+ * `upwork feed`). Unlike search/feed, the job-detail page does not
+ * populate `window.__NUXT__.state` for the job — it rehydrates into
+ * the Vuex store at `window.$nuxt.$store.state.jobDetails.{job, buyer,
+ * applicants, …}`. We read straight from that store.
+ */
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import {
+    CommandExecutionError,
+    EmptyResultError,
+    AuthRequiredError,
+} from '@jackwener/opencli/errors';
+import {
+    DETAIL_COLUMNS,
+    buildJobUrl,
+    decodeExperienceLevel,
+    decodeWorkload,
+    formatBudgetFromDetail,
+    formatSkills,
+    isPlainObject,
+    jobType,
+    requireCiphertext,
+    stripHighlight,
+    unwrapBrowserResult,
+} from './utils.js';
+cli({
+    site: 'upwork',
+    name: 'detail',
+    aliases: ['job', 'view'],
+    access: 'read',
+    description: 'Read the full Upwork job posting by ciphertext id (e.g. ~022054964136512093518)',
+    domain: 'www.upwork.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        { name: 'id', positional: true, required: true, help: 'Job ciphertext id (~01… / ~02…) or full /jobs/~02… URL' },
+    ],
+    columns: DETAIL_COLUMNS,
+    func: async (page, kwargs) => {
+        const id = requireCiphertext(kwargs.id);
+        const url = buildJobUrl(id);
+        await page.goto(url);
+        await page.wait(5);
+        let payload;
+        try {
+            payload = unwrapBrowserResult(await page.evaluate(`(async () => {
+                const haveStore = () => !!(window.$nuxt && window.$nuxt.$store && window.$nuxt.$store.state && window.$nuxt.$store.state.jobDetails && window.$nuxt.$store.state.jobDetails.job);
+                let ready = haveStore();
+                for (let i = 0; i < 30; i++) {
+                    if (ready) break;
+                    await new Promise(r => setTimeout(r, 500));
+                    ready = haveStore();
+                }
+                const onLogin = /\\/(ab\\/account-security\\/login|nx\\/login)/.test(location.pathname);
+                const challenge = (document.title || '').toLowerCase().includes('just a moment') || !!document.querySelector('[id^="cf-"]');
+                if (!ready) {
+                    return { ready, onLogin, challenge, job: null, buyer: null };
+                }
+                const s = window.$nuxt.$store.state.jobDetails;
+                return {
+                    ready,
+                    onLogin,
+                    challenge,
+                    job: s.job ? JSON.parse(JSON.stringify(s.job)) : null,
+                    buyer: s.buyer ? JSON.parse(JSON.stringify(s.buyer)) : null,
+                };
+            })()`));
+        }
+        catch (e) {
+            throw new CommandExecutionError(`Failed to read Upwork job-detail store: ${e?.message ?? e}`, 'The Vuex store was not reachable; try again after opening Upwork in the connected browser.');
+        }
+        if (payload?.onLogin) {
+            throw new AuthRequiredError('upwork.com', 'Upwork redirected to login. Open https://www.upwork.com in the connected browser and sign in, then retry.');
+        }
+        if (payload?.challenge) {
+            throw new CommandExecutionError('Upwork served a Cloudflare challenge page', 'Open https://www.upwork.com in the connected browser and clear the challenge, then retry.');
+        }
+        if (!isPlainObject(payload)) {
+            throw new CommandExecutionError('Upwork detail returned an unexpected Browser Bridge payload shape');
+        }
+        if (!payload?.ready || !payload.job) {
+            throw new EmptyResultError('upwork detail', `No Upwork job posting found for id "${id}" (may be closed, expired, or private)`);
+        }
+        if (!isPlainObject(payload.job)) {
+            throw new CommandExecutionError('Upwork job-detail store had an unexpected job shape; expected an object.');
+        }
+        const job = payload.job;
+        const returnedCiphertext = String(job?.ciphertext ?? '').trim();
+        if (returnedCiphertext && returnedCiphertext !== id) {
+            throw new CommandExecutionError(`Upwork job-detail store returned ciphertext "${returnedCiphertext}" while reading "${id}".`);
+        }
+        const buyer = payload.buyer || {};
+        const stats = buyer?.stats || {};
+        const location = buyer?.location || {};
+        const category = job?.category?.name || '';
+        const skills = formatSkills(job);
+        const totalSpent = Number(stats?.totalCharges?.amount);
+        const totalHires = Number(stats?.totalJobsWithHires);
+        const score = Number(stats?.score);
+        const totalApplicants = Number(job?.clientActivity?.totalApplicants);
+        return [{
+            id,
+            title: stripHighlight(job?.title),
+            type: jobType(job?.type),
+            budget: formatBudgetFromDetail(job),
+            experienceLevel: decodeExperienceLevel(job?.contractorTier),
+            workload: decodeWorkload(job?.workload),
+            category,
+            skills,
+            description: String(job?.description ?? '').trim(),
+            clientCountry: location?.country || '',
+            clientSpent: Number.isFinite(totalSpent) && totalSpent > 0 ? totalSpent : null,
+            clientHires: Number.isFinite(totalHires) ? totalHires : null,
+            clientRating: Number.isFinite(score) && score > 0 ? score : null,
+            proposalsCount: Number.isFinite(totalApplicants) ? totalApplicants : null,
+            publishedOn: job?.publishTime || job?.postedOn || job?.createdOn || '',
+            url,
+        }];
+    },
+});

package/clis/upwork/feed.js ADDED Viewed

@@ -0,0 +1,109 @@
+/**
+ * Upwork personalized feed (Best Matches / Most Recent).
+ *
+ * Reads the logged-in user's recommended-jobs feed. Two tabs are
+ * supported: `best-matches` (default, Upwork's relevance-ranked feed)
+ * and `most-recent` (chronological). Both surface the full job list in
+ * `window.__NUXT__.state.feed{BestMatch,MostRecent}.{jobs, paging}`.
+ *
+ * Login is required — bare visitors get redirected through the
+ * onboarding flow and never see the feed state.
+ */
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import {
+    CommandExecutionError,
+    EmptyResultError,
+    AuthRequiredError,
+} from '@jackwener/opencli/errors';
+import {
+    buildFeedUrl,
+    feedStateKey,
+    isPlainObject,
+    jobsToListRows,
+    LIST_COLUMNS,
+    requireBoundedInt,
+    requireFeedTab,
+    unwrapBrowserResult,
+} from './utils.js';
+cli({
+    site: 'upwork',
+    name: 'feed',
+    aliases: ['best-matches'],
+    access: 'read',
+    description: 'Upwork personalized jobs feed (best-matches | most-recent) — requires login',
+    domain: 'www.upwork.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        { name: 'tab', positional: true, required: false, default: 'best-matches', help: 'Feed tab: best-matches | most-recent' },
+        { name: 'limit', type: 'int', default: 20, help: 'Max rows to return (1-50, capped at one page)' },
+    ],
+    columns: LIST_COLUMNS,
+    func: async (page, kwargs) => {
+        const tab = requireFeedTab(kwargs.tab);
+        const limit = requireBoundedInt(kwargs.limit, 20, 1, 50, 'limit');
+        const stateKey = feedStateKey(tab);
+        const url = buildFeedUrl(tab);
+        await page.goto(url);
+        await page.wait(5);
+        let payload;
+        try {
+            payload = unwrapBrowserResult(await page.evaluate(`(async () => {
+                const key = ${JSON.stringify(stateKey)};
+                const haveState = () => !!(window.__NUXT__ && window.__NUXT__.state && window.__NUXT__.state[key]);
+                let ready = haveState();
+                for (let i = 0; i < 30; i++) {
+                    if (ready) break;
+                    await new Promise(r => setTimeout(r, 500));
+                    ready = haveState();
+                }
+                const onLogin = /\\/(ab\\/account-security\\/login|nx\\/login)/.test(location.pathname);
+                const challenge = (document.title || '').toLowerCase().includes('just a moment') || !!document.querySelector('[id^="cf-"]');
+                const state = window.__NUXT__ && window.__NUXT__.state && window.__NUXT__.state[key];
+                return {
+                    ready,
+                    onLogin,
+                    challenge,
+                    jobsPresent: !!(state && Object.prototype.hasOwnProperty.call(state, 'jobs')),
+                    jobs: state ? state.jobs : undefined,
+                    paging: state && state.paging ? state.paging : null,
+                };
+            })()`));
+        }
+        catch (e) {
+            throw new CommandExecutionError(`Failed to read Upwork feed state: ${e?.message ?? e}`, 'The Nuxt state global was not reachable; try again after opening Upwork in the connected browser.');
+        }
+        if (payload?.onLogin) {
+            throw new AuthRequiredError('upwork.com', 'Upwork redirected to login. Open https://www.upwork.com in the connected browser and sign in, then retry.');
+        }
+        if (payload?.challenge) {
+            throw new CommandExecutionError('Upwork served a Cloudflare challenge page', 'Open https://www.upwork.com in the connected browser and clear the challenge, then retry.');
+        }
+        if (!payload?.ready) {
+            throw new CommandExecutionError(`Upwork feed state (window.__NUXT__.state.${stateKey}) was not present within 15s`, 'The page may not have finished hydrating, or the SSR state shape may have changed.');
+        }
+        if (!isPlainObject(payload)) {
+            throw new CommandExecutionError('Upwork feed returned an unexpected Browser Bridge payload shape');
+        }
+        if (!payload.jobsPresent || !Array.isArray(payload.jobs)) {
+            throw new CommandExecutionError(`Upwork feed state had an unexpected jobs shape; expected window.__NUXT__.state.${stateKey}.jobs to be an array.`);
+        }
+        const jobs = payload.jobs;
+        if (jobs.length === 0) {
+            throw new EmptyResultError(`upwork feed ${tab}`, `Upwork ${tab} feed is empty for the current account`);
+        }
+        const rows = jobsToListRows(jobs, { limit });
+        if (rows.length === 0) {
+            throw new CommandExecutionError('Upwork feed results did not include any job with a valid ciphertext id; cannot produce round-trippable detail rows.');
+        }
+        return rows;
+    },
+});