pond-ts 0.11.2 → 0.11.4

package/dist/json.js

@@ -0,0 +1,142 @@
+/**
+ * JSON ↔ typed-row conversion primitives.
+ *
+ * Used by `TimeSeries.{toJSON,fromJSON}`, `LiveSeries.{toJSON,fromJSON,pushJson}`,
+ * and `Event.{toJsonRow}`. Extracted into its own module so `Event`
+ * can import the serialization helpers without depending on
+ * `TimeSeries` (which depends on `Event`, creating a cycle).
+ */
+import { Interval } from './Interval.js';
+import { Time } from './Time.js';
+import { TimeRange } from './TimeRange.js';
+import { parseTimestampString } from './calendar.js';
+/**
+ * Detects the object-shape variant of a JSON row.
+ */
+export function isJsonObjectRow(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parseJsonTimestamp(value, options = {}) {
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new TypeError('expected finite timestamp');
+        }
+        return value;
+    }
+    if (typeof value === 'string') {
+        return parseTimestampString(value, options);
+    }
+    if (value instanceof Date) {
+        return value.getTime();
+    }
+    throw new TypeError('expected timestamp as number or string');
+}
+/**
+ * Translate a JSON-shape key into a typed `EventKey` instance.
+ * Mirrors `TimeSeries.fromJSON`'s parsing rules: numeric/string/Date
+ * for time keys; tuple or object form for timeRange/interval.
+ */
+export function parseJsonKey(kind, value, options = {}) {
+    if (value instanceof Time ||
+        value instanceof TimeRange ||
+        value instanceof Interval) {
+        return value;
+    }
+    switch (kind) {
+        case 'time':
+            return new Time(parseJsonTimestamp(value, options));
+        case 'timeRange':
+            if (Array.isArray(value) && value.length === 2) {
+                return new TimeRange({
+                    start: parseJsonTimestamp(value[0], options),
+                    end: parseJsonTimestamp(value[1], options),
+                });
+            }
+            if (typeof value === 'object' &&
+                value !== null &&
+                'start' in value &&
+                'end' in value &&
+                !('value' in value)) {
+                return new TimeRange({
+                    start: parseJsonTimestamp(value.start, options),
+                    end: parseJsonTimestamp(value.end, options),
+                });
+            }
+            throw new TypeError('expected timeRange as [start, end] or { start, end }');
+        case 'interval':
+            if (Array.isArray(value) && value.length === 3) {
+                return new Interval({
+                    value: value[0],
+                    start: parseJsonTimestamp(value[1], options),
+                    end: parseJsonTimestamp(value[2], options),
+                });
+            }
+            if (typeof value === 'object' &&
+                value !== null &&
+                'value' in value &&
+                'start' in value &&
+                'end' in value) {
+                return new Interval({
+                    value: value.value,
+                    start: parseJsonTimestamp(value.start, options),
+                    end: parseJsonTimestamp(value.end, options),
+                });
+            }
+            throw new TypeError('expected interval as [value, start, end] or { value, start, end }');
+        default:
+            throw new TypeError(`unsupported first-column kind '${kind}'`);
+    }
+}
+/**
+ * Translate one JSON-shape row (array or object form) into a typed
+ * row tuple. Nulls become `undefined`; the key is parsed via
+ * {@link parseJsonKey}.
+ */
+export function parseJsonRow(schema, row, options = {}) {
+    const values = isJsonObjectRow(row)
+        ? schema.map((column) => row[column.name])
+        : row;
+    return Object.freeze(values.map((value, index) => {
+        if (value === null) {
+            return undefined;
+        }
+        const column = schema[index];
+        if (index === 0) {
+            return parseJsonKey(column.kind, value, options);
+        }
+        return value;
+    }));
+}
+/**
+ * Translate an array of JSON-shape rows into typed rows.
+ */
+export function parseJsonRows(schema, rows, options = {}) {
+    return rows.map((row) => parseJsonRow(schema, row, options));
+}
+/**
+ * Serialize an `EventKey` into the JSON-shape representation used
+ * on the wire.
+ */
+export function serializeJsonKey(kind, key, rowFormat) {
+    if (kind === 'time') {
+        return key.begin();
+    }
+    if (kind === 'timeRange') {
+        return rowFormat === 'object'
+            ? { start: key.begin(), end: key.end() }
+            : [key.begin(), key.end()];
+    }
+    const interval = key;
+    return rowFormat === 'object'
+        ? { value: interval.value, start: interval.begin(), end: interval.end() }
+        : [interval.value, interval.begin(), interval.end()];
+}
+/**
+ * Translate a column cell to its JSON-shape representation:
+ * `undefined` becomes `null` so wire messages round-trip through
+ * `JSON.stringify`.
+ */
+export function serializeJsonValue(value) {
+    return value === undefined ? null : value;
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

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

package/dist/types-public.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Type-only entry point at `pond-ts/types`.
+ *
+ * Lets schema-as-contract consumers — packages whose only job is to
+ * declare the `as const` schema that flows through producer /
+ * aggregator / web — constrain literals via `satisfies SeriesSchema`
+ * without taking a runtime dependency on `pond-ts`. The emitted JS
+ * for this entry is `export {};` (zero runtime); the .d.ts is a
+ * curated re-export of `types.ts`, so the source of truth doesn't
+ * drift.
+ *
+ * @example
+ * ```ts
+ * import type { SeriesSchema } from 'pond-ts/types';
+ *
+ * export const schema = [
+ *   { name: 'time', kind: 'time' },
+ *   { name: 'cpu', kind: 'number' },
+ *   { name: 'host', kind: 'string' },
+ * ] as const satisfies SeriesSchema;
+ * ```
+ *
+ * **What's included:** schema-shape types (`SeriesSchema`,
+ * `ColumnDef`, `FirstColumn`, `ValueColumn`, `ScalarKind`,
+ * `ColumnValue`, `ArrayValue`, ...), row-shape types (`RowForSchema`,
+ * `EventDataForSchema`, `EventForSchema`, `EventKeyForKind`,
+ * `EventKeyForSchema`), and wire (JSON-shape) types
+ * (`TimeSeriesJsonInput`, `JsonRowForSchema`,
+ * `JsonObjectRowForSchema`, `JsonValueForKind`, `JsonRowFormat`,
+ * `JsonTimestampInput`, `JsonTimeRangeInput`, `JsonIntervalInput`).
+ *
+ * **What's deliberately not included:**
+ * - **Operator-derived schema types** (`RollingSchema`,
+ *   `AggregateSchema`, etc.) — if you're using rolling, you're using
+ *   the runtime, and the main entry already covers you.
+ * - **`LiveSource` and other source interfaces** — they describe a
+ *   runtime contract (event subscription, dispatch). Schema-as-
+ *   contract consumers don't implement sources; if you're writing
+ *   one, import from the main entry.
+ *
+ * Existing `import { SeriesSchema } from 'pond-ts'` calls keep
+ * working unchanged.
+ */
+export type { ArrayValue, ColumnDef, ColumnValue, EventDataForSchema, EventForSchema, EventKeyForKind, EventKeyForSchema, FirstColKind, FirstColumn, JsonIntervalInput, JsonObjectRowForSchema, JsonRowForSchema, JsonRowFormat, JsonTimeRangeInput, JsonTimestampInput, JsonValueForKind, RowForSchema, ScalarKind, ScalarValue, SeriesSchema, TimeSeriesInput, TimeSeriesJsonInput, ValueColumn, ValueForKind, } from './types.js';
+//# sourceMappingURL=types-public.d.ts.map

package/dist/types-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-public.d.ts","sourceRoot":"","sources":["../src/types-public.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/types-public.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types-public.js.map

package/dist/types-public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-public.js","sourceRoot":"","sources":["../src/types-public.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pond-ts",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "description": "TypeScript-first time series primitives",
   "license": "MIT",
   "repository": {
@@ -15,6 +15,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types-public.d.ts",
+      "import": "./dist/types-public.js"
     }
   },
   "engines": {