exponential-sdk 1.25.0 → 1.26.0

package/README.md

@@ -187,6 +187,67 @@ const { draftCount, discardedWithoutEvidence } =
 
 ---
 
+### Databases
+
+Typed tables inside pages (ADR-0078). A database is a block in a page's body,
+owned by that page; each row is a page of its own (body, comments, history,
+URL) hidden from the Pages list. **Writes are typed**: every value is checked
+against its property's type and a bad one is refused naming the property
+(`error.data.property`). Reading the holding page with `pages.get` shows the
+table; this API is for the writes and for reading rows as data.
+
+```typescript
+// Create a database on a page, then place its block by appending the marker
+const page = await client.pages.get("page-123");
+const metrics = await client.databases.create({ pageId: page.id, name: "Metrics" });
+await client.pages.update({
+  id: page.id,
+  body: `${page.body}\n\n${metrics.marker}`,
+  baseVersion: page.docVersion,
+  note: "Add the Metrics database",
+});
+
+// Properties: title exists from creation; add the rest
+await client.databases.addProperty({
+  id: metrics.id,
+  name: "Status",
+  type: "select",
+  options: [{ name: "Not measured" }, { name: "Instrumenting" }, { name: "Tracked" }],
+});
+await client.databases.addProperty({ id: metrics.id, name: "Owner", type: "person" });
+
+// Rows: values by property name (or id); a select by option name
+const row = await client.databases.createRow(
+  metrics.id,
+  { Name: "Alert latency", Status: "Tracked", Owner: "user-123" },
+  { note: "Imported from the CLEAR page" },
+);
+await client.databases.updateRow(row.id, { Status: "Instrumenting" }, { note: "Re-measuring" });
+
+// Read rows through the saved view, or through a view of your own
+const { rows, nextCursor, columns } = await client.databases.listRows(metrics.id, {
+  view: { filters: [{ propertyId: "Status", op: "eq", value: "Tracked" }], hiddenPropertyIds: [], propertyOrder: [] },
+});
+```
+
+#### Property types
+
+`title` · `text` · `number` · `select` · `multiSelect` · `date` · `checkbox` ·
+`url` · `person` · `relation` (V3), plus read-only `createdTime` ·
+`lastEditedTime` · `createdBy`. Property and option ids are stable: renaming
+never rewrites a row. Stored values: `select` holds the option **id**,
+`multiSelect` and `person` lists, `date` an ISO 8601 string.
+
+#### Lifecycle
+
+Removing the block from the page **detaches** the database (`detachedAt`);
+its rows stay until `databases.delete`, the page's deletion, or the daily
+purge 30 days later. Writing the marker back re-attaches it. Rows follow the
+holding page for access, placement and publishing — `pages.move`,
+`pages.publish` and sharing on a row page are refused.
+
+---
+
 ### Configuration
 
 Credentials are stored persistently using the OS keychain via [`conf`](https://github.com/sindresorhus/conf).

package/dist/index.d.ts

@@ -47,6 +47,20 @@ type ProjectUpdateApiInput = {
     startDate?: Date | null;
     endDate?: Date | null;
 };
+/** `database.*` saved view as the server validates it (ADR-0078). */
+type DatabaseViewInput = {
+    sort?: {
+        propertyId: string;
+        direction: 'asc' | 'desc';
+    };
+    filters: {
+        propertyId: string;
+        op: string;
+        value?: unknown;
+    }[];
+    hiddenPropertyIds: string[];
+    propertyOrder: string[];
+};
 type ActionStatus$1 = 'ACTIVE' | 'COMPLETED' | 'CANCELLED' | 'DELETED' | 'DRAFT';
 type ActionKanbanStatus = 'BACKLOG' | 'TODO' | 'IN_PROGRESS' | 'IN_REVIEW' | 'DONE' | 'CANCELLED';
 type ActionPriority = 'Quick' | 'Scheduled' | '1st Priority' | '2nd Priority' | '3rd Priority' | '4th Priority' | '5th Priority' | 'Errand' | 'Remember' | 'Watch' | 'Someday Maybe';
@@ -979,6 +993,117 @@ interface TrpcClient {
             }) => Promise<unknown>;
         };
     };
+    database: {
+        create: {
+            mutate: (input: {
+                pageId: string;
+                name: string;
+            }) => Promise<unknown>;
+        };
+        get: {
+            query: (input: {
+                id: string;
+            }) => Promise<unknown>;
+        };
+        list: {
+            query: (input: {
+                pageId: string;
+            }) => Promise<unknown[]>;
+        };
+        update: {
+            mutate: (input: {
+                id: string;
+                name?: string;
+                view?: DatabaseViewInput;
+            }) => Promise<unknown>;
+        };
+        delete: {
+            mutate: (input: {
+                id: string;
+            }) => Promise<unknown>;
+        };
+        addProperty: {
+            mutate: (input: {
+                id: string;
+                name: string;
+                type: string;
+                description?: string;
+                options?: {
+                    id?: string;
+                    name: string;
+                    color?: string;
+                }[];
+            }) => Promise<unknown>;
+        };
+        updateProperty: {
+            mutate: (input: {
+                id: string;
+                propertyId: string;
+                name?: string;
+                description?: string | null;
+                type?: string;
+                options?: {
+                    id?: string;
+                    name: string;
+                    color?: string;
+                }[];
+            }) => Promise<unknown>;
+        };
+        removeProperty: {
+            mutate: (input: {
+                id: string;
+                propertyId: string;
+            }) => Promise<unknown>;
+        };
+        reorderProperties: {
+            mutate: (input: {
+                id: string;
+                propertyIds: string[];
+            }) => Promise<unknown>;
+        };
+        listRows: {
+            query: (input: {
+                id: string;
+                view?: DatabaseViewInput;
+                limit?: number;
+                cursor?: string;
+            }) => Promise<unknown>;
+        };
+        createRow: {
+            mutate: (input: {
+                id: string;
+                values?: Record<string, unknown>;
+                note?: string;
+            }) => Promise<unknown>;
+        };
+        updateRow: {
+            mutate: (input: {
+                rowId: string;
+                values: Record<string, unknown>;
+                note?: string;
+            }) => Promise<unknown>;
+        };
+        deleteRow: {
+            mutate: (input: {
+                rowId: string;
+            }) => Promise<unknown>;
+        };
+        previewCsv: {
+            mutate: (input: {
+                id: string;
+                csv: string;
+                mapping?: Record<string, unknown>;
+            }) => Promise<unknown>;
+        };
+        commitCsv: {
+            mutate: (input: {
+                id: string;
+                csv: string;
+                mapping: Record<string, unknown>;
+                note?: string;
+            }) => Promise<unknown>;
+        };
+    };
     resource: {
         list: {
             query: (input: {
@@ -4380,6 +4505,331 @@ declare class PagesApi {
     }>;
 }
 
+type PropertyType = 'title' | 'text' | 'number' | 'select' | 'multiSelect' | 'date' | 'checkbox' | 'url' | 'person' | 'relation' | 'createdTime' | 'lastEditedTime' | 'createdBy';
+/** Select-option colours are palette names, never hex. */
+type PillColor = 'gray' | 'red' | 'pink' | 'grape' | 'violet' | 'indigo' | 'blue' | 'cyan' | 'teal' | 'green' | 'lime' | 'yellow' | 'orange';
+type RelationTargetKind = 'ROW' | 'TICKET' | 'PROJECT' | 'FEATURE' | 'GOAL' | 'KEY_RESULT' | 'PAGE';
+interface SelectOption {
+    /** Stable: a renamed option keeps its id, so rows never need rewriting. */
+    id: string;
+    name: string;
+    color: PillColor;
+}
+interface RelationConfig {
+    targetKind: RelationTargetKind;
+    /** The other database, for `ROW` targets. */
+    targetDatabaseId?: string;
+    /** Set on the auto-created reverse column of a two-way database relation. */
+    inverseOf?: {
+        databaseId: string;
+        propertyId: string;
+    };
+    many: boolean;
+}
+/** One column of a database. Ids are stable; names are free to change. */
+interface PropertyDef {
+    id: string;
+    name: string;
+    type: PropertyType;
+    description?: string;
+    /** `select` / `multiSelect` only. */
+    options?: SelectOption[];
+    /** `relation` only (written from V3). */
+    relation?: RelationConfig;
+}
+type FilterOp = 'eq' | 'neq' | 'contains' | 'isEmpty' | 'isNotEmpty' | 'gt' | 'lt' | 'before' | 'after' | 'anyOf';
+interface DatabaseFilter {
+    propertyId: string;
+    op: FilterOp;
+    /**
+     * Checked against the property like a written value: a select may be
+     * named by option name or id; `anyOf` takes a list (or a comma-separated
+     * string); `gt`/`lt` a number; `before`/`after` an ISO date.
+     */
+    value?: unknown;
+}
+/** The one table view saved on the block: sort, filters, hidden columns, column order. */
+interface DatabaseView {
+    sort?: {
+        propertyId: string;
+        direction: 'asc' | 'desc';
+    };
+    filters: DatabaseFilter[];
+    hiddenPropertyIds: string[];
+    /** Column order by property id; properties missing here follow in definition order. */
+    propertyOrder: string[];
+}
+interface Database {
+    id: string;
+    /** The page whose body holds the block, and which decides access to every row. */
+    pageId: string;
+    workspaceId: string;
+    name: string;
+    properties: PropertyDef[];
+    view: DatabaseView;
+    /** The id of the `title` property; its value is each row page's title. */
+    titlePropertyId: string;
+    /**
+     * Set while the block is out of the page body. A detached database keeps
+     * its rows until it is deleted, its page is deleted, or the daily purge
+     * takes it after 30 days; writing its marker back into the body re-attaches it.
+     */
+    detachedAt: Date | null;
+    createdById: string;
+    createdAt: Date;
+    updatedAt: Date;
+    page: {
+        id: string;
+        title: string;
+    };
+    /**
+     * The marker line that stands for the block in the page's Markdown body:
+     * `<!-- database:<id> -->`. Append it to the body (through `pages.update`)
+     * to place a database you created; reads expand it into the table.
+     */
+    marker?: string;
+    /** Present on `get` and `list`. */
+    rowCount?: number;
+}
+/**
+ * A stored cell value: `title`/`text`/`url` a string, `number` a number,
+ * `select` an option id, `multiSelect` option ids, `date` an ISO 8601 string,
+ * `checkbox` a boolean, `person` user ids.
+ */
+type PropertyValue = string | number | boolean | string[];
+/** A row: a page of the database with its typed values keyed by property id. */
+interface DatabaseRow {
+    id: string;
+    /** The title property's value — the row page's title. */
+    title: string;
+    databaseId: string | null;
+    /** Values keyed by **property id** (not name); the title is not among them. */
+    values: Record<string, PropertyValue | null>;
+    createdById: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface DatabaseRowsPage {
+    rows: DatabaseRow[];
+    /** Pass back as `cursor` for the next page; null on the last one. */
+    nextCursor: string | null;
+    /** The visible property ids in view order. Rows still carry hidden values. */
+    columns: string[];
+}
+/**
+ * Why a write was refused: the property it names and the reason, in plain
+ * words. Arrives as `error.data.property` on a `BAD_REQUEST`.
+ */
+interface PropertyRejection {
+    /** Null when the write named a property that does not exist. */
+    propertyId: string | null;
+    propertyName: string;
+    reason: string;
+}
+interface DeletedDatabase {
+    id: string;
+    /** Rows deleted with it. */
+    rowCount: number;
+}
+/** Where one CSV column lands: skipped, an existing property (by id), or a new property. */
+type CsvColumnTarget = {
+    kind: 'skip';
+} | {
+    kind: 'property';
+    propertyId: string;
+} | {
+    kind: 'new';
+    name: string;
+    type: PropertyType;
+};
+/** Column header (as in the file) → target. Headers left out are skipped. */
+type CsvMapping = Record<string, CsvColumnTarget>;
+/** A cell the property's type refused: where it sits and why. */
+interface CsvCellError {
+    header: string;
+    propertyName: string;
+    reason: string;
+}
+/** One file row, typed. `values` are keyed by property id, or `new:<name>` for a column not created yet. */
+interface CsvPreviewRow {
+    /** 0-based among the data rows (the header line is not counted). */
+    index: number;
+    title: string | undefined;
+    values: Record<string, PropertyValue | null>;
+    /** Empty when the row would be created. */
+    errors: CsvCellError[];
+}
+interface CsvPreviewColumn {
+    header: string;
+    target: CsvColumnTarget;
+    propertyName: string | null;
+    type: PropertyType | null;
+}
+interface CsvPreview {
+    headers: string[];
+    /** The mapping used — the one passed, or the suggestion by header name. Pass it back to `commitCsv`. */
+    mapping: CsvMapping;
+    columns: CsvPreviewColumn[];
+    rows: CsvPreviewRow[];
+    total: number;
+    /** Rows with no cell error — what a commit creates. */
+    importable: number;
+    /**
+     * Select / multi-select option names the file uses that the property
+     * lacks, by column definition id (`new:<name>` for a new column). The
+     * commit creates them; cells naming them hold the name until then.
+     */
+    newOptions: Record<string, string[]>;
+}
+interface CsvCommitResult {
+    /** The new row ids, in file order. */
+    created: string[];
+    /** Rows left uncreated, each with the cells that did not fit. */
+    skipped: {
+        index: number;
+        errors: CsvCellError[];
+    }[];
+    /** Properties the import added (the `new` columns), with their minted ids. */
+    properties: PropertyDef[];
+    total: number;
+}
+
+interface DatabaseCreateInput {
+    /** The page whose body will hold the block; you need edit access to it. */
+    pageId: string;
+    name: string;
+}
+interface DatabaseUpdateInput {
+    id: string;
+    name?: string;
+    /** Replaces the saved view whole — send the full view, not a patch. */
+    view?: DatabaseView;
+}
+/** A select option to add or keep. Pass `id` to rename or recolour an existing one. */
+interface SelectOptionInput {
+    id?: string;
+    name: string;
+    /** Defaults to the next palette colour. */
+    color?: PillColor;
+}
+/** Types a property can be added as or changed to: everything but `title` (one per database) and `relation` (V3). */
+type AddablePropertyType = Exclude<PropertyType, 'title' | 'relation'>;
+interface PropertyAddInput {
+    /** The database. */
+    id: string;
+    name: string;
+    type: AddablePropertyType;
+    description?: string;
+    /** `select` / `multiSelect` only. */
+    options?: SelectOptionInput[];
+}
+interface PropertyUpdateInput {
+    /** The database. */
+    id: string;
+    /** The property, by id or by (unique, case-insensitive) name. */
+    propertyId: string;
+    name?: string;
+    /** Null clears it. */
+    description?: string | null;
+    type?: AddablePropertyType;
+    /**
+     * The full option list: options left out are removed (rows keep the old
+     * id, which then reads as its raw text). Options with an `id` keep it.
+     */
+    options?: SelectOptionInput[];
+}
+interface RowListOptions {
+    /**
+     * A whole view to read through instead of the saved one — for example a
+     * single filter. Every property it names must exist.
+     */
+    view?: DatabaseView;
+    /** Rows per page (1–200, server default 50). */
+    limit?: number;
+    /** `nextCursor` from the previous page. */
+    cursor?: string;
+}
+/**
+ * Cell values to write, keyed by property **id or name** (the CLI's
+ * `--set Status=Tracked` is a name). Each is checked against the property's
+ * type: a select takes an option name or id, a multiSelect a list (or a
+ * comma-separated string), a date an ISO string, a checkbox a boolean or
+ * "yes"/"no", a person a user id or list of them. `null` clears a cell.
+ * The title property's value becomes the row page's title.
+ */
+type RowValuesInput = Record<string, unknown>;
+interface RowWriteOptions {
+    /** Why — recorded on the row page's revision. Always send one from an agent. */
+    note?: string;
+}
+interface DatabasePropertyResult {
+    property: PropertyDef;
+    database: Database;
+}
+/**
+ * Databases (ADR-0078): typed tables inside pages. The database is a block in
+ * a page's body, owned by that page; each row is a page of its own, hidden
+ * from the Pages list and reached through the database.
+ *
+ * **Writes are typed.** Values are checked against the property's type and a
+ * bad one is refused naming the property (`error.data.property`). Reads of
+ * the holding page (`pages.get`) show the table; this API is for the writes
+ * and for reading rows as data. Values in responses are keyed by property id;
+ * writes accept names too.
+ *
+ * Not a work tracker: a database may point at a Ticket, Project, Feature,
+ * Goal, Key result or Page (relations, V3) but never stands in for one.
+ */
+declare class DatabasesApi {
+    private client;
+    constructor(client: TrpcClient);
+    /**
+     * Create a database on a page with a title property. Then put its
+     * `marker` into the page body (`pages.update` with the body plus the
+     * marker on its own line) so the page shows it.
+     */
+    create(input: DatabaseCreateInput): Promise<Database>;
+    /** One database: definition, view, row count and holding page. */
+    get(id: string): Promise<Database>;
+    /** The databases a page holds, detached ones included, with row counts. */
+    list(pageId: string): Promise<Database[]>;
+    /** Rename, or replace the saved view whole. */
+    update(input: DatabaseUpdateInput): Promise<Database>;
+    /** Delete the database and every row with it. Removing the block from the page only detaches; this is the delete. */
+    delete(id: string): Promise<DeletedDatabase>;
+    /** Add a property. New select options get ids and palette colours; the column goes last in the view. */
+    addProperty(input: PropertyAddInput): Promise<DatabasePropertyResult>;
+    /** Rename, describe, retype or re-option a property. Ids stay; no row is rewritten. */
+    updateProperty(input: PropertyUpdateInput): Promise<DatabasePropertyResult>;
+    /** Remove a property (by id or name) from the schema and view. Never the title. */
+    removeProperty(databaseId: string, propertyId: string): Promise<Database>;
+    /** Set the column order; `propertyIds` must name every property exactly once. */
+    reorderProperties(databaseId: string, propertyIds: string[]): Promise<Database>;
+    /** The rows through the saved view (or `options.view`), paged by cursor. */
+    listRows(databaseId: string, options?: RowListOptions): Promise<DatabaseRowsPage>;
+    /** Add a row with typed values. Placed where the holding page is. */
+    createRow(databaseId: string, values?: RowValuesInput, options?: RowWriteOptions): Promise<DatabaseRow>;
+    /** Write some of a row's values; cells not named are kept, `null` clears one. Records a revision on the row page. */
+    updateRow(rowId: string, values: RowValuesInput, options?: RowWriteOptions): Promise<DatabaseRow>;
+    /** Delete a row — the page and its search chunks. */
+    deleteRow(rowId: string): Promise<{
+        id: string;
+        databaseId: string;
+    }>;
+    /**
+     * Type a CSV against the database before anything is created: columns
+     * resolved through `mapping` (or suggested by header name), every row
+     * checked, each cell that does not fit named. Writes nothing.
+     */
+    previewCsv(databaseId: string, csv: string, mapping?: CsvMapping): Promise<CsvPreview>;
+    /**
+     * Import a CSV: new columns become properties, then every row with no
+     * cell error becomes a row with a `create` revision; the rest are reported
+     * and left uncreated. Up to 2,000 rows a time.
+     */
+    commitCsv(databaseId: string, csv: string, mapping: CsvMapping, options?: RowWriteOptions): Promise<CsvCommitResult>;
+}
+
 type ResourceContentType = 'web_page' | 'document' | 'pdf' | 'bookmark' | 'note';
 /** Has the owner consumed this Resource yet? Orthogonal to archiving. */
 type ReadStatus = 'to_read' | 'reading' | 'read';
@@ -5048,6 +5498,8 @@ declare class ExponentialClient {
     areas: AreasApi;
     meetings: MeetingsApi;
     pages: PagesApi;
+    /** Databases — typed tables inside pages (ADR-0078). */
+    databases: DatabasesApi;
     resources: ResourcesApi;
     requirements: RequirementsApi;
     scopes: ScopesApi;
@@ -5062,4 +5514,4 @@ declare class ExponentialClient {
     });
 }
 
-export { type Action, type ActionComment, type ActionCommentAddInput, type ActionCommentUpdateInput, type ActionCreateInput, type ActionOutput, type ActionStatus, type ActionUpdateInput, type ActionUpsertBySourceInput, type ActionUpsertBySourceResult, type ActionsListOutput, type AddInteractionInput, type AgentRunStatus, AgentRunsApi, type AppendEventsResult, type Area, type AreaCreateInput, type AreaListOptions, type ClaimedRun, type CommentAuthor, type Contact, type ContactCreateInput, type ContactInteraction, type ContactListOutput, type ContactUpdateInput, type ContactsListOptions, type ConversationMessage, DEFAULT_GAP_MINUTES, type DayReport, type DayReportActionRow, type DayReportEntry, type DayReportProductRow, type Deal, type DealActivity, type DealCreateInput, type DealMoveInput, type DealUpdateInput, type Decision, type DecisionAdrRef, type DecisionChainRef, type DecisionCreateInput, type DecisionDecider, type DecisionDeciderInput, type DecisionEvidenceTurn, type DecisionFeatureRef, type DecisionLink, type DecisionListOptions, type DecisionListRow, type DecisionMeetingRef, type DecisionOccurrenceRef, type DecisionProductRef, type DecisionProjectRef, type DecisionReviewState, type DecisionSetStatusInput, type DecisionSource, type DecisionStatus, type DecisionTicketRef, type DecisionUpdateInput, type DecisionUserRef, type DraftDecisionsResult, type EnrichContactResult, type Epic, type EpicCreateInput, type EpicListOptions, type EpicPriority, type EpicStatus, type EpicUpdateInput, ExponentialClient, type ExponentialConfig, type Feature, type FeatureComment, type FeatureCommentCreateInput, type FeatureCommentReplyInput, type FeatureCommentThreadInput, type FeatureCommentUpdateInput, type FeatureCreateInput, type FeatureKeyResultLink, type FeatureLinkPageInput, type FeatureListOptions, type FeatureScope, type FeatureScopeStatus, type FeatureStatus, type FeatureUpdateInput, type FinishInput, type FinishResult, type GlobalSearchOptions, type GlobalSearchOutput, type Goal, type GoalChildSummary, type GoalComment, type GoalCommentAddInput, type GoalCommentUpdateInput, type GoalCreateInput, type GoalHealth, type GoalKeyResultSummary, type GoalLifeDomain, type GoalListOptions, type GoalPeriod, type GoalProjectSummary, type GoalSetParentInput, type GoalSetStatusInput, type GoalStats, type GoalStatsOptions, type GoalStatus, type GoalTreeNode, type GoalTreeOptions, type GoalUpdateInput, type GoalUserSummary, type GoalWritableStatus, type HeartbeatResult, type InteractionDirection, type InteractionType, type KanbanStatus, type KeyResult, type KeyResultByObjectiveOptions, type KeyResultCheckIn, type KeyResultCheckInInput, type KeyResultCreateInput, type KeyResultFeatureLink, type KeyResultListOptions, type KeyResultProjectLink, type KeyResultStatus, type KeyResultUnit, type KeyResultUpdateInput, type KnowledgePage, type KnowledgeSearchOptions, type KnowledgeSearchOutput, type KnowledgeSearchResult, type KnowledgeSourceType, type LabelCreateInput, type LabelListOptions, type ListForEntityInput, type Meeting, type MeetingActionSummary, type MeetingCreateInput, type MeetingDecisions, type MeetingListOptions, type MeetingParticipant, type MeetingParticipantInput, type MeetingProjectRef, type MeetingSourceIntegration, type MeetingTypeFilter, type MeetingUpdateInput, type MeetingWorkspaceRef, type ObjectiveWithKeyResults, type Organization, type OrganizationCreateInput, type OrganizationListOutput, type OrganizationSize, type OrganizationsListOptions, type OverdueCohort, type OverdueTriage, type OverdueTriageRow, type PageComment, type PageCommentCreateInput, type PageCommentUpdateInput, type PageCreateInput, type PageDiff, type PageDiffOptions, type PageDiffSide, type PageGetFormat, type PageGetOptions, type PageHistory, type PageHistoryOptions, type PageListOptions, type PageOutlineEntry, type PageRestoreOptions, type PageRevision, type PageRevisionAuthor, type PageRevisionDetail, type PageRevisionKind, type PageSearchOptions, type PageSearchOutput, type PageSearchResult, type PageUpdateInput, type Pipeline, type PipelineStage, type Priority, type Product, type ProductCreateInput, type ProductUpdateInput, type Project, type ProjectDetail, type ProjectKeyResultLink, type ProjectOutput, type ProjectPriority, type ProjectStatus, type ProjectUpdateInput, type ProjectsListOptions, type ProjectsListOutput, ROUND_MINUTES, type ReadStatus, type Requirement, type RequirementCreateInput, type RequirementKind, type RequirementListOptions, type Resource, type ResourceContentType, type ResourceCreateInput, type ResourceListOptions, type ResourceListResult, type ResourceReadState, type ResourceUpdateInput, type RunMessage, type RunnerEvent, type RunnerEventKind, type ScopeCreateInput, type ScopeListOptions, type ScopeUpdateInput, type SearchResult, type SearchResultType, type SearchResultWorkspace, type SetEntityTagsInput, type SetEntityTagsResult, type Tag, type TagEntityType, type TagListResult, type Ticket, type TicketAssignee, type TicketComment, type TicketCommentAddInput, type TicketCommentUpdateInput, type TicketCreateInput, type TicketDependencyEdge, type TicketDetail, type TicketListOptions, type TicketSearchOptions, type TicketStatus, type TicketType, type TicketUpdateInput, TimeApi, type TimeConfirmDayResult, type TimeEntry, type TimeEntrySource, type TimeEntryStatus, type TimeLogBatchResult, type TimeLogInput, type TimeLogOutcome, type TimeLogResult, type TodaysActionRow, type TodaysActions, type TodaysActionsGroup, type UserStory, type UserStoryCreateInput, type UserStoryListOptions, type UserStoryUpdateInput, type WorklogSegment, type Workspace, type WorkspaceMember, type WorkspaceOutput, type WorkspacesListOutput, clearConfig, createConfigStore, getConfigPath, isAuthenticated, isTRPCError, loadConfig, saveConfig, segmentConversation };
+export { type Action, type ActionComment, type ActionCommentAddInput, type ActionCommentUpdateInput, type ActionCreateInput, type ActionOutput, type ActionStatus, type ActionUpdateInput, type ActionUpsertBySourceInput, type ActionUpsertBySourceResult, type ActionsListOutput, type AddInteractionInput, type AddablePropertyType, type AgentRunStatus, AgentRunsApi, type AppendEventsResult, type Area, type AreaCreateInput, type AreaListOptions, type ClaimedRun, type CommentAuthor, type Contact, type ContactCreateInput, type ContactInteraction, type ContactListOutput, type ContactUpdateInput, type ContactsListOptions, type ConversationMessage, type CsvCellError, type CsvColumnTarget, type CsvCommitResult, type CsvMapping, type CsvPreview, type CsvPreviewColumn, type CsvPreviewRow, DEFAULT_GAP_MINUTES, type Database, type DatabaseCreateInput, type DatabaseFilter, type DatabasePropertyResult, type DatabaseRow, type DatabaseRowsPage, type DatabaseUpdateInput, type DatabaseView, type DayReport, type DayReportActionRow, type DayReportEntry, type DayReportProductRow, type Deal, type DealActivity, type DealCreateInput, type DealMoveInput, type DealUpdateInput, type Decision, type DecisionAdrRef, type DecisionChainRef, type DecisionCreateInput, type DecisionDecider, type DecisionDeciderInput, type DecisionEvidenceTurn, type DecisionFeatureRef, type DecisionLink, type DecisionListOptions, type DecisionListRow, type DecisionMeetingRef, type DecisionOccurrenceRef, type DecisionProductRef, type DecisionProjectRef, type DecisionReviewState, type DecisionSetStatusInput, type DecisionSource, type DecisionStatus, type DecisionTicketRef, type DecisionUpdateInput, type DecisionUserRef, type DeletedDatabase, type DraftDecisionsResult, type EnrichContactResult, type Epic, type EpicCreateInput, type EpicListOptions, type EpicPriority, type EpicStatus, type EpicUpdateInput, ExponentialClient, type ExponentialConfig, type Feature, type FeatureComment, type FeatureCommentCreateInput, type FeatureCommentReplyInput, type FeatureCommentThreadInput, type FeatureCommentUpdateInput, type FeatureCreateInput, type FeatureKeyResultLink, type FeatureLinkPageInput, type FeatureListOptions, type FeatureScope, type FeatureScopeStatus, type FeatureStatus, type FeatureUpdateInput, type FilterOp, type FinishInput, type FinishResult, type GlobalSearchOptions, type GlobalSearchOutput, type Goal, type GoalChildSummary, type GoalComment, type GoalCommentAddInput, type GoalCommentUpdateInput, type GoalCreateInput, type GoalHealth, type GoalKeyResultSummary, type GoalLifeDomain, type GoalListOptions, type GoalPeriod, type GoalProjectSummary, type GoalSetParentInput, type GoalSetStatusInput, type GoalStats, type GoalStatsOptions, type GoalStatus, type GoalTreeNode, type GoalTreeOptions, type GoalUpdateInput, type GoalUserSummary, type GoalWritableStatus, type HeartbeatResult, type InteractionDirection, type InteractionType, type KanbanStatus, type KeyResult, type KeyResultByObjectiveOptions, type KeyResultCheckIn, type KeyResultCheckInInput, type KeyResultCreateInput, type KeyResultFeatureLink, type KeyResultListOptions, type KeyResultProjectLink, type KeyResultStatus, type KeyResultUnit, type KeyResultUpdateInput, type KnowledgePage, type KnowledgeSearchOptions, type KnowledgeSearchOutput, type KnowledgeSearchResult, type KnowledgeSourceType, type LabelCreateInput, type LabelListOptions, type ListForEntityInput, type Meeting, type MeetingActionSummary, type MeetingCreateInput, type MeetingDecisions, type MeetingListOptions, type MeetingParticipant, type MeetingParticipantInput, type MeetingProjectRef, type MeetingSourceIntegration, type MeetingTypeFilter, type MeetingUpdateInput, type MeetingWorkspaceRef, type ObjectiveWithKeyResults, type Organization, type OrganizationCreateInput, type OrganizationListOutput, type OrganizationSize, type OrganizationsListOptions, type OverdueCohort, type OverdueTriage, type OverdueTriageRow, type PageComment, type PageCommentCreateInput, type PageCommentUpdateInput, type PageCreateInput, type PageDiff, type PageDiffOptions, type PageDiffSide, type PageGetFormat, type PageGetOptions, type PageHistory, type PageHistoryOptions, type PageListOptions, type PageOutlineEntry, type PageRestoreOptions, type PageRevision, type PageRevisionAuthor, type PageRevisionDetail, type PageRevisionKind, type PageSearchOptions, type PageSearchOutput, type PageSearchResult, type PageUpdateInput, type PillColor, type Pipeline, type PipelineStage, type Priority, type Product, type ProductCreateInput, type ProductUpdateInput, type Project, type ProjectDetail, type ProjectKeyResultLink, type ProjectOutput, type ProjectPriority, type ProjectStatus, type ProjectUpdateInput, type ProjectsListOptions, type ProjectsListOutput, type PropertyAddInput, type PropertyDef, type PropertyRejection, type PropertyType, type PropertyUpdateInput, type PropertyValue, ROUND_MINUTES, type ReadStatus, type RelationConfig, type RelationTargetKind, type Requirement, type RequirementCreateInput, type RequirementKind, type RequirementListOptions, type Resource, type ResourceContentType, type ResourceCreateInput, type ResourceListOptions, type ResourceListResult, type ResourceReadState, type ResourceUpdateInput, type RowListOptions, type RowValuesInput, type RowWriteOptions, type RunMessage, type RunnerEvent, type RunnerEventKind, type ScopeCreateInput, type ScopeListOptions, type ScopeUpdateInput, type SearchResult, type SearchResultType, type SearchResultWorkspace, type SelectOption, type SelectOptionInput, type SetEntityTagsInput, type SetEntityTagsResult, type Tag, type TagEntityType, type TagListResult, type Ticket, type TicketAssignee, type TicketComment, type TicketCommentAddInput, type TicketCommentUpdateInput, type TicketCreateInput, type TicketDependencyEdge, type TicketDetail, type TicketListOptions, type TicketSearchOptions, type TicketStatus, type TicketType, type TicketUpdateInput, TimeApi, type TimeConfirmDayResult, type TimeEntry, type TimeEntrySource, type TimeEntryStatus, type TimeLogBatchResult, type TimeLogInput, type TimeLogOutcome, type TimeLogResult, type TodaysActionRow, type TodaysActions, type TodaysActionsGroup, type UserStory, type UserStoryCreateInput, type UserStoryListOptions, type UserStoryUpdateInput, type WorklogSegment, type Workspace, type WorkspaceMember, type WorkspaceOutput, type WorkspacesListOutput, clearConfig, createConfigStore, getConfigPath, isAuthenticated, isTRPCError, loadConfig, saveConfig, segmentConversation };

package/dist/index.js

@@ -1137,6 +1137,88 @@ var PagesApi = class {
   }
 };
 
+// src/databases.ts
+var DatabasesApi = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a database on a page with a title property. Then put its
+   * `marker` into the page body (`pages.update` with the body plus the
+   * marker on its own line) so the page shows it.
+   */
+  async create(input) {
+    return await this.client.database.create.mutate(input);
+  }
+  /** One database: definition, view, row count and holding page. */
+  async get(id) {
+    return await this.client.database.get.query({ id });
+  }
+  /** The databases a page holds, detached ones included, with row counts. */
+  async list(pageId) {
+    return await this.client.database.list.query({ pageId });
+  }
+  /** Rename, or replace the saved view whole. */
+  async update(input) {
+    return await this.client.database.update.mutate(input);
+  }
+  /** Delete the database and every row with it. Removing the block from the page only detaches; this is the delete. */
+  async delete(id) {
+    return await this.client.database.delete.mutate({ id });
+  }
+  // ── Properties ─────────────────────────────────────────────────────────────
+  /** Add a property. New select options get ids and palette colours; the column goes last in the view. */
+  async addProperty(input) {
+    return await this.client.database.addProperty.mutate(input);
+  }
+  /** Rename, describe, retype or re-option a property. Ids stay; no row is rewritten. */
+  async updateProperty(input) {
+    return await this.client.database.updateProperty.mutate(input);
+  }
+  /** Remove a property (by id or name) from the schema and view. Never the title. */
+  async removeProperty(databaseId, propertyId) {
+    return await this.client.database.removeProperty.mutate({ id: databaseId, propertyId });
+  }
+  /** Set the column order; `propertyIds` must name every property exactly once. */
+  async reorderProperties(databaseId, propertyIds) {
+    return await this.client.database.reorderProperties.mutate({ id: databaseId, propertyIds });
+  }
+  // ── Rows ───────────────────────────────────────────────────────────────────
+  /** The rows through the saved view (or `options.view`), paged by cursor. */
+  async listRows(databaseId, options = {}) {
+    return await this.client.database.listRows.query({ id: databaseId, ...options });
+  }
+  /** Add a row with typed values. Placed where the holding page is. */
+  async createRow(databaseId, values = {}, options = {}) {
+    return await this.client.database.createRow.mutate({ id: databaseId, values, ...options });
+  }
+  /** Write some of a row's values; cells not named are kept, `null` clears one. Records a revision on the row page. */
+  async updateRow(rowId, values, options = {}) {
+    return await this.client.database.updateRow.mutate({ rowId, values, ...options });
+  }
+  /** Delete a row — the page and its search chunks. */
+  async deleteRow(rowId) {
+    return await this.client.database.deleteRow.mutate({ rowId });
+  }
+  // ── CSV import ─────────────────────────────────────────────────────────────
+  /**
+   * Type a CSV against the database before anything is created: columns
+   * resolved through `mapping` (or suggested by header name), every row
+   * checked, each cell that does not fit named. Writes nothing.
+   */
+  async previewCsv(databaseId, csv, mapping) {
+    return await this.client.database.previewCsv.mutate({ id: databaseId, csv, ...mapping ? { mapping } : {} });
+  }
+  /**
+   * Import a CSV: new columns become properties, then every row with no
+   * cell error becomes a row with a `create` revision; the rest are reported
+   * and left uncreated. Up to 2,000 rows a time.
+   */
+  async commitCsv(databaseId, csv, mapping, options = {}) {
+    return await this.client.database.commitCsv.mutate({ id: databaseId, csv, mapping, ...options });
+  }
+};
+
 // src/resources.ts
 var ResourcesApi = class {
   constructor(client) {
@@ -1566,6 +1648,7 @@ var ExponentialClient = class {
     this.areas = new AreasApi(this.client);
     this.meetings = new MeetingsApi(this.client);
     this.pages = new PagesApi(this.client);
+    this.databases = new DatabasesApi(this.client);
     this.resources = new ResourcesApi(this.client);
     this.requirements = new RequirementsApi(this.client);
     this.scopes = new ScopesApi(this.client);
@@ -1597,6 +1680,8 @@ var ExponentialClient = class {
   areas;
   meetings;
   pages;
+  /** Databases — typed tables inside pages (ADR-0078). */
+  databases;
   resources;
   requirements;
   scopes;