@sprinterai/runtime 0.6.0 → 0.8.0

package/dist/feed/types.d.ts.map

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

package/dist/feed/types.js

@@ -0,0 +1,6 @@
+/**
+ * Feed system types for activity aggregation, ranking, and digest generation.
+ * Supports time-based filtering, personalized ranking, and daily digest summaries.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/feed/types.js.map

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

package/dist/import/batch-upsert.d.ts

@@ -0,0 +1,18 @@
+import type { CreateEntityInput, EntityRecord, UpdateEntityInput } from '@sprinterai/core';
+import type { BatchUpsertResult, ParsedRow, UpsertOptions } from './types.js';
+import { type ImportMatchStore } from './upsert-matcher.js';
+/** Store interface required for batch upsert operations. */
+export interface ImportEntityStore extends ImportMatchStore {
+    getEntityContent(id: string): Promise<Record<string, unknown>>;
+    createEntity(input: CreateEntityInput): Promise<EntityRecord>;
+    updateEntity(id: string, input: UpdateEntityInput): Promise<EntityRecord>;
+}
+/**
+ * Upsert a batch of parsed rows into the entity store.
+ *
+ * Rows are matched against existing entities using the provided `matchKey`.
+ * Matched rows are updated (with optional content merge), unmatched rows are created.
+ * Rows with an empty match-key value are skipped entirely.
+ */
+export declare function batchUpsertEntities(store: ImportEntityStore, typeSlug: string, rows: ParsedRow[], options: UpsertOptions): Promise<BatchUpsertResult>;
+//# sourceMappingURL=batch-upsert.d.ts.map

package/dist/import/batch-upsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-upsert.d.ts","sourceRoot":"","sources":["../../src/import/batch-upsert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQ7E,4DAA4D;AAC5D,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9D,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3E;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,EAAE,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAoE5B"}

package/dist/import/batch-upsert.js

@@ -0,0 +1,67 @@
+import { mergeContent } from './merge-content.js';
+import { matchRowsForUpsert } from './upsert-matcher.js';
+const UPSERT_BATCH_SIZE = 25;
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : 'Unknown error';
+}
+/**
+ * Upsert a batch of parsed rows into the entity store.
+ *
+ * Rows are matched against existing entities using the provided `matchKey`.
+ * Matched rows are updated (with optional content merge), unmatched rows are created.
+ * Rows with an empty match-key value are skipped entirely.
+ */
+export async function batchUpsertEntities(store, typeSlug, rows, options) {
+    const { matched, skippedCount } = await matchRowsForUpsert(store, typeSlug, rows, options.matchKey);
+    let created = 0;
+    let updated = 0;
+    const skipped = skippedCount;
+    let failed = 0;
+    const errors = [];
+    const toCreate = matched.filter((m) => !m.skipped && m.existingId === null);
+    const toUpdate = matched.filter((m) => !m.skipped && m.existingId !== null);
+    // --- Batch creates ---
+    for (let i = 0; i < toCreate.length; i += UPSERT_BATCH_SIZE) {
+        const batch = toCreate.slice(i, i + UPSERT_BATCH_SIZE);
+        const results = await Promise.allSettled(batch.map(({ row }) => store.createEntity({
+            typeSlug,
+            title: row.title,
+            content: row.content,
+            tags: row.tags ?? [],
+        })));
+        for (const [index, result] of results.entries()) {
+            if (result.status === 'fulfilled') {
+                created++;
+            }
+            else {
+                failed++;
+                const globalIndex = rows.indexOf(toCreate[i + index].row) + 1;
+                errors.push(`Row ${globalIndex}: ${toErrorMessage(result.reason)}`);
+            }
+        }
+    }
+    // --- Batch updates ---
+    for (let i = 0; i < toUpdate.length; i += UPSERT_BATCH_SIZE) {
+        const batch = toUpdate.slice(i, i + UPSERT_BATCH_SIZE);
+        const results = await Promise.allSettled(batch.map(async ({ row, existingId }) => {
+            const existingContent = await store.getEntityContent(existingId);
+            const mergedContent = mergeContent(existingContent, row.content, options.overwrite);
+            return store.updateEntity(existingId, {
+                content: mergedContent,
+                ...(options.overwrite ? { title: row.title } : {}),
+            });
+        }));
+        for (const [index, result] of results.entries()) {
+            if (result.status === 'fulfilled') {
+                updated++;
+            }
+            else {
+                failed++;
+                const globalIndex = rows.indexOf(toUpdate[i + index].row) + 1;
+                errors.push(`Row ${globalIndex}: ${toErrorMessage(result.reason)}`);
+            }
+        }
+    }
+    return { created, updated, skipped, failed, errors };
+}
+//# sourceMappingURL=batch-upsert.js.map

package/dist/import/batch-upsert.js.map

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

package/dist/import/index.d.ts

@@ -0,0 +1,7 @@
+export type { ParsedRow, UpsertOptions, BatchUpsertResult } from './types.js';
+export { mergeContent } from './merge-content.js';
+export type { ImportMatchStore, MatchedRow, UpsertMatchResult } from './upsert-matcher.js';
+export { matchRowsForUpsert } from './upsert-matcher.js';
+export type { ImportEntityStore } from './batch-upsert.js';
+export { batchUpsertEntities } from './batch-upsert.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/import/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/import/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/import/index.js

@@ -0,0 +1,4 @@
+export { mergeContent } from './merge-content.js';
+export { matchRowsForUpsert } from './upsert-matcher.js';
+export { batchUpsertEntities } from './batch-upsert.js';
+//# sourceMappingURL=index.js.map

package/dist/import/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/import/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/import/merge-content.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Merge import row content into existing entity content.
+ *
+ * By default only sets fields that are empty in the existing entity.
+ * When `overwrite` is true, all non-empty import values overwrite existing ones.
+ */
+export declare function mergeContent(existing: Record<string, unknown>, incoming: Record<string, unknown>, overwrite: boolean): Record<string, unknown>;
+//# sourceMappingURL=merge-content.d.ts.map

package/dist/import/merge-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-content.d.ts","sourceRoot":"","sources":["../../src/import/merge-content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,EAAE,OAAO,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}

package/dist/import/merge-content.js

@@ -0,0 +1,20 @@
+/**
+ * Merge import row content into existing entity content.
+ *
+ * By default only sets fields that are empty in the existing entity.
+ * When `overwrite` is true, all non-empty import values overwrite existing ones.
+ */
+export function mergeContent(existing, incoming, overwrite) {
+    const merged = { ...existing };
+    for (const [key, value] of Object.entries(incoming)) {
+        if (value === null || value === undefined || value === '')
+            continue;
+        const existingVal = existing[key];
+        const isEmpty = existingVal === null || existingVal === undefined || existingVal === '';
+        if (overwrite || isEmpty) {
+            merged[key] = value;
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=merge-content.js.map

package/dist/import/merge-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-content.js","sourceRoot":"","sources":["../../src/import/merge-content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAiC,EACjC,QAAiC,EACjC,SAAkB;IAElB,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QACpE,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,EAAE,CAAC;QACxF,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/import/merge-content.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=merge-content.test.d.ts.map

package/dist/import/merge-content.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-content.test.d.ts","sourceRoot":"","sources":["../../src/import/merge-content.test.ts"],"names":[],"mappings":""}

package/dist/import/merge-content.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect } from 'vitest';
+import { mergeContent } from './merge-content.js';
+describe('mergeContent', () => {
+    it('fills empty fields when overwrite is false', () => {
+        const existing = { name: 'Alice', score: null };
+        const incoming = { name: 'Bob', score: 42, tag: 'vip' };
+        const result = mergeContent(existing, incoming, false);
+        expect(result.name).toBe('Alice'); // not overwritten
+        expect(result.score).toBe(42); // filled (was null)
+        expect(result.tag).toBe('vip'); // filled (was missing)
+    });
+    it('overwrites all non-empty values when overwrite is true', () => {
+        const existing = { name: 'Alice', score: 10 };
+        const incoming = { name: 'Bob', score: 99 };
+        const result = mergeContent(existing, incoming, true);
+        expect(result.name).toBe('Bob');
+        expect(result.score).toBe(99);
+    });
+    it('skips null incoming values regardless of overwrite flag', () => {
+        const existing = { name: 'Alice' };
+        const incoming = { name: null, extra: null };
+        expect(mergeContent(existing, incoming, true).name).toBe('Alice');
+        expect(mergeContent(existing, incoming, false).name).toBe('Alice');
+    });
+    it('skips empty string incoming values', () => {
+        const existing = { name: 'Alice' };
+        const incoming = { name: '' };
+        const result = mergeContent(existing, incoming, true);
+        expect(result.name).toBe('Alice');
+    });
+    it('does not mutate the existing object', () => {
+        const existing = { name: 'Alice' };
+        const incoming = { name: 'Bob' };
+        mergeContent(existing, incoming, true);
+        expect(existing.name).toBe('Alice');
+    });
+    it('handles empty existing object', () => {
+        const result = mergeContent({}, { a: 1, b: 'x' }, false);
+        expect(result).toEqual({ a: 1, b: 'x' });
+    });
+    it('handles empty incoming object', () => {
+        const existing = { name: 'Alice' };
+        const result = mergeContent(existing, {}, false);
+        expect(result).toEqual({ name: 'Alice' });
+    });
+    it('preserves existing fields not in incoming', () => {
+        const existing = { a: 1, b: 2 };
+        const incoming = { a: 99 };
+        const result = mergeContent(existing, incoming, true);
+        expect(result.b).toBe(2);
+    });
+});
+//# sourceMappingURL=merge-content.test.js.map

package/dist/import/merge-content.test.js.map

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

package/dist/import/types.d.ts

@@ -0,0 +1,20 @@
+/** A single row of parsed import data (e.g., from CSV or spreadsheet). */
+export interface ParsedRow {
+    title: string;
+    content: Record<string, unknown>;
+    tags?: string[];
+}
+export interface UpsertOptions {
+    /** The field name used to match import rows against existing entities. */
+    matchKey: string;
+    /** When true, non-empty incoming values overwrite existing values. */
+    overwrite: boolean;
+}
+export interface BatchUpsertResult {
+    created: number;
+    updated: number;
+    skipped: number;
+    failed: number;
+    errors: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/import/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/import/types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/import/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/import/types.js.map

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

package/dist/import/upsert-matcher.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Upsert matching logic for the entity import pipeline.
+ *
+ * Given a set of rows and a match-key field, looks up existing entities
+ * via a store and partitions rows into "create" vs "update" buckets.
+ */
+import type { ParsedRow } from './types.js';
+/** Minimal store interface required for import matching. */
+export interface ImportMatchStore {
+    /** List all entities for a given type slug. Used to resolve match keys. */
+    listEntitiesByType(typeSlug: string): Promise<Array<{
+        id: string;
+        title: string | null;
+        content: Record<string, unknown> | null;
+    }>>;
+}
+export interface MatchedRow {
+    row: ParsedRow;
+    existingId: string | null;
+    /** True when the match key cell was empty — skip entirely */
+    skipped: boolean;
+}
+export interface UpsertMatchResult {
+    matched: MatchedRow[];
+    /** Count of rows where the match key column was empty */
+    skippedCount: number;
+}
+/**
+ * Look up existing entities by a match-key field value.
+ *
+ * For each row:
+ *  - If the row's match-key value is empty → mark as skipped
+ *  - If an entity exists with `content[matchKey] === value` → existingId set
+ *  - Otherwise → existingId null (will be created)
+ *
+ * When multiple entities match the same value, the first result wins.
+ */
+export declare function matchRowsForUpsert(store: ImportMatchStore, typeSlug: string, rows: ParsedRow[], matchKey: string): Promise<UpsertMatchResult>;
+//# sourceMappingURL=upsert-matcher.d.ts.map

package/dist/import/upsert-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-matcher.d.ts","sourceRoot":"","sources":["../../src/import/upsert-matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,kBAAkB,CAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;CAClG;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,SAAS,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,EAAE,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CAyD5B"}

package/dist/import/upsert-matcher.js

@@ -0,0 +1,67 @@
+/**
+ * Upsert matching logic for the entity import pipeline.
+ *
+ * Given a set of rows and a match-key field, looks up existing entities
+ * via a store and partitions rows into "create" vs "update" buckets.
+ */
+/**
+ * Look up existing entities by a match-key field value.
+ *
+ * For each row:
+ *  - If the row's match-key value is empty → mark as skipped
+ *  - If an entity exists with `content[matchKey] === value` → existingId set
+ *  - Otherwise → existingId null (will be created)
+ *
+ * When multiple entities match the same value, the first result wins.
+ */
+export async function matchRowsForUpsert(store, typeSlug, rows, matchKey) {
+    // Collect unique non-empty match values
+    const matchValues = new Set();
+    for (const row of rows) {
+        const val = row.content[matchKey];
+        const strVal = val !== null && val !== undefined && val !== ''
+            ? String(val).trim()
+            : (row.title?.trim() ?? '');
+        if (strVal)
+            matchValues.add(strVal);
+    }
+    if (matchValues.size === 0) {
+        return {
+            matched: rows.map((row) => ({ row, existingId: null, skipped: false })),
+            skippedCount: 0,
+        };
+    }
+    const isTitleKey = matchKey === 'title';
+    // Fetch all entities of this type and build a value → id map
+    const existingEntities = await store.listEntitiesByType(typeSlug);
+    const existingMap = new Map();
+    for (const entity of existingEntities) {
+        if (isTitleKey) {
+            const val = entity.title?.trim();
+            if (val && matchValues.has(val) && !existingMap.has(val)) {
+                existingMap.set(val, entity.id);
+            }
+        }
+        else {
+            const contentVal = entity.content?.[matchKey];
+            const strVal = contentVal !== null && contentVal !== undefined ? String(contentVal).trim() : undefined;
+            if (strVal && matchValues.has(strVal) && !existingMap.has(strVal)) {
+                existingMap.set(strVal, entity.id);
+            }
+        }
+    }
+    let skippedCount = 0;
+    const matched = rows.map((row) => {
+        const rawVal = isTitleKey
+            ? (row.title?.trim() ?? '')
+            : String(row.content[matchKey] ?? '').trim();
+        if (!rawVal) {
+            skippedCount++;
+            return { row, existingId: null, skipped: true };
+        }
+        const existingId = existingMap.get(rawVal) ?? null;
+        return { row, existingId, skipped: false };
+    });
+    return { matched, skippedCount };
+}
+//# sourceMappingURL=upsert-matcher.js.map

package/dist/import/upsert-matcher.js.map

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

package/dist/import/upsert-matcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=upsert-matcher.test.d.ts.map

package/dist/import/upsert-matcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-matcher.test.d.ts","sourceRoot":"","sources":["../../src/import/upsert-matcher.test.ts"],"names":[],"mappings":""}

package/dist/import/upsert-matcher.test.js

@@ -0,0 +1,77 @@
+import { describe, it, expect } from 'vitest';
+import { matchRowsForUpsert } from './upsert-matcher.js';
+function makeStore(entities) {
+    return {
+        listEntitiesByType: async () => entities,
+    };
+}
+const rows = [
+    { title: 'Alice', content: { email: 'alice@example.com' } },
+    { title: 'Bob', content: { email: 'bob@example.com' } },
+    { title: 'Charlie', content: { email: '' } }, // empty match key
+];
+describe('matchRowsForUpsert — title key', () => {
+    it('matches by title when matchKey is "title"', async () => {
+        const store = makeStore([{ id: 'id-alice', title: 'Alice', content: null }]);
+        const result = await matchRowsForUpsert(store, 'contact', rows, 'title');
+        expect(result.matched[0].existingId).toBe('id-alice');
+        expect(result.matched[1].existingId).toBeNull(); // Bob not found
+        expect(result.matched[2].existingId).toBeNull(); // Charlie
+    });
+    it('does not skip rows when title is present', async () => {
+        const store = makeStore([]);
+        const result = await matchRowsForUpsert(store, 'contact', rows, 'title');
+        expect(result.skippedCount).toBe(0);
+        expect(result.matched.every((m) => !m.skipped)).toBe(true);
+    });
+});
+describe('matchRowsForUpsert — content field key', () => {
+    it('matches by content field', async () => {
+        const store = makeStore([
+            { id: 'id-alice', title: 'Old Name', content: { email: 'alice@example.com' } },
+        ]);
+        const result = await matchRowsForUpsert(store, 'contact', rows, 'email');
+        expect(result.matched[0].existingId).toBe('id-alice');
+        expect(result.matched[1].existingId).toBeNull();
+    });
+    it('skips rows where the match-key content field is empty', async () => {
+        const store = makeStore([]);
+        const result = await matchRowsForUpsert(store, 'contact', rows, 'email');
+        expect(result.matched[2].skipped).toBe(true);
+        expect(result.skippedCount).toBe(1);
+    });
+});
+describe('matchRowsForUpsert — edge cases', () => {
+    it('returns all as new creates when store is empty', async () => {
+        const store = makeStore([]);
+        const result = await matchRowsForUpsert(store, 'contact', rows, 'title');
+        expect(result.matched.every((m) => m.existingId === null || m.skipped)).toBe(true);
+    });
+    it('treats all rows as new creates when every match value is empty (no lookup needed)', async () => {
+        // When matchValues.size === 0 (all empty), rows become new creates rather than skipped.
+        // This matches amble behavior: an entirely-empty import is created wholesale.
+        const emptyRows = [
+            { title: '', content: { email: '' } },
+            { title: '', content: { email: '' } },
+        ];
+        const store = makeStore([]);
+        const result = await matchRowsForUpsert(store, 'contact', emptyRows, 'email');
+        expect(result.skippedCount).toBe(0);
+        expect(result.matched.every((m) => !m.skipped && m.existingId === null)).toBe(true);
+    });
+    it('handles empty rows array', async () => {
+        const store = makeStore([]);
+        const result = await matchRowsForUpsert(store, 'contact', [], 'title');
+        expect(result.matched).toHaveLength(0);
+        expect(result.skippedCount).toBe(0);
+    });
+    it('first match wins when multiple entities share same key value', async () => {
+        const store = makeStore([
+            { id: 'id-first', title: 'Alice', content: null },
+            { id: 'id-second', title: 'Alice', content: null },
+        ]);
+        const result = await matchRowsForUpsert(store, 'contact', [rows[0]], 'title');
+        expect(result.matched[0].existingId).toBe('id-first');
+    });
+});
+//# sourceMappingURL=upsert-matcher.test.js.map

package/dist/import/upsert-matcher.test.js.map

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