emdash-emit 0.1.14 → 0.1.16

package/dist/sync/media/naming_mirror.js

@@ -0,0 +1,143 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { formatDatePrefix, sanitizeTitleForFilename, storageKeyToMarkdownRef, collisionSuffixedMarkdownRef, } from '../../utils/frontmatter.js';
+import { MEDIA_BINARY_EXTENSIONS } from './types.js';
+/**
+ * Moves a file from src to dest, falling back to copy + unlink when src and dest
+ * reside on different filesystems (`EXDEV`).
+ */
+export function moveFileSafe(src, dest) {
+    try {
+        fs.renameSync(src, dest);
+    }
+    catch (err) {
+        if (err?.code === 'EXDEV') {
+            fs.copyFileSync(src, dest);
+            fs.unlinkSync(src);
+        }
+        else {
+            throw err;
+        }
+    }
+}
+/**
+ * Reads the media record id a mirror belongs to from its companion YAML, accepting both the storageKey-named
+ * stem and the legacy `<yyyyMMdd>_<id>-<name>` form. Returns `null` when no companion exists or it names no
+ * valid ULID, which is how Emit refuses to prune a file it cannot attribute to a record. A companion whose
+ * id is explicitly null (or any non-ULID value) proves the mirror backs no real record, so the stem's own
+ * leading characters are never trusted as an id — that fallback would let fabricated fixture ids reach
+ * record-keyed logic.
+ */
+export function mediaRecordIdForStem(mediaDir, stem) {
+    const candidates = [`${stem}.yaml`, `${stem.replace(/^\d{8}_/, '')}.yaml`];
+    for (const name of candidates) {
+        const candidatePath = path.join(mediaDir, name);
+        if (!fs.existsSync(candidatePath))
+            continue;
+        let doc = null;
+        try {
+            doc = yaml.load(fs.readFileSync(candidatePath, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        if (!doc)
+            continue;
+        const rawId = typeof doc.id === 'string' ? doc.id.trim() : '';
+        if (/^[0-9A-Za-z_-]{26}$/.test(rawId)) {
+            return rawId.toUpperCase();
+        }
+        return null;
+    }
+    return null;
+}
+/**
+ * Removes any stale duplicate files in `media/` that belong to the same 26-char `mediaId` but sit under a
+ * different stem — a leftover date-prefixed name from an earlier local promotion, for instance. Ownership is
+ * read from each file's companion YAML rather than from the filename, because a storageKey-named mirror
+ * carries no record id at all and must never be matched (or deleted) by a coincidental ULID prefix.
+ */
+export function cleanupDuplicateMediaFilesForId(mediaDir, mediaId, canonicalBaseName) {
+    if (!fs.existsSync(mediaDir))
+        return;
+    const wanted = mediaId.toUpperCase();
+    for (const entry of fs.readdirSync(mediaDir)) {
+        if (entry.startsWith('legacy_'))
+            continue;
+        const entryBase = entry.replace(/\.yaml$/, '').replace(/\.[^.]+$/, '');
+        if (entryBase === canonicalBaseName)
+            continue;
+        // Only a companion-backed mirror can be attributed, and only when the companion itself is being
+        // retired together with its binary.
+        if (!entry.endsWith('.yaml'))
+            continue;
+        if (mediaRecordIdForStem(mediaDir, entryBase) !== wanted)
+            continue;
+        for (const orphan of [
+            `${entryBase}.yaml`,
+            ...MEDIA_BINARY_EXTENSIONS.map((e) => `${entryBase}${e}`),
+        ]) {
+            const orphanPath = path.join(mediaDir, orphan);
+            if (orphan === `${canonicalBaseName}.yaml`)
+                continue;
+            try {
+                if (fs.existsSync(orphanPath))
+                    fs.unlinkSync(orphanPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+    }
+}
+/**
+ * Resolves the storageKey-derived stem against the names already taken in `media/`. Two distinct keys can
+ * sanitize to the same basename — `a/sample.png` and `b/sample.png` both yield `sample` — and a second asset
+ * must never overwrite the first. A name already owned by this same record is reused as-is, so re-pulling is
+ * idempotent; any other collision gets the deterministic `<stem>--<mediaId>` suffix.
+ */
+export function resolveMarkdownRefCollision(mediaDir, baseRef, item) {
+    const suffixed = collisionSuffixedMarkdownRef(baseRef, item.id);
+    const takenByOther = (stem) => {
+        for (const suffix of ['.yaml', ...MEDIA_BINARY_EXTENSIONS]) {
+            const candidatePath = path.join(mediaDir, `${stem}${suffix}`);
+            if (!fs.existsSync(candidatePath))
+                continue;
+            const ownerId = mediaRecordIdForStem(mediaDir, stem);
+            if (ownerId && ownerId !== item.id.toUpperCase())
+                return true;
+        }
+        return false;
+    };
+    if (!takenByOther(baseRef))
+        return baseRef;
+    if (!takenByOther(suffixed))
+        return suffixed;
+    // Both taken and both owned by this record: the suffixed form is already this asset's, so keep it.
+    return suffixed;
+}
+/**
+ * Computes the canonical mirror name for one remote media item. Falls back to the record-id based stem only
+ * when the storageKey carries no usable basename, so a malformed migrated key cannot produce an unnameable
+ * file. Pass `mediaDir` to resolve a stem collision against the mirrors already on disk.
+ */
+export function mediaMirrorNames(item, mediaDir) {
+    const ext = path.extname(item.filename) || '';
+    const sanitizedBase = sanitizeTitleForFilename(path.basename(item.filename, ext));
+    const legacyBaseNames = [
+        `${item.id}-${sanitizedBase}`,
+        `${formatDatePrefix(item.createdAt)}${item.id}-${sanitizedBase}`,
+    ];
+    const fromKey = item.storageKey ? storageKeyToMarkdownRef(item.storageKey) : null;
+    if (fromKey) {
+        const markdownRef = mediaDir ? resolveMarkdownRefCollision(mediaDir, fromKey, item) : fromKey;
+        return { markdownRef, ext, legacyBaseNames };
+    }
+    return {
+        markdownRef: `${formatDatePrefix(item.createdAt)}${item.id}-${sanitizedBase}`,
+        ext,
+        legacyBaseNames,
+    };
+}
+//# sourceMappingURL=naming_mirror.js.map

package/dist/sync/media/naming_mirror.js.map

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

package/dist/sync/media/pull_article.d.ts

@@ -0,0 +1,37 @@
+import type { CacheDatabase } from '../../db/cache.js';
+import type { MirroredAssetResult, PullMediaResult, RemoteStorageKeyIndex } from './types.js';
+/**
+ * Pulls media referenced by a specific article (by ULID or file path).
+ */
+export declare function pullArticleMedia(options: {
+    workspaceRoot: string;
+    origin: string;
+    token: string;
+    refreshToken?: string;
+    article: string;
+    collection?: string;
+    downloadFiles?: boolean;
+    fetchFn?: typeof fetch;
+    cache?: CacheDatabase;
+}): Promise<PullMediaResult>;
+/**
+ * Mirrors only the assets a batch of pulled articles actually references, reusing the records the lightweight
+ * index walk already fetched instead of paying for a per-asset `GET /_emdash/api/media/{id}`.
+ *
+ * This is the mirror half of the default-ON local-first pull: the walk phase builds `RemoteStorageKeyIndex`
+ * (JSON only, no binaries), and this phase downloads the binary + companion YAML for exactly the storageKeys
+ * found in article bodies. A key the walk did not report is NOT proof of a missing record — the record can
+ * exist under a different primary key while the body carries an R2 storageKey — so it is re-checked against
+ * confirmed evidence only (a walked record resolved under that exact ULID, or local mirror metadata) and what
+ * still fails is reported as `orphanStorageKeys`. Emit never fetches such an asset and never registers one.
+ */
+export declare function mirrorReferencedAssetsFromIndex(referencedStorageKeys: Iterable<string>, index: RemoteStorageKeyIndex, options: {
+    workspaceRoot: string;
+    origin: string;
+    token: string;
+    refreshToken?: string;
+    downloadFiles?: boolean;
+    fetchFn?: typeof fetch;
+    cache?: CacheDatabase;
+}): Promise<MirroredAssetResult>;
+//# sourceMappingURL=pull_article.d.ts.map

package/dist/sync/media/pull_article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull_article.d.ts","sourceRoot":"","sources":["../../../src/sync/media/pull_article.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,OAAO,KAAK,EAEV,mBAAmB,EAEnB,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6L3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,+BAA+B,CACnD,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE;IACP,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAuE9B"}

package/dist/sync/media/pull_article.js

@@ -0,0 +1,273 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { unwrapEnvelope } from '../../client/api.js';
+import { ApiError } from '../../client/error.js';
+import { createAuthedFetch } from '../../client/http.js';
+import { extractMediaUlid } from '../../client/mapper.js';
+import { parseMarkdown } from '../../utils/frontmatter.js';
+import { collectArticleReferencedMediaIds, collectArticleStorageKeys } from './body_scan.js';
+import { collectLocalMediaMirrorCandidates } from './companions.js';
+import { syncSingleMediaItem } from './mirror_item.js';
+/**
+ * Pulls media referenced by a specific article (by ULID or file path).
+ */
+export async function pullArticleMedia(options) {
+    const fetchFn = createAuthedFetch(options);
+    const collection = options.collection || 'posts';
+    const downloadFiles = options.downloadFiles !== false;
+    const mediaDir = path.join(options.workspaceRoot, 'media');
+    fs.mkdirSync(mediaDir, { recursive: true });
+    let articleId = options.article;
+    let articleContent = null;
+    // 1. Try resolving as direct file path
+    const directPath = path.isAbsolute(options.article)
+        ? options.article
+        : path.resolve(options.workspaceRoot, options.article);
+    if (fs.existsSync(directPath) && fs.statSync(directPath).isFile()) {
+        articleContent = fs.readFileSync(directPath, 'utf8');
+        try {
+            const parsed = parseMarkdown(articleContent);
+            articleId = parsed.frontmatter.id || articleId;
+        }
+        catch {
+            // Keep articleId as fallback
+        }
+    }
+    else {
+        // 2. Try finding file in draft/published
+        for (const status of ['draft', 'published']) {
+            const statusDir = path.join(options.workspaceRoot, collection, status);
+            if (!fs.existsSync(statusDir))
+                continue;
+            const found = fs
+                .readdirSync(statusDir)
+                .find((f) => f.endsWith('.md') && f.includes(options.article));
+            if (found) {
+                articleContent = fs.readFileSync(path.join(statusDir, found), 'utf8');
+                try {
+                    const parsed = parseMarkdown(articleContent);
+                    articleId = parsed.frontmatter.id || articleId;
+                }
+                catch {
+                    // fallback
+                }
+                break;
+            }
+        }
+    }
+    // 3. If still absent locally, fetch remote article content from EmDash API
+    if (!articleContent) {
+        const url = new URL(`/_emdash/api/content/${collection}/${options.article}`, options.origin);
+        const res = await fetchFn(url.toString(), {
+            headers: {
+                Authorization: `Bearer ${options.token}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!res.ok) {
+            throw new ApiError({
+                message: `Failed to fetch remote article for media resolution: ${res.statusText}`,
+                code: 'ARTICLE_NOT_FOUND',
+                status: res.status,
+                endpoint: url.toString(),
+                suggestion: `Verify that article '${options.article}' exists in collection '${collection}' on remote.`,
+            });
+        }
+        const json = await res.json();
+        const data = unwrapEnvelope(json);
+        const item = (data.item || data);
+        articleId = item.id || options.article;
+        // Build a content string from the remote representation so references can be collected even when
+        // no local file exists yet.
+        const remoteFi = item.featured_image || item.featuredImage;
+        const fiId = extractMediaUlid(remoteFi);
+        const fiPart = fiId ? `featuredImage: ${fiId}\n` : '';
+        const bodyPart = typeof item.content === 'string'
+            ? item.content
+            : JSON.stringify(item.content || item.body || '');
+        articleContent = `---\n${fiPart}---\n${bodyPart}`;
+    }
+    const mediaIds = collectArticleReferencedMediaIds(articleContent);
+    // Body storageKeys are the only handle available when a migrated body bakes the R2 `storageKey`
+    // instead of the D1 record id. They must never be fed to `GET /_emdash/api/media/{id}` as if they
+    // were ids: that lookup keys on the primary key, so it returns 404 for a record that does exist.
+    const storageKeyDescriptors = collectArticleStorageKeys(articleContent);
+    const descriptorsByKey = new Map();
+    for (const descriptor of storageKeyDescriptors) {
+        descriptorsByKey.set(descriptor.storageKey, descriptor);
+    }
+    const allKeys = Array.from(descriptorsByKey.keys()).sort();
+    if (mediaIds.length === 0 && allKeys.length === 0) {
+        return {
+            total: 0,
+            downloaded: 0,
+            skipped: 0,
+            failed: 0,
+            articleId,
+            mediaIds: [],
+            orphanStorageKeys: [],
+        };
+    }
+    let downloadedCount = 0;
+    let skippedCount = 0;
+    // A body ULID that no canonical lookup resolves is the normal shape of a migrated corpus: the URL
+    // carries an R2 storageKey, not a media id. Only a reference that also survives every storageKey
+    // check is a problem, so a failed id lookup alone is never reported as `failed`.
+    let unresolvedIdCount = 0;
+    const recoveredStorageKeys = new Set();
+    // Ids whose canonical lookup succeeded. A body key sharing one of these ULIDs is a confirmed match:
+    // the record exists, it simply carries a storageKey that differs from the one baked into the body.
+    const resolvedRecordIds = new Set();
+    // 1. Canonical path: resolve each referenced media record id and mirror it normally.
+    for (const mId of mediaIds) {
+        try {
+            const mediaUrl = new URL(`/_emdash/api/media/${mId}`, options.origin);
+            const res = await fetchFn(mediaUrl.toString(), {
+                headers: {
+                    Authorization: `Bearer ${options.token}`,
+                    Accept: 'application/json',
+                },
+            });
+            if (!res.ok) {
+                unresolvedIdCount++;
+                continue;
+            }
+            const json = await res.json();
+            const envelope = unwrapEnvelope(json);
+            const item = (envelope.item || envelope);
+            const result = await syncSingleMediaItem({
+                item,
+                mediaDir,
+                origin: options.origin,
+                token: options.token,
+                downloadFiles,
+                fetchFn,
+                cache: options.cache,
+            });
+            if (result.downloaded)
+                downloadedCount++;
+            else if (result.skipped)
+                skippedCount++;
+            resolvedRecordIds.add(mId.toUpperCase());
+            if (item.storageKey)
+                recoveredStorageKeys.add(item.storageKey);
+        }
+        catch {
+            unresolvedIdCount++;
+        }
+    }
+    // 2. Unresolved storageKeys: a body key that no canonical id lookup mirrored is NOT proof of a
+    //    missing record. The record can exist under a different primary key, so Emit re-checks the key
+    //    against confirmed evidence only — a record it just resolved under the same ULID, or the local
+    //    mirror metadata (companion YAML `id` + `storageKey`) — and reports what still fails as
+    //    unresolved. Emit never fetches such an asset and never registers a record for it.
+    const mirrorCandidates = collectLocalMediaMirrorCandidates(mediaDir);
+    const verifiedStorageKeys = [];
+    const orphanStorageKeys = [];
+    for (const key of allKeys) {
+        if (recoveredStorageKeys.has(key))
+            continue;
+        const ulids = (key.match(/[0-9A-HJ-NP-Z]{26}/gi) ?? []).map((u) => u.toUpperCase());
+        // Only two things count as evidence: a record Emit successfully fetched under this exact ULID, or
+        // confirmed local mirror metadata naming it. A body reference alone is never self-confirming — that
+        // is precisely the case where the asset must be reported instead of assumed healthy.
+        const confirmed = ulids.some((ulid) => resolvedRecordIds.has(ulid) || mirrorCandidates.has(ulid));
+        if (confirmed) {
+            verifiedStorageKeys.push(key);
+            continue;
+        }
+        orphanStorageKeys.push(key);
+    }
+    return {
+        total: mediaIds.length + verifiedStorageKeys.length + orphanStorageKeys.length,
+        downloaded: downloadedCount,
+        skipped: skippedCount,
+        failed: orphanStorageKeys.length,
+        unresolvedIds: unresolvedIdCount,
+        articleId,
+        mediaIds,
+        verifiedStorageKeys,
+        orphanStorageKeys,
+    };
+}
+/**
+ * Mirrors only the assets a batch of pulled articles actually references, reusing the records the lightweight
+ * index walk already fetched instead of paying for a per-asset `GET /_emdash/api/media/{id}`.
+ *
+ * This is the mirror half of the default-ON local-first pull: the walk phase builds `RemoteStorageKeyIndex`
+ * (JSON only, no binaries), and this phase downloads the binary + companion YAML for exactly the storageKeys
+ * found in article bodies. A key the walk did not report is NOT proof of a missing record — the record can
+ * exist under a different primary key while the body carries an R2 storageKey — so it is re-checked against
+ * confirmed evidence only (a walked record resolved under that exact ULID, or local mirror metadata) and what
+ * still fails is reported as `orphanStorageKeys`. Emit never fetches such an asset and never registers one.
+ */
+export async function mirrorReferencedAssetsFromIndex(referencedStorageKeys, index, options) {
+    const fetchFn = createAuthedFetch(options);
+    const downloadFiles = options.downloadFiles !== false;
+    const mediaDir = path.join(options.workspaceRoot, 'media');
+    fs.mkdirSync(mediaDir, { recursive: true });
+    const mirroredStorageKeys = new Set();
+    let downloadedCount = 0;
+    let skippedCount = 0;
+    // Walk every referenced key once. A key resolves to a walked record either directly (the walk reported
+    // that exact storageKey) or through a ULID the walk resolved under that record id — the migrated-corpus
+    // case where the body URL bakes an R2 storageKey that differs from the record's own primary key.
+    const referenced = [...referencedStorageKeys];
+    const mirrorCandidates = collectLocalMediaMirrorCandidates(mediaDir);
+    const verifiedStorageKeys = [];
+    const orphanStorageKeys = [];
+    for (const key of referenced) {
+        let item = index.recordsByStorageKey.get(key);
+        if (!item) {
+            // The body key may itself be a record id the walk stored under `recordsById`, or share a ULID with a
+            // walked record. Reuse that record rather than re-fetching it.
+            const ulids = (key.match(/[0-9A-HJ-NP-Z]{26}/gi) ?? []).map((u) => u.toUpperCase());
+            for (const ulid of ulids) {
+                const byId = index.recordsById.get(ulid);
+                if (byId) {
+                    item = byId;
+                    break;
+                }
+            }
+        }
+        if (item) {
+            const result = await syncSingleMediaItem({
+                item,
+                mediaDir,
+                origin: options.origin,
+                token: options.token,
+                downloadFiles,
+                fetchFn,
+                cache: options.cache,
+            });
+            if (result.downloaded)
+                downloadedCount++;
+            else if (result.skipped)
+                skippedCount++;
+            if (item.storageKey)
+                mirroredStorageKeys.add(item.storageKey);
+            mirroredStorageKeys.add(key);
+            continue;
+        }
+        // No walked record owns this key. Only two things count as evidence it is healthy: a local mirror
+        // companion already names the ULID, or the walk stored a matching storageKey. A bare body reference is
+        // never self-confirming — that is precisely the case to report rather than assume healthy.
+        const ulids = (key.match(/[0-9A-HJ-NP-Z]{26}/gi) ?? []).map((u) => u.toUpperCase());
+        const confirmed = index.storageKeys.has(key) ||
+            ulids.some((ulid) => index.recordsById.has(ulid) || mirrorCandidates.has(ulid));
+        if (confirmed) {
+            verifiedStorageKeys.push(key);
+        }
+        else {
+            orphanStorageKeys.push(key);
+        }
+    }
+    return {
+        mirroredStorageKeys,
+        downloaded: downloadedCount,
+        skipped: skippedCount,
+        verifiedStorageKeys,
+        orphanStorageKeys,
+    };
+}
+//# sourceMappingURL=pull_article.js.map

package/dist/sync/media/pull_article.js.map

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

package/dist/sync/media/pull_library.d.ts

@@ -0,0 +1,12 @@
+import { type PullMediaOptions, type PullMediaResult } from './types.js';
+/**
+ * Pulls media metadata and files from EmDash API into media/ directory with cursor pagination.
+ * media/<markdownRef>.yaml
+ * media/<markdownRef>.<ext>
+ *
+ * `markdownRef` is the sanitized storageKey basename (`storageKeyToMarkdownRef`), never the record id, so the
+ * mirror on disk shares one stem with the body URL that references it; the original `filename` survives only
+ * inside the companion YAML. See `mediaMirrorNames()` for the full naming and collision rule.
+ */
+export declare function pullMedia(options: PullMediaOptions): Promise<PullMediaResult>;
+//# sourceMappingURL=pull_library.d.ts.map

package/dist/sync/media/pull_library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull_library.d.ts","sourceRoot":"","sources":["../../../src/sync/media/pull_library.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4PnF"}