Merge branch 'main' into refactor/wal-naming

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

docs/src/js/interfaces/AddDataOptions.md

@@ -10,6 +10,22 @@ Options for adding data to a table.
 
 ## Properties
 
+### allowExternalBlobOutsideBases?
+
+```ts
+optional allowExternalBlobOutsideBases: boolean;
+```
+
+Whether blob URIs outside registered external bases may be written.
+
+Defaults to `false`. This option is supported only for local/native
+tables; remote tables return an error when it is enabled. An enabled write
+stores the absolute URI reference without registering a base or copying
+the external object into the database. The object must remain accessible
+when the blob is read later.
+
+***
+
 ### mode
 
 ```ts

docs/src/js/interfaces/CatalogOptions.md

@@ -0,0 +1,81 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / CatalogOptions
+
+# Interface: CatalogOptions
+
+Options shared by a catalog and the database connections it returns.
+
+## Extends
+
+- `Omit`<`NativeCatalogOptions`, `"oauthConfig"`>
+
+## Properties
+
+### apiKey?
+
+```ts
+optional apiKey: string;
+```
+
+#### Inherited from
+
+`Omit.apiKey`
+
+***
+
+### clientConfig?
+
+```ts
+optional clientConfig: ClientConfig;
+```
+
+#### Inherited from
+
+`Omit.clientConfig`
+
+***
+
+### headerProvider?
+
+```ts
+optional headerProvider: HeaderProvider | () => Record<string, string> | Promise<Record<string, string>>;
+```
+
+Called for each request to supply authentication headers.
+
+***
+
+### oauthConfig?
+
+```ts
+optional oauthConfig: OAuthConfig;
+```
+
+***
+
+### readConsistencyInterval?
+
+```ts
+optional readConsistencyInterval: number;
+```
+
+#### Inherited from
+
+`Omit.readConsistencyInterval`
+
+***
+
+### sqlHostOverride?
+
+```ts
+optional sqlHostOverride: string;
+```
+
+SQL service endpoint inherited by database connections.
+
+#### Inherited from
+
+`Omit.sqlHostOverride`

docs/src/js/interfaces/CherryPickResult.md

@@ -38,9 +38,9 @@ preview: CherryPickPreview;
 
 ```ts
 status:
-  | "failed"
-  | "unknown"
   | "ready"
+  | "failed"
   | "notImplemented"
-  | "cherryPicked";
+  | "cherryPicked"
+  | "unknown";
 ```

docs/src/js/interfaces/ClientConfig.md

@@ -22,6 +22,10 @@ optional extraHeaders: Record<string, string>;
 optional idDelimiter: string;
 ```
 
+The delimiter joining a namespace path and a name into one object
+identifier. `"$"` is the only supported value, and leaving this unset is
+how to get it; anything else is rejected when the connection is created.
+
 ***
 
 ### retryConfig?

docs/src/js/interfaces/DropNamespaceOptions.md

@@ -21,7 +21,7 @@ Refuse to drop if non-empty (restrict) or drop recursively (cascade).
 ### mode?
 
 ```ts
-optional mode: "fail" | "skip";
+optional mode: "skip" | "fail";
 ```
 
 Whether to skip if the namespace doesn't exist, or fail.

docs/src/js/interfaces/FtsOptions.md

@@ -37,6 +37,8 @@ The following tokenizers are available:
 
 "raw" - Raw tokenizer. This tokenizer does not split the text into tokens and indexes the entire text as a single token.
 
+"code" - Code tokenizer. This tokenizer keeps snake_case and camelCase identifiers as single tokens.
+
 "icu" - ICU dictionary-based word segmentation.
 
 "icu/split" - ICU segmentation with simple-style delimiter splitting.

docs/src/js/interfaces/FunctionErrorFragment.md

@@ -0,0 +1,42 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / FunctionErrorFragment
+
+# Interface: FunctionErrorFragment
+
+A fragment whose per-row error detail was capped: `rowsSkipped` rows
+failed, of which only `rowsRecorded` have a record of their own.
+
+## Properties
+
+### fragmentId
+
+```ts
+fragmentId: number;
+```
+
+***
+
+### jobId
+
+```ts
+jobId: string;
+```
+
+***
+
+### rowsRecorded
+
+```ts
+rowsRecorded: number;
+```
+
+***
+
+### rowsSkipped
+
+```ts
+rowsSkipped: number;
+```

docs/src/js/interfaces/FunctionErrorRecord.md

@@ -0,0 +1,92 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / FunctionErrorRecord
+
+# Interface: FunctionErrorRecord
+
+One row a Function refresh skipped, as the server recorded it.
+
+## Properties
+
+### column
+
+```ts
+column: string;
+```
+
+***
+
+### createdAtMillis
+
+```ts
+createdAtMillis: number;
+```
+
+***
+
+### errorMessage
+
+```ts
+errorMessage: string;
+```
+
+***
+
+### errorType
+
+```ts
+errorType: string;
+```
+
+***
+
+### fragmentId
+
+```ts
+fragmentId: number;
+```
+
+***
+
+### function
+
+```ts
+function: string;
+```
+
+***
+
+### functionVersion
+
+```ts
+functionVersion: string;
+```
+
+***
+
+### jobId
+
+```ts
+jobId: string;
+```
+
+***
+
+### rowOffset?
+
+```ts
+optional rowOffset: number;
+```
+
+The row's offset within the fragment; absent when the fragment's
+detail was capped.
+
+***
+
+### tableVersion
+
+```ts
+tableVersion: number;
+```

docs/src/js/interfaces/FunctionErrors.md

@@ -0,0 +1,39 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / FunctionErrors
+
+# Interface: FunctionErrors
+
+A table's per-row Function errors.
+
+## Properties
+
+### fragments
+
+```ts
+fragments: FunctionErrorFragment[];
+```
+
+Fragments whose detail was capped.
+
+***
+
+### records
+
+```ts
+records: FunctionErrorRecord[];
+```
+
+The recorded rows, newest job first.
+
+***
+
+### truncated
+
+```ts
+truncated: boolean;
+```
+
+Whether the listing stopped at its limit.

docs/src/js/interfaces/FunctionErrorsOptions.md

@@ -0,0 +1,39 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / FunctionErrorsOptions
+
+# Interface: FunctionErrorsOptions
+
+Which per-row Function errors to list; every filter is optional.
+
+## Properties
+
+### column?
+
+```ts
+optional column: string;
+```
+
+Only errors on this column.
+
+***
+
+### jobId?
+
+```ts
+optional jobId: string;
+```
+
+Only errors recorded by this job.
+
+***
+
+### limit?
+
+```ts
+optional limit: number;
+```
+
+At most this many records (server default 10000, cap 100000).

docs/src/js/interfaces/HnswPqOptions.md

@@ -118,7 +118,7 @@ Number of sub-vectors of PQ.
 This value controls how much the vector is compressed during the quantization step.
 The more sub vectors there are the less the vector is compressed.  The default is
 the dimension of the vector divided by 16.  If the dimension is not evenly divisible
-by 16 we use the dimension divded by 8.
+by 16 we use the dimension divided by 8.
 
 The above two cases are highly preferred.  Having 8 or 16 values per subvector allows
 us to use efficient SIMD instructions.

docs/src/js/interfaces/IndexOptions.md

@@ -16,7 +16,7 @@ optional config: Index;
 
 Advanced index configuration
 
-This option allows you to specify a specfic index to create and also
+This option allows you to specify a specific index to create and also
 allows you to pass in configuration for training the index.
 
 See the static methods on Index for details on the various index types.

docs/src/js/interfaces/IvfPqOptions.md

@@ -112,7 +112,7 @@ Number of sub-vectors of PQ.
 This value controls how much the vector is compressed during the quantization step.
 The more sub vectors there are the less the vector is compressed.  The default is
 the dimension of the vector divided by 16.  If the dimension is not evenly divisible
-by 16 we use the dimension divded by 8.
+by 16 we use the dimension divided by 8.
 
 The above two cases are highly preferred.  Having 8 or 16 values per subvector allows
 us to use efficient SIMD instructions.

docs/src/js/interfaces/JobDescription.md

@@ -1,66 +0,0 @@
-[**@lancedb/lancedb**](../README.md) • **Docs**
-
-***
-
-[@lancedb/lancedb](../globals.md) / JobDescription
-
-# Interface: JobDescription
-
-A described job from `Connection.getJob`.
-
-## Properties
-
-### creationMs
-
-```ts
-creationMs: number;
-```
-
-When the job was created, in milliseconds since the epoch.
-
-***
-
-### failure?
-
-```ts
-optional failure: JobFailureInfo;
-```
-
-Why the job failed, when the job is failed and the server reports a
-reason.
-
-***
-
-### jobId
-
-```ts
-jobId: string;
-```
-
-***
-
-### jobType
-
-```ts
-jobType: string;
-```
-
-***
-
-### specJson?
-
-```ts
-optional specJson: string;
-```
-
-The job-type-specific specification as a JSON string, when present.
-
-***
-
-### state
-
-```ts
-state: string;
-```
-
-Lifecycle state: "running", "finished", "failed", or "cancelled".

docs/src/js/interfaces/JobEventsOptions.md

@@ -0,0 +1,29 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / JobEventsOptions
+
+# Interface: JobEventsOptions
+
+Which of a job's events [Job.events](../classes/Job.md#events) returns.
+
+## Properties
+
+### filter?
+
+```ts
+optional filter: string;
+```
+
+SQL-like filter over the event columns.
+
+***
+
+### limit?
+
+```ts
+optional limit: number;
+```
+
+Maximum event rows to return, up to the server maximum of 10,000.

docs/src/js/interfaces/JobInfo.md

@@ -26,7 +26,7 @@ When the job was created, in milliseconds since the epoch.
 jobId: string;
 ```
 
-The job id -- what `Connection.getJob` and `Connection.cancelJob`
+The job id -- what `Connection.openJob` and `Connection.cancelJob`
 accept.
 
 ***

docs/src/js/interfaces/ListTablesOptions.md

@@ -15,6 +15,7 @@ optional limit: number;
 ```
 
 An upper bound on how many tables to return.
+Defaults to 100. Zero returns an empty page without a continuation token.
 
 A page may hold fewer than this and still not be the last one, so keep
 going while the response carries a page token rather than while pages are

docs/src/js/interfaces/ListingOptions.md

@@ -0,0 +1,29 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / ListingOptions
+
+# Interface: ListingOptions
+
+Pagination controls for lazy resource listings.
+
+## Properties
+
+### pageLimit?
+
+```ts
+optional pageLimit: number;
+```
+
+Maximum results per request, not a limit on the whole listing.
+
+***
+
+### pageToken?
+
+```ts
+optional pageToken: string;
+```
+
+Starting continuation token; omitted starts at the beginning.

docs/src/js/interfaces/LsmWriteSpec.md

@@ -34,9 +34,8 @@ Bucket and identity variants: the sharding column.
 optional maintainedIndexes: string[];
 ```
 
-Indexes the MemWAL keeps up to date. Omit to maintain every supported
-index, resolved on install — a snapshot, so indexes created later are not
-maintained. Pass `[]` for none.
+Indexes the MemWAL keeps up to date. Omit for every index the table has,
+including ones created later. Pass `[]` for none.
 
 ***
 

docs/src/js/interfaces/MaterializedViewDefinition.md

@@ -6,54 +6,17 @@
 
 # Interface: MaterializedViewDefinition
 
-The query that defines a materialized view.
+The query that defines a materialized view, as stored:
+`SELECT columns FROM [ns.]table [, function(args) AS alias | , UNNEST(column) AS alias]
+[WHERE predicate] [GROUP BY expr, ...] [LIMIT n]`. A Function in `FROM`
+position yields one row per element it returns.
 
 ## Properties
 
-### filter?
+### query
 
 ```ts
-optional filter: string;
+query: string;
 ```
 
-SQL predicate selecting the source rows the view holds.
-
-***
-
-### inputs
-
-```ts
-inputs: string[];
-```
-
-Source columns the projections and filter read.
-
-***
-
-### limit?
-
-```ts
-optional limit: number;
-```
-
-Cap on the number of rows the view holds.
-
-***
-
-### projections
-
-```ts
-projections: [string, string][];
-```
-
-`[output column, SQL expression]` pairs, in view schema order.
-
-***
-
-### sourceTable
-
-```ts
-sourceTable: string;
-```
-
-Name of the source table, in the same database as the view.
+The defining query, in the canonical spelling the server stores.

docs/src/js/interfaces/NativeOAuthConfig.md

@@ -15,6 +15,39 @@ All token acquisition and refresh is handled in the Rust layer.
 
 ## Properties
 
+### audience?
+
+```ts
+optional audience: string;
+```
+
+Optional provider-specific audience for authorization and token requests.
+
+***
+
+### callbackPort?
+
+```ts
+optional callbackPort: number;
+```
+
+Port for the authorization_code loopback callback server.
+
+***
+
+### clientAuthMethod?
+
+```ts
+optional clientAuthMethod: string;
+```
+
+How the client authenticates to the token endpoint: "none",
+"client_secret_basic", or "client_secret_post". Defaults to
+"client_secret_basic" when a client secret is set, and "none" for
+public clients.
+
+***
+
 ### clientId
 
 ```ts
@@ -41,7 +74,8 @@ Client secret (required for client_credentials).
 optional flow: string;
 ```
 
-Authentication flow: "client_credentials" or "azure_managed_identity"
+Authentication flow: "client_credentials", "authorization_code",
+"device_code", or "azure_managed_identity"
 
 ***
 
@@ -66,6 +100,16 @@ Client ID for user-assigned managed identity (azure_managed_identity).
 
 ***
 
+### redirectUri?
+
+```ts
+optional redirectUri: string;
+```
+
+Loopback redirect URI for authorization_code.
+
+***
+
 ### refreshBufferSecs?
 
 ```ts
@@ -78,6 +122,16 @@ the TTL, each request refreshes the token.
 
 ***
 
+### resource?
+
+```ts
+optional resource: string;
+```
+
+Optional resource indicator for authorization and token requests.
+
+***
+
 ### scopes
 
 ```ts
@@ -86,3 +140,24 @@ scopes: string[];
 
 OAuth scopes to request. For Azure managed identity, exactly one scope
 or resource is required. For example: `["api://{app_id}/.default"]`
+
+***
+
+### tokenCache?
+
+```ts
+optional tokenCache: TokenCacheOptions;
+```
+
+Opt in to the persistent token cache so short-lived processes reuse
+one session. Only refresh tokens are persisted.
+
+***
+
+### usePkce?
+
+```ts
+optional usePkce: boolean;
+```
+
+Whether authorization_code uses S256 PKCE (default: true).

docs/src/js/interfaces/OAuthConfig.md

@@ -26,6 +26,18 @@ const config: OAuthConfig = {
 };
 ```
 
+Providers requiring an explicit target can set `resource` and/or `audience`:
+```typescript
+const targeted: OAuthConfig = {
+  issuerUrl: "https://issuer.example.com",
+  clientId: "app-id",
+  clientSecret: "secret",
+  scopes: ["read"],
+  resource: "https://api.example.com",
+  audience: "lancedb-api",
+};
+```
+
 ```typescript
 const config: OAuthConfig = {
   issuerUrl: "https://login.microsoftonline.com/{tenant}/v2.0",
@@ -35,8 +47,57 @@ const config: OAuthConfig = {
 };
 ```
 
+The authorization URL is written to stderr before LanceDB tries to open a
+browser, so it can be copied in headless environments.
+```typescript
+const config: OAuthConfig = {
+  issuerUrl: "https://login.microsoftonline.com/{tenant}/v2.0",
+  clientId: "app-id",
+  scopes: ["openid", "api://lancedb-api/access"],
+  flow: OAuthFlowType.AuthorizationCode,
+};
+```
+
+Device Authorization writes the verification URL and user code to stderr
+before polling begins.
+
 ## Properties
 
+### audience?
+
+```ts
+optional audience: string;
+```
+
+Provider-specific audience, forwarded to authorization and token endpoints,
+including refresh requests. Not supported for Azure managed identity.
+
+***
+
+### callbackPort?
+
+```ts
+optional callbackPort: number;
+```
+
+Port for the AuthorizationCode loopback callback server (default: 8400).
+
+***
+
+### clientAuthMethod?
+
+```ts
+optional clientAuthMethod: ClientAuthMethod;
+```
+
+How the client authenticates to the token endpoint (default: auto).
+With a `clientSecret` the default is `ClientAuthMethod.ClientSecretBasic`,
+which matches the RFC 6749 recommendation and the default configuration
+of Okta confidential applications; without a secret the client is public
+and no client authentication is sent.
+
+***
+
 ### clientId
 
 ```ts
@@ -88,6 +149,16 @@ Client ID for user-assigned managed identity (AzureManagedIdentity).
 
 ***
 
+### redirectUri?
+
+```ts
+optional redirectUri: string;
+```
+
+Loopback redirect URI for AuthorizationCode.
+
+***
+
 ### refreshBufferSecs?
 
 ```ts
@@ -100,6 +171,18 @@ the TTL, each request refreshes the token.
 
 ***
 
+### resource?
+
+```ts
+optional resource: string;
+```
+
+Resource indicator (RFC 8707), forwarded verbatim to authorization and token
+endpoints, including refresh requests. Must be an absolute URI without a
+fragment. Not supported for Azure managed identity.
+
+***
+
 ### scopes
 
 ```ts
@@ -109,3 +192,26 @@ scopes: string[];
 OAuth scopes to request.
 For Azure managed identity, exactly one scope or resource is required.
 For example: `["api://{app_id}/.default"]`
+
+***
+
+### tokenCache?
+
+```ts
+optional tokenCache: TokenCacheOptions;
+```
+
+Opt in to the persistent token cache so short-lived processes reuse one
+session. Only refresh tokens are persisted. Only supported by
+AuthorizationCode and DeviceCode; Azure managed identity is rejected.
+Default: unset (memory only).
+
+***
+
+### usePkce?
+
+```ts
+optional usePkce: boolean;
+```
+
+Protect AuthorizationCode with S256 PKCE (default: true).

docs/src/js/interfaces/OptimizeOptions.md

@@ -26,7 +26,8 @@ const olderThan = new Date();
 olderThan.setDate(olderThan.getDate() - 1));
 tbl.optimize({cleanupOlderThan: olderThan});
 
-// Delete all versions except the current version
+// Delete versions committed before this point. Versions created by the
+// optimize call itself are newer than the cutoff and will be retained.
 tbl.optimize({cleanupOlderThan: new Date()});
 ```
 

docs/src/js/interfaces/RefreshMaterializedViewResult.md

@@ -14,7 +14,7 @@
 mode: string;
 ```
 
-How the view was brought up to date: "rebuild", "incremental" or "no_op".
+How the view was brought up to date: "rebuild".
 
 ***
 

docs/src/js/interfaces/SessionLogout.md

@@ -0,0 +1,20 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / SessionLogout
+
+# Interface: SessionLogout
+
+Result of [OAuthSession.logout](../classes/OAuthSession.md#logout).
+
+## Properties
+
+### removed
+
+```ts
+removed: boolean;
+```
+
+Whether a cached credential was removed. `false` means no matching
+session was cached; logout is idempotent.

docs/src/js/interfaces/SessionStatus.md

@@ -0,0 +1,94 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / SessionStatus
+
+# Interface: SessionStatus
+
+Safe, non-secret view of a cached OAuth session, returned by
+[OAuthSession.status](../classes/OAuthSession.md#status) and [OAuthSession.login](../classes/OAuthSession.md#login).
+
+## Properties
+
+### audience?
+
+```ts
+optional audience: string;
+```
+
+Provider-specific audience used to obtain the cached session, if configured.
+
+***
+
+### clientId
+
+```ts
+clientId: string;
+```
+
+Client ID of the cached session.
+
+***
+
+### flow
+
+```ts
+flow: string;
+```
+
+Flow that produced the cached session.
+
+***
+
+### issuerUrl
+
+```ts
+issuerUrl: string;
+```
+
+Canonical issuer URL of the cached session.
+
+***
+
+### obtainedAt?
+
+```ts
+optional obtainedAt: number;
+```
+
+When the cached session was obtained, as Unix seconds.
+
+***
+
+### refreshable
+
+```ts
+refreshable: boolean;
+```
+
+Whether a cached session exists that can obtain tokens without
+interactive authentication. Because access tokens are not persisted,
+this is `true` exactly when a refresh token is cached; the next
+connection refreshes with it rather than opening a browser or device
+prompt.
+
+***
+
+### resource?
+
+```ts
+optional resource: string;
+```
+
+Resource indicator used to obtain the cached session, if configured.
+
+***
+
+### scopes
+
+```ts
+scopes: string[];
+```
+
+Canonical (sorted, de-duplicated) scope set of the cached session.

docs/src/js/interfaces/TableNamesOptions.md

@@ -19,7 +19,7 @@ instead.
 optional limit: number;
 ```
 
-An optional limit to the number of results to return.
+The maximum number of names to return. Omitted returns all names; zero returns none.
 
 ***
 

docs/src/js/interfaces/TableStatistics.md

@@ -18,6 +18,23 @@ Statistics on table fragments
 
 ***
 
+### numDeletedRows?
+
+```ts
+optional numDeletedRows: number;
+```
+
+The number of rows marked as deleted across all fragments of the table
+
+These rows are not included in `numRows`, but still occupy space on disk
+until the table is compacted, so a large value here indicates that the
+table should be optimized. Fragments in which every row was deleted are
+dropped outright, so their rows are not counted here.
+
+Absent (`undefined`) when the backend does not report deletion counts.
+
+***
+
 ### numIndices
 
 ```ts

docs/src/js/interfaces/TokenCacheOptions.md

@@ -0,0 +1,41 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / TokenCacheOptions
+
+# Interface: TokenCacheOptions
+
+Options for the persistent OAuth token cache.
+
+The cache is opt-in: it is only used when set as `tokenCache` on
+[OAuthConfig](OAuthConfig.md). Only refresh tokens are persisted, in a private
+directory with owner-only permissions, so short-lived processes can reuse
+an authenticated session instead of re-prompting on every start.
+
+Multiple identities (issuer, client, scopes, resource, audience, flow, client authentication)
+get separate cache entries. Within one identity the most recent login wins.
+
+## Properties
+
+### cacheDir?
+
+```ts
+optional cacheDir: string;
+```
+
+Directory that holds cached credentials. Defaults to
+`$XDG_CACHE_HOME/lancedb/oauth`, `$HOME/.cache/lancedb/oauth` on Unix,
+or `%LOCALAPPDATA%\\lancedb\\oauth` on Windows. The directory is created
+with owner-only permissions (`0700`) when missing.
+
+***
+
+### lockTimeoutSecs?
+
+```ts
+optional lockTimeoutSecs: number;
+```
+
+How long to wait for the cross-process refresh lock before failing, in
+seconds (default: 30).

docs/src/js/interfaces/ViewDescription.md

@@ -0,0 +1,78 @@
+[**@lancedb/lancedb**](../README.md) • **Docs**
+
+***
+
+[@lancedb/lancedb](../globals.md) / ViewDescription
+
+# Interface: ViewDescription
+
+What a database records about one view.
+
+A view holds no rows: it stores the statement that defines it and the
+schema that statement resolved to, so a reader sees its sources as they
+are at read time.
+
+## Properties
+
+### defaultDatabase
+
+```ts
+defaultDatabase: string;
+```
+
+The database that unqualified table names in [query](ViewDescription.md#query) resolve against.
+
+***
+
+### defaultNamespacePath
+
+```ts
+defaultNamespacePath: string[];
+```
+
+The namespace path those unqualified names resolve against; empty is the
+root namespace.
+
+Recorded with the view because it outlives the session that declared it:
+a reader resolving the query against its own default namespace could read
+a different table than the view was defined over.
+
+***
+
+### name
+
+```ts
+name: string;
+```
+
+The view's name within its namespace.
+
+***
+
+### namespacePath
+
+```ts
+namespacePath: string[];
+```
+
+The namespace holding the view; empty is the root namespace.
+
+***
+
+### query
+
+```ts
+query: string;
+```
+
+The defining query, as the database stores it.
+
+***
+
+### schema
+
+```ts
+schema: Schema<any>;
+```
+
+The schema the defining query resolved to when the view was created.