emdash-emit 0.1.16 → 0.1.18

package/dist/sync/push/preflight_stage.js

@@ -0,0 +1,40 @@
+/*
+ * 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 { runPreflightChecks } from '../preflight.js';
+import { PushValidationError } from './guards.js';
+export function executePreflightStage(targetFilePath, parsed, options, syncState, baseSnapshot, knownTaxonomies) {
+    const preflight = runPreflightChecks(targetFilePath, parsed, {
+        allowPublish: options.allowPublish,
+        knownTaxonomies,
+        baseMarkdown: baseSnapshot?.bodyMarkdown,
+        previousStatus: syncState?.status || 'draft',
+        workspaceRoot: options.workspaceRoot,
+        cache: options.cache,
+    });
+    if (!preflight.valid) {
+        throw new PushValidationError(`Push blocked by Preflight Guards (${preflight.errors.length} error(s)).`, preflight.errors);
+    }
+    // Update parsed with cleaned body (e.g. trimmed duplicate heading)
+    parsed.body = preflight.cleanedBody;
+    return preflight;
+}
+//# sourceMappingURL=preflight_stage.js.map

package/dist/sync/push/preflight_stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight_stage.js","sourceRoot":"","sources":["../../../src/sync/push/preflight_stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAwB,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,UAAU,qBAAqB,CACnC,cAAsB,EACtB,MAAsB,EACtB,OAAoB,EACpB,SAAuC,EACvC,YAA6C,EAC7C,eAA0C;IAE1C,MAAM,SAAS,GAAG,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE;QAC3D,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,eAAe;QACf,YAAY,EAAE,YAAY,EAAE,YAAY;QACxC,cAAc,EAAG,SAAS,EAAE,MAAgC,IAAI,OAAO;QACvE,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,IAAI,mBAAmB,CAC3B,qCAAqC,SAAS,CAAC,MAAM,CAAC,MAAM,aAAa,EACzE,SAAS,CAAC,MAAM,CACjB,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC;IAEpC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/sync/push/tax_audit.d.ts

@@ -0,0 +1,24 @@
+import type { BaseSnapshot, SyncState } from '../../db/cache.js';
+import type { ParsedMarkdown } from '../../utils/frontmatter.js';
+import type { PushOptions } from './types.js';
+export interface TaxonomyAuditResult {
+    remoteTaxAudit: {
+        categories: string[] | null;
+        tags: string[] | null;
+    } | null;
+    taxonomyDivergenceDetected: boolean;
+}
+/**
+ * Pre-PUT Taxonomy Audit to detect out-of-band remote taxonomy changes before updating an article.
+ */
+export declare function auditRemoteTaxonomies(params: {
+    collection: string;
+    id: string;
+    parsed: ParsedMarkdown;
+    syncState: SyncState | null | undefined;
+    baseSnapshot: BaseSnapshot | null | undefined;
+    options: PushOptions;
+    fetchFn: typeof fetch;
+    warnings: string[];
+}): Promise<TaxonomyAuditResult>;
+//# sourceMappingURL=tax_audit.d.ts.map

package/dist/sync/push/tax_audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax_audit.d.ts","sourceRoot":"","sources":["../../../src/sync/push/tax_audit.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9E,0BAA0B,EAAE,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwD/B"}

package/dist/sync/push/tax_audit.js

@@ -0,0 +1,70 @@
+/*
+ * 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 { readBaselineFrontmatter } from '../../db/baseline.js';
+import { fetchAssignedTaxonomies, computeTaxonomyHash } from '../terms.js';
+/**
+ * Pre-PUT Taxonomy Audit to detect out-of-band remote taxonomy changes before updating an article.
+ */
+export async function auditRemoteTaxonomies(params) {
+    const { collection, id, parsed, syncState, baseSnapshot, options, fetchFn, warnings } = params;
+    let remoteTaxAudit = null;
+    let taxonomyDivergenceDetected = false;
+    const baseFm = readBaselineFrontmatter(baseSnapshot);
+    const hasLocalTaxonomies = Boolean(parsed.frontmatter.taxonomies &&
+        (parsed.frontmatter.taxonomies.categories !== undefined ||
+            parsed.frontmatter.taxonomies.tags !== undefined));
+    const hasBaseTaxonomies = Boolean(baseFm?.taxonomies && (baseFm.taxonomies.categories || baseFm.taxonomies.tags));
+    if ((hasLocalTaxonomies || hasBaseTaxonomies) && !options.noTaxonomyAudit) {
+        remoteTaxAudit = await fetchAssignedTaxonomies({
+            origin: options.origin,
+            token: options.token,
+            collection,
+            id,
+            fetchFn,
+        });
+        if (remoteTaxAudit.categories === null && remoteTaxAudit.tags === null) {
+            warnings.push('⚠️ Remote taxonomy state unknown (could not audit remote terms).');
+        }
+        else {
+            if (remoteTaxAudit.categories === null) {
+                warnings.push('⚠️ Remote category taxonomy state unknown (could not audit categories).');
+            }
+            if (remoteTaxAudit.tags === null) {
+                warnings.push('⚠️ Remote tag taxonomy state unknown (could not audit tags).');
+            }
+            const baselineTaxHash = syncState?.remoteTaxonomyHash ||
+                (baseFm?.taxonomies
+                    ? computeTaxonomyHash(baseFm.taxonomies.categories, baseFm.taxonomies.tags)
+                    : null);
+            const currentRemoteCats = remoteTaxAudit.categories !== null
+                ? remoteTaxAudit.categories
+                : baseFm?.taxonomies?.categories || [];
+            const currentRemoteTags = remoteTaxAudit.tags !== null ? remoteTaxAudit.tags : baseFm?.taxonomies?.tags || [];
+            const currentRemoteTaxHash = computeTaxonomyHash(currentRemoteCats, currentRemoteTags);
+            if (baselineTaxHash && currentRemoteTaxHash !== baselineTaxHash) {
+                taxonomyDivergenceDetected = true;
+            }
+        }
+    }
+    return { remoteTaxAudit, taxonomyDivergenceDetected };
+}
+//# sourceMappingURL=tax_audit.js.map

package/dist/sync/push/tax_audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax_audit.js","sourceRoot":"","sources":["../../../src/sync/push/tax_audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQ3E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAS3C;IACC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE/F,IAAI,cAAc,GAAkE,IAAI,CAAC;IACzF,IAAI,0BAA0B,GAAG,KAAK,CAAC;IAEvC,MAAM,MAAM,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,kBAAkB,GAAG,OAAO,CAChC,MAAM,CAAC,WAAW,CAAC,UAAU;QAC7B,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS;YACrD,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CACpD,CAAC;IACF,MAAM,iBAAiB,GAAG,OAAO,CAC/B,MAAM,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAC/E,CAAC;IAEF,IAAI,CAAC,kBAAkB,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAC1E,cAAc,GAAG,MAAM,uBAAuB,CAAC;YAC7C,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU;YACV,EAAE;YACF,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,cAAc,CAAC,UAAU,KAAK,IAAI,IAAI,cAAc,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACvE,QAAQ,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QACpF,CAAC;aAAM,CAAC;YACN,IAAI,cAAc,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;YAC3F,CAAC;YACD,IAAI,cAAc,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;YAChF,CAAC;YACD,MAAM,eAAe,GACnB,SAAS,EAAE,kBAAkB;gBAC7B,CAAC,MAAM,EAAE,UAAU;oBACjB,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;oBAC3E,CAAC,CAAC,IAAI,CAAC,CAAC;YAEZ,MAAM,iBAAiB,GACrB,cAAc,CAAC,UAAU,KAAK,IAAI;gBAChC,CAAC,CAAC,cAAc,CAAC,UAAU;gBAC3B,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,IAAI,EAAE,CAAC;YAC3C,MAAM,iBAAiB,GACrB,cAAc,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC;YAEtF,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;YAEvF,IAAI,eAAe,IAAI,oBAAoB,KAAK,eAAe,EAAE,CAAC;gBAChE,0BAA0B,GAAG,IAAI,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,CAAC;AACxD,CAAC"}

package/dist/sync/push/taxonomy_plan.d.ts

@@ -0,0 +1,36 @@
+import type { BaseSnapshot } from '../../db/cache.js';
+import type { ParsedMarkdown } from '../../utils/frontmatter.js';
+import type { loadLocalTaxonomyMaps } from '../taxonomies.js';
+import type { PushOptions, ResolvedTaxonomyItem } from './types.js';
+export interface TaxonomyPlanResult {
+    resolvedTaxonomies: {
+        categories?: ResolvedTaxonomyItem[];
+        tags?: ResolvedTaxonomyItem[];
+        [taxonomy: string]: ResolvedTaxonomyItem[] | undefined;
+    };
+}
+/**
+ * Canonicalizes frontmatter taxonomy terms in-place before preflight and payload creation.
+ */
+export declare function canonicalizeFrontmatterTaxonomies(parsed: ParsedMarkdown, taxonomyMaps: ReturnType<typeof loadLocalTaxonomyMaps>): TaxonomyPlanResult;
+export interface TaxonomySyncFailure {
+    taxonomy: string;
+    status: number;
+    error: string;
+    endpoint: string;
+}
+/**
+ * Synchronizes taxonomy assignments for an article via dedicated terms endpoints.
+ */
+export declare function syncArticleTaxonomies(params: {
+    articleId: string;
+    collection: string;
+    parsed: ParsedMarkdown;
+    taxonomyMaps: ReturnType<typeof loadLocalTaxonomyMaps>;
+    resolvedTaxonomies: TaxonomyPlanResult['resolvedTaxonomies'];
+    baseSnapshot: BaseSnapshot | null | undefined;
+    options: PushOptions;
+    fetchFn: typeof fetch;
+    warnings: string[];
+}): Promise<TaxonomySyncFailure[]>;
+//# sourceMappingURL=taxonomy_plan.d.ts.map

package/dist/sync/push/taxonomy_plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy_plan.d.ts","sourceRoot":"","sources":["../../../src/sync/push/taxonomy_plan.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE;QAClB,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;QACpC,IAAI,CAAC,EAAE,oBAAoB,EAAE,CAAC;QAC9B,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,EAAE,GAAG,SAAS,CAAC;KACxD,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,GACrD,kBAAkB,CA6CpB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACvD,kBAAkB,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;IAC7D,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAuFjC"}

package/dist/sync/push/taxonomy_plan.js

@@ -0,0 +1,136 @@
+/*
+ * 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 { articleTermsEndpoint } from '../../client/endpoints.js';
+import { readBaselineFrontmatter } from '../../db/baseline.js';
+/**
+ * Canonicalizes frontmatter taxonomy terms in-place before preflight and payload creation.
+ */
+export function canonicalizeFrontmatterTaxonomies(parsed, taxonomyMaps) {
+    const resolvedTaxonomies = {};
+    const canonicalizeTerms = (taxName, terms) => {
+        const list = [];
+        const canonicalized = terms.map((term) => {
+            // 1. If term is a ULID in idToSlug
+            if (taxonomyMaps.idToSlug[taxName]?.[term]) {
+                const canonicalSlug = taxonomyMaps.idToSlug[taxName][term];
+                list.push({ input: term, resolved: canonicalSlug, id: term });
+                return canonicalSlug;
+            }
+            // 2. If term is in slugToId (can be canonical slug, decoded slug, or human name alias)
+            const id = taxonomyMaps.slugToId[taxName]?.[term];
+            if (id && taxonomyMaps.idToSlug[taxName]?.[id]) {
+                const canonicalSlug = taxonomyMaps.idToSlug[taxName][id];
+                if (term !== canonicalSlug) {
+                    list.push({ input: term, resolved: canonicalSlug, id });
+                }
+                return canonicalSlug;
+            }
+            return term;
+        });
+        if (list.length > 0) {
+            resolvedTaxonomies[taxName === 'category' ? 'categories' : 'tags'] = list;
+        }
+        return canonicalized;
+    };
+    if (parsed.frontmatter.taxonomies) {
+        if (parsed.frontmatter.taxonomies.categories) {
+            parsed.frontmatter.taxonomies.categories = canonicalizeTerms('category', parsed.frontmatter.taxonomies.categories);
+        }
+        if (parsed.frontmatter.taxonomies.tags) {
+            parsed.frontmatter.taxonomies.tags = canonicalizeTerms('tag', parsed.frontmatter.taxonomies.tags);
+        }
+    }
+    return { resolvedTaxonomies };
+}
+/**
+ * Synchronizes taxonomy assignments for an article via dedicated terms endpoints.
+ */
+export async function syncArticleTaxonomies(params) {
+    const { articleId, collection, parsed, taxonomyMaps, resolvedTaxonomies, baseSnapshot, options, fetchFn, warnings, } = params;
+    const failures = [];
+    if (!parsed.frontmatter.taxonomies)
+        return failures;
+    const taxMaps = taxonomyMaps;
+    const updateTaxonomy = async (taxonomyName, termSlugsOrIds) => {
+        const slugMap = taxMaps.slugToId[taxonomyName] || {};
+        const idMap = taxMaps.idToSlug[taxonomyName] || {};
+        const resolvedTermIds = Array.from(new Set(termSlugsOrIds
+            .map((item) => {
+            // 1. If item is already a known ULID, preserve it directly to avoid silent substitution
+            if (idMap[item])
+                return item;
+            // 2. If item was canonicalized from a specific ULID or alias, preserve the bound term ID
+            const tracked = resolvedTaxonomies[taxonomyName === 'category' ? 'categories' : 'tags'];
+            const match = tracked?.find((t) => t.resolved === item);
+            if (match?.id)
+                return match.id;
+            // 3. Fallback to slugMap
+            return slugMap[item] || item;
+        })
+            .filter((tid) => Boolean(tid))));
+        if (resolvedTermIds.length === 0) {
+            // Check if remote previously had assignments in baseline
+            const baseFm = readBaselineFrontmatter(baseSnapshot);
+            const prevTerms = taxonomyName === 'category' ? baseFm?.taxonomies?.categories : baseFm?.taxonomies?.tags;
+            if (prevTerms && prevTerms.length > 0) {
+                if (!options.allowWipeTaxonomies && !options.force && !options.resolveTaxonomy) {
+                    throw new ApiError({
+                        endpoint: `/_emdash/api/content/${collection}/${articleId}/terms/${taxonomyName}`,
+                        code: 'DESTRUCTIVE_TAXONOMY_WIPE',
+                        status: 400,
+                        message: `Local article specified empty array for ${taxonomyName}, which would remove ${prevTerms.length} existing remote assignment(s).`,
+                        suggestion: `Pass --allow-wipe-taxonomies (or --force) to confirm wiping all ${taxonomyName} assignments.`,
+                    });
+                }
+                warnings.push(`🏷️ Cleared all ${prevTerms.length} ${taxonomyName} assignment(s) from remote (local specified empty array).`);
+            }
+        }
+        const termsUrl = articleTermsEndpoint(options.origin, collection, articleId, taxonomyName);
+        const termRes = await fetchFn(termsUrl, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${options.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ termIds: resolvedTermIds }),
+        });
+        if (!termRes.ok) {
+            const errBody = await termRes.text().catch(() => '');
+            failures.push({
+                taxonomy: taxonomyName,
+                status: termRes.status,
+                error: errBody || termRes.statusText,
+                endpoint: termsUrl,
+            });
+            warnings.push(`Failed to update ${taxonomyName} terms: ${termRes.statusText} ${errBody}`);
+        }
+    };
+    if (parsed.frontmatter.taxonomies.categories) {
+        await updateTaxonomy('category', parsed.frontmatter.taxonomies.categories);
+    }
+    if (parsed.frontmatter.taxonomies.tags) {
+        await updateTaxonomy('tag', parsed.frontmatter.taxonomies.tags);
+    }
+    return failures;
+}
+//# sourceMappingURL=taxonomy_plan.js.map

package/dist/sync/push/taxonomy_plan.js.map

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

package/dist/sync/push/transport.d.ts

@@ -0,0 +1,10 @@
+import type { PushOptions } from './types.js';
+/**
+ * Transitions article publish/draft status via dedicated EmDash endpoints.
+ */
+export declare function transitionContentStatus(collection: string, id: string, targetStatus: 'draft' | 'published', currentRev: string, publishedAt: string | null | undefined, options: PushOptions, fetchFn: typeof fetch): Promise<string>;
+/**
+ * Standardized error thrower when a remote article 404s or 410s on update.
+ */
+export declare function throwRemoteArticleDeleted(collection: string, id: string, targetFilePath: string, endpoint: string): never;
+//# sourceMappingURL=transport.d.ts.map

package/dist/sync/push/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/sync/push/transport.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,OAAO,GAAG,WAAW,EACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,KAAK,CAYP"}

package/dist/sync/push/transport.js

@@ -0,0 +1,74 @@
+/*
+ * 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 { extractRev } from '../../client/api.js';
+import { articleStatusTransitionEndpoint } from '../../client/endpoints.js';
+/**
+ * Transitions article publish/draft status via dedicated EmDash endpoints.
+ */
+export async function transitionContentStatus(collection, id, targetStatus, currentRev, publishedAt, options, fetchFn) {
+    const isPublishing = targetStatus === 'published';
+    const endpoint = articleStatusTransitionEndpoint(options.origin, collection, id, isPublishing ? 'publish' : 'unpublish');
+    const body = { _rev: currentRev };
+    if (isPublishing && publishedAt) {
+        body.publishedAt = publishedAt;
+    }
+    const res = await fetchFn(endpoint, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${options.token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const errText = await res.text().catch(() => '');
+        throw new ApiError({
+            message: `Failed to ${isPublishing ? 'publish' : 'unpublish'} content: ${res.statusText}${errText ? ` - ${errText}` : ''}`,
+            code: isPublishing ? 'PUBLISH_FAILED' : 'UNPUBLISH_FAILED',
+            status: res.status,
+            endpoint,
+            suggestion: isPublishing
+                ? 'Verify publish permissions and revision state.'
+                : 'Verify unpublish permissions and revision state.',
+        });
+    }
+    const json = (await res.json().catch(() => ({})));
+    return extractRev(json, currentRev);
+}
+/**
+ * Standardized error thrower when a remote article 404s or 410s on update.
+ */
+export function throwRemoteArticleDeleted(collection, id, targetFilePath, endpoint) {
+    throw new ApiError({
+        endpoint,
+        code: 'REMOTE_ARTICLE_DELETED',
+        status: 404,
+        message: `Article ${id} (${targetFilePath}) was deleted on the remote server.`,
+        suggestion: [
+            '1. Keep your edits and re-create as a new article: remove the `id:` field from frontmatter, then "emit push <file>".',
+            `2. Discard local edits and untrack: "emit pull ${id} --force"   (local copy is preserved under posts/conflicts/)`,
+            `3. Delete with rescue backup: "emit delete ${targetFilePath} --discard-local-edits"`,
+        ].join('\n  '),
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/sync/push/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/sync/push/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAG5E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAkB,EAClB,EAAU,EACV,YAAmC,EACnC,UAAkB,EAClB,WAAsC,EACtC,OAAoB,EACpB,OAAqB;IAErB,MAAM,YAAY,GAAG,YAAY,KAAK,WAAW,CAAC;IAClD,MAAM,QAAQ,GAAG,+BAA+B,CAC9C,OAAO,CAAC,MAAM,EACd,UAAU,EACV,EAAE,EACF,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CACvC,CAAC;IAEF,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC3D,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE;QAClC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,OAAO,CAAC,KAAK,EAAE;YACxC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACjD,MAAM,IAAI,QAAQ,CAAC;YACjB,OAAO,EAAE,aAAa,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,aAAa,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1H,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,kBAAkB;YAC1D,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ;YACR,UAAU,EAAE,YAAY;gBACtB,CAAC,CAAC,gDAAgD;gBAClD,CAAC,CAAC,kDAAkD;SACvD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAA4B,CAAC;IAC7E,OAAO,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,EAAU,EACV,cAAsB,EACtB,QAAgB;IAEhB,MAAM,IAAI,QAAQ,CAAC;QACjB,QAAQ;QACR,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,qCAAqC;QAC9E,UAAU,EAAE;YACV,sHAAsH;YACtH,kDAAkD,EAAE,8DAA8D;YAClH,8CAA8C,cAAc,yBAAyB;SACtF,CAAC,IAAI,CAAC,MAAM,CAAC;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/sync/push/types.d.ts

@@ -0,0 +1,62 @@
+import type { MapperOptions } from '../../client/mapper.js';
+import type { CacheDatabase } from '../../db/cache.js';
+import type { TaxonomyCandidates } from '../../utils/frontmatter.js';
+import type { PreflightError } from '../preflight.js';
+export type TaxonomyResolutionStrategy = 'union' | 'local' | 'remote';
+export interface PushOptions extends MapperOptions {
+    workspaceRoot: string;
+    cache: CacheDatabase;
+    origin: string;
+    token: string;
+    refreshToken?: string;
+    fetchFn?: typeof fetch;
+    allowPublish?: boolean;
+    knownTaxonomies?: Record<string, string[]>;
+    candidates?: TaxonomyCandidates;
+    resolveTaxonomy?: TaxonomyResolutionStrategy;
+    force?: boolean;
+    /**
+     * Explicit confirmation required to clear all remote assignments for a taxonomy.
+     */
+    allowWipeTaxonomies?: boolean;
+    /**
+     * Skip pre-PUT audit of remote taxonomy assignments (defaults to false).
+     */
+    noTaxonomyAudit?: boolean;
+    /**
+     * Allow push even if unapplied taxonomy updates remain pending in sync_state.
+     */
+    allowUnappliedTaxonomies?: boolean;
+    /**
+     * Explicit confirmation required to push an article that is marked delete_pending.
+     */
+    revive?: boolean;
+    /**
+     * Write mirrored body images into the local file as article-relative `../../media/<storageKey>` references,
+     * at the depth derived from the article's own path.
+     */
+    localMediaRefs?: boolean;
+}
+export interface ResolvedTaxonomyItem {
+    input: string;
+    resolved: string;
+    id?: string;
+}
+export interface PushResult {
+    success: boolean;
+    id: string;
+    rev: string;
+    filePath: string;
+    previousId?: string;
+    previousFilePath?: string;
+    conflict: boolean;
+    taxonomyConflict?: boolean;
+    warnings: string[];
+    errors?: PreflightError[];
+    resolvedTaxonomies?: {
+        categories?: ResolvedTaxonomyItem[];
+        tags?: ResolvedTaxonomyItem[];
+        [taxonomy: string]: ResolvedTaxonomyItem[] | undefined;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sync/push/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sync/push/types.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,eAAe,CAAC,EAAE,0BAA0B,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE;QACnB,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;QACpC,IAAI,CAAC,EAAE,oBAAoB,EAAE,CAAC;QAC9B,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,EAAE,GAAG,SAAS,CAAC;KACxD,CAAC;CACH"}

package/dist/sync/push/types.js

@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sync/push/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sync/push/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/sync/push.d.ts

@@ -1,60 +1,5 @@
-import type { CacheDatabase } from '../db/cache.js';
-import { type MapperOptions } from '../client/mapper.js';
-import { type TaxonomyCandidates } from '../utils/frontmatter.js';
-import { type PreflightError } from './preflight.js';
-export type TaxonomyResolutionStrategy = 'union' | 'local' | 'remote';
-export interface PushOptions extends MapperOptions {
-    workspaceRoot: string;
-    cache: CacheDatabase;
-    origin: string;
-    token: string;
-    refreshToken?: string;
-    fetchFn?: typeof fetch;
-    candidates?: TaxonomyCandidates;
-    knownTaxonomies?: Record<string, string[]>;
-    resolveTaxonomy?: TaxonomyResolutionStrategy;
-    allowWipeTaxonomies?: boolean;
-    allowUnappliedTaxonomies?: boolean;
-    revive?: boolean;
-    force?: boolean;
-    noTaxonomyAudit?: boolean;
-    /**
-     * Accept body images spelled as local mirror references — article-relative `../../media/<storageKey>` or the
-     * older depth-free `media/<storageKey>` — and rewrite them to the canonical
-     * `/_emdash/api/media/file/<storageKey>` URL before anything reaches EmDash. The cache baseline stores the
-     * canonical form too, so a local-ref workspace never reports a phantom diff.
-     */
-    localMediaRefs?: boolean;
-}
-export interface ResolvedTaxonomyItem {
-    input: string;
-    resolved: string;
-    id: string;
-}
-export interface PushResult {
-    success: boolean;
-    id: string;
-    rev: string;
-    filePath: string;
-    previousId?: string;
-    previousFilePath?: string;
-    conflict: boolean;
-    taxonomyConflict?: boolean;
-    warnings: string[];
-    errors?: PreflightError[];
-    resolvedTaxonomies?: {
-        categories?: ResolvedTaxonomyItem[];
-        tags?: ResolvedTaxonomyItem[];
-        [taxonomy: string]: ResolvedTaxonomyItem[] | undefined;
-    };
-}
-export declare class PushValidationError extends Error {
-    errors: PreflightError[];
-    constructor(message: string, errors: PreflightError[]);
-}
 /**
- * Pushes a local markdown article to remote EmDash with full preflight guards,
- * two-tier lock lease protection, and automatic 3-way merge on conflict.
+ * Re-exports pushArticle and push pipeline stages including [LOCAL_IMAGE_AUTO_UPLOAD] guards.
  */
-export declare function pushArticle(targetFilePath: string, options: PushOptions): Promise<PushResult>;
+export * from './push/index.js';
 //# sourceMappingURL=push.d.ts.map

package/dist/sync/push.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/sync/push.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAQL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAgD,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAqBnG,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,eAAe,CAAC,EAAE,0BAA0B,CAAC;IAC7C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE;QACnB,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;QACpC,IAAI,CAAC,EAAE,oBAAoB,EAAE,CAAC;QAC9B,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,EAAE,GAAG,SAAS,CAAC;KACxD,CAAC;CACH;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IACrC,MAAM,EAAE,cAAc,EAAE,CAAC;IAEhC,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAIpD;CACF;AA0aD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAkgCrB"}
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/sync/push.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,cAAc,iBAAiB,CAAC"}