@hazeljs/data 0.2.0-alpha.1

package/dist/quality/quality.service.d.ts.map

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

package/dist/quality/quality.service.js

@@ -0,0 +1,326 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QualityService = void 0;
+const core_1 = require("@hazeljs/core");
+const core_2 = __importDefault(require("@hazeljs/core"));
+/**
+ * Quality Service — data quality checks, profiling, and anomaly detection.
+ *
+ * Built-in check factories:
+ * - completeness(fields[])
+ * - notNull(fields[])
+ * - uniqueness(fields[])
+ * - range(field, { min, max })
+ * - pattern(field, regex, message?)
+ * - referentialIntegrity(field, allowedValues[])
+ *
+ * Profiling:
+ * - profile(dataset, records[]) → DataProfile
+ *
+ * Anomaly detection:
+ * - detectAnomalies(records[], fields[], threshold?) → AnomalyResult[]
+ */
+let QualityService = class QualityService {
+    constructor() {
+        this.checks = new Map();
+    }
+    registerCheck(name, check) {
+        this.checks.set(name, check);
+        core_2.default.debug(`Registered quality check: ${name}`);
+    }
+    async runChecks(dataset, data) {
+        const results = [];
+        const items = Array.isArray(data) ? data : [data];
+        const totalRows = items.length;
+        for (const [name, check] of this.checks) {
+            try {
+                const result = await Promise.resolve(check(data));
+                results.push({ ...result, name: result.name || name });
+            }
+            catch (error) {
+                results.push({
+                    name,
+                    passed: false,
+                    score: 0,
+                    message: error instanceof Error ? error.message : 'Check failed',
+                });
+            }
+        }
+        const passed = results.every((r) => r.passed);
+        const scores = results.map((r) => (r.score !== undefined ? r.score : r.passed ? 100 : 0));
+        const score = scores.length > 0 ? Math.round(scores.reduce((a, b) => a + b, 0) / scores.length) : 100;
+        return { timestamp: new Date(), dataset, totalRows, checks: results, passed, score };
+    }
+    // ─── Built-in check factories ─────────────────────────────────────────────
+    completeness(requiredFields) {
+        return (data) => {
+            const items = Array.isArray(data) ? data : [data];
+            let totalMissing = 0;
+            const missingByField = {};
+            for (const item of items) {
+                if (item === null || typeof item !== 'object')
+                    continue;
+                const obj = item;
+                for (const f of requiredFields) {
+                    if (obj[f] === undefined || obj[f] === null) {
+                        totalMissing++;
+                        missingByField[f] = (missingByField[f] ?? 0) + 1;
+                    }
+                }
+            }
+            const total = items.length * requiredFields.length;
+            const score = total > 0 ? Math.round(((total - totalMissing) / total) * 100) : 100;
+            return {
+                name: 'completeness',
+                passed: totalMissing === 0,
+                score,
+                message: totalMissing > 0
+                    ? `${totalMissing} missing values across ${Object.keys(missingByField).length} fields`
+                    : undefined,
+                details: { missingByField, required: requiredFields },
+            };
+        };
+    }
+    notNull(fields) {
+        return (data) => {
+            const items = Array.isArray(data) ? data : [data];
+            const nullFields = [];
+            for (const item of items) {
+                if (item === null || typeof item !== 'object')
+                    continue;
+                const obj = item;
+                for (const f of fields) {
+                    if ((obj[f] === null || obj[f] === undefined) && !nullFields.includes(f)) {
+                        nullFields.push(f);
+                    }
+                }
+            }
+            return {
+                name: 'notNull',
+                passed: nullFields.length === 0,
+                score: nullFields.length === 0
+                    ? 100
+                    : Math.round(((fields.length - nullFields.length) / fields.length) * 100),
+                message: nullFields.length > 0 ? `Null fields: ${nullFields.join(', ')}` : undefined,
+                details: { nullFields },
+            };
+        };
+    }
+    uniqueness(fields) {
+        return (data) => {
+            const items = Array.isArray(data) ? data : [data];
+            const seen = {};
+            const duplicates = {};
+            for (const f of fields)
+                seen[f] = new Set();
+            for (const item of items) {
+                if (item === null || typeof item !== 'object')
+                    continue;
+                const obj = item;
+                for (const f of fields) {
+                    const v = obj[f];
+                    if (seen[f].has(v)) {
+                        duplicates[f] = (duplicates[f] ?? 0) + 1;
+                    }
+                    else {
+                        seen[f].add(v);
+                    }
+                }
+            }
+            const totalDups = Object.values(duplicates).reduce((a, b) => a + b, 0);
+            const score = items.length > 0 ? Math.round(((items.length - totalDups) / items.length) * 100) : 100;
+            return {
+                name: 'uniqueness',
+                passed: totalDups === 0,
+                score,
+                message: totalDups > 0 ? `${totalDups} duplicate values found` : undefined,
+                details: { duplicates, fields },
+            };
+        };
+    }
+    range(field, options) {
+        return (data) => {
+            const items = Array.isArray(data) ? data : [data];
+            const violations = [];
+            items.forEach((item, idx) => {
+                if (item === null || typeof item !== 'object')
+                    return;
+                const obj = item;
+                const v = obj[field];
+                if (typeof v !== 'number')
+                    return;
+                if (options.min !== undefined && v < options.min)
+                    violations.push({ index: idx, value: v });
+                else if (options.max !== undefined && v > options.max)
+                    violations.push({ index: idx, value: v });
+            });
+            const score = items.length > 0
+                ? Math.round(((items.length - violations.length) / items.length) * 100)
+                : 100;
+            return {
+                name: `range:${field}`,
+                passed: violations.length === 0,
+                score,
+                message: violations.length > 0
+                    ? `${violations.length} values out of range [${options.min ?? '−∞'}, ${options.max ?? '+∞'}]`
+                    : undefined,
+                details: { field, violations: violations.slice(0, 10), options },
+            };
+        };
+    }
+    pattern(field, regex, message) {
+        return (data) => {
+            const items = Array.isArray(data) ? data : [data];
+            const violations = [];
+            items.forEach((item, idx) => {
+                if (item === null || typeof item !== 'object')
+                    return;
+                const obj = item;
+                const v = obj[field];
+                if (typeof v === 'string' && !regex.test(v))
+                    violations.push({ index: idx, value: v });
+            });
+            const score = items.length > 0
+                ? Math.round(((items.length - violations.length) / items.length) * 100)
+                : 100;
+            return {
+                name: `pattern:${field}`,
+                passed: violations.length === 0,
+                score,
+                message: violations.length > 0
+                    ? (message ?? `${violations.length} values don't match pattern ${regex.source}`)
+                    : undefined,
+                details: { field, regex: regex.source, violations: violations.slice(0, 10) },
+            };
+        };
+    }
+    referentialIntegrity(field, allowedValues) {
+        const allowed = new Set(allowedValues);
+        return (data) => {
+            const items = Array.isArray(data) ? data : [data];
+            const violations = [];
+            items.forEach((item, idx) => {
+                if (item === null || typeof item !== 'object')
+                    return;
+                const obj = item;
+                const v = obj[field];
+                if (v !== undefined && v !== null && !allowed.has(v)) {
+                    violations.push({ index: idx, value: v });
+                }
+            });
+            const score = items.length > 0
+                ? Math.round(((items.length - violations.length) / items.length) * 100)
+                : 100;
+            return {
+                name: `referentialIntegrity:${field}`,
+                passed: violations.length === 0,
+                score,
+                message: violations.length > 0 ? `${violations.length} values not in allowed set` : undefined,
+                details: { field, violations: violations.slice(0, 10), allowedCount: allowedValues.length },
+            };
+        };
+    }
+    // ─── Data Profiling ───────────────────────────────────────────────────────
+    profile(dataset, records) {
+        if (records.length === 0) {
+            return { dataset, totalRows: 0, fields: {}, generatedAt: new Date() };
+        }
+        const fieldNames = Array.from(new Set(records.flatMap((r) => Object.keys(r))));
+        const fields = {};
+        for (const field of fieldNames) {
+            const values = records.map((r) => r[field]);
+            const nonNull = values.filter((v) => v !== null && v !== undefined);
+            const nums = nonNull.filter((v) => typeof v === 'number');
+            const uniqueSet = new Set(values.map((v) => JSON.stringify(v)));
+            // Top values by frequency
+            const freq = new Map();
+            for (const v of values) {
+                const k = JSON.stringify(v);
+                const entry = freq.get(k) ?? { value: v, count: 0 };
+                entry.count++;
+                freq.set(k, entry);
+            }
+            const topValues = Array.from(freq.values())
+                .sort((a, b) => b.count - a.count)
+                .slice(0, 10);
+            let mean;
+            let stddev;
+            let min;
+            let max;
+            if (nums.length > 0) {
+                mean = nums.reduce((a, b) => a + b, 0) / nums.length;
+                stddev = Math.sqrt(nums.reduce((acc, v) => acc + Math.pow(v - mean, 2), 0) / nums.length);
+                min = Math.min(...nums);
+                max = Math.max(...nums);
+            }
+            else {
+                const strs = nonNull.filter((v) => typeof v === 'string');
+                if (strs.length > 0) {
+                    const sorted = [...strs].sort();
+                    min = sorted[0];
+                    max = sorted[sorted.length - 1];
+                }
+            }
+            fields[field] = {
+                count: values.length,
+                nullCount: values.length - nonNull.length,
+                nullPct: parseFloat(((1 - nonNull.length / values.length) * 100).toFixed(2)),
+                uniqueCount: uniqueSet.size,
+                cardinality: parseFloat((uniqueSet.size / values.length).toFixed(4)),
+                min,
+                max,
+                mean: mean !== undefined ? parseFloat(mean.toFixed(4)) : undefined,
+                stddev: stddev !== undefined ? parseFloat(stddev.toFixed(4)) : undefined,
+                topValues,
+            };
+        }
+        return { dataset, totalRows: records.length, fields, generatedAt: new Date() };
+    }
+    // ─── Anomaly Detection ────────────────────────────────────────────────────
+    /**
+     * Detect statistical anomalies using Z-score.
+     * @param records Dataset rows
+     * @param fields  Numeric fields to analyze
+     * @param threshold Z-score threshold (default: 3.0)
+     */
+    detectAnomalies(records, fields, threshold = 3.0) {
+        const anomalies = [];
+        for (const field of fields) {
+            const nums = records
+                .map((r, i) => ({ value: r[field], index: i }))
+                .filter((x) => typeof x.value === 'number');
+            if (nums.length < 3)
+                continue;
+            const mean = nums.reduce((a, b) => a + b.value, 0) / nums.length;
+            const stddev = Math.sqrt(nums.reduce((acc, b) => acc + Math.pow(b.value - mean, 2), 0) / nums.length);
+            if (stddev === 0)
+                continue;
+            for (const { value, index } of nums) {
+                const zScore = Math.abs((value - mean) / stddev);
+                if (zScore > threshold) {
+                    anomalies.push({
+                        field,
+                        rowIndex: index,
+                        value,
+                        zScore: parseFloat(zScore.toFixed(3)),
+                        message: `Field "${field}" value ${value} is ${zScore.toFixed(2)} stddevs from mean (${mean.toFixed(2)})`,
+                    });
+                }
+            }
+        }
+        return anomalies.sort((a, b) => b.zScore - a.zScore);
+    }
+};
+exports.QualityService = QualityService;
+exports.QualityService = QualityService = __decorate([
+    (0, core_1.Service)()
+], QualityService);

package/dist/quality/quality.service.test.d.ts

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

package/dist/quality/quality.service.test.d.ts.map

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

package/dist/quality/quality.service.test.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const quality_service_1 = require("./quality.service");
+describe('QualityService', () => {
+    let service;
+    beforeEach(() => {
+        service = new quality_service_1.QualityService();
+    });
+    it('runs registered checks', async () => {
+        service.registerCheck('custom', (data) => ({
+            name: 'custom',
+            passed: data.ok === true,
+        }));
+        const report = await service.runChecks('test', { ok: true });
+        expect(report.checks).toHaveLength(1);
+        expect(report.checks[0].passed).toBe(true);
+        expect(report.passed).toBe(true);
+    });
+    it('completeness check', () => {
+        const check = service.completeness(['email', 'name']);
+        expect(check({ email: 'a@b.com', name: 'x' }).passed).toBe(true);
+        expect(check({ email: 'a@b.com' }).passed).toBe(false);
+    });
+    it('notNull check', () => {
+        const check = service.notNull(['id']);
+        expect(check({ id: 1 }).passed).toBe(true);
+        expect(check({ id: null }).passed).toBe(false);
+    });
+    it('report includes totalRows', async () => {
+        service.registerCheck('dummy', () => ({ name: 'dummy', passed: true }));
+        const report = await service.runChecks('ds', [{}, {}]);
+        expect(report.totalRows).toBe(2);
+    });
+    it('report includes quality score', async () => {
+        service.registerCheck('custom', (_data) => ({
+            name: 'custom',
+            passed: true,
+            score: 100,
+        }));
+        const report = await service.runChecks('ds', [{}]);
+        expect(report.score).toBe(100);
+    });
+    it('uniqueness check', () => {
+        const check = service.uniqueness(['id']);
+        expect(check([{ id: 1 }, { id: 2 }]).passed).toBe(true);
+        expect(check([{ id: 1 }, { id: 1 }]).passed).toBe(false);
+    });
+    it('range check', () => {
+        const check = service.range('age', { min: 0, max: 120 });
+        expect(check([{ age: 25 }]).passed).toBe(true);
+        expect(check([{ age: 150 }]).passed).toBe(false);
+    });
+    it('pattern check', () => {
+        const check = service.pattern('phone', /^\d{10}$/);
+        expect(check([{ phone: '1234567890' }]).passed).toBe(true);
+        expect(check([{ phone: '123' }]).passed).toBe(false);
+    });
+    it('pattern check with custom message', () => {
+        const check = service.pattern('code', /^[A-Z]+$/, 'Must be uppercase');
+        const result = check([{ code: 'abc' }]);
+        expect(result.passed).toBe(false);
+        expect(result.message).toContain('Must be uppercase');
+    });
+    it('range check with only min', () => {
+        const check = service.range('age', { min: 18 });
+        expect(check([{ age: 25 }]).passed).toBe(true);
+        expect(check([{ age: 10 }]).passed).toBe(false);
+    });
+    it('range check with only max', () => {
+        const check = service.range('age', { max: 65 });
+        expect(check([{ age: 50 }]).passed).toBe(true);
+        expect(check([{ age: 100 }]).passed).toBe(false);
+    });
+    it('referentialIntegrity check', () => {
+        const check = service.referentialIntegrity('status', ['active', 'inactive']);
+        expect(check([{ status: 'active' }]).passed).toBe(true);
+        expect(check([{ status: 'unknown' }]).passed).toBe(false);
+    });
+    it('profile returns field stats', () => {
+        const records = [
+            { name: 'a', age: 10 },
+            { name: 'b', age: 20 },
+            { name: 'c', age: 30 },
+        ];
+        const profile = service.profile('test', records);
+        expect(profile.totalRows).toBe(3);
+        expect(profile.fields).toHaveProperty('name');
+        expect(profile.fields).toHaveProperty('age');
+        expect(profile.fields.age.mean).toBe(20);
+    });
+    it('detectAnomalies flags outliers', () => {
+        const records = [{ value: 10 }, { value: 11 }, { value: 12 }, { value: 1000 }];
+        const anomalies = service.detectAnomalies(records, ['value'], 1.5);
+        expect(anomalies.length).toBeGreaterThan(0);
+        expect(anomalies.some((a) => a.value === 1000)).toBe(true);
+    });
+    it('completeness skips non-object items and returns passed when no objects processed', () => {
+        const check = service.completeness(['email']);
+        const result = check('not an object');
+        expect(result.passed).toBe(true);
+        expect(result.score).toBe(100);
+    });
+    it('runChecks handles check throwing', async () => {
+        service.registerCheck('throws', () => {
+            throw new Error('Check failed');
+        });
+        const report = await service.runChecks('ds', [{}]);
+        expect(report.checks).toHaveLength(1);
+        expect(report.checks[0].passed).toBe(false);
+        expect(report.checks[0].message).toBe('Check failed');
+    });
+    it('runChecks handles check throwing non-Error', async () => {
+        service.registerCheck('throws', () => {
+            throw 'string error';
+        });
+        const report = await service.runChecks('ds', [{}]);
+        expect(report.checks[0].message).toBe('Check failed');
+    });
+    it('runChecks with no checks returns score 100', async () => {
+        const report = await service.runChecks('ds', [{}]);
+        expect(report.score).toBe(100);
+    });
+    it('profile returns empty for empty records', () => {
+        const profile = service.profile('empty', []);
+        expect(profile.totalRows).toBe(0);
+        expect(profile.fields).toEqual({});
+    });
+});

package/dist/schema/schema.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Schema builder for data validation - fluent API
+ * Zero runtime dependencies. TypeScript-first with full type inference.
+ *
+ * Supported types: string, number, boolean, date, object, array, literal, union
+ * Modifiers: optional, nullable, default, transform, refine, refineAsync
+ * Utilities: toJsonSchema(), Infer<T>, validateAsync()
+ */
+export interface SchemaValidationError {
+    path: string;
+    message: string;
+}
+export type SchemaValidator<T = unknown> = (value: unknown) => {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: SchemaValidationError[];
+};
+type SyncResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: SchemaValidationError[];
+};
+export interface BaseSchema<T = unknown> {
+    readonly _type: T;
+    validate(value: unknown): SyncResult<T>;
+    validateAsync(value: unknown): Promise<SyncResult<T>>;
+    optional(): BaseSchema<T | undefined>;
+    nullable(): BaseSchema<T | null>;
+    default(value: NonNullable<T>): BaseSchema<T>;
+    transform<U>(fn: (value: T) => U): BaseSchema<U>;
+    refine(fn: (value: T) => boolean, message: string): BaseSchema<T>;
+    refineAsync(fn: (value: T) => Promise<boolean>, message: string): BaseSchema<T>;
+    toJsonSchema(): Record<string, unknown>;
+}
+/**
+ * Infer the output TypeScript type from a schema.
+ * @example
+ * const UserSchema = Schema.object({ name: Schema.string(), age: Schema.number() });
+ * type User = Infer<typeof UserSchema>; // { name: string; age: number }
+ */
+export type Infer<T extends BaseSchema<unknown>> = T extends BaseSchema<infer U> ? U : never;
+export interface StringSchema extends BaseSchema<string> {
+    email(): StringSchema;
+    url(): StringSchema;
+    min(length: number): StringSchema;
+    max(length: number): StringSchema;
+    uuid(): StringSchema;
+    oneOf(values: string[]): StringSchema;
+    pattern(regex: RegExp, message?: string): StringSchema;
+    required(): StringSchema;
+    trim(): StringSchema;
+    refine(fn: (value: string) => boolean, message: string): StringSchema;
+    refineAsync(fn: (value: string) => Promise<boolean>, message: string): StringSchema;
+    optional(): BaseSchema<string | undefined>;
+    nullable(): BaseSchema<string | null>;
+    default(value: string): StringSchema;
+    transform<U>(fn: (value: string) => U): BaseSchema<U>;
+}
+export interface NumberSchema extends BaseSchema<number> {
+    min(n: number): NumberSchema;
+    max(n: number): NumberSchema;
+    integer(): NumberSchema;
+    positive(): NumberSchema;
+    negative(): NumberSchema;
+    multipleOf(n: number): NumberSchema;
+    refine(fn: (value: number) => boolean, message: string): NumberSchema;
+    refineAsync(fn: (value: number) => Promise<boolean>, message: string): NumberSchema;
+    optional(): BaseSchema<number | undefined>;
+    nullable(): BaseSchema<number | null>;
+    default(value: number): NumberSchema;
+    transform<U>(fn: (value: number) => U): BaseSchema<U>;
+}
+export interface BooleanSchema extends BaseSchema<boolean> {
+    optional(): BaseSchema<boolean | undefined>;
+    nullable(): BaseSchema<boolean | null>;
+    default(value: boolean): BooleanSchema;
+    transform<U>(fn: (value: boolean) => U): BaseSchema<U>;
+}
+export interface DateSchema extends BaseSchema<Date> {
+    min(date: Date): DateSchema;
+    max(date: Date): DateSchema;
+    optional(): BaseSchema<Date | undefined>;
+    nullable(): BaseSchema<Date | null>;
+    default(value: Date): DateSchema;
+    transform<U>(fn: (value: Date) => U): BaseSchema<U>;
+}
+export interface ObjectSchema<T = Record<string, unknown>> extends BaseSchema<T> {
+    shape: Record<string, BaseSchema>;
+    strict(): ObjectSchema<T>;
+    pick<K extends keyof T>(keys: K[]): ObjectSchema<Pick<T, K>>;
+    omit<K extends keyof T>(keys: K[]): ObjectSchema<Omit<T, K>>;
+    extend<E extends Record<string, BaseSchema>>(extra: E): ObjectSchema<T & {
+        [K in keyof E]: Infer<E[K]>;
+    }>;
+    optional(): BaseSchema<T | undefined>;
+    nullable(): BaseSchema<T | null>;
+}
+export interface ArraySchema<T = unknown> extends BaseSchema<T[]> {
+    min(length: number): ArraySchema<T>;
+    max(length: number): ArraySchema<T>;
+    nonempty(): ArraySchema<T>;
+    optional(): BaseSchema<T[] | undefined>;
+    nullable(): BaseSchema<T[] | null>;
+}
+export interface LiteralSchema<T extends string | number | boolean> extends BaseSchema<T> {
+    readonly value: T;
+}
+export type UnionSchema<T> = BaseSchema<T>;
+type ShapeToType<S extends Record<string, BaseSchema>> = {
+    [K in keyof S]: Infer<S[K]>;
+};
+export declare const Schema: {
+    string(): StringSchema;
+    number(): NumberSchema;
+    boolean(): BooleanSchema;
+    date(): DateSchema;
+    object<S extends Record<string, BaseSchema>>(shape: S): ObjectSchema<ShapeToType<S>>;
+    array<T>(itemSchema: BaseSchema<T>): ArraySchema<T>;
+    literal<T extends string | number | boolean>(value: T): LiteralSchema<T>;
+    union<T extends BaseSchema<unknown>[]>(schemas: T): UnionSchema<Infer<T[number]>>;
+};
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema/schema.d.ts.map

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