nucleus-core-ts 0.9.811 → 0.9.813

package/dist/src/ElysiaPlugin/routes/integrations/inspect.d.ts

@@ -80,6 +80,7 @@ export declare function previewRun(chain: ResolvedChain, tokenCache: TokenCache,
     }[]>;
     readEntityColumn: (entity: string, field: string) => Promise<unknown[]>;
     requiredFields: (entity: string) => string[];
+    uniqueFields: (entity: string) => string[];
 }, deps?: {
     fetchImpl?: typeof fetch;
     maxRecords?: number;

package/dist/src/ElysiaPlugin/routes/integrations/repository.d.ts

@@ -76,6 +76,14 @@ export declare function resolveEndpointContext(deps: RepositoryDeps, by: {
 export declare function cacheEndpointSample(deps: RepositoryDeps, endpointId: string, records: readonly unknown[]): Promise<void>;
 /** Columns of a target that must carry a value, for pre-write validation. */
 export declare function requiredFieldsOf(entities: NucleusTable[], targetEntity: string): string[];
+/**
+ * Columns the target enforces as unique, single-column only.
+ *
+ * A composite unique index is not a value one record can be said to duplicate,
+ * so it is left to the database — the point here is to name the two records that
+ * clash, and for a pair of columns there is nothing useful to name.
+ */
+export declare function uniqueFieldsOf(entities: NucleusTable[], targetEntity: string): string[];
 export declare function createRunRepository(deps: RepositoryDeps, entities: NucleusTable[]): RunRepository;
 /** Current contents of the rows a revert is about to touch, keyed by id. */
 export declare function readRowsById(deps: RepositoryDeps, targetEntity: string, ids: string[]): Promise<Map<string, Record<string, unknown>>>;

package/dist/src/Services/Integrations/plan.d.ts

@@ -56,6 +56,16 @@ export type PlanInput = {
     missingValue?: string | null;
     /** NOT NULL, no-default columns of the target — a row missing one cannot be written. */
     requiredFields?: readonly string[];
+    /**
+     * Columns the target enforces as unique.
+     *
+     * Checked here so a collision is a reported record rather than a rolled-back
+     * import. Two people called Ayşe Yılmaz produce the same generated address,
+     * and letting Postgres discover that means all eight hundred rows are lost to
+     * one duplicate — with a driver message naming a constraint instead of the two
+     * records that clashed.
+     */
+    uniqueFields?: readonly string[];
     /**
      * Values the engine puts on every NEW record, under whatever the source
      * carries.

package/dist/src/Services/Integrations/runner.d.ts

@@ -98,6 +98,8 @@ export type RunRepository = {
     readEntityColumn(entity: string, field: string): Promise<unknown[]>;
     /** NOT NULL, no-default columns of the target. */
     requiredFields(targetEntity: string): string[];
+    /** Single-column unique constraints of the target. */
+    uniqueFields(targetEntity: string): string[];
 };
 export type RunnerDeps = {
     repo: RunRepository;

package/dist/src/Services/Integrations/types.d.ts

@@ -7,7 +7,9 @@
  * operator registered.
  */
 /** A per-field transform applied to a source value before it lands in a column. */
-export type MappingTransform = 'none' | 'trim' | 'upper' | 'lower' | 'toString' | 'toNumber' | 'toBoolean' | 'dateOnly';
+export type MappingTransform = 'none' | 'trim' | 'upper' | 'lower' | 'toString' | 'toNumber' | 'toBoolean' | 'dateOnly'
+/** Folds accents, lowercases, and removes what an address cannot contain. */
+ | 'emailSafe';
 /** One field of a mapping: external `source` path → internal `target` column. */
 export type FieldMapping = {
     /** Dot-path into the external record, e.g. `employeeNo` or `department.code`. */
@@ -17,7 +19,15 @@ export type FieldMapping = {
     transform?: MappingTransform;
     /** Used INSTEAD of reading `source` — a fixed value for every row. */
     constant?: string;
-    /** Used when the source value resolves to null/undefined/empty. */
+    /**
+     * Used when the source value resolves to null/undefined/empty.
+     *
+     * Accepts the same `{field}` templates as `source`, so a record that arrives
+     * without an address can still be given one built from the fields it does
+     * have — `{ad}.{soyad}@example.com`. The transform is applied to it as well,
+     * which is what turns `Ayşe Yılmaz` into something that can be typed into a
+     * login box.
+     */
     fallback?: string;
 };
 /**
@@ -121,7 +131,7 @@ export type RunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancell
  */
 export type RunIssue = {
     sourceIndex: number;
-    kind: 'missing_required' | 'missing_dedup_key' | 'duplicate_in_batch' | 'invalid_value' | 'unmapped' | 'missing_reference';
+    kind: 'missing_required' | 'missing_dedup_key' | 'duplicate_in_batch' | 'duplicate_value' | 'invalid_value' | 'unmapped' | 'missing_reference';
     message: string;
     dedupKey?: string | null;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nucleus-core-ts",
-	"version": "0.9.811",
+	"version": "0.9.813",
 	"description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
 	"author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
 	"license": "SEE LICENSE IN LICENSE",