@jackchuka/gql-ingest 1.4.0 → 2.0.0

package/dist/dependency-resolver.d.ts

@@ -8,7 +8,8 @@ export interface ExecutionWave {
 export declare class DependencyResolver {
     private dependencies;
     private entities;
-    constructor(entities: string[], dependencies?: DependencyGraph);
+    private allowPartialResolution;
+    constructor(entities: string[], dependencies?: DependencyGraph, allowPartialResolution?: boolean);
     resolveExecutionOrder(): ExecutionWave[];
     validateDependencies(): string[];
     getDependents(entityName: string): string[];

package/dist/dependency-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../src/dependency-resolver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,EAAE,MAAM,EAAE,EAAE,YAAY,GAAE,eAAoB;IAKlE,qBAAqB,IAAI,aAAa,EAAE;IA8CxC,oBAAoB,IAAI,MAAM,EAAE;IAwBhC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAM3C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;CAG9C"}
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../src/dependency-resolver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,sBAAsB,CAAU;gBAE5B,QAAQ,EAAE,MAAM,EAAE,EAAE,YAAY,GAAE,eAAoB,EAAE,sBAAsB,GAAE,OAAe;IAM3G,qBAAqB,IAAI,aAAa,EAAE;IAgDxC,oBAAoB,IAAI,MAAM,EAAE;IAwBhC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAM3C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;CAG9C"}

package/dist/mapper.d.ts

@@ -2,22 +2,27 @@ import { GraphQLClientWrapper } from "./graphql-client";
 import { MetricsCollector } from "./metrics";
 import { ParallelProcessingConfig, RetryConfig } from "./config";
 export interface MappingConfig {
-    csvFile: string;
+    csvFile?: string;
+    dataFile?: string;
+    dataFormat?: string;
     graphqlFile: string;
-    mapping: Record<string, string>;
+    mapping: Record<string, string | any>;
 }
 export declare class DataMapper {
     private client;
     private basePath;
     private metrics;
     private verbose;
-    constructor(client: GraphQLClientWrapper, basePath?: string, metrics?: MetricsCollector, verbose?: boolean);
-    discoverMappings(configDir: string): string[];
+    private formatOverride?;
+    constructor(client: GraphQLClientWrapper, basePath?: string, metrics?: MetricsCollector, verbose?: boolean, formatOverride?: string);
+    discoverMappings(configDir: string, entityFilter?: string[]): string[];
     processEntity(configPath: string, parallelConfig?: ParallelProcessingConfig, retryConfig?: RetryConfig): Promise<void>;
     private processRowsSequentially;
     private processRowsConcurrently;
     private chunkArray;
-    private mapCsvRowToVariables;
+    private mapRowToVariables;
+    private getValueByPath;
+    private mapNestedObject;
     private extractVariableTypes;
     private extractTypeName;
     private convertValue;

package/dist/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../src/mapper.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAU;gBAGvB,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,GAAE,MAAsB,EAChC,OAAO,CAAC,EAAE,gBAAgB,EAC1B,OAAO,GAAE,OAAe;IAQ1B,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAiBvC,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,wBAAwB,EACzC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC;YA8CF,uBAAuB;YAwCvB,uBAAuB;IA8ErC,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,YAAY;IAsDpB,UAAU,IAAI,gBAAgB;CAG/B"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../src/mapper.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEjE,MAAM,WAAW,aAAa;IAE5B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC;CACvC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAC,CAAS;gBAG9B,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,GAAE,MAAsB,EAChC,OAAO,CAAC,EAAE,gBAAgB,EAC1B,OAAO,GAAE,OAAe,EACxB,cAAc,CAAC,EAAE,MAAM;IASzB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IA4ChE,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,wBAAwB,EACzC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC;YAyDF,uBAAuB;YAwCvB,uBAAuB;IA8ErC,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,iBAAiB;IA+CzB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,eAAe;IA0CvB,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,YAAY;IAmEpB,UAAU,IAAI,gBAAgB;CAG/B"}

package/dist/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAoB;;IAgBnC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAW/C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASvC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASvC,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOhD,gBAAgB,IAAI,iBAAiB;IAKrC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI/D,iBAAiB,IAAI,MAAM;IAI3B,cAAc,IAAI,MAAM;IAKxB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1C,yBAAyB,IAAI,MAAM;IAMnC,aAAa,IAAI,MAAM;IAKvB,eAAe,IAAI,MAAM;CAmC1B"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAoB;;IAgBnC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAW/C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASvC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASvC,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOhD,gBAAgB,IAAI,iBAAiB;IAKrC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI/D,iBAAiB,IAAI,MAAM;IAI3B,cAAc,IAAI,MAAM;IAKxB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1C,yBAAyB,IAAI,MAAM;IAMnC,aAAa,IAAI,MAAM;IAKvB,eAAe,IAAI,MAAM;CA2C1B"}

package/dist/readers/csv.d.ts

@@ -0,0 +1,10 @@
+import { DataReader, DataRow } from "./data-reader";
+export interface CsvRow {
+    [key: string]: string;
+}
+export declare function readCsvFile(filePath: string): Promise<CsvRow[]>;
+export declare class CsvReader extends DataReader {
+    getSupportedExtensions(): string[];
+    readFile(filePath: string): Promise<DataRow[]>;
+}
+//# sourceMappingURL=csv.d.ts.map

package/dist/readers/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/readers/csv.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,MAAM;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUrE;AAED,qBAAa,SAAU,SAAQ,UAAU;IACvC,sBAAsB,IAAI,MAAM,EAAE;IAI5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAGrD"}

package/dist/readers/csv.test.d.ts

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

package/dist/readers/csv.test.d.ts.map

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

package/dist/readers/data-reader.d.ts

@@ -0,0 +1,21 @@
+export interface DataRow {
+    [key: string]: any;
+}
+export declare abstract class DataReader {
+    abstract readFile(filePath: string): Promise<DataRow[]>;
+    /**
+     * Get the supported file extensions for this reader
+     */
+    abstract getSupportedExtensions(): string[];
+    /**
+     * Check if this reader can handle the given file
+     */
+    canHandle(filePath: string): boolean;
+}
+export declare class DataReaderFactory {
+    private static readers;
+    static registerReader(reader: DataReader): void;
+    static getReader(filePath: string, format?: string): DataReader;
+    static getSupportedFormats(): string[];
+}
+//# sourceMappingURL=data-reader.d.ts.map

package/dist/readers/data-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-reader.d.ts","sourceRoot":"","sources":["../../src/readers/data-reader.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,8BAAsB,UAAU;IAC9B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,sBAAsB,IAAI,MAAM,EAAE;IAE3C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAMrC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAoB;IAE1C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAI/C,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU;IAuB/D,MAAM,CAAC,mBAAmB,IAAI,MAAM,EAAE;CAOvC"}

package/dist/readers/data-reader.test.d.ts

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

package/dist/readers/data-reader.test.d.ts.map

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

package/dist/readers/index.d.ts

@@ -0,0 +1,6 @@
+export { DataReader, DataRow, DataReaderFactory } from "./data-reader";
+export { CsvReader, readCsvFile, CsvRow } from "./csv";
+export { JsonReader } from "./json";
+export { YamlReader } from "./yaml";
+export { JsonlReader } from "./jsonl";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/readers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/readers/json.d.ts

@@ -0,0 +1,6 @@
+import { DataReader, DataRow } from "./data-reader";
+export declare class JsonReader extends DataReader {
+    getSupportedExtensions(): string[];
+    readFile(filePath: string): Promise<DataRow[]>;
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/readers/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/readers/json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpD,qBAAa,UAAW,SAAQ,UAAU;IACxC,sBAAsB,IAAI,MAAM,EAAE;IAI5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAkBrD"}

package/dist/readers/json.test.d.ts

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

package/dist/readers/json.test.d.ts.map

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

package/dist/readers/jsonl.d.ts

@@ -0,0 +1,6 @@
+import { DataReader, DataRow } from "./data-reader";
+export declare class JsonlReader extends DataReader {
+    getSupportedExtensions(): string[];
+    readFile(filePath: string): Promise<DataRow[]>;
+}
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/readers/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../src/readers/jsonl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpD,qBAAa,WAAY,SAAQ,UAAU;IACzC,sBAAsB,IAAI,MAAM,EAAE;IAI5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAmBrD"}

package/dist/readers/jsonl.test.d.ts

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

package/dist/readers/jsonl.test.d.ts.map

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

package/dist/readers/yaml.d.ts

@@ -0,0 +1,6 @@
+import { DataReader, DataRow } from "./data-reader";
+export declare class YamlReader extends DataReader {
+    getSupportedExtensions(): string[];
+    readFile(filePath: string): Promise<DataRow[]>;
+}
+//# sourceMappingURL=yaml.d.ts.map

package/dist/readers/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/readers/yaml.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpD,qBAAa,UAAW,SAAQ,UAAU;IACxC,sBAAsB,IAAI,MAAM,EAAE;IAI5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAkBrD"}

package/dist/readers/yaml.test.d.ts

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

package/dist/readers/yaml.test.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackchuka/gql-ingest",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "description": "A CLI tool for ingesting data from CSV files into a GraphQL API",
   "type": "module",
   "main": "dist/cli.js",

package/src/cli.ts

@@ -31,11 +31,19 @@ program
     "-c, --config <path>",
     "Path to configuration directory (containing data/, graphql/, mappings/ subdirectories)"
   )
+  .option(
+    "-n, --entities <entities>",
+    "Comma-separated list of specific entities to process (e.g., users,products)"
+  )
   .option(
     "-h, --headers <headers>",
     "JSON string of headers to include in requests"
   )
   .option("-v, --verbose", "Show detailed request results and responses")
+  .option(
+    "-f, --format <format>",
+    "Override data format detection (csv, json, yaml, jsonl)"
+  )
   .action(async (options) => {
     try {
       console.log("Starting seed data generation...");
@@ -62,32 +70,65 @@ program
         client,
         process.cwd(),
         metrics,
-        options.verbose
+        options.verbose,
+        options.format
       );
 
+      // Parse entities filter if provided
+      const entityFilter = options.entities
+        ? options.entities.split(",").map((e: string) => e.trim())
+        : undefined;
+
       // Discover all mapping files dynamically
-      const mappingPaths = mapper.discoverMappings(options.config);
+      const mappingPaths = mapper.discoverMappings(
+        options.config,
+        entityFilter
+      );
 
       if (mappingPaths.length === 0) {
-        console.warn(`No mapping files found in ${options.config}/mappings`);
+        const filterMsg = entityFilter
+          ? ` matching entities: ${entityFilter.join(", ")}`
+          : "";
+        console.warn(
+          `No mapping files found in ${options.config}/mappings${filterMsg}`
+        );
         return;
       }
 
       // Extract entity names from mapping paths
       const entityNames = mappingPaths.map((path) => basename(path, ".json"));
 
-      // Setup dependency resolver
+      // Filter dependencies to only include those relevant to selected entities
+      const relevantDependencies: Record<string, string[]> = {};
+      if (config.entityDependencies) {
+        for (const entity of entityNames) {
+          if (config.entityDependencies[entity]) {
+            relevantDependencies[entity] = config.entityDependencies[entity];
+          }
+        }
+      }
+
+      // Setup dependency resolver with filtered dependencies
       const resolver = new DependencyResolver(
         entityNames,
-        config.entityDependencies
+        relevantDependencies,
+        !!entityFilter // Allow partial resolution when using --entities
       );
 
       // Validate dependencies
       const validationErrors = resolver.validateDependencies();
       if (validationErrors.length > 0) {
-        console.error("Dependency validation errors:");
-        validationErrors.forEach((error) => console.error(`  - ${error}`));
-        process.exit(1);
+        if (entityFilter) {
+          // When using --entities flag, show warnings instead of errors
+          console.warn("\n⚠️  Warning: Dependency validation issues:");
+          validationErrors.forEach((error) => console.warn(`  - ${error}`));
+          console.warn("This may cause errors if the dependent data doesn't already exist.\n");
+        } else {
+          // Strict validation when processing all entities
+          console.error("Dependency validation errors:");
+          validationErrors.forEach((error) => console.error(`  - ${error}`));
+          process.exit(1);
+        }
       }
 
       // Process entities in dependency-aware waves

package/src/dependency-resolver.test.ts

@@ -88,12 +88,26 @@ describe("DependencyResolver", () => {
         a: ["missing"],
         b: ["a"],
       };
-      const resolver = new DependencyResolver(entities, dependencies);
+      const resolver = new DependencyResolver(entities, dependencies, false);
 
       expect(() => resolver.resolveExecutionOrder()).toThrow(
         "Circular dependency detected or missing dependencies for entities: a, b"
       );
     });
+
+    it("should allow entities with dependencies not in the entity list when partial resolution is enabled", () => {
+      const entities = ["a", "b"];
+      const dependencies = {
+        a: ["missing"],
+        b: ["a"],
+      };
+      const resolver = new DependencyResolver(entities, dependencies, true);
+
+      const waves = resolver.resolveExecutionOrder();
+      expect(waves).toHaveLength(2);
+      expect(waves[0].entities).toEqual(["a"]);
+      expect(waves[1].entities).toEqual(["b"]);
+    });
   });
 
   describe("validateDependencies", () => {

package/src/dependency-resolver.ts

@@ -10,10 +10,12 @@ export interface ExecutionWave {
 export class DependencyResolver {
   private dependencies: DependencyGraph;
   private entities: string[];
+  private allowPartialResolution: boolean;
 
-  constructor(entities: string[], dependencies: DependencyGraph = {}) {
+  constructor(entities: string[], dependencies: DependencyGraph = {}, allowPartialResolution: boolean = false) {
     this.entities = entities;
     this.dependencies = dependencies;
+    this.allowPartialResolution = allowPartialResolution;
   }
 
   resolveExecutionOrder(): ExecutionWave[] {
@@ -31,7 +33,9 @@ export class DependencyResolver {
         }
 
         const deps = this.dependencies[entity] || [];
-        const canProcess = deps.every((dep) => processed.has(dep));
+        const canProcess = deps.every((dep) => 
+          processed.has(dep) || (this.allowPartialResolution && !this.entities.includes(dep))
+        );
 
         if (canProcess) {
           currentWave.push(entity);

package/src/graphql-client.test.ts

@@ -63,7 +63,10 @@ describe("GraphQLClientWrapper", () => {
       clientWrapper.executeMutation(mutation, variables)
     ).rejects.toThrow("GraphQL error");
 
-    expect(consoleSpy).toHaveBeenCalledWith("GraphQL mutation failed after 3 attempts:", error);
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "GraphQL mutation failed after 3 attempts:",
+      error
+    );
 
     consoleSpy.mockRestore();
   });
@@ -96,7 +99,11 @@ describe("GraphQLClientWrapper", () => {
         .mockRejectedValueOnce(serverError)
         .mockResolvedValueOnce({ data: { result: "success" } });
 
-      const result = await clientWrapper.executeMutation(mutation, variables, retryConfig);
+      const result = await clientWrapper.executeMutation(
+        mutation,
+        variables,
+        retryConfig
+      );
 
       expect(mockRequest).toHaveBeenCalledTimes(3);
       expect(result).toEqual({ data: { result: "success" } });
@@ -143,7 +150,11 @@ describe("GraphQLClientWrapper", () => {
         .mockRejectedValueOnce(networkError)
         .mockResolvedValueOnce({ data: { result: "success" } });
 
-      const result = await clientWrapper.executeMutation(mutation, variables, retryConfig);
+      const result = await clientWrapper.executeMutation(
+        mutation,
+        variables,
+        retryConfig
+      );
 
       expect(mockRequest).toHaveBeenCalledTimes(2);
       expect(result).toEqual({ data: { result: "success" } });
@@ -192,7 +203,11 @@ describe("GraphQLClientWrapper", () => {
         .mockResolvedValueOnce({ data: { result: "success" } });
 
       const startTime = Date.now();
-      const result = await clientWrapper.executeMutation(mutation, variables, retryConfig);
+      const result = await clientWrapper.executeMutation(
+        mutation,
+        variables,
+        retryConfig
+      );
       const totalTime = Date.now() - startTime;
 
       expect(mockRequest).toHaveBeenCalledTimes(3);