pond-ts 0.1.0

package/dist/validate.js

@@ -0,0 +1,145 @@
+import { Interval } from './Interval.js';
+import { Event } from './Event.js';
+import { Time } from './Time.js';
+import { TimeRange } from './TimeRange.js';
+import { ValidationError } from './errors.js';
+const FIRST_COLUMN_KINDS = new Set([
+    'time',
+    'interval',
+    'timeRange',
+]);
+function assertCellKind(kind, value, row, col) {
+    if (value === undefined) {
+        return;
+    }
+    switch (kind) {
+        case 'time': {
+            const ok = value instanceof Time ||
+                (value instanceof Date && Number.isFinite(value.getTime())) ||
+                (typeof value === 'number' && Number.isFinite(value));
+            if (!ok) {
+                throw new ValidationError(`row ${row} col ${col}: expected time as Time, Date or finite number`);
+            }
+            return;
+        }
+        case 'interval': {
+            const ok = value instanceof Interval ||
+                (Array.isArray(value) &&
+                    value.length === 3 &&
+                    (typeof value[0] === 'string' || typeof value[0] === 'number')) ||
+                (!Array.isArray(value) &&
+                    typeof value === 'object' &&
+                    value !== null &&
+                    'value' in value &&
+                    'start' in value &&
+                    'end' in value);
+            if (!ok) {
+                throw new ValidationError(`row ${row} col ${col}: expected interval as Interval or { value, start, end }`);
+            }
+            return;
+        }
+        case 'timeRange': {
+            const ok = value instanceof TimeRange ||
+                (Array.isArray(value) && value.length === 2) ||
+                (!Array.isArray(value) &&
+                    typeof value === 'object' &&
+                    value !== null &&
+                    'start' in value &&
+                    'end' in value);
+            if (!ok) {
+                throw new ValidationError(`row ${row} col ${col}: expected timeRange as TimeRange or { start, end }`);
+            }
+            return;
+        }
+        case 'number': {
+            if (typeof value !== 'number' || !Number.isFinite(value)) {
+                throw new ValidationError(`row ${row} col ${col}: expected finite number`);
+            }
+            return;
+        }
+        case 'string': {
+            if (typeof value !== 'string') {
+                throw new ValidationError(`row ${row} col ${col}: expected string`);
+            }
+            return;
+        }
+        case 'boolean': {
+            if (typeof value !== 'boolean') {
+                throw new ValidationError(`row ${row} col ${col}: expected boolean`);
+            }
+            return;
+        }
+        default:
+            throw new ValidationError(`row ${row} col ${col}: unknown kind '${kind}'`);
+    }
+}
+function normalizeKey(kind, value, row, col) {
+    try {
+        switch (kind) {
+            case 'time':
+                return value instanceof Time ? value : new Time(value);
+            case 'timeRange':
+                return value instanceof TimeRange
+                    ? value
+                    : new TimeRange(value);
+            case 'interval':
+                return value instanceof Interval
+                    ? value
+                    : new Interval(value);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'invalid key';
+        throw new ValidationError(`row ${row} col ${col}: ${message}`);
+    }
+}
+function compareKeys(left, right) {
+    if (left.begin() !== right.begin()) {
+        return left.begin() - right.begin();
+    }
+    return left.end() - right.end();
+}
+export function validateAndNormalize(input) {
+    const { schema, rows } = input;
+    if (!schema.length) {
+        throw new ValidationError('schema must have at least one column');
+    }
+    if (!FIRST_COLUMN_KINDS.has(schema[0].kind)) {
+        throw new ValidationError('first column must be one of: time, interval, timeRange');
+    }
+    for (let col = 1; col < schema.length; col += 1) {
+        const kind = schema[col].kind;
+        if (kind !== 'number' && kind !== 'string' && kind !== 'boolean') {
+            throw new ValidationError(`column ${col} has unsupported value kind '${kind}'`);
+        }
+    }
+    const normalized = rows.map((row, rowIndex) => {
+        if (row.length !== schema.length) {
+            throw new ValidationError(`row ${rowIndex} expected ${schema.length} values, got ${row.length}`);
+        }
+        const keyDef = schema[0];
+        const rawKey = row[0];
+        const normalizedKey = normalizeKey(keyDef.kind, rawKey, rowIndex, 0);
+        const data = {};
+        for (let col = 1; col < schema.length; col += 1) {
+            const def = schema[col];
+            const value = row[col];
+            const required = def.required !== false;
+            if (value === undefined && required) {
+                throw new ValidationError(`row ${rowIndex} col ${col} (${def.name}) is required`);
+            }
+            assertCellKind(def.kind, value, rowIndex, col);
+            data[def.name] = value;
+        }
+        return new Event(normalizedKey, data);
+    });
+    for (let index = 1; index < normalized.length; index += 1) {
+        const previous = normalized[index - 1];
+        const current = normalized[index];
+        if (compareKeys(previous.key(), current.key()) > 0) {
+            throw new ValidationError(`row ${index} is out of order`);
+        }
+    }
+    return Object.freeze(normalized.slice());
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "pond-ts",
+  "version": "0.1.0",
+  "description": "TypeScript-first time series primitives",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pjm17971/pond-ts.git"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepack": "npm run build",
+    "test": "npm run test:type && npm run test:runtime",
+    "test:runtime": "vitest run",
+    "test:type": "tsc -p tsconfig.types.json",
+    "verify": "npm run format:check && npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "prettier": "^3.8.3",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  },
+  "dependencies": {
+    "@js-temporal/polyfill": "^0.5.1"
+  }
+}