@semics-tech/mongolite 1.1.0 → 1.3.0

package/dist/cli/schema.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Schema inference for the guided CLI.
+ *
+ * MongoLite stores documents as JSON, so there is no declared schema to read.
+ * We sample documents and derive the field paths, their types, how often they
+ * appear and a handful of example values. That is enough to offer the user a
+ * list of "columns" to filter and sort on without them knowing anything about
+ * the shape of the data up front.
+ */
+export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'null';
+export interface InferredField {
+    /** Dotted path, e.g. `address.city`. */
+    path: string;
+    /** Every type observed at this path, most frequent first. */
+    types: FieldType[];
+    /** The most frequently observed type - what the UI builds prompts around. */
+    primaryType: FieldType;
+    /** Number of sampled documents that contain this path. */
+    count: number;
+    /** Fraction of sampled documents containing this path (0-1). */
+    presence: number;
+    /** Up to `MAX_SAMPLES` distinct example values, in first-seen order. */
+    examples: unknown[];
+    /** For arrays: the types seen inside the array. */
+    elementTypes?: FieldType[];
+    /** For arrays of objects: the field paths found on the elements. */
+    elementFields?: string[];
+    /** True when every observed value at this path was one of a small set. */
+    lowCardinality: boolean;
+    /** Distinct values seen, when there were few enough to be worth offering. */
+    distinctValues?: unknown[];
+}
+export interface InferredSchema {
+    /** Number of documents inspected. */
+    sampled: number;
+    fields: InferredField[];
+}
+/** Classify a single JSON value into one of our display types. */
+export declare function valueType(value: unknown): FieldType;
+export interface InferOptions {
+    /** How deep to descend into nested objects. Default 3. */
+    maxDepth?: number;
+}
+/**
+ * Infer a schema from a sample of documents.
+ * Fields are ordered by how commonly they appear, then alphabetically, with
+ * `_id` pinned first so result tables always lead with the identifier.
+ */
+export declare function inferSchema(docs: Record<string, unknown>[], options?: InferOptions): InferredSchema;
+/**
+ * Pick a sensible default set of columns for a results table: shallow, common,
+ * scalar-ish fields, leading with `_id`.
+ */
+export declare function defaultColumns(schema: InferredSchema, max?: number): string[];
+/** Read a dotted path out of a document, descending through objects. */
+export declare function getPath(doc: unknown, path: string): unknown;
+/** Human-readable one-line summary of a field, used as a menu hint. */
+export declare function describeField(field: InferredField): string;

package/dist/cli/schema.js

@@ -0,0 +1,205 @@
+/**
+ * Schema inference for the guided CLI.
+ *
+ * MongoLite stores documents as JSON, so there is no declared schema to read.
+ * We sample documents and derive the field paths, their types, how often they
+ * appear and a handful of example values. That is enough to offer the user a
+ * list of "columns" to filter and sort on without them knowing anything about
+ * the shape of the data up front.
+ */
+const MAX_SAMPLES = 5;
+const MAX_DISTINCT = 25;
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/;
+/** Classify a single JSON value into one of our display types. */
+export function valueType(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (value instanceof Date)
+        return 'date';
+    if (Array.isArray(value))
+        return 'array';
+    if (typeof value === 'string')
+        return ISO_DATE.test(value) ? 'date' : 'string';
+    if (typeof value === 'number')
+        return 'number';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    if (typeof value === 'object')
+        return 'object';
+    return 'string';
+}
+function accumulator(path) {
+    return {
+        path,
+        typeCounts: new Map(),
+        count: 0,
+        examples: [],
+        distinct: new Map(),
+        distinctOverflow: false,
+        elementTypes: new Set(),
+        elementFields: new Set(),
+    };
+}
+function isPlainObject(value) {
+    return (typeof value === 'object' && value !== null && !Array.isArray(value) && !(value instanceof Date));
+}
+function recordValue(acc, value) {
+    const type = valueType(value);
+    acc.count += 1;
+    acc.typeCounts.set(type, (acc.typeCounts.get(type) ?? 0) + 1);
+    if (acc.examples.length < MAX_SAMPLES && value !== null && value !== undefined) {
+        const alreadySeen = acc.examples.some((existing) => stableKey(existing) === stableKey(value));
+        if (!alreadySeen)
+            acc.examples.push(value);
+    }
+    // Track distinct values for scalars only - object/array equality is not worth
+    // the noise, and a "pick a value" prompt only makes sense for scalars.
+    if (type === 'string' || type === 'number' || type === 'boolean' || type === 'date') {
+        if (!acc.distinctOverflow) {
+            const key = stableKey(value);
+            if (!acc.distinct.has(key)) {
+                if (acc.distinct.size >= MAX_DISTINCT) {
+                    acc.distinctOverflow = true;
+                    acc.distinct.clear();
+                }
+                else {
+                    acc.distinct.set(key, value);
+                }
+            }
+        }
+    }
+    if (Array.isArray(value)) {
+        for (const element of value) {
+            acc.elementTypes.add(valueType(element));
+            if (isPlainObject(element)) {
+                for (const key of Object.keys(element))
+                    acc.elementFields.add(key);
+            }
+        }
+    }
+}
+function stableKey(value) {
+    if (value instanceof Date)
+        return `date:${value.toISOString()}`;
+    if (typeof value === 'object' && value !== null)
+        return `json:${JSON.stringify(value)}`;
+    return `${typeof value}:${String(value)}`;
+}
+function walk(doc, prefix, depth, maxDepth, fields) {
+    for (const [key, value] of Object.entries(doc)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        let acc = fields.get(path);
+        if (!acc) {
+            acc = accumulator(path);
+            fields.set(path, acc);
+        }
+        recordValue(acc, value);
+        if (isPlainObject(value) && depth < maxDepth) {
+            walk(value, path, depth + 1, maxDepth, fields);
+        }
+    }
+}
+/**
+ * Infer a schema from a sample of documents.
+ * Fields are ordered by how commonly they appear, then alphabetically, with
+ * `_id` pinned first so result tables always lead with the identifier.
+ */
+export function inferSchema(docs, options = {}) {
+    const maxDepth = options.maxDepth ?? 3;
+    const fields = new Map();
+    for (const doc of docs) {
+        if (!isPlainObject(doc))
+            continue;
+        walk(doc, '', 1, maxDepth, fields);
+    }
+    const total = docs.length || 1;
+    const inferred = [...fields.values()].map((acc) => {
+        const types = [...acc.typeCounts.entries()].sort((a, b) => b[1] - a[1]).map(([type]) => type);
+        // Prefer a concrete type over `null` when a field is sometimes empty.
+        const primaryType = types.find((t) => t !== 'null') ?? types[0] ?? 'null';
+        const distinctValues = acc.distinctOverflow ? undefined : [...acc.distinct.values()];
+        return {
+            path: acc.path,
+            types,
+            primaryType,
+            count: acc.count,
+            presence: acc.count / total,
+            examples: acc.examples,
+            elementTypes: acc.elementTypes.size ? [...acc.elementTypes] : undefined,
+            elementFields: acc.elementFields.size ? [...acc.elementFields].sort() : undefined,
+            lowCardinality: Boolean(distinctValues && distinctValues.length > 0 && distinctValues.length <= 12),
+            distinctValues,
+        };
+    });
+    inferred.sort((a, b) => {
+        if (a.path === '_id')
+            return -1;
+        if (b.path === '_id')
+            return 1;
+        const depthDiff = a.path.split('.').length - b.path.split('.').length;
+        if (depthDiff !== 0)
+            return depthDiff;
+        if (b.count !== a.count)
+            return b.count - a.count;
+        return a.path.localeCompare(b.path);
+    });
+    return { sampled: docs.length, fields: inferred };
+}
+/**
+ * Pick a sensible default set of columns for a results table: shallow, common,
+ * scalar-ish fields, leading with `_id`.
+ */
+export function defaultColumns(schema, max = 6) {
+    const scalarish = ['string', 'number', 'boolean', 'date'];
+    const candidates = schema.fields.filter((field) => field.path !== '_id' &&
+        !field.path.includes('.') &&
+        field.presence >= 0.5 &&
+        scalarish.includes(field.primaryType));
+    const columns = candidates.slice(0, max - 1).map((field) => field.path);
+    const hasId = schema.fields.some((field) => field.path === '_id');
+    if (columns.length === 0) {
+        // Nothing scalar and shallow - fall back to whatever we do have.
+        const fallback = schema.fields
+            .filter((field) => field.path !== '_id' && !field.path.includes('.'))
+            .slice(0, max - 1)
+            .map((field) => field.path);
+        return hasId ? ['_id', ...fallback] : fallback;
+    }
+    return hasId ? ['_id', ...columns] : columns;
+}
+/** Read a dotted path out of a document, descending through objects. */
+export function getPath(doc, path) {
+    return path.split('.').reduce((current, segment) => {
+        if (current === null || current === undefined)
+            return undefined;
+        if (Array.isArray(current)) {
+            const index = Number.parseInt(segment, 10);
+            return Number.isInteger(index) ? current[index] : undefined;
+        }
+        if (typeof current === 'object')
+            return current[segment];
+        return undefined;
+    }, doc);
+}
+/** Human-readable one-line summary of a field, used as a menu hint. */
+export function describeField(field) {
+    const parts = [];
+    const type = field.primaryType === 'array' && field.elementTypes?.length
+        ? `array of ${field.elementTypes.filter((t) => t !== 'null').join('/') || 'values'}`
+        : field.primaryType;
+    parts.push(type);
+    if (field.presence < 0.999) {
+        parts.push(`in ${Math.round(field.presence * 100)}% of docs`);
+    }
+    if (field.examples.length > 0) {
+        const example = field.examples[0];
+        const rendered = example instanceof Date
+            ? example.toISOString()
+            : typeof example === 'object'
+                ? JSON.stringify(example)
+                : String(example);
+        parts.push(`e.g. ${rendered.length > 30 ? `${rendered.slice(0, 29)}…` : rendered}`);
+    }
+    return `— ${parts.join(', ')}`;
+}
+//# sourceMappingURL=schema.js.map

package/dist/cli/schema.js.map

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

package/dist/cli/ui.d.ts

@@ -0,0 +1,71 @@
+export declare const isInteractive: () => boolean;
+export declare const style: {
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    italic: (text: string) => string;
+    underline: (text: string) => string;
+    red: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    blue: (text: string) => string;
+    magenta: (text: string) => string;
+    cyan: (text: string) => string;
+    grey: (text: string) => string;
+};
+/** Visible width of a string, ignoring ANSI escape sequences. */
+export declare function displayWidth(text: string): number;
+/** Truncate to `max` visible characters, appending an ellipsis when cut. */
+export declare function truncate(text: string, max: number): string;
+export declare function terminalWidth(): number;
+export interface Choice<T> {
+    /** Text shown in the list. */
+    label: string;
+    /** Value returned when the choice is picked. */
+    value: T;
+    /** Dimmed text shown to the right of the label. */
+    hint?: string;
+    /** Renders as a non-selectable heading. */
+    separator?: boolean;
+}
+export interface SelectOptions<T> {
+    message: string;
+    choices: Choice<T>[];
+    pageSize?: number;
+    initialIndex?: number;
+    /** Extra guidance rendered under the question. */
+    hint?: string;
+}
+/** Thrown when the user aborts a prompt with Esc or Ctrl+C. */
+export declare class PromptCancelledError extends Error {
+    constructor();
+}
+/**
+ * Ask the user to pick one of `choices`.
+ * Interactive terminals get an arrow-key menu with type-to-filter; everything
+ * else gets a numbered list.
+ */
+export declare function select<T>(options: SelectOptions<T>): Promise<T>;
+/** Release the shared interface so the process can exit. */
+export declare function closePrompts(): void;
+/** Read a single line from stdin. */
+export declare function question(prompt: string): Promise<string>;
+export interface TextOptions {
+    message: string;
+    defaultValue?: string;
+    /** Return an error string to re-prompt, or undefined when the value is fine. */
+    validate?: (value: string) => string | undefined;
+    allowEmpty?: boolean;
+    hint?: string;
+}
+/** Ask for free-text input, re-prompting until `validate` is happy. */
+export declare function text(options: TextOptions): Promise<string>;
+/** Ask for multi-line input; a blank line ends the entry. */
+export declare function multilineText(message: string): Promise<string>;
+export declare function confirm(message: string, defaultValue?: boolean): Promise<boolean>;
+/** Wait for the user before scrolling more output past them. */
+export declare function pause(message?: string): Promise<void>;
+export declare function heading(text: string): void;
+export declare function info(text: string): void;
+export declare function warn(text: string): void;
+export declare function error(text: string): void;
+export declare function success(text: string): void;