@databricks/appkit 0.71.0 → 0.73.0

package/docs/api/appkit/TypeAlias.DatabaseApiWritesConfig.md

@@ -0,0 +1,49 @@
+# Type Alias: DatabaseApiWritesConfig\<TSchema>
+
+```ts
+type DatabaseApiWritesConfig<TSchema> = 
+  | boolean
+  | {
+  operations?: readonly DatabaseApiWriteOperation[];
+  tables?: readonly SchemaTableName<TSchema>[];
+};
+
+```
+
+All writes by default; false keeps reads only, and an object narrows writes.
+
+## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
+
+| Type Parameter                                                              |
+| --------------------------------------------------------------------------- |
+| `TSchema` *extends* [`Schema`](./docs/api/appkit/Interface.Schema.md) |
+
+## Type Declaration[​](#type-declaration "Direct link to Type Declaration")
+
+`boolean`
+
+```ts
+{
+  operations?: readonly DatabaseApiWriteOperation[];
+  tables?: readonly SchemaTableName<TSchema>[];
+}
+
+```
+
+### operations?[​](#operations "Direct link to operations?")
+
+```ts
+readonly optional operations: readonly DatabaseApiWriteOperation[];
+
+```
+
+Operations that remain enabled. Defaults to create, update, and delete.
+
+### tables?[​](#tables "Direct link to tables?")
+
+```ts
+readonly optional tables: readonly SchemaTableName<TSchema>[];
+
+```
+
+Tables that remain writable. Defaults to every exposed table.

package/docs/api/appkit/TypeAlias.DatabaseExports.md

@@ -26,9 +26,9 @@ transaction<T>(callback: (tx: TransactionClient) => Promise<T>): Promise<T>;
 
 #### Parameters[​](#parameters "Direct link to Parameters")
 
-| Parameter  | Type                                          |
-| ---------- | --------------------------------------------- |
-| `callback` | (`tx`: `TransactionClient`) => `Promise`<`T`> |
+| Parameter  | Type                                                                                                    |
+| ---------- | ------------------------------------------------------------------------------------------------------- |
+| `callback` | (`tx`: [`TransactionClient`](./docs/api/appkit/TypeAlias.TransactionClient.md)) => `Promise`<`T`> |
 
 #### Returns[​](#returns "Direct link to Returns")
 

package/docs/api/appkit/TypeAlias.EntityHooks.md

@@ -0,0 +1,25 @@
+# Type Alias: EntityHooks\<TTable>
+
+```ts
+type EntityHooks<TTable> = EntityMutationHooks<TTable> & {
+  serialize?: ReadSerializer;
+};
+
+```
+
+Response shaping and mutation lifecycle declared for one table.
+
+## Type Declaration[​](#type-declaration "Direct link to Type Declaration")
+
+### serialize?[​](#serialize "Direct link to serialize?")
+
+```ts
+readonly optional serialize: ReadSerializer;
+
+```
+
+## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
+
+| Type Parameter              | Default type |
+| --------------------------- | ------------ |
+| `TTable` *extends* `string` | `string`     |

package/docs/api/appkit/TypeAlias.EvalProgress.md

@@ -0,0 +1,26 @@
+# Type Alias: EvalProgress
+
+```ts
+type EvalProgress = 
+  | {
+  total: number;
+  type: "discovered";
+}
+  | {
+  runId: string;
+  type: "run-created";
+}
+  | {
+  id: string;
+  index: number;
+  total: number;
+  type: "start";
+}
+  | {
+  index: number;
+  result: EvalResult;
+  total: number;
+  type: "result";
+};
+
+```

package/docs/api/appkit/TypeAlias.IDatabaseConfig.md

@@ -2,8 +2,8 @@
 
 ```ts
 type IDatabaseConfig<TSchema> = {
-  crudRoutes?: CrudRoutesConfig<TSchema>;
-  hooks?: { readonly [TTable in SchemaTableName<TSchema>]?: { serialize?: ReadSerializer } };
+  api?: DatabaseApiConfig<TSchema>;
+  hooks?: { readonly [TTable in SchemaTableName<TSchema>]?: EntityHooks<TTable> };
   schema: TSchema;
 };
 
@@ -19,10 +19,21 @@ Configuration for one schema-bound DatabasePlugin instance.
 
 ## Properties[​](#properties "Direct link to Properties")
 
-### crudRoutes?[​](#crudroutes "Direct link to crudRoutes?")
+### api?[​](#api "Direct link to api?")
 
 ```ts
-readonly optional crudRoutes: CrudRoutesConfig<TSchema>;
+readonly optional api: DatabaseApiConfig<TSchema>;
+
+```
+
+Generated HTTP CRUD is enabled for all tables by default, using the app's service principal. Every admitted caller receives the enabled operations; no per-user or per-row authorization is applied. This plugin does not support OBO. Use custom routes for application-specific authorization.
+
+Set `false` to disable routes, `{ writes: false }` for reads only, or `{ tables: ["notes"] }` to expose only selected tables. To disable delete, use `{ writes: { operations: ["create", "update"] } }`.
+
+#### Default Value[​](#default-value "Direct link to Default Value")
+
+```ts
+true
 
 ```
 
@@ -31,7 +42,7 @@ readonly optional crudRoutes: CrudRoutesConfig<TSchema>;
 ### hooks?[​](#hooks "Direct link to hooks?")
 
 ```ts
-readonly optional hooks: { readonly [TTable in SchemaTableName<TSchema>]?: { serialize?: ReadSerializer } };
+readonly optional hooks: { readonly [TTable in SchemaTableName<TSchema>]?: EntityHooks<TTable> };
 
 ```
 

package/docs/api/appkit/TypeAlias.Matcher.md

@@ -0,0 +1,18 @@
+# Type Alias: Matcher()
+
+```ts
+type Matcher = (value: string) => MatchResult;
+
+```
+
+A deterministic matcher: inspects a string value and returns a result.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type     |
+| --------- | -------- |
+| `value`   | `string` |
+
+## Returns[​](#returns "Direct link to Returns")
+
+[`MatchResult`](./docs/api/appkit/Interface.MatchResult.md)

package/docs/api/appkit/TypeAlias.ReadSerializer.md

@@ -0,0 +1,19 @@
+# Type Alias: ReadSerializer()
+
+```ts
+type ReadSerializer = (row: Record<string, unknown>, context: ReadSerializerContext) => Record<string, unknown>;
+
+```
+
+Shape one already private-safe row before it reaches the wire. A `Promise` is not assignable to the return type, so an async callback fails to compile: serializers run inside the response path and must not add latency there.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                                                  |
+| --------- | ------------------------------------------------------------------------------------- |
+| `row`     | `Record`<`string`, `unknown`>                                                         |
+| `context` | [`ReadSerializerContext`](./docs/api/appkit/Interface.ReadSerializerContext.md) |
+
+## Returns[​](#returns "Direct link to Returns")
+
+`Record`<`string`, `unknown`>

package/docs/api/appkit/TypeAlias.Severity.md

@@ -0,0 +1,8 @@
+# Type Alias: Severity
+
+```ts
+type Severity = "gate" | "soft";
+
+```
+
+Whether an assertion fails the eval (`gate`) or is tracked only (`soft`).

package/docs/api/appkit/TypeAlias.TransactionClient.md

@@ -0,0 +1,19 @@
+# Type Alias: TransactionClient
+
+```ts
+type TransactionClient = { readonly [K in EntityName]: TypedEntityClient<K> } & {
+  sql: SqlTag;
+};
+
+```
+
+Entity and SQL capabilities bound to one transaction.
+
+## Type Declaration[​](#type-declaration "Direct link to Type Declaration")
+
+### sql[​](#sql "Direct link to sql")
+
+```ts
+readonly sql: SqlTag;
+
+```