@aigne/afs-did-space 1.12.0-beta.5

package/dist/tree-query.d.cts

@@ -0,0 +1,70 @@
+import { AFSAggregateGroup, AFSAggregateOp, AFSCollectionQueryGroup, AFSCollectionQuerySpec, AFSTimeGranularity } from "@aigne/afs";
+
+//#region src/tree-query.d.ts
+/** One result row — index-level shape (provider maps to AFSEntry). */
+interface TreeQueryRow {
+  /** Tree path (dir rows keep their trailing slash, same as listChildren). */
+  path: string;
+  /** Child basename (the keyset tie column). */
+  name: string;
+  kind: "file" | "dir";
+  cid: string;
+  size: number;
+  mtime: number;
+  ctime: number;
+  mimeType?: string;
+  /** Raw record text (doc-joined for dir rows / inline content for file rows). */
+  content?: string;
+  /** cid of the joined doc sub-file (dir rows only) — caller re-verifies. */
+  contentCid?: string;
+  /**
+   * Application metadata column (entries.metadata, parsed) — surfaced when
+   * the row carries it so the in-memory query path can dispatch `meta.*`
+   * filter / orderBy against the same data the SQL path reads from
+   * `entries.metadata` (planning/agent-hub/metadata-foundation.md).
+   */
+  metadata?: Record<string, unknown>;
+}
+interface TreeQueryResult {
+  rows: TreeQueryRow[];
+  /**
+   * Exact post-WHERE total. In aggregate mode this is the number of GROUP
+   * rows pre-pagination (mirrors the core reference evaluator).
+   */
+  total: number;
+  cursor?: string;
+  groups?: AFSCollectionQueryGroup[];
+  /** Aggregate-mode result rows (parallel to {@link AFSCollectionQueryResult.aggregateGroups}). */
+  aggregateGroups?: AFSAggregateGroup[];
+  /**
+   * Present when the spec carried `seekId`. The 0-based index of the sought
+   * entry in the sorted+filtered set, or -1 when not found.
+   * Mirrors {@link AFSCollectionQueryResult.seekOffset}.
+   */
+  seekOffset?: number;
+}
+/** The spec subset a TreeIndex engine executes (validated + provider-checked). */
+interface TreeQuerySpec {
+  doc?: string;
+  where?: AFSCollectionQuerySpec["where"];
+  orderBy?: [string, "asc" | "desc"][];
+  groupBy?: string | string[];
+  count?: boolean;
+  /**
+   * Skip the exact-total count pass (afs-collection-query). When true the
+   * engine does NOT build/run the `count` statement and the result carries
+   * `total: -1` ("not computed" sentinel). See AFSCollectionQuerySpec.skipTotal.
+   */
+  skipTotal?: boolean;
+  limit?: number;
+  offset?: number;
+  cursor?: string;
+  /** Cross-page seek — mirrors {@link AFSCollectionQuerySpec.seekId}. */
+  seekId?: string;
+  aggregations?: AFSAggregateOp[];
+  timeGranularity?: AFSTimeGranularity;
+  timeBucketField?: string;
+}
+//#endregion
+export { TreeQueryResult, TreeQuerySpec };
+//# sourceMappingURL=tree-query.d.cts.map

package/dist/tree-query.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-query.d.cts","names":[],"sources":["../src/tree-query.ts"],"mappings":";;;;UAiDiB,YAAA;EAkCG;EAhClB,IAAA;EAgCmC;EA9BnC,IAAA;EACA,IAAA;EACA,GAAA;EACA,IAAA;EACA,KAAA;EACA,KAAA;EACA,QAAA;EAwBkB;EAtBlB,OAAA;EA4BU;EA1BV,UAAA;EA8Be;;;;;;EAvBf,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,eAAA;EACf,IAAA,EAAM,YAAA;EAqBE;;;;EAhBR,KAAA;EACA,MAAA;EACA,MAAA,GAAS,uBAAA;EA0BT;EAxBA,eAAA,GAAkB,iBAAA;EA6BlB;;;;;EAvBA,UAAA;AAAA;;UAIe,aAAA;EACf,GAAA;EACA,KAAA,GAAQ,sBAAA;EACR,OAAA;EACA,OAAA;EACA,KAAA;;;;;;EAMA,SAAA;EACA,KAAA;EACA,MAAA;EACA,MAAA;;EAEA,MAAA;EAGA,YAAA,GAAe,cAAA;EACf,eAAA,GAAkB,kBAAA;EAClB,eAAA;AAAA"}

package/dist/tree-query.d.mts

@@ -0,0 +1,70 @@
+import { AFSAggregateGroup, AFSAggregateOp, AFSCollectionQueryGroup, AFSCollectionQuerySpec, AFSTimeGranularity } from "@aigne/afs";
+
+//#region src/tree-query.d.ts
+/** One result row — index-level shape (provider maps to AFSEntry). */
+interface TreeQueryRow {
+  /** Tree path (dir rows keep their trailing slash, same as listChildren). */
+  path: string;
+  /** Child basename (the keyset tie column). */
+  name: string;
+  kind: "file" | "dir";
+  cid: string;
+  size: number;
+  mtime: number;
+  ctime: number;
+  mimeType?: string;
+  /** Raw record text (doc-joined for dir rows / inline content for file rows). */
+  content?: string;
+  /** cid of the joined doc sub-file (dir rows only) — caller re-verifies. */
+  contentCid?: string;
+  /**
+   * Application metadata column (entries.metadata, parsed) — surfaced when
+   * the row carries it so the in-memory query path can dispatch `meta.*`
+   * filter / orderBy against the same data the SQL path reads from
+   * `entries.metadata` (planning/agent-hub/metadata-foundation.md).
+   */
+  metadata?: Record<string, unknown>;
+}
+interface TreeQueryResult {
+  rows: TreeQueryRow[];
+  /**
+   * Exact post-WHERE total. In aggregate mode this is the number of GROUP
+   * rows pre-pagination (mirrors the core reference evaluator).
+   */
+  total: number;
+  cursor?: string;
+  groups?: AFSCollectionQueryGroup[];
+  /** Aggregate-mode result rows (parallel to {@link AFSCollectionQueryResult.aggregateGroups}). */
+  aggregateGroups?: AFSAggregateGroup[];
+  /**
+   * Present when the spec carried `seekId`. The 0-based index of the sought
+   * entry in the sorted+filtered set, or -1 when not found.
+   * Mirrors {@link AFSCollectionQueryResult.seekOffset}.
+   */
+  seekOffset?: number;
+}
+/** The spec subset a TreeIndex engine executes (validated + provider-checked). */
+interface TreeQuerySpec {
+  doc?: string;
+  where?: AFSCollectionQuerySpec["where"];
+  orderBy?: [string, "asc" | "desc"][];
+  groupBy?: string | string[];
+  count?: boolean;
+  /**
+   * Skip the exact-total count pass (afs-collection-query). When true the
+   * engine does NOT build/run the `count` statement and the result carries
+   * `total: -1` ("not computed" sentinel). See AFSCollectionQuerySpec.skipTotal.
+   */
+  skipTotal?: boolean;
+  limit?: number;
+  offset?: number;
+  cursor?: string;
+  /** Cross-page seek — mirrors {@link AFSCollectionQuerySpec.seekId}. */
+  seekId?: string;
+  aggregations?: AFSAggregateOp[];
+  timeGranularity?: AFSTimeGranularity;
+  timeBucketField?: string;
+}
+//#endregion
+export { TreeQueryResult, TreeQuerySpec };
+//# sourceMappingURL=tree-query.d.mts.map

package/dist/tree-query.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-query.d.mts","names":[],"sources":["../src/tree-query.ts"],"mappings":";;;;UAiDiB,YAAA;EAkCG;EAhClB,IAAA;EAgCmC;EA9BnC,IAAA;EACA,IAAA;EACA,GAAA;EACA,IAAA;EACA,KAAA;EACA,KAAA;EACA,QAAA;EAwBkB;EAtBlB,OAAA;EA4BU;EA1BV,UAAA;EA8Be;;;;;;EAvBf,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,eAAA;EACf,IAAA,EAAM,YAAA;EAqBE;;;;EAhBR,KAAA;EACA,MAAA;EACA,MAAA,GAAS,uBAAA;EA0BT;EAxBA,eAAA,GAAkB,iBAAA;EA6BlB;;;;;EAvBA,UAAA;AAAA;;UAIe,aAAA;EACf,GAAA;EACA,KAAA,GAAQ,sBAAA;EACR,OAAA;EACA,OAAA;EACA,KAAA;;;;;;EAMA,SAAA;EACA,KAAA;EACA,MAAA;EACA,MAAA;;EAEA,MAAA;EAGA,YAAA,GAAe,cAAA;EACf,eAAA,GAAkB,kBAAA;EAClB,eAAA;AAAA"}