emdash-emit 0.1.25 → 0.1.30

package/dist/sync/pull/index.js

@@ -0,0 +1,363 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { apiResponseToLocal } from '../../client/mapper.js';
+import { ApiError } from '../../client/error.js';
+import { createAuthedFetch } from '../../client/http.js';
+import { extractRev, extractComparisonRev, isSameRev } from '../../client/api.js';
+import { articleContentEndpoint } from '../../client/endpoints.js';
+import { extractDatePrefixFromPath, serializeMarkdown, } from '../../utils/frontmatter.js';
+import { hasUncommittedDraftRevision } from '../../utils/draft-revision.js';
+import { localizeArticleMediaRefs, carriesDepthFreeMediaRef, shouldPreferLegacyRef, } from '../../utils/media-body-refs.js';
+import { CONFLICTS_SUBDIR, calculateHash, commitArticleSnapshot, findLocalFilesByUlid, isQuarantinedRelativePath, quarantineLocalCopy, resolveCanonicalArticlePath, } from '../workspace/index.js';
+import { loadLocalTaxonomyCandidates } from '../taxonomies.js';
+import { syncRemoteBylines, extractRemoteBylineIds } from '../bylines.js';
+import { updateConfigSyncedVersion } from '../../utils/config.js';
+import { fetchAssignedTerms as fetchAssignedTermsShared, computeTaxonomyHash } from '../terms.js';
+import { extractCanonicalRemoteTitle, getRemoteMaxBatchLimit, listRemoteArticles } from './list.js';
+import { formatQuarantineNotice, handleRemoteDeletedArticle, quarantineDivergentLocalCopies, } from './quarantine.js';
+import { tryFastPathOrHeal } from './fast_path.js';
+import { mirrorArticleReferencedMedia, createMediaMirrorSession } from './media_stage.js';
+export { CONFLICTS_SUBDIR, calculateHash, findLocalFilesByUlid, isQuarantinedRelativePath, quarantineLocalCopy, resolveCanonicalArticlePath, carriesDepthFreeMediaRef, shouldPreferLegacyRef, extractCanonicalRemoteTitle, getRemoteMaxBatchLimit, listRemoteArticles, formatQuarantineNotice, mirrorArticleReferencedMedia, createMediaMirrorSession, };
+/**
+ * Pulls a content item from EmDash and updates local files and cache.
+ * Implements Differential Skip: if remote _rev matches cached rev and local file is untouched,
+ * skips disk write and AST conversion.
+ */
+export async function pullArticle(collection, id, options) {
+    const fetchFn = createAuthedFetch(options);
+    let rawItem = options.rawItem;
+    // Helper to fetch assigned terms for a taxonomy ('category' | 'tag')
+    const fetchAssignedTerms = (taxonomy) => fetchAssignedTermsShared({
+        origin: options.origin,
+        token: options.token,
+        collection,
+        id,
+        taxonomy,
+        fetchFn,
+    });
+    // Helper to resolve byline ID-to-slug mapping
+    let bylineIdToSlug = options.bylineIdToSlug;
+    const getBylineIdToSlug = async () => {
+        if (bylineIdToSlug)
+            return bylineIdToSlug;
+        const cachedMaps = options.cache.getBylineMaps();
+        const remoteBylineIds = rawItem ? extractRemoteBylineIds(rawItem) : [];
+        const hasUnknownByline = Object.keys(cachedMaps.idToSlug).length === 0 ||
+            remoteBylineIds.some((ref) => !cachedMaps.idToSlug[ref] && !cachedMaps.slugToId[ref]);
+        if (!hasUnknownByline) {
+            bylineIdToSlug = cachedMaps.idToSlug;
+            return bylineIdToSlug;
+        }
+        const freshMaps = await syncRemoteBylines({
+            origin: options.origin,
+            token: options.token,
+            refreshToken: options.refreshToken,
+            cache: options.cache,
+            fetchFn: options.fetchFn,
+        }).catch(() => ({ slugToId: {}, idToSlug: {} }));
+        bylineIdToSlug = freshMaps.idToSlug;
+        return bylineIdToSlug;
+    };
+    // Helper to resolve taxonomy candidates for frontmatter inline comments
+    let candidates = options.candidates;
+    const getTaxonomyCandidates = () => {
+        if (candidates)
+            return candidates;
+        candidates = loadLocalTaxonomyCandidates(options.workspaceRoot);
+        return candidates;
+    };
+    /** The path a tracked article currently sits at, used when the caller has not resolved a new one yet. */
+    const existingFilePathForDepth = () => {
+        const tracked = options.cache.getSyncState(id)?.localFilePath;
+        if (tracked)
+            return tracked;
+        const onDisk = findLocalFilesByUlid(options.workspaceRoot, collection, id)[0];
+        return onDisk ?? `${collection}/draft/${id}.md`;
+    };
+    /**
+     * Applies the workspace's local-media-ref spelling to a serialized document. `sync_state.local_hash` always
+     * records the exact bytes on disk, so every comparison against a tracked file must run through this same
+     * transform: reconstructing the canonical form from a remote response and then localizing it keeps the
+     * fast-path skip honest whether or not `localMediaRefs` is enabled.
+     */
+    const localizeDiskMarkdown = (canonicalContent, articleRelPath, preferLegacyRef) => options.localMediaRefs
+        ? localizeArticleMediaRefs(canonicalContent, {
+            workspaceRoot: options.workspaceRoot,
+            articleRelPath: articleRelPath ?? existingFilePathForDepth(),
+            fs,
+            preferLegacyRef,
+        })
+        : canonicalContent;
+    const fastPathCtx = {
+        collection,
+        id,
+        options,
+        fetchAssignedTerms,
+        getBylineIdToSlug,
+        getTaxonomyCandidates,
+        localizeDiskMarkdown,
+    };
+    // 1. Fast-path check: If rawItem is provided in options, test fast-path / heal
+    if (rawItem) {
+        const fastResult = await tryFastPathOrHeal(fastPathCtx, rawItem);
+        if (fastResult) {
+            updateConfigSyncedVersion(options.workspaceRoot);
+            return fastResult;
+        }
+        // Fast-path missed: remote content changed or local repair required.
+        // EmDash list API returns stale creation-time posts.data for drafts, and liveData for published articles.
+        // When a published article has unpublished draft changes (draftRevisionId exists), list API does NOT expand
+        // the draft body (it returns only liveData).
+        // Therefore, if this is an existing tracked article whose remote draft revision has advanced, we must discard
+        // the stale list rawItem so Step 2 fetches the full canonical item via single GET!
+        const rawObj = rawItem;
+        const hasDraftRevision = Boolean(rawObj.draftRevisionId);
+        const isDraft = String(rawObj.status || 'draft') !== 'published';
+        const needsFullDraftFetch = isDraft || hasDraftRevision;
+        const existingSync = options.cache.getSyncState(id);
+        const rawRevCandidate = String(rawItem._rev || rawItem.rev || rawItem.version || rawObj._rev || '');
+        const remoteRev = extractRev(rawObj, rawRevCandidate);
+        const remoteComparisonRev = extractComparisonRev(rawObj, remoteRev);
+        const remoteChanged = !existingSync || !isSameRev(existingSync.remoteRev, remoteComparisonRev);
+        if (needsFullDraftFetch && existingSync && remoteChanged) {
+            rawItem = undefined;
+        }
+    }
+    // 2. Fetch raw item if not passed in options (or discarded above for draft updates)
+    if (!rawItem) {
+        const url = articleContentEndpoint(options.origin, collection, id);
+        const res = await fetchFn(url, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${options.token}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!res.ok) {
+            if (res.status === 404 || res.status === 410) {
+                const deletedResult = handleRemoteDeletedArticle(collection, id, options, getTaxonomyCandidates());
+                if (deletedResult)
+                    return deletedResult;
+            }
+            throw new ApiError({
+                message: `Failed to pull article ${collection}/${id}: ${res.statusText}`,
+                code: 'ARTICLE_PULL_FAILED',
+                status: res.status,
+                endpoint: url,
+                suggestion: `Verify that article '${id}' exists in collection '${collection}'.`,
+            });
+        }
+        rawItem = (await res.json());
+        // Step 2b (D5): Test fast-path / non-destructive heal for single-article pull as well!
+        const singleHealResult = await tryFastPathOrHeal(fastPathCtx, rawItem);
+        if (singleHealResult) {
+            updateConfigSyncedVersion(options.workspaceRoot);
+            return singleHealResult;
+        }
+    }
+    // Ensure byline ID-to-slug mapping is loaded
+    const resolvedBylineMap = await getBylineIdToSlug();
+    const effectiveOptions = {
+        ...options,
+        bylineIdToSlug: resolvedBylineMap,
+    };
+    const { frontmatter, body, rev } = apiResponseToLocal(rawItem, effectiveOptions);
+    const [categoriesTerms, tagsTerms] = await Promise.all([
+        fetchAssignedTerms('category'),
+        fetchAssignedTerms('tag'),
+    ]);
+    if (categoriesTerms !== null || tagsTerms !== null) {
+        if (!frontmatter.taxonomies) {
+            frontmatter.taxonomies = {};
+        }
+        if (categoriesTerms !== null) {
+            frontmatter.taxonomies.categories = categoriesTerms;
+        }
+        if (tagsTerms !== null) {
+            frontmatter.taxonomies.tags = tagsTerms;
+        }
+    }
+    // Format full Markdown. `canonicalMarkdown` is the remote form and is what every cache hash and every
+    // base snapshot records; `markdownContent` is what lands on disk, which may spell mirrored images as local
+    // references when `localMediaRefs` is enabled.
+    const comparisonRev = extractComparisonRev(rawItem, rev);
+    const hasDraft = hasUncommittedDraftRevision({
+        status: frontmatter.status,
+        remoteRev: comparisonRev,
+    });
+    const canonicalMarkdown = serializeMarkdown(frontmatter, body, getTaxonomyCandidates(), {
+        hasDraftRevision: hasDraft,
+    });
+    // Determine standard relative file path: <collection>/<status>/<yyyyMMdd>_<ulid>-<title>.md
+    const existingSync = options.cache.getSyncState(frontmatter.id);
+    const existingDiskMatches = findLocalFilesByUlid(options.workspaceRoot, frontmatter.collection, frontmatter.id);
+    const preferredDiskMatch = existingDiskMatches.find((p) => p.startsWith(`${frontmatter.collection}/${frontmatter.status}/`)) ?? existingDiskMatches[0];
+    const existingPrefix = existingSync?.localFilePath
+        ? extractDatePrefixFromPath(existingSync.localFilePath)
+        : preferredDiskMatch
+            ? extractDatePrefixFromPath(preferredDiskMatch)
+            : null;
+    const canonicalTitle = rawItem
+        ? extractCanonicalRemoteTitle(rawItem, frontmatter.slug)
+        : frontmatter.title || frontmatter.slug;
+    const relPath = resolveCanonicalArticlePath(frontmatter.collection, frontmatter.status, frontmatter.id, canonicalTitle, {
+        publishedAt: frontmatter.publishedAt || rawItem?.publishedAt || null,
+        createdAt: rawItem?.createdAt || null,
+        updatedAt: rawItem?.updatedAt || null,
+    }, existingPrefix);
+    let mediaSummary = undefined;
+    if (options.mediaSync !== false) {
+        mediaSummary = await mirrorArticleReferencedMedia(options, canonicalMarkdown, frontmatter.featuredImage);
+    }
+    const markdownContent = localizeDiskMarkdown(canonicalMarkdown, relPath, shouldPreferLegacyRef(options.workspaceRoot, existingDiskMatches));
+    const fullFilePath = path.join(options.workspaceRoot, relPath);
+    // Path tracking: Remove any previous file(s) for this ULID at a different path
+    // BEFORE writing fullFilePath so case-insensitive filesystems (e.g. macOS APFS)
+    // do not unlink the newly written file when only casing differs.
+    const staleRelPaths = new Set(existingDiskMatches);
+    if (existingSync?.localFilePath) {
+        staleRelPaths.add(existingSync.localFilePath);
+    }
+    const canonicalResolved = path.resolve(fullFilePath);
+    // Data safety: preserve every local copy whose content diverges from the last synced
+    // baseline (or has no cache baseline at all) before it is overwritten or unlinked.
+    const quarantined = quarantineDivergentLocalCopies(options, frontmatter.collection, staleRelPaths, existingSync?.localHash, markdownContent, existingSync?.conflictCopyHash, existingSync, getTaxonomyCandidates());
+    for (const staleRel of staleRelPaths) {
+        const staleFull = path.resolve(options.workspaceRoot, staleRel);
+        if (staleFull !== canonicalResolved && fs.existsSync(staleFull)) {
+            try {
+                fs.unlinkSync(staleFull);
+            }
+            catch {
+                // Ignore removal failure
+            }
+        }
+    }
+    // Update sync state with explicit conflict pending preservation
+    let conflictInfo = {};
+    const divergedQuarantines = !options.force
+        ? (quarantined ?? []).filter((q) => q.reason === 'diverged-from-baseline')
+        : [];
+    const divergedQuarantine = divergedQuarantines[divergedQuarantines.length - 1];
+    if (divergedQuarantine) {
+        const qFull = path.join(options.workspaceRoot, divergedQuarantine.quarantineFilePath);
+        let qHash = null;
+        if (fs.existsSync(qFull)) {
+            qHash = calculateHash(fs.readFileSync(qFull, 'utf8'));
+        }
+        conflictInfo = {
+            conflictPending: 1,
+            bodyConflictPending: 1,
+            taxonomyConflictPending: existingSync?.taxonomyConflictPending ?? 0,
+            conflictCopyPath: divergedQuarantine.quarantineFilePath,
+            conflictCopyHash: qHash,
+            conflictAt: Math.floor(Date.now() / 1000),
+        };
+    }
+    else if (!options.force && existingSync?.conflictCopyPath) {
+        const existingFull = path.join(options.workspaceRoot, existingSync.conflictCopyPath);
+        if (fs.existsSync(existingFull)) {
+            conflictInfo = {
+                conflictPending: existingSync.conflictPending,
+                bodyConflictPending: existingSync.bodyConflictPending,
+                taxonomyConflictPending: existingSync.taxonomyConflictPending,
+                conflictCopyPath: existingSync.conflictCopyPath,
+                conflictCopyHash: existingSync.conflictCopyHash,
+                conflictAt: existingSync.conflictAt,
+            };
+        }
+        else {
+            const taxPending = existingSync.taxonomyConflictPending ?? 0;
+            conflictInfo = {
+                conflictPending: taxPending,
+                bodyConflictPending: 0,
+                taxonomyConflictPending: taxPending,
+                conflictCopyPath: null,
+                conflictCopyHash: null,
+                conflictAt: null,
+            };
+        }
+    }
+    else if (options.force) {
+        conflictInfo = {
+            conflictPending: 0,
+            bodyConflictPending: 0,
+            taxonomyConflictPending: 0,
+            conflictCopyPath: null,
+            conflictCopyHash: null,
+            conflictAt: null,
+        };
+    }
+    else {
+        const taxPending = existingSync?.taxonomyConflictPending ?? 0;
+        conflictInfo = {
+            conflictPending: taxPending,
+            bodyConflictPending: 0,
+            taxonomyConflictPending: taxPending,
+            conflictCopyPath: null,
+            conflictCopyHash: null,
+            conflictAt: null,
+        };
+    }
+    // Commit canonical Markdown and sync state via commitArticleSnapshot
+    commitArticleSnapshot(options.cache, options.workspaceRoot, {
+        id: frontmatter.id,
+        relPath,
+        diskContent: markdownContent,
+        canonicalContent: canonicalMarkdown,
+        frontmatter,
+        bodyMarkdown: body,
+        revForTransport: rev,
+        revForComparison: comparisonRev,
+        flags: {
+            remoteTaxonomyHash: computeTaxonomyHash(frontmatter.taxonomies?.categories, frontmatter.taxonomies?.tags),
+            taxonomyApplyPending: 0,
+            ...conflictInfo,
+        },
+    });
+    // Update entries cache
+    options.cache.saveEntry({
+        id: frontmatter.id,
+        collection: frontmatter.collection,
+        slug: frontmatter.slug,
+        status: frontmatter.status,
+        title: frontmatter.title,
+        rev,
+        publishedAt: frontmatter.publishedAt,
+        rawJson: JSON.stringify(rawItem),
+        updatedAt: Math.floor(Date.now() / 1000),
+    });
+    updateConfigSyncedVersion(options.workspaceRoot);
+    return {
+        id: frontmatter.id,
+        slug: frontmatter.slug,
+        status: frontmatter.status,
+        filePath: relPath,
+        updated: true,
+        title: frontmatter.title,
+        quarantined: quarantined.length > 0 ? quarantined : undefined,
+        media: mediaSummary,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/sync/pull/index.js.map

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

package/dist/sync/pull/list.d.ts

@@ -0,0 +1,22 @@
+import type { ListRemoteArticlesOptions, RemoteArticleItem } from './types.js';
+/**
+ * Resolves the canonical article title from remote data symmetrically across
+ * fast-path and full-pull (EMIT-005 / v0.1.14 backlog §1).
+ */
+export declare function extractCanonicalRemoteTitle(rawObj: Record<string, unknown>, fallbackSlug?: string): string;
+/**
+ * Discovers the server's maximum allowed limit for content list queries from /_emdash/api/openapi.json.
+ * Defaults to 100 if openapi.json cannot be fetched or parsed.
+ */
+export declare function getRemoteMaxBatchLimit(options: {
+    origin: string;
+    token?: string;
+    fetchFn?: typeof fetch;
+}): Promise<number>;
+/**
+ * Lists articles from EmDash API with cursor pagination and dynamic batch size detection.
+ * When status is not specified or 'all', fetches up to `limit` published articles AND
+ * up to `limit` draft articles in parallel, ensuring drafts and published posts are both covered.
+ */
+export declare function listRemoteArticles(collection: string, options: ListRemoteArticlesOptions): Promise<RemoteArticleItem[]>;
+//# sourceMappingURL=list.d.ts.map

package/dist/sync/pull/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/sync/pull/list.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/E;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB;AAyGD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAe9B"}

package/dist/sync/pull/list.js

@@ -0,0 +1,175 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { ApiError } from '../../client/error.js';
+import { createAuthedFetch } from '../../client/http.js';
+import { unwrapEnvelope, unwrapItem, extractRev } from '../../client/api.js';
+import { articleContentEndpoint, openApiEndpoint } from '../../client/endpoints.js';
+/**
+ * Resolves the canonical article title from remote data symmetrically across
+ * fast-path and full-pull (EMIT-005 / v0.1.14 backlog §1).
+ */
+export function extractCanonicalRemoteTitle(rawObj, fallbackSlug) {
+    const item = unwrapItem(rawObj);
+    const data = (item.data || {}) || {};
+    const rawTitle = String(data.title || item.title || '').trim();
+    if (rawTitle)
+        return rawTitle;
+    const rawSlug = String(item.slug || fallbackSlug || '').trim();
+    if (rawSlug)
+        return rawSlug;
+    return 'Untitled';
+}
+/**
+ * Discovers the server's maximum allowed limit for content list queries from /_emdash/api/openapi.json.
+ * Defaults to 100 if openapi.json cannot be fetched or parsed.
+ */
+export async function getRemoteMaxBatchLimit(options) {
+    const fetchFn = options.fetchFn || fetch;
+    try {
+        const url = openApiEndpoint(options.origin);
+        const headers = { Accept: 'application/json' };
+        if (options.token) {
+            headers.Authorization = `Bearer ${options.token}`;
+        }
+        const res = await fetchFn(url, { headers });
+        if (!res.ok)
+            return 100;
+        const json = (await res.json());
+        const paths = (json.paths || {});
+        const getEndpoint = paths['/_emdash/api/content/{collection}']?.get || paths['/content/{collection}']?.get;
+        if (getEndpoint && Array.isArray(getEndpoint.parameters)) {
+            const params = getEndpoint.parameters;
+            const limitParam = params.find((p) => p.name === 'limit');
+            const schema = (limitParam?.schema || {});
+            if (typeof schema.maximum === 'number' && schema.maximum > 0) {
+                return schema.maximum;
+            }
+        }
+    }
+    catch {
+        // Ignore network or parse error, fallback to safe 100
+    }
+    return 100;
+}
+/**
+ * Fetches articles for a specific status ('draft' or 'published') using cursor pagination.
+ */
+async function fetchStatusArticles(collection, status, options, serverMaxLimit) {
+    const fetchFn = createAuthedFetch(options);
+    const targetTotal = options.all ? Infinity : (options.limit ?? 100);
+    const items = [];
+    let cursor = undefined;
+    let batchLimit = serverMaxLimit;
+    while (items.length < targetTotal) {
+        const remaining = targetTotal - items.length;
+        const currentBatch = Math.min(remaining, batchLimit);
+        const url = new URL(articleContentEndpoint(options.origin, collection));
+        url.searchParams.set('status', status);
+        url.searchParams.set('limit', String(currentBatch));
+        if (cursor) {
+            url.searchParams.set('cursor', cursor);
+        }
+        let res = await fetchFn(url.toString(), {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${options.token}`,
+                Accept: 'application/json',
+            },
+        });
+        // Adaptive fallback if server responds with validation error on limit
+        if (!res.ok && res.status === 400) {
+            try {
+                const errJson = (await res.clone().json());
+                const errMsg = JSON.stringify(errJson);
+                const match = errMsg.match(/expected number to be <=(\d+)/);
+                if (match && Number(match[1]) < batchLimit) {
+                    batchLimit = Number(match[1]);
+                    url.searchParams.set('limit', String(Math.min(remaining, batchLimit)));
+                    res = await fetchFn(url.toString(), {
+                        method: 'GET',
+                        headers: {
+                            Authorization: `Bearer ${options.token}`,
+                            Accept: 'application/json',
+                        },
+                    });
+                }
+            }
+            catch {
+                // Continue to normal error handling below
+            }
+        }
+        if (!res.ok) {
+            throw new ApiError({
+                message: `Failed to list remote articles (${status}): ${res.statusText}`,
+                code: 'ARTICLE_LIST_FAILED',
+                status: res.status,
+                endpoint: url.toString(),
+                suggestion: 'Verify network connection, permissions, or try lowering the limit.',
+            });
+        }
+        const json = await res.json();
+        const data = unwrapEnvelope(json);
+        const rawItems = (Array.isArray(data.items) ? data.items : Array.isArray(data) ? data : []);
+        if (rawItems.length === 0) {
+            break;
+        }
+        for (const raw of rawItems) {
+            const rawData = (raw.data || {});
+            const rev = extractRev(raw, '1');
+            items.push({
+                id: String(raw.id),
+                slug: String(raw.slug || ''),
+                status: String(raw.status || status),
+                title: String(rawData.title || raw.title || 'Untitled'),
+                _rev: rev,
+                rawItem: raw,
+            });
+            if (items.length >= targetTotal) {
+                break;
+            }
+        }
+        if (!data.nextCursor || typeof data.nextCursor !== 'string') {
+            break;
+        }
+        cursor = data.nextCursor;
+    }
+    return items;
+}
+/**
+ * Lists articles from EmDash API with cursor pagination and dynamic batch size detection.
+ * When status is not specified or 'all', fetches up to `limit` published articles AND
+ * up to `limit` draft articles in parallel, ensuring drafts and published posts are both covered.
+ */
+export async function listRemoteArticles(collection, options) {
+    const serverMaxLimit = options.batchSize || (await getRemoteMaxBatchLimit(options));
+    // If a specific status is explicitly requested
+    if (options.status === 'draft' || options.status === 'published') {
+        return fetchStatusArticles(collection, options.status, options, serverMaxLimit);
+    }
+    // Default: Fetch both published (up to limit) and draft (up to limit) in parallel
+    const [draftItems, publishedItems] = await Promise.all([
+        fetchStatusArticles(collection, 'draft', options, serverMaxLimit),
+        fetchStatusArticles(collection, 'published', options, serverMaxLimit),
+    ]);
+    return [...draftItems, ...publishedItems];
+}
+//# sourceMappingURL=list.js.map

package/dist/sync/pull/list.js.map

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