@kubun/store-graph 0.10.2 → 0.12.0

package/lib/cursor.d.ts

@@ -2,6 +2,7 @@ export type CursorData = {
     id: string;
     ts?: number;
     values?: Record<string, unknown>;
+    nullKeys?: Array<string>;
 };
 export declare function parseCursor(cursor: string): CursorData;
 export declare function serializeCursor(data: CursorData): string;

package/lib/cursor.js

@@ -1 +1,7 @@
-import{b64uFromJSON as r,b64uToJSON as e}from"@enkaku/codec";export function parseCursor(r){return e(r)}export function serializeCursor(e){return r(e)}
+import { b64uFromJSON, b64uToJSON } from '@sozai/codec';
+export function parseCursor(cursor) {
+    return b64uToJSON(cursor);
+}
+export function serializeCursor(data) {
+    return b64uFromJSON(data);
+}

package/lib/definition.js

@@ -1 +1,7 @@
-import{createGraphStore as r}from"./api.js";import{getGraphMigrations as i}from"./migrations.js";export const graphStoreDefinition={name:"graph",migrations:i,createAPI:r};
+import { createGraphStore } from './api.js';
+import { getGraphMigrations } from './migrations.js';
+export const graphStoreDefinition = {
+    name: 'graph',
+    migrations: getGraphMigrations,
+    createAPI: createGraphStore
+};

package/lib/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * True when `err` is the driver's way of saying `tableName` does not exist.
+ * Each adapter words it differently, so the match is the only place the two
+ * spellings are known.
+ */
+export declare function isMissingTableError(err: unknown, tableName: string): boolean;
+/**
+ * Thrown when a read names a document model this device never deployed. The
+ * model's table is created at deploy time, so its absence is a fact about this
+ * device rather than about the document — a peer holding the model reads the
+ * same id fine.
+ *
+ * Tagged with the protocol-level error code `KB15` so a caller branches on the
+ * class instead of matching a driver's wording, which differs per adapter. Not
+ * a permanent apply error: a model may be deployed later, so a mutation naming
+ * one stays retryable.
+ */
+export declare class ModelNotDeployedError extends Error {
+    #private;
+    constructor(modelID: string, options?: {
+        cause?: unknown;
+    });
+    get code(): 'KB15';
+    get modelID(): string;
+    /**
+     * graphql-js copies a wrapped error's `extensions` onto the error it locates,
+     * so a resolver that lets this through surfaces the code to the app without
+     * translating it at the throw site.
+     */
+    get extensions(): {
+        code: 'KB15';
+        modelID: string;
+    };
+}

package/lib/errors.js

@@ -0,0 +1,45 @@
+/**
+ * True when `err` is the driver's way of saying `tableName` does not exist.
+ * Each adapter words it differently, so the match is the only place the two
+ * spellings are known.
+ */ export function isMissingTableError(err, tableName) {
+    if (!(err instanceof Error)) return false;
+    const message = err.message;
+    // SQLite: "no such table: k_<modelID>"
+    // Postgres: `relation "k_<modelID>" does not exist`
+    return message.includes('no such table') && message.includes(tableName) || message.includes('does not exist') && message.includes(tableName);
+}
+/**
+ * Thrown when a read names a document model this device never deployed. The
+ * model's table is created at deploy time, so its absence is a fact about this
+ * device rather than about the document — a peer holding the model reads the
+ * same id fine.
+ *
+ * Tagged with the protocol-level error code `KB15` so a caller branches on the
+ * class instead of matching a driver's wording, which differs per adapter. Not
+ * a permanent apply error: a model may be deployed later, so a mutation naming
+ * one stays retryable.
+ */ export class ModelNotDeployedError extends Error {
+    #modelID;
+    constructor(modelID, options){
+        super(`Document model ${modelID} is not deployed on this device`, options);
+        this.name = 'ModelNotDeployedError';
+        this.#modelID = modelID;
+    }
+    get code() {
+        return 'KB15';
+    }
+    get modelID() {
+        return this.#modelID;
+    }
+    /**
+   * graphql-js copies a wrapped error's `extensions` onto the error it locates,
+   * so a resolver that lets this through surfaces the code to the app without
+   * translating it at the throw site.
+   */ get extensions() {
+        return {
+            code: 'KB15',
+            modelID: this.#modelID
+        };
+    }
+}

package/lib/index.d.ts

@@ -1,8 +1,9 @@
 import type { StoreProvider } from '@kubun/db';
 import type { GraphStoreAPI } from './api.js';
-export type { GraphStoreAPI, StoredAccessRule } from './api.js';
+export type { GraphStoreAPI, StoredAccessDefaultRow, StoredAccessRule } from './api.js';
 export { createGraphStore } from './api.js';
 export { graphStoreDefinition } from './definition.js';
+export { ModelNotDeployedError } from './errors.js';
 export declare const GRAPH_STORE: "graph";
 export declare function getGraphStore(provider: StoreProvider): Promise<GraphStoreAPI>;
 export type { AccessLevel, AccessPermissions, AddDocumentModelParams, Catalog, ClusterDefinitionRow, ClusterModel, ConnectionArguments, CreateDocumentParams, CreateGraphParams, CursorDocument, Document, DocumentAttachment, DocumentData, DocumentModelRow, DocumentParams, GraphModel, GraphModelWithRecord, GraphTables, InsertCatalog, InsertClusterModel, InsertDocument, InsertDocumentAttachment, InsertDocumentModel, InsertDocumentModelInterface, InsertMutationLogEntry, ListDocumentsParams, MutationLogEntry, PaginatedResult, PaginationParams, QueryDocumentsParams, QueryDocumentsResult, SaveDocumentParams, SearchConfig, SearchDocumentResult, SearchDocumentsParams, UpdateDocument, UpdateDocumentModel, ViewerReadAccess, } from './tables.js';

package/lib/index.js

@@ -1 +1,7 @@
-export{createGraphStore}from"./api.js";export{graphStoreDefinition}from"./definition.js";export const GRAPH_STORE="graph";export function getGraphStore(r){return r.getStore("graph")}
+export { createGraphStore } from './api.js';
+export { graphStoreDefinition } from './definition.js';
+export { ModelNotDeployedError } from './errors.js';
+export const GRAPH_STORE = 'graph';
+export function getGraphStore(provider) {
+    return provider.getStore(GRAPH_STORE);
+}

package/lib/migrations.d.ts

@@ -1,3 +1,16 @@
 import type { MigrationContext } from '@kubun/db';
 import type { Migration } from 'kysely/migration';
+/**
+ * A shipped migration is immutable: once a database has run it, editing it
+ * changes nothing on that database and silently diverges the schema from the
+ * code. Every schema change after a release therefore goes in a NEW migration,
+ * which is why the later ones here say so.
+ *
+ * `0-init` is a deliberate exception on this change: it was edited in place
+ * rather than extended. That is a BREAKING change — a database created before it
+ * will not pick the new columns up and must be recreated. It was taken because
+ * this release already requires recreating local databases for unrelated reasons,
+ * so folding the change into the initial schema costs nothing and keeps `0-init`
+ * readable as the whole schema. Do NOT repeat it after this release ships.
+ */
 export declare function getGraphMigrations(ctx: MigrationContext): Record<string, Migration>;

package/lib/migrations.js

@@ -1 +1,100 @@
-export function getGraphMigrations(e){let t=e.types,a=e.functions.now;return{"0-init":{async up(e){await e.schema.createTable("kubun_graph_document_attachments").ifNotExists().addColumn("id",t.text,e=>e.notNull().primaryKey()).addColumn("data",t.binary,e=>e.notNull()).addColumn("created_at",t.timestamp,e=>e.defaultTo(a).notNull()).execute(),await e.schema.createTable("kubun_graph_document_models").ifNotExists().addColumn("id",t.text,e=>e.notNull().primaryKey()).addColumn("version",t.text,e=>e.notNull()).addColumn("name",t.text,e=>e.notNull()).addColumn("behavior",t.text,e=>e.notNull()).addColumn("unique_fields",t.json).addColumn("interfaces",t.json,e=>e.notNull()).addColumn("schema",t.json,e=>e.notNull()).addColumn("fields_meta",t.json,e=>e.notNull()).addColumn("created_at",t.timestamp,e=>e.defaultTo(a).notNull()).execute(),await e.schema.createTable("kubun_graph_document_model_interfaces").ifNotExists().addColumn("interface_id",t.text,e=>e.notNull().references("kubun_graph_document_models.id")).addColumn("implementation_id",t.text,e=>e.notNull().references("kubun_graph_document_models.id")).addUniqueConstraint("kubun_graph_document_model_interfaces_pkey",["interface_id","implementation_id"]).execute(),await e.schema.createTable("kubun_graph_models").ifNotExists().addColumn("id",t.text,e=>e.notNull().primaryKey()).addColumn("name",t.text,e=>e.notNull()).addColumn("aliases",t.json,e=>e.defaultTo("{}").notNull()).addColumn("search",t.json).addColumn("extension_sdl",t.text).addColumn("plugin_config",t.json).addColumn("created_at",t.timestamp,e=>e.defaultTo(a).notNull()).addColumn("updated_at",t.timestamp).execute(),await e.schema.createTable("kubun_graph_document_model_links").ifNotExists().addColumn("graph_model_id",t.text,e=>e.notNull().references("kubun_graph_models.id")).addColumn("document_model_id",t.text,e=>e.notNull().references("kubun_graph_document_models.id")).addUniqueConstraint("kubun_graph_document_model_links_pkey",["graph_model_id","document_model_id"]).execute(),await e.schema.createTable("kubun_graph_user_model_access_defaults").ifNotExists().addColumn("owner_did",t.text,e=>e.notNull()).addColumn("model_id",t.text,e=>e.notNull()).addColumn("permission_type",t.text,e=>e.notNull()).addColumn("access_level",t.text,e=>e.notNull()).addColumn("allowed_dids",t.json).addColumn("allowed_circles",t.json).addColumn("allowed_groups",t.json).addColumn("created_at",t.timestamp,e=>e.defaultTo(a).notNull()).addColumn("updated_at",t.timestamp).addPrimaryKeyConstraint("kubun_graph_user_model_access_defaults_pkey",["owner_did","model_id","permission_type"]).execute(),await e.schema.createIndex("idx_graph_user_model_access_owner_model").on("kubun_graph_user_model_access_defaults").columns(["owner_did","model_id"]).execute(),await e.schema.createTable("kubun_graph_mutation_log").ifNotExists().addColumn("mutation_hash",t.text,e=>e.primaryKey()).addColumn("model_id",t.text,e=>e.notNull()).addColumn("document_id",t.text,e=>e.notNull()).addColumn("author_did",t.text,e=>e.notNull()).addColumn("hlc",t.text,e=>e.notNull()).addColumn("mutation_jwt",t.text,e=>e.notNull()).addColumn("status",t.text,e=>e.notNull().defaultTo("applied")).execute(),await e.schema.createIndex("idx_graph_mutation_log_hlc").on("kubun_graph_mutation_log").column("hlc").execute(),await e.schema.createIndex("idx_graph_mutation_log_document").on("kubun_graph_mutation_log").column("document_id").execute(),await e.schema.createIndex("idx_graph_mutation_log_status").on("kubun_graph_mutation_log").column("status").execute(),await e.schema.createTable("kubun_graph_cluster_models").ifNotExists().addColumn("model_id",t.text,e=>e.notNull().primaryKey()).addColumn("cluster_id",t.text,e=>e.notNull()).addColumn("cluster_index","integer",e=>e.notNull()).execute(),await e.schema.createIndex("idx_graph_cluster_models_cluster").on("kubun_graph_cluster_models").column("cluster_id").execute(),await e.schema.createTable("kubun_graph_clusters").ifNotExists().addColumn("id",t.text,e=>e.notNull().primaryKey()).addColumn("definition",t.json,e=>e.notNull()).execute(),await e.schema.createTable("kubun_graph_catalogs").ifNotExists().addColumn("id",t.text,e=>e.notNull().primaryKey()).addColumn("owner_did",t.text,e=>e.notNull()).addColumn("name",t.text,e=>e.notNull()).addColumn("description",t.text,e=>e.notNull().defaultTo("")).addColumn("filter_criteria",t.json,e=>e.notNull()).addColumn("hlc",t.text,e=>e.notNull()).addColumn("created_at",t.timestamp,e=>e.defaultTo(a).notNull()).addColumn("updated_at",t.timestamp).execute(),await e.schema.createIndex("idx_graph_catalogs_owner").ifNotExists().on("kubun_graph_catalogs").column("owner_did").execute()},async down(e){await e.schema.dropTable("kubun_graph_catalogs").ifExists().execute(),await e.schema.dropTable("kubun_graph_clusters").ifExists().execute(),await e.schema.dropTable("kubun_graph_cluster_models").ifExists().execute(),await e.schema.dropTable("kubun_graph_mutation_log").ifExists().execute(),await e.schema.dropTable("kubun_graph_user_model_access_defaults").ifExists().execute(),await e.schema.dropTable("kubun_graph_document_model_links").ifExists().execute(),await e.schema.dropTable("kubun_graph_models").ifExists().execute(),await e.schema.dropTable("kubun_graph_document_model_interfaces").ifExists().execute(),await e.schema.dropTable("kubun_graph_document_models").ifExists().execute(),await e.schema.dropTable("kubun_graph_document_attachments").ifExists().execute()}}}}
+/**
+ * A shipped migration is immutable: once a database has run it, editing it
+ * changes nothing on that database and silently diverges the schema from the
+ * code. Every schema change after a release therefore goes in a NEW migration,
+ * which is why the later ones here say so.
+ *
+ * `0-init` is a deliberate exception on this change: it was edited in place
+ * rather than extended. That is a BREAKING change — a database created before it
+ * will not pick the new columns up and must be recreated. It was taken because
+ * this release already requires recreating local databases for unrelated reasons,
+ * so folding the change into the initial schema costs nothing and keeps `0-init`
+ * readable as the whole schema. Do NOT repeat it after this release ships.
+ */ export function getGraphMigrations(ctx) {
+    const t = ctx.types;
+    const now = ctx.functions.now;
+    const init = {
+        async up (db) {
+            // Document attachments
+            await db.schema.createTable('kubun_graph_document_attachments').ifNotExists().addColumn('id', t.text, (col)=>col.notNull().primaryKey()).addColumn('data', t.binary, (col)=>col.notNull()).addColumn('created_at', t.timestamp, (col)=>col.defaultTo(now).notNull()).execute();
+            // Document models
+            await db.schema.createTable('kubun_graph_document_models').ifNotExists().addColumn('id', t.text, (col)=>col.notNull().primaryKey()).addColumn('version', t.text, (col)=>col.notNull()).addColumn('name', t.text, (col)=>col.notNull()).addColumn('behavior', t.text, (col)=>col.notNull()).addColumn('unique_fields', t.json).addColumn('interfaces', t.json, (col)=>col.notNull()).addColumn('schema', t.json, (col)=>col.notNull()).addColumn('fields_meta', t.json, (col)=>col.notNull()).addColumn('created_at', t.timestamp, (col)=>col.defaultTo(now).notNull()).execute();
+            // Document model interfaces
+            await db.schema.createTable('kubun_graph_document_model_interfaces').ifNotExists().addColumn('interface_id', t.text, (col)=>col.notNull().references('kubun_graph_document_models.id')).addColumn('implementation_id', t.text, (col)=>col.notNull().references('kubun_graph_document_models.id')).addUniqueConstraint('kubun_graph_document_model_interfaces_pkey', [
+                'interface_id',
+                'implementation_id'
+            ]).execute();
+            // Graph models
+            await db.schema.createTable('kubun_graph_models').ifNotExists().addColumn('id', t.text, (col)=>col.notNull().primaryKey()).addColumn('name', t.text, (col)=>col.notNull()).addColumn('aliases', t.json, (col)=>col.defaultTo('{}').notNull()).addColumn('search', t.json).addColumn('extension_sdl', t.text).addColumn('plugin_config', t.json).addColumn('created_at', t.timestamp, (col)=>col.defaultTo(now).notNull()).addColumn('updated_at', t.timestamp).execute();
+            // Graph document model links (junction: graph-model ↔ document-model)
+            await db.schema.createTable('kubun_graph_document_model_links').ifNotExists().addColumn('graph_model_id', t.text, (col)=>col.notNull().references('kubun_graph_models.id')).addColumn('document_model_id', t.text, (col)=>col.notNull().references('kubun_graph_document_models.id')).addUniqueConstraint('kubun_graph_document_model_links_pkey', [
+                'graph_model_id',
+                'document_model_id'
+            ]).execute();
+            // User model access defaults
+            await db.schema.createTable('kubun_graph_user_model_access_defaults').ifNotExists().addColumn('owner_did', t.text, (col)=>col.notNull()).addColumn('model_id', t.text, (col)=>col.notNull()).addColumn('permission_type', t.text, (col)=>col.notNull()).addColumn('access_level', t.text, (col)=>col.notNull()).addColumn('allowed_dids', t.json).addColumn('allowed_circles', t.json).addColumn('allowed_groups', t.json)// LWW anchor for replicated rules; null for rows never stamped by a broadcast.
+            .addColumn('hlc', t.text)// Retained-tombstone marker (0/null = active, 1 = removed): removal keeps
+            // the row so its `hlc` stays the LWW anchor and hides it from reads.
+            .addColumn('removed', 'integer').addColumn('created_at', t.timestamp, (col)=>col.defaultTo(now).notNull()).addColumn('updated_at', t.timestamp).addPrimaryKeyConstraint('kubun_graph_user_model_access_defaults_pkey', [
+                'owner_did',
+                'model_id',
+                'permission_type'
+            ]).execute();
+            await db.schema.createIndex('idx_graph_user_model_access_owner_model').ifNotExists().on('kubun_graph_user_model_access_defaults').columns([
+                'owner_did',
+                'model_id'
+            ]).execute();
+            // Mutation log
+            await db.schema.createTable('kubun_graph_mutation_log').ifNotExists().addColumn('mutation_hash', t.text, (col)=>col.primaryKey()).addColumn('model_id', t.text, (col)=>col.notNull()).addColumn('document_id', t.text, (col)=>col.notNull()).addColumn('author_did', t.text, (col)=>col.notNull()).addColumn('hlc', t.text, (col)=>col.notNull()).addColumn('mutation_jwt', t.text, (col)=>col.notNull()).addColumn('status', t.text, (col)=>col.notNull().defaultTo('applied')).execute();
+            await db.schema.createIndex('idx_graph_mutation_log_hlc').ifNotExists().on('kubun_graph_mutation_log').column('hlc').execute();
+            await db.schema.createIndex('idx_graph_mutation_log_document').ifNotExists().on('kubun_graph_mutation_log').column('document_id').execute();
+            await db.schema.createIndex('idx_graph_mutation_log_status').ifNotExists().on('kubun_graph_mutation_log').column('status').execute();
+            // Cluster models (model -> cluster mapping)
+            await db.schema.createTable('kubun_graph_cluster_models').ifNotExists().addColumn('model_id', t.text, (col)=>col.notNull().primaryKey()).addColumn('cluster_id', t.text, (col)=>col.notNull()).addColumn('cluster_index', 'integer', (col)=>col.notNull()).execute();
+            await db.schema.createIndex('idx_graph_cluster_models_cluster').ifNotExists().on('kubun_graph_cluster_models').column('cluster_id').execute();
+            // Cluster definitions
+            await db.schema.createTable('kubun_graph_clusters').ifNotExists().addColumn('id', t.text, (col)=>col.notNull().primaryKey()).addColumn('definition', t.json, (col)=>col.notNull()).execute();
+            // Catalogs
+            await db.schema.createTable('kubun_graph_catalogs').ifNotExists().addColumn('id', t.text, (col)=>col.notNull().primaryKey()).addColumn('owner_did', t.text, (col)=>col.notNull()).addColumn('name', t.text, (col)=>col.notNull()).addColumn('description', t.text, (col)=>col.notNull().defaultTo('')).addColumn('filter_criteria', t.json, (col)=>col.notNull()).addColumn('hlc', t.text, (col)=>col.notNull())// Local-only sync activation (1 = active, 0/null = known-not-activated).
+            .addColumn('active', 'integer')// First-discovery provenance (nullable; never overwritten on re-discovery).
+            .addColumn('source_group_id', t.text).addColumn('source_circle_id', t.text)// Creator-signed `catalog:set` token; forwarded verbatim in invite seeds.
+            .addColumn('signed_token', t.text).addColumn('created_at', t.timestamp, (col)=>col.defaultTo(now).notNull()).addColumn('updated_at', t.timestamp).execute();
+            await db.schema.createIndex('idx_graph_catalogs_owner').ifNotExists().on('kubun_graph_catalogs').column('owner_did').execute();
+            // `.ifNotExists()` protects a half-created table from being recreated —
+            // and, because this migration was edited in place, it equally protects a
+            // table an EARLIER run created from ever acquiring the columns that edit
+            // added. A database that ran the pre-edit `0-init`, or crashed after
+            // creating this table but before Kysely recorded the migration (SQLite
+            // DDL is not transactional), would otherwise complete this migration with
+            // a table that has no `hlc` and no `removed` — and every subsequent
+            // `setUserModelAccessDefault` would fail with "no such column: hlc",
+            // permanently, with no repair path. Healing it here is what makes the
+            // half-upgraded shape unrepresentable rather than merely unlikely.
+            const accessTable = (await db.introspection.getTables()).find((table)=>table.name === 'kubun_graph_user_model_access_defaults');
+            if (accessTable != null) {
+                const existing = new Set(accessTable.columns.map((column)=>column.name));
+                if (!existing.has('hlc')) {
+                    await db.schema.alterTable('kubun_graph_user_model_access_defaults').addColumn('hlc', t.text).execute();
+                }
+                if (!existing.has('removed')) {
+                    await db.schema.alterTable('kubun_graph_user_model_access_defaults').addColumn('removed', 'integer').execute();
+                }
+            }
+        },
+        async down (db) {
+            await db.schema.dropTable('kubun_graph_catalogs').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_clusters').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_cluster_models').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_mutation_log').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_user_model_access_defaults').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_document_model_links').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_models').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_document_model_interfaces').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_document_models').ifExists().execute();
+            await db.schema.dropTable('kubun_graph_document_attachments').ifExists().execute();
+        }
+    };
+    return {
+        '0-init': init
+    };
+}

package/lib/query-builder.d.ts

@@ -1,6 +1,6 @@
 import type { Adapter } from '@kubun/db-adapter';
 import type { AggregateSpec, AnyValueFilter, DocumentFilter, DocumentOrderBy } from '@kubun/protocol';
-import type { AliasedExpression, ExpressionBuilder, ExpressionWrapper, SelectQueryBuilder } from 'kysely';
+import { type AliasedExpression, type ExpressionBuilder, type ExpressionWrapper, type SelectQueryBuilder } from 'kysely';
 import type { ConnectionArguments, Document, GraphTables } from './tables.js';
 export type CoerceFilterValue = (value: unknown) => unknown;
 type DocumentExpressionBuilder = ExpressionBuilder<GraphTables, 'k_document'>;
@@ -16,8 +16,14 @@ export declare function applyGroupBySelections(eb: DocumentExpressionBuilder, gr
     selections: Array<AggregateSelection>;
     expressions: Array<DocumentExpressionWrapper>;
 };
-export declare function applyPagination(query: DocumentQueryBuilder, args: ConnectionArguments, orderBy?: DocumentOrderBy): [DocumentQueryBuilder, number];
+export declare function applyPagination(query: DocumentQueryBuilder, args: ConnectionArguments, orderBy?: DocumentOrderBy, coerce?: CoerceFilterValue): [DocumentQueryBuilder, number];
 export declare function applyDocumentFilter(eb: DocumentExpressionBuilder, filter: DocumentFilter, path?: Array<string>, coerce?: CoerceFilterValue): DocumentExpressionWrapper;
 export declare function applyValueFilter(eb: DocumentExpressionBuilder, keys: Array<string>, filter: AnyValueFilter, coerce?: CoerceFilterValue): DocumentExpressionWrapper;
-export declare function applyDocumentOrderBy(queryBuilder: DocumentQueryBuilder, orderBy?: DocumentOrderBy, isReverse?: boolean): [DocumentQueryBuilder, Array<Array<string>> | null];
+export declare function applyDocumentOrderBy(queryBuilder: DocumentQueryBuilder, adapter: Adapter, orderBy?: DocumentOrderBy, isReverse?: boolean): [DocumentQueryBuilder, Array<Array<string>> | null];
+export declare const KNOWN_FIELDS: {
+    readonly _createdAt: "created_at";
+    readonly _docOwner: "owner";
+};
+export type KnownFieldColumn = (typeof KNOWN_FIELDS)[keyof typeof KNOWN_FIELDS];
+export declare function knownFieldColumn(keys: Array<string>): KnownFieldColumn | undefined;
 export {};