@query-farm/vgi 0.19.1 → 0.21.0

package/dist/arrow/impl-arrowjs/index.d.ts

@@ -10,3 +10,10 @@ export { readCanonicalValue } from "./canonical.js";
 export { withBatchMetadata } from "./metadata.js";
 export { serializeSchema, deserializeSchema, serializeBatch, deserializeBatch, } from "./ipc.js";
 export { buildStatisticsBatch, type ColumnStatistics } from "./statistics.js";
+/**
+ * No-op on this backend: arrow-js `RecordBatch`/`Vector` already expose the
+ * full API worker code uses, and arrow-js is a peer dependency, so there is
+ * only ever one copy. Present so both backends satisfy one facade interface —
+ * see impl-flechette/compat.ts for what this does there.
+ */
+export declare function adoptArrowJsShape<T>(batch: T): T;

package/dist/arrow/impl-flechette/arrowjs-shape.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Attach `isSigned` to a flechette Int type, recursing through children /
+ * dictionary / index types.
+ *
+ * The alias is a non-enumerable getter so it never shows up in structural
+ * comparisons, IPC encoding or `Object.keys` — flechette keeps writing
+ * `signed`, and this is purely a read-side view of it. Mutating in place is
+ * safe: these objects are freshly built per decode.
+ */
+export declare function aliasIntSigned<T>(type: T): T;
+/**
+ * Bring a freshly decoded flechette schema up to the arrow-js shape shared
+ * code expects: every field (and nested child field) has a metadata `Map`,
+ * and every Int type answers to `isSigned`.
+ */
+export declare function normalizeDecodedSchema<T>(schema: T): T;

package/dist/arrow/impl-flechette/compat.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Give a batch the arrow-js shape even when it was not built by our copy of
+ * flechette.
+ *
+ * The prototype patches above are scoped to one module instance. npm/bun will
+ * happily install a *second* copy of `@query-farm/flechette` — nested under
+ * `@query-farm/vgi-rpc`, say, whenever the two version ranges disagree even
+ * transiently — and then batches decoded off the wire by vgi-rpc are instances
+ * of classes our patches never touched. Worker code that has been calling
+ * `col.isValid(i)` happily for the whole bind phase suddenly gets
+ * `TypeError: col.isValid is not a function` on the first exchange round, with
+ * nothing in the stack to suggest the cause. That is not hypothetical: it took
+ * out four integration tests, and a duplicate copy is invisible to
+ * `bun install` output and to the lockfile, which lists flechette once.
+ *
+ * So rather than trusting module identity, patch whatever prototypes we are
+ * actually handed, once each. `adopted` keeps it to a WeakSet probe per call.
+ *
+ * Returns its argument (mutating prototypes, not the batch) so call sites can
+ * wrap inline.
+ */
+export declare function adoptArrowJsShape<T>(batch: T): T;

package/dist/arrow/impl-flechette/index.d.ts

@@ -1,4 +1,5 @@
 import type { VgiBackendInfo } from "../types.js";
+import "./compat.js";
 export declare const backend: VgiBackendInfo;
 export { schema, field, nullType, bool, int, int8, int16, int32, int64, uint8, uint16, uint32, uint64, float16, float32, float64, utf8, binary, fixedSizeBinary, decimal, decimal128, decimal256, date, dateDay, dateMillisecond, time, timeSecond, timeMillisecond, timeMicrosecond, timeNanosecond, timestamp, duration, interval, list, fixedSizeList, struct, map, dictionary, union, sparseUnion, denseUnion, TimeUnit, DateUnit, IntervalUnit, UnionMode, } from "./schema.js";
 export { emptyBatch } from "./empty.js";
@@ -10,3 +11,4 @@ export { readCanonicalValue } from "./canonical.js";
 export { withBatchMetadata } from "./metadata.js";
 export { serializeSchema, deserializeSchema, serializeBatch, deserializeBatch, } from "./ipc.js";
 export { buildStatisticsBatch, type ColumnStatistics } from "./statistics.js";
+export { adoptArrowJsShape } from "./compat.js";

package/dist/arrow/impl-flechette/ipc.d.ts

@@ -30,4 +30,4 @@ export declare function serializeBatch(batch: VgiBatch): Uint8Array;
  * multi-batch streams this collapses to a single logical batch, matching
  * the subprocess transport's one-batch-per-call convention.
  */
-export declare function deserializeBatch(bytes: Uint8Array): VgiBatch;
+export declare function deserializeBatch(input: Uint8Array): VgiBatch;

package/dist/arrow/index.d.ts

@@ -1,6 +1,6 @@
 export type { VgiTypeId, VgiDataType, VgiField, VgiSchema, VgiColumn, VgiColumnData, VgiBatch, VgiBackendInfo, TaggedUnion, } from "./types.js";
-export { TypeId, isNull, isInt, isFloat, isBinary, isUtf8, isBool, isDecimal, isDate, isTime, isTimestamp, isInterval, isList, isStruct, isUnion, isFixedSizeBinary, isFixedSizeList, isMap, isDuration, isDictionary, isBatch, } from "./predicates.js";
-export { backend, emptyBatch, batchFromRows, batchFromColumns, columnFromArray, iterRows, batchToScalarDict, batchToSecretDict, safeNumber, decodeDictValue, filterBatch, projectSchema, projectBatch, withBatchMetadata, readCanonicalValue, serializeSchema, deserializeSchema, serializeBatch, deserializeBatch, buildStatisticsBatch, } from "#arrow-impl";
+export { TypeId, isNull, isInt, isFloat, isBinary, isUtf8, isBool, isDecimal, isDate, isTime, isTimestamp, isInterval, isList, isStruct, isUnion, isFixedSizeBinary, isFixedSizeList, isMap, isDuration, isDictionary, isBatch, typeSignature, } from "./predicates.js";
+export { backend, emptyBatch, batchFromRows, batchFromColumns, columnFromArray, iterRows, batchToScalarDict, batchToSecretDict, safeNumber, decodeDictValue, filterBatch, projectSchema, projectBatch, withBatchMetadata, adoptArrowJsShape, readCanonicalValue, serializeSchema, deserializeSchema, serializeBatch, deserializeBatch, buildStatisticsBatch, } from "#arrow-impl";
 export type { ColumnStatistics } from "#arrow-impl";
 export { schema, field, nullType, bool, int, int8, int16, int32, int64, uint8, uint16, uint32, uint64, float16, float32, float64, utf8, binary, fixedSizeBinary, decimal, decimal128, decimal256, date, dateDay, dateMillisecond, time, timeSecond, timeMillisecond, timeMicrosecond, timeNanosecond, timestamp, duration, interval, timestampSeconds, timestampMillis, timestampMicros, timestampNanos, durationSeconds, durationMillis, durationMicros, durationNanos, list, fixedSizeList, struct, map, dictionary, union, sparseUnion, denseUnion, TimeUnit, DateUnit, IntervalUnit, UnionMode, } from "./schema-types.js";
 export type { NullDescriptor, BoolType, IntType, Int8Type, Int16Type, Int32Type, Int64Type, Uint8Type, Uint16Type, Uint32Type, Uint64Type, FloatType, Utf8Type, LargeUtf8Type, BinaryType, LargeBinaryType, FixedSizeBinaryType, DecimalType, Date32Type, Date64Type, Time32Type, Time64Type, TimestampType, DurationType, IntervalType, ListType, FixedSizeListType, StructType, MapType, DictionaryType, UnionType, TypedField, TUnit, } from "./codec/type-descriptors.js";

package/dist/arrow/predicates.d.ts

@@ -41,6 +41,22 @@ export declare function isFixedSizeList(t: VgiDataType): boolean;
 export declare function isMap(t: VgiDataType): boolean;
 export declare function isDuration(t: VgiDataType): boolean;
 export declare function isDictionary(t: VgiDataType): boolean;
+/**
+ * Stable structural identity for an Arrow type, usable for equality.
+ *
+ * `String(type)` is NOT usable for this: arrow-js DataTypes are class
+ * instances with a meaningful `toString()` ("Int64", "Utf8", …), while
+ * flechette types are plain object literals that stringify to
+ * "[object Object]". Comparing with `toString()` therefore reports *every*
+ * flechette type as equal to every other, and never equal to a declared
+ * arrow-js type — which collapsed overload resolution to a first-match tie
+ * (`type_info(42::BIGINT)` picked the INTEGER overload).
+ *
+ * Both libraries agree on `typeId` and on the parameter *values*; they differ
+ * only on a few property names, so those are read under both spellings. The
+ * output is an opaque key — compare it, don't display it.
+ */
+export declare function typeSignature(t: VgiDataType | null | undefined): string;
 /** Runtime check: does `x` quack like a VgiBatch? Used at API boundaries
  *  where callers may pass either a batch or a plain column dict. Duck-typed
  *  because arrow-js and flechette use unrelated classes. */

package/dist/cache-control.d.ts

@@ -35,6 +35,7 @@ export declare const CACHE_REVALIDATABLE_KEY = "vgi.cache.revalidatable";
 export declare const CACHE_STALE_WHILE_REVALIDATE_KEY = "vgi.cache.stale_while_revalidate";
 export declare const CACHE_STALE_IF_ERROR_KEY = "vgi.cache.stale_if_error";
 export declare const CACHE_NOT_MODIFIED_KEY = "vgi.cache.not_modified";
+export declare const CACHE_PARTITION_SCOPE_KEY = "vgi.cache.partition_scope";
 export declare const CACHE_IF_NONE_MATCH_KEY = "vgi.cache.if_none_match";
 export declare const CACHE_IF_MODIFIED_SINCE_KEY = "vgi.cache.if_modified_since";
 export declare const CACHE_SCOPE_CATALOG = "catalog";
@@ -75,6 +76,12 @@ export interface CacheControl {
      *  assert the client's stored payload is still fresh (the client reuses it
      *  instead of re-streaming). */
     notModified?: boolean;
+    /** Opt in to per-PARTITION caching: in addition to the whole-scan entry, the
+     *  client stores the result split by distinct partition tuple, so a later
+     *  `=`/`IN`-filtered scan on the partition column(s) can serve the requested
+     *  partitions without calling the worker. Only meaningful for a
+     *  `SINGLE_VALUE_PARTITIONS` table function; purely additive. */
+    partitionScope?: boolean;
 }
 /**
  * Render a {@link CacheControl} to the `vgi.cache.*` batch-metadata map.

package/dist/client-entry.js

@@ -122,6 +122,7 @@ __export(exports_impl_arrowjs, {
   batchFromRows: () => batchFromRows,
   batchFromColumns: () => batchFromColumns,
   backend: () => backend,
+  adoptArrowJsShape: () => adoptArrowJsShape,
   UnionMode: () => UnionMode,
   TimeUnit: () => TimeUnit,
   IntervalUnit: () => IntervalUnit,
@@ -1758,6 +1759,9 @@ function assemble(columnNames, minData, maxData, hasNull, hasNotNull, distinctCo
 
 // src/arrow/impl-arrowjs/index.ts
 var backend = { name: "arrow-js" };
+function adoptArrowJsShape(batch) {
+  return batch;
+}
 // src/arrow/schema-types.ts
 var { TimeUnit: TimeUnit2, DateUnit: DateUnit3, IntervalUnit: IntervalUnit2, UnionMode: UnionMode2, schema: schema2 } = exports_impl_arrowjs;
 function field2(name, type, nullable, metadata) {
@@ -3917,4 +3921,4 @@ export {
   ArgumentValidationError
 };
 
-//# debugId=7B4A06FF3B2070C464756E2164756E21
+//# debugId=D04A9CC224B063B264756E2164756E21