publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/instagram/user.js

@@ -1,476 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-const INSTAGRAM_APP_ID = '936619743392459';
-const DEFAULT_LIMIT = 12;
-const MAX_LIMIT = 1000;
-const BATCH_LIMIT = 50;
-const USER_HOME = 'https://www.instagram.com';
-const DEFAULT_CAPTION_FILTER_MODE = 'contains';
-const CAPTION_FILTER_MODES = ['contains', 'regex'];
-const DAY_RE = /^\d{4}-\d{2}-\d{2}$/;
-const UNIX_SECONDS_RE = /^\d{10}$/;
-const UNIX_MILLISECONDS_RE = /^\d{13}$/;
-function requirePositiveBoundedInt(value, options) {
-    const { defaultValue, max, label } = options;
-    const normalized = value === undefined ? defaultValue : Number(value);
-    if (!Number.isInteger(normalized) || normalized <= 0) {
-        throw new ArgumentError(`${label} must be a positive integer`);
-    }
-    if (normalized > max) {
-        throw new ArgumentError(`${label} must be <= ${max}`);
-    }
-    return normalized;
-}
-function normalizeShortcode(item) {
-    return String(item?.code || '').trim();
-}
-function normalizeCaptionText(raw) {
-    return String(raw || '').replace(/\s+/g, ' ').trim();
-}
-function normalizeCaptionFilterMode(value) {
-    const mode = String(value || DEFAULT_CAPTION_FILTER_MODE).trim().toLowerCase();
-    if (!CAPTION_FILTER_MODES.includes(mode)) {
-        throw new ArgumentError(`Invalid caption-filter-mode: ${value}. Supported values: contains, regex`);
-    }
-    return mode;
-}
-function compileCaptionMatcher(pattern, options) {
-    const { mode, caseSensitive, label } = options;
-    const normalized = normalizeCaptionText(pattern);
-    if (!normalized) {
-        return null;
-    }
-    if (mode === 'regex') {
-        const flags = caseSensitive ? '' : 'i';
-        try {
-            const re = new RegExp(normalized, flags);
-            return (caption) => re.test(normalizeCaptionText(caption));
-        }
-        catch (error) {
-            throw new ArgumentError(`Invalid ${label} regular expression: ${error?.message || error}`);
-        }
-    }
-    const needle = caseSensitive ? normalized : normalized.toLowerCase();
-    return (caption) => {
-        const text = normalizeCaptionText(caption);
-        return caseSensitive ? text.includes(needle) : text.toLowerCase().includes(needle);
-    };
-}
-function makeCaptionFilter(kwargs) {
-    const filterMode = normalizeCaptionFilterMode(kwargs['caption-filter-mode']);
-    const includePattern = normalizeCaptionText(kwargs['caption-filter'] || kwargs.captionFilter);
-    const rejectPattern = normalizeCaptionText(kwargs['caption-reject'] || kwargs.captionReject);
-    const caseSensitive = kwargs['caption-case-sensitive'] === true || kwargs.captionCaseSensitive === true;
-    if (filterMode === 'regex' && !includePattern && !rejectPattern) {
-        return null;
-    }
-    if (!includePattern && !rejectPattern) {
-        return null;
-    }
-    const includeMatcher = includePattern
-        ? compileCaptionMatcher(includePattern, { mode: filterMode, caseSensitive, label: 'caption-filter' })
-        : null;
-    const rejectMatcher = rejectPattern
-        ? compileCaptionMatcher(rejectPattern, { mode: filterMode, caseSensitive, label: 'caption-reject' })
-        : null;
-    return {
-        test(raw) {
-            const caption = normalizeCaptionText(raw);
-            if (rejectMatcher && rejectMatcher(caption)) {
-                return false;
-            }
-            if (!includeMatcher) {
-                return true;
-            }
-            return includeMatcher(caption);
-        },
-    };
-}
-function normalizeMediaType(item) {
-    if (item?.media_type === 1) {
-        return 'photo';
-    }
-    if (item?.media_type === 2) {
-        return 'video';
-    }
-    return 'carousel';
-}
-function resolvePostKind(item) {
-    const kind = String(item?.product_type || '').toLowerCase();
-    if (kind === 'clips' || kind === 'reel') {
-        return 'reel';
-    }
-    if (item?.is_reel_media) {
-        return 'reel';
-    }
-    return 'p';
-}
-function formatInstagramDate(timestamp) {
-    const seconds = Number(timestamp || 0);
-    return Number.isFinite(seconds) && seconds > 0
-        ? new Date(seconds * 1000).toLocaleDateString()
-        : '';
-}
-function formatInstagramPostedAt(timestamp) {
-    const seconds = Number(timestamp || 0);
-    return Number.isFinite(seconds) && seconds > 0
-        ? new Date(seconds * 1000).toISOString()
-        : '';
-}
-function buildInstagramPostUrl(shortcode, kind = 'p') {
-    return shortcode ? `${USER_HOME}/${kind}/${shortcode}/` : '';
-}
-function parseDayBounds(value, options = {}) {
-    const label = options.label || 'date';
-    const normalized = String(value || '').trim();
-    if (!DAY_RE.test(normalized)) {
-        throw new ArgumentError(`Invalid --${label}: ${JSON.stringify(value)}. Use YYYY-MM-DD.`);
-    }
-    const startMs = new Date(`${normalized}T00:00:00`).getTime();
-    const endMs = new Date(`${normalized}T23:59:59.999`).getTime();
-    if (!Number.isFinite(startMs) || !Number.isFinite(endMs)) {
-        throw new ArgumentError(`Invalid --${label}: ${JSON.stringify(value)}. Use YYYY-MM-DD.`);
-    }
-    return {
-        startSec: Math.floor(startMs / 1000),
-        endSec: Math.floor(endMs / 1000),
-    };
-}
-function parseTimestampArg(value, options = {}) {
-    const label = options.label || 'from';
-    const normalized = String(value || '').trim();
-    if (!normalized) {
-        throw new ArgumentError(`Missing --${label} timestamp`);
-    }
-    if (UNIX_SECONDS_RE.test(normalized)) {
-        return Number(normalized);
-    }
-    if (UNIX_MILLISECONDS_RE.test(normalized)) {
-        return Math.floor(Number(normalized) / 1000);
-    }
-    const ms = new Date(normalized).getTime();
-    if (!Number.isFinite(ms)) {
-        throw new ArgumentError(`Invalid --${label}: ${JSON.stringify(value)}. Use ISO 8601 like 2026-07-11T18:30:00+05:30 or Unix seconds.`);
-    }
-    return Math.floor(ms / 1000);
-}
-function resolveTimeWindow(kwargs) {
-    const dateArg = String(kwargs.date || '').trim();
-    const fromArg = String(kwargs.from || '').trim();
-    const toArg = String(kwargs.to || '').trim();
-    if (dateArg && (fromArg || toArg)) {
-        throw new ArgumentError('Cannot combine --date with --from/--to. Use --date YYYY-MM-DD for a whole day, or --from/--to for an exact time range.');
-    }
-    if (toArg && !fromArg) {
-        throw new ArgumentError('Using --to requires --from.');
-    }
-    if (dateArg) {
-        return parseDayBounds(dateArg, { label: 'date' });
-    }
-    if (!fromArg && !toArg) {
-        return null;
-    }
-    const startSec = parseTimestampArg(fromArg, { label: 'from' });
-    const endSec = toArg ? parseTimestampArg(toArg, { label: 'to' }) : Number.POSITIVE_INFINITY;
-    if (endSec < startSec) {
-        throw new ArgumentError('--from must be earlier than or equal to --to.');
-    }
-    return { startSec, endSec };
-}
-async function fetchInstagramJson(page, url) {
-    try {
-        const response = await page.evaluate(async (requestUrl, appId) => {
-            const headers = { 'X-IG-App-ID': appId };
-            const request = await fetch(requestUrl, {
-                credentials: 'include',
-                headers,
-            });
-            const text = await request.text();
-            let data = null;
-            try {
-                data = text ? JSON.parse(text) : null;
-            }
-            catch {
-                data = null;
-            }
-            return {
-                ok: request.ok,
-                status: request.status,
-                text,
-                data,
-            };
-        }, url, INSTAGRAM_APP_ID);
-        if (!response || typeof response !== 'object') {
-            throw new Error('Instagram API returned no payload');
-        }
-        return response;
-    }
-    catch (error) {
-        throw new CommandExecutionError(`Instagram API request failed for ${url}: ${error?.message || error}`);
-    }
-}
-function isRateLimited(result) {
-    const message = String(result?.text || '').toLowerCase();
-    const status = Number(result?.status || 0);
-    return status === 429 || message.includes('rate limit') || message.includes('wait a few minutes');
-}
-function isAuthRequired(result) {
-    const status = Number(result?.status || 0);
-    if (status === 401 || status === 403)
-        return true;
-    const message = String(result?.text || '').toLowerCase();
-    return message.includes('login') || message.includes('require_login');
-}
-function normalizeFeedItem(item, rank) {
-    const shortcode = normalizeShortcode(item);
-    const kind = resolvePostKind(item);
-    const captionSource = item?.caption?.text || item?.caption || '';
-    return {
-        index: rank,
-        caption: normalizeCaptionText(captionSource),
-        likes: item?.like_count ?? 0,
-        comments: item?.comment_count ?? 0,
-        type: normalizeMediaType(item),
-        date: formatInstagramDate(item?.taken_at),
-        posted_at: formatInstagramPostedAt(item?.taken_at),
-        kind,
-        shortcode,
-        media_id: String(item?.id || ''),
-        url: buildInstagramPostUrl(shortcode, kind),
-    };
-}
-function parseFeedItems(data) {
-    return Array.isArray(data) ? data : [];
-}
-function isWithinTimeWindow(timestamp, timeWindow) {
-    if (!timeWindow) {
-        return true;
-    }
-    const seconds = Number(timestamp || 0);
-    if (!Number.isFinite(seconds) || seconds <= 0) {
-        return false;
-    }
-    return seconds >= timeWindow.startSec && seconds <= timeWindow.endSec;
-}
-async function collectUserPosts(page, userId, limit, captionFilter) {
-    const rows = [];
-    const dedup = new Set();
-    let maxId = '';
-    let keepPaging = true;
-
-    while (rows.length < limit && keepPaging) {
-        const remaining = limit - rows.length;
-        const pageCount = remaining > BATCH_LIMIT ? BATCH_LIMIT : remaining;
-        const base = `https://www.instagram.com/api/v1/feed/user/${encodeURIComponent(userId)}/?count=${pageCount}`;
-        const url = maxId ? `${base}&max_id=${encodeURIComponent(maxId)}` : base;
-        const result = await fetchInstagramJson(page, url);
-        if (!result.ok) {
-            if (isAuthRequired(result)) {
-                throw new AuthRequiredError('www.instagram.com', result.text || `HTTP ${result.status}`);
-            }
-            if (isRateLimited(result)) {
-                throw new CommandExecutionError('Instagram feed request is rate limited', 'Wait a few minutes and retry.');
-            }
-            throw new CommandExecutionError('Failed to fetch user posts', `Instagram returned HTTP ${result.status} for ${url}`);
-        }
-        const data = result.data || {};
-        if (!data || typeof data !== 'object') {
-            throw new CommandExecutionError('Instagram returned an unexpected response for user feed');
-        }
-        const items = parseFeedItems(data.items);
-        if (items.length === 0) {
-            break;
-        }
-        for (const item of items) {
-            const shortcode = normalizeShortcode(item);
-            if (!shortcode || dedup.has(shortcode))
-                continue;
-            const captionText = item?.caption?.text || item?.caption || '';
-            if (captionFilter && !captionFilter.test(captionText)) {
-                continue;
-            }
-            dedup.add(shortcode);
-            rows.push(normalizeFeedItem(item, rows.length + 1));
-            if (rows.length >= limit) {
-                return rows;
-            }
-        }
-        if (!data.more_available) {
-            keepPaging = false;
-            break;
-        }
-        const nextMaxId = String(data.next_max_id || '').trim();
-        if (!nextMaxId || nextMaxId === maxId) {
-            break;
-        }
-        maxId = nextMaxId;
-        if (rows.length < limit) {
-            await page.wait({ time: 0.5 });
-        }
-    }
-    return rows;
-}
-async function collectUserPostsByTimeWindow(page, userId, limit, captionFilter, timeWindow) {
-    const rows = [];
-    const dedup = new Set();
-    let maxId = '';
-    let keepPaging = true;
-    while (rows.length < limit && keepPaging) {
-        const remaining = limit - rows.length;
-        const pageCount = remaining > BATCH_LIMIT ? BATCH_LIMIT : remaining;
-        const base = `https://www.instagram.com/api/v1/feed/user/${encodeURIComponent(userId)}/?count=${pageCount}`;
-        const url = maxId ? `${base}&max_id=${encodeURIComponent(maxId)}` : base;
-        const result = await fetchInstagramJson(page, url);
-        if (!result.ok) {
-            if (isAuthRequired(result)) {
-                throw new AuthRequiredError('www.instagram.com', result.text || `HTTP ${result.status}`);
-            }
-            if (isRateLimited(result)) {
-                throw new CommandExecutionError('Instagram feed request is rate limited', 'Wait a few minutes and retry.');
-            }
-            throw new CommandExecutionError('Failed to fetch user posts', `Instagram returned HTTP ${result.status} for ${url}`);
-        }
-        const data = result.data || {};
-        if (!data || typeof data !== 'object') {
-            throw new CommandExecutionError('Instagram returned an unexpected response for user feed');
-        }
-        const items = parseFeedItems(data.items);
-        if (items.length === 0) {
-            break;
-        }
-        let hitOlderThanRange = false;
-        for (const item of items) {
-            const takenAt = Number(item?.taken_at || 0);
-            if (Number.isFinite(takenAt) && takenAt > 0 && takenAt < timeWindow.startSec) {
-                hitOlderThanRange = true;
-                break;
-            }
-            const shortcode = normalizeShortcode(item);
-            if (!shortcode || dedup.has(shortcode))
-                continue;
-            if (!isWithinTimeWindow(takenAt, timeWindow)) {
-                continue;
-            }
-            const captionText = item?.caption?.text || item?.caption || '';
-            if (captionFilter && !captionFilter.test(captionText)) {
-                continue;
-            }
-            dedup.add(shortcode);
-            rows.push(normalizeFeedItem(item, rows.length + 1));
-            if (rows.length >= limit) {
-                return rows;
-            }
-        }
-        if (hitOlderThanRange || !data.more_available) {
-            keepPaging = false;
-            break;
-        }
-        const nextMaxId = String(data.next_max_id || '').trim();
-        if (!nextMaxId || nextMaxId === maxId) {
-            break;
-        }
-        maxId = nextMaxId;
-        if (rows.length < limit) {
-            await page.wait({ time: 0.5 });
-        }
-    }
-    return rows;
-}
-cli({
-    site: 'instagram',
-    name: 'user',
-    access: 'read',
-    description: 'Get recent posts from an Instagram user',
-    domain: 'www.instagram.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: 'https://www.instagram.com',
-    args: [
-        { name: 'username', required: true, positional: true, help: 'Instagram username' },
-        { name: 'limit', type: 'int', default: DEFAULT_LIMIT, help: `Number of posts (1-${MAX_LIMIT})` },
-        {
-            name: 'date',
-            default: '',
-            help: 'Fetch posts from one full local day. Format: YYYY-MM-DD. Cannot be combined with --from/--to.',
-        },
-        {
-            name: 'from',
-            default: '',
-            help: 'Fetch posts from this timestamp onward. Use ISO 8601 like 2026-07-11T18:30:00+05:30 or Unix seconds.',
-        },
-        {
-            name: 'to',
-            default: '',
-            help: 'Fetch posts up to this timestamp. Requires --from. Use ISO 8601 like 2026-07-12T18:30:00+05:30 or Unix seconds.',
-        },
-        {
-            name: 'caption-filter-mode',
-            default: DEFAULT_CAPTION_FILTER_MODE,
-            choices: CAPTION_FILTER_MODES,
-            help: 'Caption matching mode: contains or regex',
-        },
-        { name: 'caption-filter', default: '', help: 'Keep only posts whose caption matches this pattern' },
-        { name: 'caption-reject', default: '', help: 'Drop posts whose caption matches this pattern (same mode as caption-filter-mode)' },
-        { name: 'caption-case-sensitive', type: 'bool', default: false, help: 'Match captions case-sensitively' },
-    ],
-    columns: ['index', 'caption', 'likes', 'comments', 'type', 'date', 'posted_at', 'kind', 'shortcode', 'media_id', 'url'],
-    func: async (page, kwargs) => {
-        const username = String(kwargs.username || '').trim().replace(/^@+/, '');
-        if (!username) {
-            throw new ArgumentError('Instagram username is required');
-        }
-        const limit = requirePositiveBoundedInt(kwargs.limit, {
-            defaultValue: DEFAULT_LIMIT,
-            max: MAX_LIMIT,
-            label: 'Instagram user limit',
-        });
-        const captionFilter = makeCaptionFilter(kwargs);
-        const timeWindow = resolveTimeWindow(kwargs);
-
-        const profileUrl = `https://www.instagram.com/api/v1/users/web_profile_info/?username=${encodeURIComponent(username)}`;
-        const profileResult = await fetchInstagramJson(page, profileUrl);
-        if (!profileResult.ok) {
-            if (isAuthRequired(profileResult)) {
-                throw new AuthRequiredError('www.instagram.com', 'Instagram login required to read user profile');
-            }
-            if (isRateLimited(profileResult)) {
-                throw new CommandExecutionError('Instagram profile request is rate limited', 'Wait a few minutes and retry.');
-            }
-            throw new CommandExecutionError('Failed to resolve Instagram user', `Instagram returned HTTP ${profileResult.status} for profile lookup`);
-        }
-        const userId = String(profileResult.data?.data?.user?.id || '').trim();
-        if (!userId) {
-            throw new CommandExecutionError(`Instagram user not found: ${username}`);
-        }
-        const rows = timeWindow
-            ? await collectUserPostsByTimeWindow(page, userId, limit, captionFilter, timeWindow)
-            : await collectUserPosts(page, userId, limit, captionFilter);
-        if (rows.length === 0) {
-            throw new EmptyResultError('instagram user', `No posts found for ${username}`);
-        }
-        return rows;
-    },
-    __test__: {
-        DEFAULT_LIMIT,
-        MAX_LIMIT,
-        DEFAULT_CAPTION_FILTER_MODE,
-        BATCH_LIMIT,
-        parseFeedItems,
-        normalizeCaptionFilterMode,
-        compileCaptionMatcher,
-        makeCaptionFilter,
-        resolvePostKind,
-        normalizeFeedItem,
-        normalizeMediaType,
-        requirePositiveBoundedInt,
-        buildInstagramPostUrl,
-        parseDayBounds,
-        parseTimestampArg,
-        resolveTimeWindow,
-        isWithinTimeWindow,
-        isAuthRequired,
-        isRateLimited,
-        formatInstagramDate,
-        formatInstagramPostedAt,
-    },
-});
+import{cli as K,Strategy as V}from"@jackwener/opencli/registry";import{ArgumentError as m,AuthRequiredError as N,CommandExecutionError as d,EmptyResultError as Q}from"@jackwener/opencli/errors";const Z="936619743392459",C=12,D=1000,_=50,tt="https://www.instagram.com",A="contains",O=["contains","regex"],et=/^\d{4}-\d{2}-\d{2}$/,nt=/^\d{10}$/,rt=/^\d{13}$/;function k(t,e){const{defaultValue:n,max:r,label:o}=e,s=t===void 0?n:Number(t);if(!Number.isInteger(s)||s<=0)throw new m(`${o} must be a positive integer`);if(s>r)throw new m(`${o} must be <= ${r}`);return s}function U(t){return String(t?.code||"").trim()}function I(t){return String(t||"").replace(/\s+/g," ").trim()}function Y(t){const e=String(t||A).trim().toLowerCase();if(!O.includes(e))throw new m(`Invalid caption-filter-mode: ${t}. Supported values: contains, regex`);return e}function E(t,e){const{mode:n,caseSensitive:r,label:o}=e,s=I(t);if(!s)return null;if(n==="regex"){const a=r?"":"i";try{const i=new RegExp(s,a);return(f)=>i.test(I(f))}catch(i){throw new m(`Invalid ${o} regular expression: ${i?.message||i}`)}}const c=r?s:s.toLowerCase();return(a)=>{const i=I(a);return r?i.includes(c):i.toLowerCase().includes(c)}}function L(t){const e=Y(t["caption-filter-mode"]),n=I(t["caption-filter"]||t.captionFilter),r=I(t["caption-reject"]||t.captionReject),o=t["caption-case-sensitive"]===!0||t.captionCaseSensitive===!0;if(e==="regex"&&!n&&!r)return null;if(!n&&!r)return null;const s=n?E(n,{mode:e,caseSensitive:o,label:"caption-filter"}):null,c=r?E(r,{mode:e,caseSensitive:o,label:"caption-reject"}):null;return{test(a){const i=I(a);if(c&&c(i))return!1;if(!s)return!0;return s(i)}}}function q(t){if(t?.media_type===1)return"photo";if(t?.media_type===2)return"video";return"carousel"}function j(t){const e=String(t?.product_type||"").toLowerCase();if(e==="clips"||e==="reel")return"reel";if(t?.is_reel_media)return"reel";return"p"}function z(t){const e=Number(t||0);return Number.isFinite(e)&&e>0?new Date(e*1000).toLocaleDateString():""}function H(t){const e=Number(t||0);return Number.isFinite(e)&&e>0?new Date(e*1000).toISOString():""}function B(t,e="p"){return t?`${tt}/${e}/${t}/`:""}function J(t,e={}){const n=e.label||"date",r=String(t||"").trim();if(!et.test(r))throw new m(`Invalid --${n}: ${JSON.stringify(t)}. Use YYYY-MM-DD.`);const o=new Date(`${r}T00:00:00`).getTime(),s=new Date(`${r}T23:59:59.999`).getTime();if(!Number.isFinite(o)||!Number.isFinite(s))throw new m(`Invalid --${n}: ${JSON.stringify(t)}. Use YYYY-MM-DD.`);return{startSec:Math.floor(o/1000),endSec:Math.floor(s/1000)}}function F(t,e={}){const n=e.label||"from",r=String(t||"").trim();if(!r)throw new m(`Missing --${n} timestamp`);if(nt.test(r))return Number(r);if(rt.test(r))return Math.floor(Number(r)/1000);const o=new Date(r).getTime();if(!Number.isFinite(o))throw new m(`Invalid --${n}: ${JSON.stringify(t)}. Use ISO 8601 like 2026-07-11T18:30:00+05:30 or Unix seconds.`);return Math.floor(o/1000)}function W(t){const e=String(t.date||"").trim(),n=String(t.from||"").trim(),r=String(t.to||"").trim();if(e&&(n||r))throw new m("Cannot combine --date with --from/--to. Use --date YYYY-MM-DD for a whole day, or --from/--to for an exact time range.");if(r&&!n)throw new m("Using --to requires --from.");if(e)return J(e,{label:"date"});if(!n&&!r)return null;const o=F(n,{label:"from"}),s=r?F(r,{label:"to"}):Number.POSITIVE_INFINITY;if(s<o)throw new m("--from must be earlier than or equal to --to.");return{startSec:o,endSec:s}}async function P(t,e){try{const n=await t.evaluate(async(r,o)=>{const c=await fetch(r,{credentials:"include",headers:{"X-IG-App-ID":o}}),a=await c.text();let i=null;try{i=a?JSON.parse(a):null}catch{i=null}return{ok:c.ok,status:c.status,text:a,data:i}},e,Z);if(!n||typeof n!=="object")throw Error("Instagram API returned no payload");return n}catch(n){throw new d(`Instagram API request failed for ${e}: ${n?.message||n}`)}}function T(t){const e=String(t?.text||"").toLowerCase();return Number(t?.status||0)===429||e.includes("rate limit")||e.includes("wait a few minutes")}function y(t){const e=Number(t?.status||0);if(e===401||e===403)return!0;const n=String(t?.text||"").toLowerCase();return n.includes("login")||n.includes("require_login")}function R(t,e){const n=U(t),r=j(t),o=t?.caption?.text||t?.caption||"";return{index:e,caption:I(o),likes:t?.like_count??0,comments:t?.comment_count??0,type:q(t),date:z(t?.taken_at),posted_at:H(t?.taken_at),kind:r,shortcode:n,media_id:String(t?.id||""),url:B(n,r)}}function v(t){return Array.isArray(t)?t:[]}function X(t,e){if(!e)return!0;const n=Number(t||0);if(!Number.isFinite(n)||n<=0)return!1;return n>=e.startSec&&n<=e.endSec}async function ot(t,e,n,r){const o=[],s=new Set;let c="",a=!0;while(o.length<n&&a){const i=n-o.length,f=i>_?_:i,x=`https://www.instagram.com/api/v1/feed/user/${encodeURIComponent(e)}/?count=${f}`,S=c?`${x}&max_id=${encodeURIComponent(c)}`:x,l=await P(t,S);if(!l.ok){if(y(l))throw new N("www.instagram.com",l.text||`HTTP ${l.status}`);if(T(l))throw new d("Instagram feed request is rate limited","Wait a few minutes and retry.");throw new d("Failed to fetch user posts",`Instagram returned HTTP ${l.status} for ${S}`)}const u=l.data||{};if(!u||typeof u!=="object")throw new d("Instagram returned an unexpected response for user feed");const p=v(u.items);if(p.length===0)break;for(const w of p){const h=U(w);if(!h||s.has(h))continue;const g=w?.caption?.text||w?.caption||"";if(r&&!r.test(g))continue;s.add(h);o.push(R(w,o.length+1));if(o.length>=n)return o}if(!u.more_available){a=!1;break}const b=String(u.next_max_id||"").trim();if(!b||b===c)break;c=b;if(o.length<n)await t.wait({time:0.5})}return o}async function st(t,e,n,r,o){const s=[],c=new Set;let a="",i=!0;while(s.length<n&&i){const f=n-s.length,x=f>_?_:f,S=`https://www.instagram.com/api/v1/feed/user/${encodeURIComponent(e)}/?count=${x}`,l=a?`${S}&max_id=${encodeURIComponent(a)}`:S,u=await P(t,l);if(!u.ok){if(y(u))throw new N("www.instagram.com",u.text||`HTTP ${u.status}`);if(T(u))throw new d("Instagram feed request is rate limited","Wait a few minutes and retry.");throw new d("Failed to fetch user posts",`Instagram returned HTTP ${u.status} for ${l}`)}const p=u.data||{};if(!p||typeof p!=="object")throw new d("Instagram returned an unexpected response for user feed");const b=v(p.items);if(b.length===0)break;let w=!1;for(const g of b){const $=Number(g?.taken_at||0);if(Number.isFinite($)&&$>0&&$<o.startSec){w=!0;break}const M=U(g);if(!M||c.has(M))continue;if(!X($,o))continue;const G=g?.caption?.text||g?.caption||"";if(r&&!r.test(G))continue;c.add(M);s.push(R(g,s.length+1));if(s.length>=n)return s}if(w||!p.more_available){i=!1;break}const h=String(p.next_max_id||"").trim();if(!h||h===a)break;a=h;if(s.length<n)await t.wait({time:0.5})}return s}K({site:"instagram",name:"user",access:"read",description:"Get recent posts from an Instagram user",domain:"www.instagram.com",strategy:V.COOKIE,browser:!0,navigateBefore:"https://www.instagram.com",args:[{name:"username",required:!0,positional:!0,help:"Instagram username"},{name:"limit",type:"int",default:C,help:`Number of posts (1-${D})`},{name:"date",default:"",help:"Fetch posts from one full local day. Format: YYYY-MM-DD. Cannot be combined with --from/--to."},{name:"from",default:"",help:"Fetch posts from this timestamp onward. Use ISO 8601 like 2026-07-11T18:30:00+05:30 or Unix seconds."},{name:"to",default:"",help:"Fetch posts up to this timestamp. Requires --from. Use ISO 8601 like 2026-07-12T18:30:00+05:30 or Unix seconds."},{name:"caption-filter-mode",default:A,choices:O,help:"Caption matching mode: contains or regex"},{name:"caption-filter",default:"",help:"Keep only posts whose caption matches this pattern"},{name:"caption-reject",default:"",help:"Drop posts whose caption matches this pattern (same mode as caption-filter-mode)"},{name:"caption-case-sensitive",type:"bool",default:!1,help:"Match captions case-sensitively"}],columns:["index","caption","likes","comments","type","date","posted_at","kind","shortcode","media_id","url"],func:async(t,e)=>{const n=String(e.username||"").trim().replace(/^@+/,"");if(!n)throw new m("Instagram username is required");const r=k(e.limit,{defaultValue:C,max:D,label:"Instagram user limit"}),o=L(e),s=W(e),c=`https://www.instagram.com/api/v1/users/web_profile_info/?username=${encodeURIComponent(n)}`,a=await P(t,c);if(!a.ok){if(y(a))throw new N("www.instagram.com","Instagram login required to read user profile");if(T(a))throw new d("Instagram profile request is rate limited","Wait a few minutes and retry.");throw new d("Failed to resolve Instagram user",`Instagram returned HTTP ${a.status} for profile lookup`)}const i=String(a.data?.data?.user?.id||"").trim();if(!i)throw new d(`Instagram user not found: ${n}`);const f=s?await st(t,i,r,o,s):await ot(t,i,r,o);if(f.length===0)throw new Q("instagram user",`No posts found for ${n}`);return f},__test__:{DEFAULT_LIMIT:C,MAX_LIMIT:D,DEFAULT_CAPTION_FILTER_MODE:A,BATCH_LIMIT:_,parseFeedItems:v,normalizeCaptionFilterMode:Y,compileCaptionMatcher:E,makeCaptionFilter:L,resolvePostKind:j,normalizeFeedItem:R,normalizeMediaType:q,requirePositiveBoundedInt:k,buildInstagramPostUrl:B,parseDayBounds:J,parseTimestampArg:F,resolveTimeWindow:W,isWithinTimeWindow:X,isAuthRequired:y,isRateLimited:T,formatInstagramDate:z,formatInstagramPostedAt:H}});

package/clis/jd/add-cart.js

@@ -1,27 +1,4 @@
-import { AuthRequiredError } from '@jackwener/opencli/errors';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { clampInt, normalizeNumericId } from '../_shared/common.js';
-cli({
-    site: 'jd',
-    name: 'add-cart',
-    access: 'write',
-    description: '京东加入购物车',
-    domain: 'item.jd.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'sku', positional: true, required: true, help: '商品 SKU ID' },
-        { name: 'num', type: 'int', default: 1, help: '数量' },
-        { name: 'dry-run', type: 'bool', default: false, help: '仅预览，不实际加入购物车' },
-    ],
-    columns: ['status', 'title', 'price', 'sku'],
-    navigateBefore: false,
-    func: async (page, kwargs) => {
-        const sku = normalizeNumericId(kwargs.sku, 'sku', '100291143898');
-        const num = clampInt(kwargs.num, 1, 1, 99);
-        const dryRun = !!kwargs['dry-run'];
-        await page.goto(`https://item.jd.com/${sku}.html`);
-        await page.wait(4);
-        const info = await page.evaluate(`
+import{AuthRequiredError as o}from"@jackwener/opencli/errors";import{cli as a,Strategy as l}from"@jackwener/opencli/registry";import{clampInt as d,normalizeNumericId as m}from"../_shared/common.js";a({site:"jd",name:"add-cart",access:"write",description:"京东加入购物车",domain:"item.jd.com",strategy:l.COOKIE,args:[{name:"sku",positional:!0,required:!0,help:"商品 SKU ID"},{name:"num",type:"int",default:1,help:"数量"},{name:"dry-run",type:"bool",default:!1,help:"仅预览，不实际加入购物车"}],columns:["status","title","price","sku"],navigateBefore:!1,func:async(t,r)=>{const e=m(r.sku,"sku","100291143898"),s=d(r.num,1,1,99),u=!!r["dry-run"];await t.goto(`https://item.jd.com/${e}.html`);await t.wait(4);const i=await t.evaluate(`
       (() => {
         const text = document.body?.innerText || '';
         const titleMatch = document.title.match(/^【[^】]*】(.+?)【/);
@@ -30,18 +7,7 @@ cli({
         const price = priceMatch ? '¥' + priceMatch[1] : '';
         return { title, price };
       })()
-    `);
-        if (dryRun) {
-            return [{
-                    status: 'dry-run',
-                    title: (info?.title || '').slice(0, 80),
-                    price: info?.price || '',
-                    sku,
-                }];
-        }
-        await page.goto(`https://cart.jd.com/gate.action?pid=${sku}&pcount=${num}&ptype=1`);
-        await page.wait(4);
-        const result = await page.evaluate(`
+    `);if(u)return[{status:"dry-run",title:(i?.title||"").slice(0,80),price:i?.price||"",sku:e}];await t.goto(`https://cart.jd.com/gate.action?pid=${e}&pcount=${s}&ptype=1`);await t.wait(4);const n=await t.evaluate(`
       (() => {
         const url = location.href;
         const text = document.body?.innerText || '';
@@ -53,20 +19,4 @@ cli({
         }
         return 'page:' + url.substring(0, 60) + ' | ' + text.substring(0, 100);
       })()
-    `);
-        if (result === 'login_required') {
-            throw new AuthRequiredError('jd add-cart requires a logged-in JD session');
-        }
-        let status = '? 未知';
-        if (result === 'success')
-            status = '✓ 已加入购物车';
-        else
-            status = '? ' + result;
-        return [{
-                status,
-                title: (info?.title || '').slice(0, 80),
-                price: info?.price || '',
-                sku,
-            }];
-    },
-});
+    `);if(n==="login_required")throw new o("jd add-cart requires a logged-in JD session");let c="? 未知";if(n==="success")c="✓ 已加入购物车";else c="? "+n;return[{status:c,title:(i?.title||"").slice(0,80),price:i?.price||"",sku:e}]}});

package/clis/jd/auth.js

@@ -1,19 +1,4 @@
-import { AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-
-async function hasJdSessionCookie(page) {
-  const cookies = await page.getCookies({ url: 'https://www.jd.com' });
-  const names = new Set(cookies.map(c => c.name));
-  return names.has('pin') || names.has('thor');
-}
-
-async function verifyJdIdentity(page) {
-  if (!await hasJdSessionCookie(page)) {
-    throw new AuthRequiredError('jd.com', 'JD pin / thor cookie missing');
-  }
-  await page.goto('https://home.jd.com/');
-  await page.wait(3);
-  const probe = await page.evaluate(`
+import{AuthRequiredError as i,CommandExecutionError as a}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as s}from"../_shared/site-auth.js";async function t(e){const n=await e.getCookies({url:"https://www.jd.com"}),r=new Set(n.filter((o)=>o.value).map((o)=>o.name));return r.has("pin")||r.has("thor")}async function c(e){if(!await t(e))throw new i("jd.com","JD pin / thor cookie missing");await e.goto("https://home.jd.com/");await e.wait(3);const n=await e.evaluate(`
     (() => {
       const pinCookie = (document.cookie.split('; ').find(c => c.startsWith('pin=')) || '').split('=')[1] || '';
       const decoded = pinCookie ? decodeURIComponent(pinCookie) : '';
@@ -24,23 +9,4 @@ async function verifyJdIdentity(page) {
       const nickname = (nickEl && nickEl.textContent && nickEl.textContent.trim()) || '';
       return { ok: true, pin: decoded, nickname };
     })()
-  `);
-  if (probe?.kind === 'auth') throw new AuthRequiredError('jd.com', probe.detail);
-  if (!probe?.ok) throw new CommandExecutionError(`Unexpected JD probe: ${JSON.stringify(probe)}`);
-  return { pin: probe.pin, nickname: probe.nickname };
-}
-
-registerSiteAuthCommands({
-  site: 'jd',
-  domain: 'jd.com',
-  loginUrl: 'https://passport.jd.com/new/login.aspx',
-  columns: ['pin', 'nickname'],
-  quickCheck: hasJdSessionCookie,
-  verify: verifyJdIdentity,
-  poll: async (page) => {
-    if (!await hasJdSessionCookie(page)) {
-      throw new AuthRequiredError('jd.com', 'Waiting for JD pin / thor cookie');
-    }
-    return verifyJdIdentity(page);
-  },
-});
+  `);if(n?.kind==="auth")throw new i("jd.com",n.detail);if(!n?.ok)throw new a(`Unexpected JD probe: ${JSON.stringify(n)}`);return{pin:n.pin,nickname:n.nickname}}s({site:"jd",domain:"jd.com",loginUrl:"https://passport.jd.com/new/login.aspx",columns:["pin","nickname"],quickCheck:t,verify:c,poll:async(e)=>{if(!await t(e))throw new i("jd.com","Waiting for JD pin / thor cookie");return c(e)}});

package/clis/jd/cart.js

@@ -1,19 +1,4 @@
-import { AuthRequiredError } from '@jackwener/opencli/errors';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'jd',
-    name: 'cart',
-    access: 'read',
-    description: '查看京东购物车',
-    domain: 'cart.jd.com',
-    strategy: Strategy.COOKIE,
-    args: [],
-    columns: ['index', 'title', 'price', 'quantity', 'sku'],
-    navigateBefore: false,
-    func: async (page) => {
-        await page.goto('https://cart.jd.com/cart_index');
-        await page.wait(5);
-        const data = await page.evaluate(`
+import{AuthRequiredError as r}from"@jackwener/opencli/errors";import{cli as i,Strategy as n}from"@jackwener/opencli/registry";i({site:"jd",name:"cart",access:"read",description:"查看京东购物车",domain:"cart.jd.com",strategy:n.COOKIE,args:[],columns:["index","title","price","quantity","sku"],navigateBefore:!1,func:async(t)=>{await t.goto("https://cart.jd.com/cart_index");await t.wait(5);const e=await t.evaluate(`
       (async () => {
         const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
         for (let i = 0; i < 20; i++) {
@@ -71,10 +56,4 @@ cli({
         }
         return { items };
       })()
-    `);
-        if (data?.error === 'auth-required') {
-            throw new AuthRequiredError('jd cart requires a logged-in JD session');
-        }
-        return Array.isArray(data?.items) ? data.items : [];
-    },
-});
+    `);if(e?.error==="auth-required")throw new r("jd cart requires a logged-in JD session");return Array.isArray(e?.items)?e.items:[]}});