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

package/dist/sqlite-tree-index.d.cts

@@ -0,0 +1,107 @@
+import { TreeQueryResult, TreeQuerySpec } from "./tree-query.cjs";
+import { DirtyPathRow, ListDirtyPathOptions } from "./dirty-path-queue.cjs";
+import { BatchDeleteEntry, BatchDeleteEntryResult, BatchIndexContext, BatchPutEntry, BatchPutEntryResult, ChangelogEntry, PutOpts, TreeEntry, TreeIndex, TreeIndexListEntriesResult, TreeIndexListOptions, TreeIndexListResult } from "./tree-index.cjs";
+import { MetadataDB } from "./metadata-db.cjs";
+import { InlineContentOptions } from "./inline-content.cjs";
+
+//#region src/sqlite-tree-index.d.ts
+declare class SQLiteTreeIndex implements TreeIndex {
+  private readonly scope;
+  private readonly client;
+  private readonly maxEntriesPerScope;
+  /** upload-limits Phase 5 byte quota (0 = disabled, the opt-in default). */
+  private readonly maxBytesPerScope;
+  private readonly inline;
+  constructor(db: MetadataDB, scope: string, opts?: {
+    maxEntriesPerScope?: number;
+    maxBytesPerScope?: number;
+  } & InlineContentOptions);
+  /**
+   * Current Σ size of this scope's file rows (upload-limits Phase 5 byte quota).
+   * SQLite (local Node) has no D1 rows_read billing, so a direct `SUM(size)` is
+   * fine here — same pattern as the file-count quota's `count("")` scan (the
+   * trigger-maintained `scope_meta.total_bytes` is a D1-only optimization).
+   */
+  private scopeTotalBytes;
+  get(path: string, opts?: {
+    includeContent?: boolean;
+  }): Promise<TreeEntry | null>;
+  getDirTimes(dirPath: string): Promise<{
+    ctime: number;
+    mtime: number;
+  } | null>;
+  put(path: string, entry: TreeEntry, opts: PutOpts): Promise<{
+    oldCid?: string;
+  }>;
+  /** Inline content this entry would store — drives loopBatchPutEntries' content-aware skip. */
+  inlineForEntry(entry: TreeEntry): Promise<string | null>;
+  /** Point seek on the `(scope, dedup_scope, dedup_key)` partial UNIQUE index. */
+  findByDedupKey(dedupScope: string, dedupKey: string): Promise<({
+    path: string;
+  } & TreeEntry) | null>;
+  /** Index-only backfill: set the dedup columns without touching content/changelog. */
+  setDedupKey(path: string, dedupScope: string, dedupKey: string, opts: PutOpts): Promise<void>;
+  getPrefixWatermark(prefix: string): Promise<number | null>;
+  /**
+   * Build the file-row UPSERT. Inline-enabled indexes always write the
+   * content column (inline copy or NULL — an overwrite without inline content
+   * MUST clear any prior copy so the column never goes stale relative to the
+   * new cid); default-off indexes keep the byte-identical legacy statement
+   * (and never touch a not-yet-migrated database's missing column).
+   */
+  private buildFileUpsert;
+  delete(path: string, opts: PutOpts): Promise<void>;
+  private cleanEmptyParents;
+  list(prefix: string, options?: TreeIndexListOptions): Promise<TreeIndexListResult>;
+  listEntries(prefix: string, options?: TreeIndexListOptions): Promise<TreeIndexListEntriesResult>;
+  hasChildren(prefix: string): Promise<boolean>;
+  count(prefix: string): Promise<number>;
+  deleteByPrefix(prefix: string, opts: PutOpts): Promise<number>;
+  listChildren(parent: string, options?: TreeIndexListOptions): Promise<TreeIndexListEntriesResult>;
+  countChildren(parent: string): Promise<number>;
+  /** Collection query (afs-collection-query Phase 1) — see tree-query.ts. */
+  query(parent: string, spec: TreeQuerySpec): Promise<TreeQueryResult>;
+  /** Page-bounded grouped child counts — see D1TreeIndex.countChildrenMany
+   *  (same ≤90-per-chunk shape kept for cross-backend statement parity). */
+  countChildrenMany(parents: string[]): Promise<Map<string, number>>;
+  aggregate(prefix: string): Promise<{
+    fileCount: number;
+    totalSize: number;
+  }>;
+  /** Batch metadata read — loop over get (no IN-merge needed off-CF). */
+  getMany(paths: string[]): Promise<Map<string, TreeEntry | null>>;
+  /** Batch sync fast path — loop reference semantics (conformance-pinned
+   *  equivalent of the merged D1 implementation). */
+  batchPutEntries(entries: BatchPutEntry[], ctx?: BatchIndexContext): Promise<BatchPutEntryResult[]>;
+  /** Delete twin of {@link batchPutEntries} (loop reference semantics). */
+  batchDeleteEntries(entries: BatchDeleteEntry[], ctx?: BatchIndexContext): Promise<BatchDeleteEntryResult[]>;
+  putBatch(entries: Array<{
+    path: string;
+    entry: TreeEntry;
+  }>, opts: PutOpts): Promise<void>;
+  listModifiedSince(prefix: string, since: number, options?: TreeIndexListOptions): Promise<TreeIndexListEntriesResult>;
+  getMaxSeq(): Promise<number>;
+  /**
+   * Read-auth reference check (design §4.1) — three-way, scoped, optionally
+   * prefix-local. See {@link TreeIndex.isReferenced}.
+   */
+  isReferenced(cid: string, pathPrefix?: string): Promise<boolean>;
+  /**
+   * Batch read-auth (design §7.2 / §14) — three-way-equivalent to per-cid
+   * {@link isReferenced}, sharded (see {@link SQLITE_MANY_SHARD_SIZE}). Returns
+   * the referenced subset of `cids`.
+   */
+  isReferencedMany(cids: string[], pathPrefix?: string): Promise<Set<string>>;
+  getChangelogSince(sinceSeq: number, limit: number): Promise<{
+    entries: ChangelogEntry[];
+    hasMore: boolean;
+    cursor: number;
+  }>;
+  getCompactedBelowSeq(): Promise<number>;
+  listDirtyPaths(options: ListDirtyPathOptions): Promise<DirtyPathRow[]>;
+  ackDirtyPath(path: string, latestSeq: number): Promise<boolean>;
+  markDirtyPathError(path: string, latestSeq: number, error: string, nextAttemptAt: number): Promise<boolean>;
+}
+//#endregion
+export { SQLiteTreeIndex };
+//# sourceMappingURL=sqlite-tree-index.d.cts.map

package/dist/sqlite-tree-index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-tree-index.d.cts","names":[],"sources":["../src/sqlite-tree-index.ts"],"mappings":"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"}

package/dist/sqlite-tree-index.d.mts

@@ -0,0 +1,107 @@
+import { TreeQueryResult, TreeQuerySpec } from "./tree-query.mjs";
+import { DirtyPathRow, ListDirtyPathOptions } from "./dirty-path-queue.mjs";
+import { BatchDeleteEntry, BatchDeleteEntryResult, BatchIndexContext, BatchPutEntry, BatchPutEntryResult, ChangelogEntry, PutOpts, TreeEntry, TreeIndex, TreeIndexListEntriesResult, TreeIndexListOptions, TreeIndexListResult } from "./tree-index.mjs";
+import { MetadataDB } from "./metadata-db.mjs";
+import { InlineContentOptions } from "./inline-content.mjs";
+
+//#region src/sqlite-tree-index.d.ts
+declare class SQLiteTreeIndex implements TreeIndex {
+  private readonly scope;
+  private readonly client;
+  private readonly maxEntriesPerScope;
+  /** upload-limits Phase 5 byte quota (0 = disabled, the opt-in default). */
+  private readonly maxBytesPerScope;
+  private readonly inline;
+  constructor(db: MetadataDB, scope: string, opts?: {
+    maxEntriesPerScope?: number;
+    maxBytesPerScope?: number;
+  } & InlineContentOptions);
+  /**
+   * Current Σ size of this scope's file rows (upload-limits Phase 5 byte quota).
+   * SQLite (local Node) has no D1 rows_read billing, so a direct `SUM(size)` is
+   * fine here — same pattern as the file-count quota's `count("")` scan (the
+   * trigger-maintained `scope_meta.total_bytes` is a D1-only optimization).
+   */
+  private scopeTotalBytes;
+  get(path: string, opts?: {
+    includeContent?: boolean;
+  }): Promise<TreeEntry | null>;
+  getDirTimes(dirPath: string): Promise<{
+    ctime: number;
+    mtime: number;
+  } | null>;
+  put(path: string, entry: TreeEntry, opts: PutOpts): Promise<{
+    oldCid?: string;
+  }>;
+  /** Inline content this entry would store — drives loopBatchPutEntries' content-aware skip. */
+  inlineForEntry(entry: TreeEntry): Promise<string | null>;
+  /** Point seek on the `(scope, dedup_scope, dedup_key)` partial UNIQUE index. */
+  findByDedupKey(dedupScope: string, dedupKey: string): Promise<({
+    path: string;
+  } & TreeEntry) | null>;
+  /** Index-only backfill: set the dedup columns without touching content/changelog. */
+  setDedupKey(path: string, dedupScope: string, dedupKey: string, opts: PutOpts): Promise<void>;
+  getPrefixWatermark(prefix: string): Promise<number | null>;
+  /**
+   * Build the file-row UPSERT. Inline-enabled indexes always write the
+   * content column (inline copy or NULL — an overwrite without inline content
+   * MUST clear any prior copy so the column never goes stale relative to the
+   * new cid); default-off indexes keep the byte-identical legacy statement
+   * (and never touch a not-yet-migrated database's missing column).
+   */
+  private buildFileUpsert;
+  delete(path: string, opts: PutOpts): Promise<void>;
+  private cleanEmptyParents;
+  list(prefix: string, options?: TreeIndexListOptions): Promise<TreeIndexListResult>;
+  listEntries(prefix: string, options?: TreeIndexListOptions): Promise<TreeIndexListEntriesResult>;
+  hasChildren(prefix: string): Promise<boolean>;
+  count(prefix: string): Promise<number>;
+  deleteByPrefix(prefix: string, opts: PutOpts): Promise<number>;
+  listChildren(parent: string, options?: TreeIndexListOptions): Promise<TreeIndexListEntriesResult>;
+  countChildren(parent: string): Promise<number>;
+  /** Collection query (afs-collection-query Phase 1) — see tree-query.ts. */
+  query(parent: string, spec: TreeQuerySpec): Promise<TreeQueryResult>;
+  /** Page-bounded grouped child counts — see D1TreeIndex.countChildrenMany
+   *  (same ≤90-per-chunk shape kept for cross-backend statement parity). */
+  countChildrenMany(parents: string[]): Promise<Map<string, number>>;
+  aggregate(prefix: string): Promise<{
+    fileCount: number;
+    totalSize: number;
+  }>;
+  /** Batch metadata read — loop over get (no IN-merge needed off-CF). */
+  getMany(paths: string[]): Promise<Map<string, TreeEntry | null>>;
+  /** Batch sync fast path — loop reference semantics (conformance-pinned
+   *  equivalent of the merged D1 implementation). */
+  batchPutEntries(entries: BatchPutEntry[], ctx?: BatchIndexContext): Promise<BatchPutEntryResult[]>;
+  /** Delete twin of {@link batchPutEntries} (loop reference semantics). */
+  batchDeleteEntries(entries: BatchDeleteEntry[], ctx?: BatchIndexContext): Promise<BatchDeleteEntryResult[]>;
+  putBatch(entries: Array<{
+    path: string;
+    entry: TreeEntry;
+  }>, opts: PutOpts): Promise<void>;
+  listModifiedSince(prefix: string, since: number, options?: TreeIndexListOptions): Promise<TreeIndexListEntriesResult>;
+  getMaxSeq(): Promise<number>;
+  /**
+   * Read-auth reference check (design §4.1) — three-way, scoped, optionally
+   * prefix-local. See {@link TreeIndex.isReferenced}.
+   */
+  isReferenced(cid: string, pathPrefix?: string): Promise<boolean>;
+  /**
+   * Batch read-auth (design §7.2 / §14) — three-way-equivalent to per-cid
+   * {@link isReferenced}, sharded (see {@link SQLITE_MANY_SHARD_SIZE}). Returns
+   * the referenced subset of `cids`.
+   */
+  isReferencedMany(cids: string[], pathPrefix?: string): Promise<Set<string>>;
+  getChangelogSince(sinceSeq: number, limit: number): Promise<{
+    entries: ChangelogEntry[];
+    hasMore: boolean;
+    cursor: number;
+  }>;
+  getCompactedBelowSeq(): Promise<number>;
+  listDirtyPaths(options: ListDirtyPathOptions): Promise<DirtyPathRow[]>;
+  ackDirtyPath(path: string, latestSeq: number): Promise<boolean>;
+  markDirtyPathError(path: string, latestSeq: number, error: string, nextAttemptAt: number): Promise<boolean>;
+}
+//#endregion
+export { SQLiteTreeIndex };
+//# sourceMappingURL=sqlite-tree-index.d.mts.map

package/dist/sqlite-tree-index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-tree-index.d.mts","names":[],"sources":["../src/sqlite-tree-index.ts"],"mappings":"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"}