@seedprotocol/mapping 0.6.0 → 0.6.2

package/dist/relationLookup.d.ts

@@ -1,4 +1,4 @@
-import type { TargetProperty } from './types';
+import type { FieldMapping, LookupEntry, MappingLookups, SourceNode, TargetProperty } from './types';
 /**
  * True when the target expects a Seed relation uid (or list of uids)
  * rather than a copied scalar string.
@@ -6,9 +6,29 @@ import type { TargetProperty } from './types';
 export declare function isRelationLookupTarget(target: TargetProperty): boolean;
 /** Trim and collapse internal whitespace for lookup dictionary keys. */
 export declare function normalizeLookupKey(raw: string): string;
+/** Normalized sample string for a source node (value, then label). */
+export declare function sampleValueFromSource(source: SourceNode | undefined): string;
 /**
  * Shape a looked-up uid value for the target dataType.
  * Relation → single string; List → string[].
  */
 export declare function shapeLookupValue(mapped: string | string[], target: TargetProperty): string | string[];
+/** Entries stored on a lookup edge. Missing `lookup` is an empty assignment. */
+export declare function lookupEntriesFromMapping(mapping: FieldMapping | undefined): LookupEntry[];
+/**
+ * First entry whose normalized `value` matches `rawValue`.
+ * Empty / whitespace-only refs are ignored.
+ */
+export declare function lookupRefFromEntries(entries: LookupEntry[] | undefined, rawValue: string): string | undefined;
+/**
+ * @deprecated Document-level table. Prefer `lookupRefFromEntries`.
+ */
+export declare function lookupRefFromTable(lookups: MappingLookups | undefined, propertyName: string, rawKey: string): string | string[] | undefined;
+/**
+ * Resolve a lookup ref: edge entries first, then deprecated document table.
+ */
+export declare function resolveLookupMapped(mapping: FieldMapping, rawValue: string, lookups?: MappingLookups): string | string[] | undefined;
+export declare function withLookupEntries(edge: FieldMapping, entries: LookupEntry[]): FieldMapping;
+/** Drop `lookup` when the edge is no longer a lookup job. */
+export declare function stripLookup(edge: FieldMapping): FieldMapping;
 //# sourceMappingURL=relationLookup.d.ts.map

package/dist/relationLookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationLookup.d.ts","sourceRoot":"","sources":["../src/relationLookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAMtE;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,MAAM,EAAE,cAAc,GACrB,MAAM,GAAG,MAAM,EAAE,CAanB"}
+{"version":3,"file":"relationLookup.d.ts","sourceRoot":"","sources":["../src/relationLookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACV,cAAc,EACf,MAAM,SAAS,CAAA;AAEhB;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAMtE;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAG5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,MAAM,EAAE,cAAc,GACrB,MAAM,GAAG,MAAM,EAAE,CAanB;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,GAAG,SAAS,GAChC,WAAW,EAAE,CAEf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CASpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAQ/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAK/B;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,EAAE,GACrB,YAAY,CAOd;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAI5D"}

package/dist/types.d.ts

@@ -32,19 +32,33 @@ export type TargetProperty = {
      */
     required?: boolean;
 };
+/** One origin string → opaque host ref for `resolve: 'lookup'`. */
+export type LookupEntry = {
+    /** Trimmed origin source string (e.g. RSS author). */
+    value: string;
+    /** Opaque host-stable id (`seedLocalId` or `seedUid`). Package does not interpret it. */
+    ref: string;
+};
 /**
  * Source → property edge.
  * A source may map to multiple properties; each property appears at most once.
- * When `resolve` is set, async apply transforms the value; sync apply skips the edge.
+ * `resolve: 'extract' | 'file'` is applied by `applyMappingAsync` via a host callback.
+ * `resolve: 'lookup'` is applied from `lookup.entries` (sync and async).
  */
 export type FieldMapping = {
     sourceId: string;
     propertyName: string;
     resolve?: ResolveJob;
+    /** Stored string → ref assignments for `resolve: 'lookup'`. Omit or empty = unassigned. */
+    lookup?: {
+        entries: LookupEntry[];
+    };
 };
 /**
  * Per-property string → seed uid (or uid list) dictionary for `resolve: 'lookup'`.
  * Keys are trimmed source values.
+ *
+ * @deprecated Prefer `FieldMapping.lookup.entries`. Read as a fallback only.
  */
 export type MappingLookups = Record<string, Record<string, string | string[]>>;
 /** Persistable mapping authored in the UI (or programmatically). */
@@ -52,7 +66,10 @@ export type MappingDocument = {
     version: 1;
     sourceKind: 'markdown' | 'rss' | 'xml';
     mappings: FieldMapping[];
-    /** Optional relation value maps keyed by property name. */
+    /**
+     * Optional relation value maps keyed by property name.
+     * @deprecated Prefer `FieldMapping.lookup.entries` on each lookup edge.
+     */
     lookups?: MappingLookups;
 };
 /** Result of applying mappings: property name → coerced value. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,SAAS,GACT,MAAM,GACN,UAAU,GACV,SAAS,GACT,UAAU,CAAA;AAEd,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,GACP,SAAS,CAAA;AAEb,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEtD,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,UAAU,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAA;AAE9E,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAA;IACV,UAAU,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,CAAA;IACtC,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEjD,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,UAAU,CAAA;IACf,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,cAAc,CAAA;IACtB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,WAAW,CAAA;IACvB,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC5B,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seedprotocol/mapping",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Source-to-model-property field mapping helpers and UI for Seed Protocol",
   "type": "module",
   "main": "./dist/index.js",