@slotform/api 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +50 -2
  3. package/dist/client.d.ts +16 -0
  4. package/dist/client.d.ts.map +1 -0
  5. package/dist/client.js +98 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/error.d.ts +2 -0
  8. package/dist/error.d.ts.map +1 -0
  9. package/dist/error.js +2 -0
  10. package/dist/error.js.map +1 -0
  11. package/dist/index.d.ts +153 -0
  12. package/dist/index.d.ts.map +1 -0
  13. package/dist/index.js +640 -0
  14. package/dist/index.js.map +1 -0
  15. package/dist/lib/chosen.d.ts +12 -0
  16. package/dist/lib/chosen.d.ts.map +1 -0
  17. package/dist/lib/chosen.js +18 -0
  18. package/dist/lib/chosen.js.map +1 -0
  19. package/dist/lib/cursor.d.ts +68 -0
  20. package/dist/lib/cursor.d.ts.map +1 -0
  21. package/dist/lib/cursor.js +220 -0
  22. package/dist/lib/cursor.js.map +1 -0
  23. package/dist/lib/limits.d.ts +4 -0
  24. package/dist/lib/limits.d.ts.map +1 -0
  25. package/dist/lib/limits.js +10 -0
  26. package/dist/lib/limits.js.map +1 -0
  27. package/dist/lib/local-origin.d.ts +2 -0
  28. package/dist/lib/local-origin.d.ts.map +1 -0
  29. package/dist/lib/local-origin.js +17 -0
  30. package/dist/lib/local-origin.js.map +1 -0
  31. package/dist/lib/slugify.d.ts +4 -0
  32. package/dist/lib/slugify.d.ts.map +1 -0
  33. package/dist/lib/slugify.js +26 -0
  34. package/dist/lib/slugify.js.map +1 -0
  35. package/dist/lib/window.d.ts +52 -0
  36. package/dist/lib/window.d.ts.map +1 -0
  37. package/dist/lib/window.js +70 -0
  38. package/dist/lib/window.js.map +1 -0
  39. package/dist/mcp-path.d.ts +2 -0
  40. package/dist/mcp-path.d.ts.map +1 -0
  41. package/dist/mcp-path.js +3 -0
  42. package/dist/mcp-path.js.map +1 -0
  43. package/dist/mcp.d.ts +15 -0
  44. package/dist/mcp.d.ts.map +1 -0
  45. package/dist/mcp.js +5 -0
  46. package/dist/mcp.js.map +1 -0
  47. package/dist/node/barrel.d.ts +3 -0
  48. package/dist/node/barrel.d.ts.map +1 -0
  49. package/dist/node/barrel.js +70 -0
  50. package/dist/node/barrel.js.map +1 -0
  51. package/dist/node/codegen.d.ts +10 -0
  52. package/dist/node/codegen.d.ts.map +1 -0
  53. package/dist/node/codegen.js +132 -0
  54. package/dist/node/codegen.js.map +1 -0
  55. package/dist/node/procedure-codegen.d.ts +14 -0
  56. package/dist/node/procedure-codegen.d.ts.map +1 -0
  57. package/dist/node/procedure-codegen.js +95 -0
  58. package/dist/node/procedure-codegen.js.map +1 -0
  59. package/dist/node/schema-child.d.ts +2 -0
  60. package/dist/node/schema-child.d.ts.map +1 -0
  61. package/dist/node/schema-child.js +31 -0
  62. package/dist/node/schema-child.js.map +1 -0
  63. package/dist/node/schema-source.d.ts +3 -0
  64. package/dist/node/schema-source.d.ts.map +1 -0
  65. package/dist/node/schema-source.js +33 -0
  66. package/dist/node/schema-source.js.map +1 -0
  67. package/dist/node/server-client.d.ts +19 -0
  68. package/dist/node/server-client.d.ts.map +1 -0
  69. package/dist/node/server-client.js +45 -0
  70. package/dist/node/server-client.js.map +1 -0
  71. package/dist/node/types.d.ts +42 -0
  72. package/dist/node/types.d.ts.map +1 -0
  73. package/dist/node/types.js +13 -0
  74. package/dist/node/types.js.map +1 -0
  75. package/dist/not-found.d.ts +2 -0
  76. package/dist/not-found.d.ts.map +1 -0
  77. package/dist/not-found.js +6 -0
  78. package/dist/not-found.js.map +1 -0
  79. package/dist/procedure.d.ts +188 -0
  80. package/dist/procedure.d.ts.map +1 -0
  81. package/dist/procedure.js +392 -0
  82. package/dist/procedure.js.map +1 -0
  83. package/dist/query-invalidation.d.ts +20 -0
  84. package/dist/query-invalidation.d.ts.map +1 -0
  85. package/dist/query-invalidation.js +66 -0
  86. package/dist/query-invalidation.js.map +1 -0
  87. package/dist/schema.d.ts +32 -0
  88. package/dist/schema.d.ts.map +1 -0
  89. package/dist/schema.js +103 -0
  90. package/dist/schema.js.map +1 -0
  91. package/dist/types.d.ts +30 -0
  92. package/dist/types.d.ts.map +1 -0
  93. package/dist/types.js +2 -0
  94. package/dist/types.js.map +1 -0
  95. package/dist/wire.d.ts +11 -0
  96. package/dist/wire.d.ts.map +1 -0
  97. package/dist/wire.js +26 -0
  98. package/dist/wire.js.map +1 -0
  99. package/dist/worker/guards.d.ts +6 -0
  100. package/dist/worker/guards.d.ts.map +1 -0
  101. package/dist/worker/guards.js +29 -0
  102. package/dist/worker/guards.js.map +1 -0
  103. package/dist/worker/index.d.ts +57 -0
  104. package/dist/worker/index.d.ts.map +1 -0
  105. package/dist/worker/index.js +418 -0
  106. package/dist/worker/index.js.map +1 -0
  107. package/dist/worker/mcp.d.ts +28 -0
  108. package/dist/worker/mcp.d.ts.map +1 -0
  109. package/dist/worker/mcp.js +361 -0
  110. package/dist/worker/mcp.js.map +1 -0
  111. package/dist/worker/request-log.d.ts +10 -0
  112. package/dist/worker/request-log.d.ts.map +1 -0
  113. package/dist/worker/request-log.js +37 -0
  114. package/dist/worker/request-log.js.map +1 -0
  115. package/guide/add-a-procedure.md +42 -0
  116. package/guide/background.md +86 -0
  117. package/guide/client.md +93 -0
  118. package/guide/config.md +85 -0
  119. package/guide/mcp.md +68 -0
  120. package/guide/middleware.md +79 -0
  121. package/guide/procedures.md +95 -0
  122. package/guide/utilities.md +135 -0
  123. package/package.json +120 -3
  124. package/src/client.ts +129 -0
  125. package/src/error.ts +1 -0
  126. package/src/index.ts +787 -0
  127. package/src/lib/chosen.ts +31 -0
  128. package/src/lib/cursor.ts +354 -0
  129. package/src/lib/limits.ts +10 -0
  130. package/src/lib/local-origin.ts +18 -0
  131. package/src/lib/slugify.ts +29 -0
  132. package/src/lib/window.ts +155 -0
  133. package/src/mcp-path.ts +2 -0
  134. package/src/mcp.ts +30 -0
  135. package/src/node/barrel.ts +77 -0
  136. package/src/node/codegen.ts +173 -0
  137. package/src/node/procedure-codegen.ts +131 -0
  138. package/src/node/schema-child.ts +31 -0
  139. package/src/node/schema-source.ts +45 -0
  140. package/src/node/server-client.ts +67 -0
  141. package/src/node/types.ts +64 -0
  142. package/src/not-found.ts +6 -0
  143. package/src/procedure.ts +935 -0
  144. package/src/query-invalidation.ts +106 -0
  145. package/src/schema.ts +133 -0
  146. package/src/types.ts +72 -0
  147. package/src/wire.ts +34 -0
  148. package/src/worker/guards.ts +37 -0
  149. package/src/worker/index.ts +681 -0
  150. package/src/worker/mcp.ts +470 -0
  151. package/src/worker/request-log.ts +50 -0
@@ -0,0 +1,12 @@
1
+ import { type SQL } from "drizzle-orm";
2
+ import type { SQLiteColumn } from "drizzle-orm/sqlite-core";
3
+ import type { Selector } from "../schema.ts";
4
+ export interface ChosenOptions<Q> {
5
+ /** The table's id column. */
6
+ id: SQLiteColumn;
7
+ /** The where clause of the read's query, the one its list procedure builds from the same input. */
8
+ where: (query: Q) => SQL | undefined;
9
+ }
10
+ /** The rows a selector names, as a where clause: `{ ids }` those rows, `{ query, except }` every row the query matches but the excepted. Each list binds one value, whatever its length. */
11
+ export declare function chosenWhere<Q>(selection: Selector<Q>, options: ChosenOptions<Q>): SQL;
12
+ //# sourceMappingURL=chosen.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chosen.d.ts","sourceRoot":"","sources":["../../src/lib/chosen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAO,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,6BAA6B;IAC7B,EAAE,EAAE,YAAY,CAAC;IACjB,mGAAmG;IACnG,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,GAAG,SAAS,CAAC;CACrC;AAQD,4LAA4L;AAC5L,wBAAgB,WAAW,CAAC,CAAC,EAC5B,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,GAAG,CASL"}
@@ -0,0 +1,18 @@
1
+ import { and, sql } from "drizzle-orm";
2
+ // A D1 statement binds at most 100 values, so a list of ids travels as one
3
+ // JSON value that `json_each` expands.
4
+ function idList(ids) {
5
+ return sql `(select value from json_each(${JSON.stringify(ids)}))`;
6
+ }
7
+ /** The rows a selector names, as a where clause: `{ ids }` those rows, `{ query, except }` every row the query matches but the excepted. Each list binds one value, whatever its length. */
8
+ export function chosenWhere(selection, options) {
9
+ const { id } = options;
10
+ if ("ids" in selection)
11
+ return sql `${id} in ${idList(selection.ids)}`;
12
+ const matching = options.where(selection.query);
13
+ const kept = selection.except.length > 0
14
+ ? sql `${id} not in ${idList(selection.except)}`
15
+ : undefined;
16
+ return and(matching, kept) ?? sql `1 = 1`;
17
+ }
18
+ //# sourceMappingURL=chosen.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chosen.js","sourceRoot":"","sources":["../../src/lib/chosen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,GAAG,EAAE,MAAM,aAAa,CAAC;AAWjD,2EAA2E;AAC3E,uCAAuC;AACvC,SAAS,MAAM,CAAC,GAAsB;IACrC,OAAO,GAAG,CAAA,gCAAgC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;AACnE,CAAC;AAED,4LAA4L;AAC5L,MAAM,UAAU,WAAW,CAC1B,SAAsB,EACtB,OAAyB;IAEzB,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvB,IAAI,KAAK,IAAI,SAAS;QAAE,OAAO,GAAG,CAAA,GAAG,EAAE,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,IAAI,GACT,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAC1B,CAAC,CAAC,GAAG,CAAA,GAAG,EAAE,WAAW,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;QAC/C,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,GAAG,CAAA,OAAO,CAAC;AAC1C,CAAC"}
@@ -0,0 +1,68 @@
1
+ import { type SQL } from "drizzle-orm";
2
+ import type { SQLiteColumn } from "drizzle-orm/sqlite-core";
3
+ export { DEFAULT_LIMIT, LIMIT_CEILING } from "./limits.ts";
4
+ export type Direction = "asc" | "desc";
5
+ /** One column a page orders by. */
6
+ export interface Order {
7
+ column: SQLiteColumn;
8
+ direction: Direction;
9
+ }
10
+ /** The `sort` a procedure declaring `sort: [...keys]` takes: a key of the procedure's `sorts` (else a column key of the table) and the way round. */
11
+ export interface SortInput<K extends string = string> {
12
+ column: K;
13
+ direction: Direction;
14
+ }
15
+ /** What a sort key orders by: a column, or for a window an SQL expression (`sql\`${tasks.title} collate nocase\``, `bm25(...)`). */
16
+ export type Orderable = SQLiteColumn | SQL;
17
+ /** The sort key to ordering map a procedure names, for a key that is not a column of the table or orders by an expression. */
18
+ export type Sorts<K extends string = string, V = SQLiteColumn> = Record<K, V>;
19
+ type CursorValue = string | number | boolean | Date | null;
20
+ /** A cursor for the row after which the next page continues: the order columns' values, in order, then the row's id. */
21
+ export declare function encodeCursor(values: readonly CursorValue[], id: string): string;
22
+ export declare function decodeCursor(cursor: string): {
23
+ values: CursorValue[];
24
+ id: string;
25
+ };
26
+ /** A limit within 1 and `LIMIT_CEILING` (the procedure's own `maxLimit` already bounded what it took), defaulting to `DEFAULT_LIMIT`. */
27
+ export declare function clampLimit(limit: number | undefined): number;
28
+ /** Drizzle's relational `columns`, narrowed to exclusion so `id` stays; the order columns stay too, whatever it names. */
29
+ export type ExcludedColumns<T> = {
30
+ [K in Exclude<keyof T, "id">]?: false;
31
+ };
32
+ export interface PageOptions<C = object, K extends string = string> {
33
+ where?: SQL;
34
+ limit?: number;
35
+ /** The default order: one column, or several in precedence. `id` follows in the first one's direction. */
36
+ orderBy: Order | readonly Order[];
37
+ /** The caller's order, a procedure's `input.sort`: it replaces `orderBy` with the ordering `sorts` maps its key to (else the column of `idColumn`'s table it names), so a Table's header sort reaches the query. */
38
+ sort?: SortInput<K> | undefined;
39
+ /** The ordering each sort key stands for, where a key is not a column's name. */
40
+ sorts?: Partial<Sorts<K>>;
41
+ idColumn: SQLiteColumn;
42
+ columns?: C;
43
+ }
44
+ export interface PaginateOptions<C = object, K extends string = string> extends PageOptions<C, K> {
45
+ cursor?: string;
46
+ }
47
+ export interface PaginatedResult<T> {
48
+ data: T[];
49
+ nextCursor: string | null;
50
+ }
51
+ export declare function sortOf(key: string, sorts: Readonly<Partial<Record<string, Orderable>>> | undefined, idColumn: SQLiteColumn): Orderable | undefined;
52
+ interface QueryBuilder<T, C> {
53
+ findMany(config: {
54
+ columns?: C;
55
+ where?: SQL;
56
+ limit?: number;
57
+ offset?: number;
58
+ orderBy?: SQL[];
59
+ }): Promise<T[]>;
60
+ }
61
+ export declare function orderSql(orders: readonly {
62
+ column: Orderable;
63
+ direction: Direction;
64
+ }[], idColumn: SQLiteColumn): SQL[];
65
+ export declare function paginate<T extends {
66
+ id: string;
67
+ }, const C extends ExcludedColumns<T> = object, K extends string = string>(queryBuilder: QueryBuilder<T, NoInfer<C>>, options: PaginateOptions<C, K>): Promise<PaginatedResult<Omit<T, keyof C>>>;
68
+ //# sourceMappingURL=cursor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/lib/cursor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,220 @@
1
+ import { and, asc, Column, desc, eq, getTableColumns, gt, gte, is, isNull, lt, lte, or, sql, } from "drizzle-orm";
2
+ import { ApiError } from "../error.js";
3
+ import { DEFAULT_LIMIT, LIMIT_CEILING } from "./limits.js";
4
+ export { DEFAULT_LIMIT, LIMIT_CEILING } from "./limits.js";
5
+ // A moment travels as `{ $date }`: the cursor is JSON, which has no date, and
6
+ // the page that decodes it has no column type to say a number is one.
7
+ function toWire(value) {
8
+ return value instanceof Date ? { $date: value.getTime() } : value;
9
+ }
10
+ function fromWire(value) {
11
+ if (typeof value === "object" && value !== null && "$date" in value) {
12
+ const at = value.$date;
13
+ if (typeof at !== "number")
14
+ return undefined;
15
+ const date = new Date(at);
16
+ return Number.isNaN(date.getTime()) ? undefined : date;
17
+ }
18
+ return value === null ||
19
+ typeof value === "string" ||
20
+ typeof value === "number" ||
21
+ typeof value === "boolean"
22
+ ? value
23
+ : undefined;
24
+ }
25
+ // Base64 of the JSON's UTF-8 bytes: a title is not Latin-1, which `btoa` takes.
26
+ function toBase64(text) {
27
+ let binary = "";
28
+ for (const byte of new TextEncoder().encode(text)) {
29
+ binary += String.fromCharCode(byte);
30
+ }
31
+ return btoa(binary);
32
+ }
33
+ function fromBase64(encoded) {
34
+ const binary = atob(encoded);
35
+ return new TextDecoder("utf-8", { fatal: true }).decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
36
+ }
37
+ /** A cursor for the row after which the next page continues: the order columns' values, in order, then the row's id. */
38
+ export function encodeCursor(values, id) {
39
+ return toBase64(JSON.stringify([values.map(toWire), id]));
40
+ }
41
+ export function decodeCursor(cursor) {
42
+ const malformed = () => new ApiError("BAD_REQUEST", { message: "Invalid cursor" });
43
+ let parsed;
44
+ try {
45
+ parsed = JSON.parse(fromBase64(cursor));
46
+ }
47
+ catch {
48
+ throw malformed();
49
+ }
50
+ if (!Array.isArray(parsed) || parsed.length !== 2)
51
+ throw malformed();
52
+ const [wire, id] = parsed;
53
+ if (!Array.isArray(wire) || typeof id !== "string" || !id)
54
+ throw malformed();
55
+ const values = wire.map(fromWire);
56
+ if (values.some((value) => value === undefined))
57
+ throw malformed();
58
+ return { values: values, id };
59
+ }
60
+ /** A limit within 1 and `LIMIT_CEILING` (the procedure's own `maxLimit` already bounded what it took), defaulting to `DEFAULT_LIMIT`. */
61
+ export function clampLimit(limit) {
62
+ return Math.max(1, Math.min(limit ?? DEFAULT_LIMIT, LIMIT_CEILING));
63
+ }
64
+ // An unknown sort column answers BAD_REQUEST (a procedure that declares `sort`
65
+ // already refuses it at the schema).
66
+ function orderOf(options) {
67
+ const { sort, idColumn } = options;
68
+ if (sort) {
69
+ const found = sortOf(sort.column, options.sorts, idColumn);
70
+ if (!found || !isColumn(found)) {
71
+ throw new ApiError("BAD_REQUEST", {
72
+ message: `Cannot sort by ${sort.column}`,
73
+ });
74
+ }
75
+ return [{ column: found, direction: sort.direction }];
76
+ }
77
+ return Array.isArray(options.orderBy)
78
+ ? [...options.orderBy]
79
+ : [options.orderBy];
80
+ }
81
+ // What a sort key orders by: its entry in `sorts`, else the table's column of
82
+ // that name. Own keys only, so `constructor` is not a column.
83
+ export function sortOf(key, sorts, idColumn) {
84
+ if (sorts !== undefined && Object.hasOwn(sorts, key))
85
+ return sorts[key];
86
+ const columns = getTableColumns(idColumn.table);
87
+ return Object.hasOwn(columns, key) ? columns[key] : undefined;
88
+ }
89
+ function isColumn(value) {
90
+ return is(value, Column);
91
+ }
92
+ function keysOf(orders, idColumn) {
93
+ const columns = Object.entries(getTableColumns(idColumn.table));
94
+ return orders.map(({ column }) => {
95
+ const found = columns.find(([, each]) => each === column);
96
+ if (!found) {
97
+ throw new Error(`paginate: the order column ${column.name} is not a column of the table ${idColumn.table}`);
98
+ }
99
+ return found[0];
100
+ });
101
+ }
102
+ // What a cursor value of each column data type is: a value of another type
103
+ // would reach the driver, which refuses to bind it. A type not listed here is
104
+ // not judged.
105
+ const FITS = {
106
+ string: (value) => typeof value === "string",
107
+ number: (value) => typeof value === "number",
108
+ boolean: (value) => typeof value === "boolean",
109
+ date: (value) => value instanceof Date,
110
+ };
111
+ function fits(column, value) {
112
+ return value === null || (FITS[column.dataType]?.(value) ?? true);
113
+ }
114
+ // The rows strictly after the cursor's, in order, as keyset segments read one
115
+ // after another. Within a segment, for columns c1..cn and id, (c1 > v1) or
116
+ // (c1 = v1 and c2 > v2) or ... or (all equal and id > vid), each `>` a `<` in a
117
+ // descending column; the id follows the first column's way. Nulls sort last,
118
+ // so nothing is past a null value, which compares by `is null`. A nullable
119
+ // column holding a value closes the segment: the rows of the same prefix with a
120
+ // null there follow as a segment of their own, then the shallower branches.
121
+ // One statement with an `or c is null` term loses the index order, and SQLite
122
+ // sorts the scope.
123
+ function segments(orders, idColumn, cursor) {
124
+ if (cursor.values.length !== orders.length ||
125
+ orders.some((order, at) => !fits(order.column, cursor.values[at] ?? null))) {
126
+ throw new ApiError("BAD_REQUEST", { message: "Invalid cursor" });
127
+ }
128
+ const steps = [
129
+ ...orders.map((order, at) => ({
130
+ column: order.column,
131
+ direction: order.direction,
132
+ value: cursor.values[at],
133
+ })),
134
+ {
135
+ column: idColumn,
136
+ direction: orders[0]?.direction ?? "asc",
137
+ value: cursor.id,
138
+ },
139
+ ];
140
+ // Each step's column is of some type the value must match; `SQLiteColumn`
141
+ // does not carry it, so the comparison takes the value as `never`.
142
+ const equal = steps.map((step) => step.value === null
143
+ ? isNull(step.column)
144
+ : eq(step.column, step.value));
145
+ const found = [];
146
+ let branches = [];
147
+ // The segment's shallowest column bounded by its value, which every branch
148
+ // implies: SQLite takes no range from the `or` alone and walks the scope.
149
+ let bound;
150
+ // `and` and `or` answer `undefined` only for no conditions; each here has one.
151
+ for (const [at, step] of [...steps.entries()].reverse()) {
152
+ if (step.value === null)
153
+ continue;
154
+ const [past, from] = step.direction === "desc" ? [lt, lte] : [gt, gte];
155
+ branches.unshift(and(...equal.slice(0, at), past(step.column, step.value)));
156
+ bound = from(step.column, step.value);
157
+ if (step.column.notNull)
158
+ continue;
159
+ found.push(and(bound, or(...branches)), and(...equal.slice(0, at), isNull(step.column)));
160
+ branches = [];
161
+ }
162
+ if (branches.length > 0)
163
+ found.push(and(bound, or(...branches)));
164
+ return found;
165
+ }
166
+ // Drizzle's `columns` with the order columns and the id put back, which the
167
+ // cursor reads off the last row.
168
+ function withKept(columns, keys) {
169
+ if (!columns)
170
+ return undefined;
171
+ const kept = { ...columns };
172
+ for (const key of [...keys, "id"])
173
+ delete kept[key];
174
+ return kept;
175
+ }
176
+ export function orderSql(orders, idColumn) {
177
+ const direction = orders[0]?.direction ?? "asc";
178
+ const by = direction === "desc" ? desc : asc;
179
+ // The id, a primary key, is never null; `nulls last` on it as a later term
180
+ // makes SQLite 3.54 sort an ascending page in a temp B-tree.
181
+ return [
182
+ ...orders.map((order) => sql `${order.direction === "desc" ? desc(order.column) : asc(order.column)} nulls last`),
183
+ by(idColumn),
184
+ ];
185
+ }
186
+ export async function paginate(queryBuilder, options) {
187
+ const limit = clampLimit(options.limit);
188
+ const { idColumn } = options;
189
+ const orders = orderOf(options);
190
+ const keys = keysOf(orders, idColumn);
191
+ // The first page is one statement: the whole order, nulls last.
192
+ const reads = options.cursor
193
+ ? segments(orders, idColumn, decodeCursor(options.cursor))
194
+ : [undefined];
195
+ const columns = withKept(options.columns, keys);
196
+ const orderBy = orderSql(orders, idColumn);
197
+ const rows = [];
198
+ for (const segment of reads) {
199
+ if (rows.length > limit)
200
+ break;
201
+ rows.push(...(await queryBuilder.findMany({
202
+ ...(columns ? { columns } : {}),
203
+ where: and(options.where, segment),
204
+ limit: limit + 1 - rows.length,
205
+ orderBy,
206
+ })));
207
+ }
208
+ const hasMore = rows.length > limit;
209
+ const data = hasMore ? rows.slice(0, -1) : rows;
210
+ const lastItem = data[data.length - 1];
211
+ return {
212
+ data: data,
213
+ nextCursor: hasMore && lastItem
214
+ ? encodeCursor(
215
+ // `withKept` keeps the order columns, which hold a cursor value.
216
+ keys.map((key) => lastItem[key]), lastItem.id)
217
+ : null,
218
+ };
219
+ }
220
+ //# sourceMappingURL=cursor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/lib/cursor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export declare const DEFAULT_LIMIT = 20;
2
+ export declare const LIMIT_CEILING = 10000;
3
+ export declare const MAX_LIMIT = 100;
4
+ //# sourceMappingURL=limits.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/lib/limits.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,KAAK,CAAC;AAGhC,eAAO,MAAM,aAAa,QAAS,CAAC;AAEpC,eAAO,MAAM,SAAS,MAAM,CAAC"}
@@ -0,0 +1,10 @@
1
+ // A page's size bounds, import-free so the procedure factory reads them
2
+ // without the pagination helpers' drizzle import.
3
+ // The rows a page holds unless the caller names a `limit`.
4
+ export const DEFAULT_LIMIT = 20;
5
+ // What no procedure may name as its `maxLimit`: a page this large is a table
6
+ // scan the client asked for by mistake.
7
+ export const LIMIT_CEILING = 10_000;
8
+ // What a paginated procedure accepts unless it names its own `maxLimit`.
9
+ export const MAX_LIMIT = 100;
10
+ //# sourceMappingURL=limits.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/lib/limits.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,kDAAkD;AAElD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,6EAA6E;AAC7E,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,yEAAyE;AACzE,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function isLocalOrigin(origin: string): boolean;
2
+ //# sourceMappingURL=local-origin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-origin.d.ts","sourceRoot":"","sources":["../../src/lib/local-origin.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAcrD"}
@@ -0,0 +1,17 @@
1
+ // Local-dev hostnames: docs/architecture/plugins/api.md, "Local and dev origins".
2
+ const LOCAL_HOSTNAMES = new Set(["localhost", "127.0.0.1", "[::1]", "0.0.0.0"]);
3
+ export function isLocalOrigin(origin) {
4
+ try {
5
+ const { hostname } = new URL(origin);
6
+ // `*.localhost` is reserved (RFC 6761); `*.localdomain` is common in
7
+ // Linux /etc/hosts.
8
+ return (LOCAL_HOSTNAMES.has(hostname) ||
9
+ hostname.endsWith(".localhost") ||
10
+ hostname.endsWith(".localdomain"));
11
+ }
12
+ catch {
13
+ // A string `URL` cannot parse is not a local origin.
14
+ return false;
15
+ }
16
+ }
17
+ //# sourceMappingURL=local-origin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-origin.js","sourceRoot":"","sources":["../../src/lib/local-origin.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAEhF,MAAM,UAAU,aAAa,CAAC,MAAc;IAC3C,IAAI,CAAC;QACJ,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,qEAAqE;QACrE,oBAAoB;QACpB,OAAO,CACN,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC7B,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC/B,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CACjC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,qDAAqD;QACrD,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ export declare const RESERVED_SLUGS: readonly ["admin", "api", "system", "auth", "new", "settings"];
2
+ export declare function slugify(text: string): string;
3
+ export declare function isReservedSlug(slug: string): boolean;
4
+ //# sourceMappingURL=slugify.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/lib/slugify.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,YAC1B,OAAO,EACP,KAAK,EACL,QAAQ,EACR,MAAM,EACN,KAAK,EACL,UAAU,CACD,CAAC;AAQX,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD"}
@@ -0,0 +1,26 @@
1
+ import slugifyPkg from "slugify";
2
+ // Reserved slugs: docs/architecture/plugins/auth.md, "Reserved slugs".
3
+ export const RESERVED_SLUGS = [
4
+ "admin",
5
+ "api",
6
+ "system",
7
+ "auth",
8
+ "new",
9
+ "settings",
10
+ ];
11
+ const reserved = new Set(RESERVED_SLUGS);
12
+ // `slugify` turns text into a URL segment and never refuses; `isReservedSlug`
13
+ // answers whether a slug is taken by the app's own routes, so a procedure
14
+ // names the refusal as its own field error. A dot is a word boundary, so a
15
+ // domain reads as its words.
16
+ export function slugify(text) {
17
+ return slugifyPkg(text.replaceAll(".", " "), {
18
+ lower: true,
19
+ strict: true,
20
+ trim: true,
21
+ });
22
+ }
23
+ export function isReservedSlug(slug) {
24
+ return reserved.has(slug);
25
+ }
26
+ //# sourceMappingURL=slugify.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../src/lib/slugify.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,SAAS,CAAC;AAEjC,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,OAAO;IACP,KAAK;IACL,QAAQ;IACR,MAAM;IACN,KAAK;IACL,UAAU;CACD,CAAC;AAEX,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;AAEjD,8EAA8E;AAC9E,0EAA0E;AAC1E,2EAA2E;AAC3E,6BAA6B;AAC7B,MAAM,UAAU,OAAO,CAAC,IAAY;IACnC,OAAO,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE;QAC5C,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,IAAI;KACV,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}
@@ -0,0 +1,52 @@
1
+ import { type SQL } from "drizzle-orm";
2
+ import type { BaseSQLiteDatabase, SQLiteColumn, SQLiteSelect } from "drizzle-orm/sqlite-core";
3
+ import { type Direction, type ExcludedColumns, type Orderable, type SortInput } from "./cursor.ts";
4
+ /** One thing a window orders by: a column or an SQL expression, and the way round. */
5
+ export interface WindowOrder {
6
+ column: Orderable;
7
+ direction: Direction;
8
+ }
9
+ export interface WindowOptions<C = object, K extends string = string> {
10
+ where?: SQL;
11
+ limit?: number;
12
+ /** The default order: one column or expression, or several in precedence. `id` follows in the first one's direction. */
13
+ orderBy: WindowOrder | readonly WindowOrder[];
14
+ /** The caller's order, a procedure's `input.sort`: it replaces `orderBy` with what `sorts` maps its key to, so a Table's header sort reaches the query. */
15
+ sort?: SortInput<K> | undefined;
16
+ /** What each sort key orders by: a column, or an expression (`sql\`${tasks.title} collate nocase\``). A key not named here sorts by the column of `idColumn`'s table of that name. */
17
+ sorts?: Partial<Record<K, Orderable>>;
18
+ idColumn: SQLiteColumn;
19
+ columns?: C;
20
+ /** The page's first row, a procedure's `input.offset`. */
21
+ offset?: number;
22
+ /** The database: `context.db`. */
23
+ db: BaseSQLiteDatabase<"sync" | "async", unknown, // biome-ignore lint/suspicious/noExplicitAny: the schema is the consumer's
24
+ any>;
25
+ /** Joins the query selects the ids and the count from (it starts at `idColumn`'s table), so `where` and the order may name a joined table: `(query) => query.innerJoin(taskSearch, eq(taskSearch.rowid, tasks.seq))`. */
26
+ join?: (query: SQLiteSelect) => SQLiteSelect;
27
+ }
28
+ export interface WindowResult<T> {
29
+ data: T[];
30
+ /** Every row the filter matches: the scroller's length. */
31
+ total: number;
32
+ offset: number;
33
+ }
34
+ interface QueryBuilder<T, C> {
35
+ findMany(config: {
36
+ columns?: C;
37
+ where?: SQL;
38
+ limit?: number;
39
+ offset?: number;
40
+ orderBy?: SQL[];
41
+ }): Promise<T[]>;
42
+ }
43
+ /**
44
+ * The answer of a `paginated: "window"` procedure: one page at `offset` and the filter's total, both from the one `where`, in the order `orderBy` (or the caller's `sort`) gives, then `id`.
45
+ *
46
+ * The order is decided on the ids alone (a sorter that holds a key and an id, not every column of a wide row), then the page's rows are read by id: the cost of a deep offset stays a narrow sort. The first page of a query with no `join` is read in one statement, since a top-N sort is cheap.
47
+ */
48
+ export declare function paginateWindow<T extends {
49
+ id: string;
50
+ }, const C extends ExcludedColumns<T> = object, K extends string = string>(queryBuilder: QueryBuilder<T, NoInfer<C>>, options: WindowOptions<C, K>): Promise<WindowResult<Omit<T, keyof C>>>;
51
+ export {};
52
+ //# sourceMappingURL=window.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../src/lib/window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,GAAG,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EACX,kBAAkB,EAClB,YAAY,EACZ,YAAY,EAEZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAEN,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,SAAS,EAEd,KAAK,SAAS,EAEd,MAAM,aAAa,CAAC;AAErB,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IACnE,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wHAAwH;IACxH,OAAO,EAAE,WAAW,GAAG,SAAS,WAAW,EAAE,CAAC;IAC9C,2JAA2J;IAC3J,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAChC,sLAAsL;IACtL,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACtC,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,EAAE,EAAE,kBAAkB,CACrB,MAAM,GAAG,OAAO,EAChB,OAAO,EAAE,2EAA2E;IACpF,GAAG,CACH,CAAC;IACF,yNAAyN;IACzN,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,UAAU,YAAY,CAAC,CAAC,EAAE,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE;QAChB,OAAO,CAAC,EAAE,CAAC,CAAC;QACZ,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;KAChB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACjB;AAsBD;;;;GAIG;AACH,wBAAsB,cAAc,CACnC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACxB,KAAK,CAAC,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,EAC3C,CAAC,SAAS,MAAM,GAAG,MAAM,EAEzB,YAAY,EAAE,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EACzC,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAC1B,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CA0DzC"}
@@ -0,0 +1,70 @@
1
+ import { count, inArray } from "drizzle-orm";
2
+ import { ApiError } from "../error.js";
3
+ import { clampLimit, orderSql, sortOf, } from "./cursor.js";
4
+ const BATCH = 90;
5
+ function orders(options) {
6
+ const { sort, idColumn } = options;
7
+ if (sort) {
8
+ const found = sortOf(sort.column, options.sorts, idColumn);
9
+ if (!found) {
10
+ throw new ApiError("BAD_REQUEST", {
11
+ message: `Cannot sort by ${sort.column}`,
12
+ });
13
+ }
14
+ return [{ column: found, direction: sort.direction }];
15
+ }
16
+ return Array.isArray(options.orderBy)
17
+ ? [...options.orderBy]
18
+ : [options.orderBy];
19
+ }
20
+ /**
21
+ * The answer of a `paginated: "window"` procedure: one page at `offset` and the filter's total, both from the one `where`, in the order `orderBy` (or the caller's `sort`) gives, then `id`.
22
+ *
23
+ * The order is decided on the ids alone (a sorter that holds a key and an id, not every column of a wide row), then the page's rows are read by id: the cost of a deep offset stays a narrow sort. The first page of a query with no `join` is read in one statement, since a top-N sort is cheap.
24
+ */
25
+ export async function paginateWindow(queryBuilder, options) {
26
+ const limit = clampLimit(options.limit);
27
+ const offset = Math.max(0, Math.trunc(options.offset ?? 0));
28
+ const { idColumn, where, db, join } = options;
29
+ const table = idColumn.table;
30
+ const orderBy = orderSql(orders(options), idColumn);
31
+ const columns = options.columns ? { columns: options.columns } : {};
32
+ // A fresh query over the one source: the ids and the count must agree.
33
+ const source = (fields) => {
34
+ const query = db.select(fields).from(table).$dynamic();
35
+ return (join ? join(query) : query).where(where);
36
+ };
37
+ const total = async () => {
38
+ const [row] = (await source({ n: count() }));
39
+ return row?.n ?? 0;
40
+ };
41
+ if (offset === 0 && !join) {
42
+ const [data, n] = await Promise.all([
43
+ queryBuilder.findMany({ ...columns, where, limit, orderBy }),
44
+ total(),
45
+ ]);
46
+ return { data: data, total: n, offset };
47
+ }
48
+ const [ids, n] = await Promise.all([
49
+ (async () => (await source({ id: idColumn })
50
+ .orderBy(...orderBy)
51
+ .limit(limit)
52
+ .offset(offset)).map((row) => row.id))(),
53
+ total(),
54
+ ]);
55
+ if (ids.length === 0)
56
+ return { data: [], total: n, offset };
57
+ // A D1 statement binds at most 100 values: a long page is read in batches.
58
+ const batches = [];
59
+ for (let at = 0; at < ids.length; at += BATCH) {
60
+ batches.push(ids.slice(at, at + BATCH));
61
+ }
62
+ const rows = (await Promise.all(batches.map((batch) => queryBuilder.findMany({ ...columns, where: inArray(idColumn, batch) })))).flat();
63
+ const byId = new Map(rows.map((row) => [row.id, row]));
64
+ const data = ids.flatMap((id) => {
65
+ const row = byId.get(id);
66
+ return row ? [row] : [];
67
+ });
68
+ return { data: data, total: n, offset };
69
+ }
70
+ //# sourceMappingURL=window.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"window.js","sourceRoot":"","sources":["../../src/lib/window.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare const MCP_PATH = "/mcp";
2
+ //# sourceMappingURL=mcp-path.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-path.d.ts","sourceRoot":"","sources":["../src/mcp-path.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,QAAQ,SAAS,CAAC"}
@@ -0,0 +1,3 @@
1
+ // The path the MCP endpoint answers at, beside the RPC prefix: docs/architecture/plugins/api.md, "MCP".
2
+ export const MCP_PATH = "/mcp";
3
+ //# sourceMappingURL=mcp-path.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-path.js","sourceRoot":"","sources":["../src/mcp-path.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC"}
package/dist/mcp.d.ts ADDED
@@ -0,0 +1,15 @@
1
+ import type { Procedure } from "./types.ts";
2
+ export type ProcedurePath<TRoutes, TPrefix extends string = ""> = {
3
+ [K in keyof TRoutes & string]: TRoutes[K] extends Procedure<infer _TInput, infer _TOutput> ? `${TPrefix}${K}` : TRoutes[K] extends Record<string, unknown> ? ProcedurePath<TRoutes[K], `${TPrefix}${K}.`> : never;
4
+ }[keyof TRoutes & string];
5
+ export interface McpDefinition {
6
+ instructions: string;
7
+ tools: Partial<Record<string, string>>;
8
+ }
9
+ export declare function defineMcp<TRoutes>(definition: {
10
+ instructions: string;
11
+ tools: {
12
+ [K in ProcedurePath<TRoutes>]?: string;
13
+ };
14
+ }): McpDefinition;
15
+ //# sourceMappingURL=mcp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,MAAM,MAAM,aAAa,CAAC,OAAO,EAAE,OAAO,SAAS,MAAM,GAAG,EAAE,IAAI;KAChE,CAAC,IAAI,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,SAAS,CAC1D,MAAM,OAAO,EACb,MAAM,QAAQ,CACd,GACE,GAAG,OAAO,GAAG,CAAC,EAAE,GAChB,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,GAC5C,KAAK;CACT,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC;AAE1B,MAAM,WAAW,aAAa;IAG7B,YAAY,EAAE,MAAM,CAAC;IAErB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvC;AAGD,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;SAAG,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM;KAAE,CAAC;CAClD,GAAG,aAAa,CAEhB"}
package/dist/mcp.js ADDED
@@ -0,0 +1,5 @@
1
+ // `defineMcp`: docs/architecture/plugins/api.md, "MCP".
2
+ export function defineMcp(definition) {
3
+ return definition;
4
+ }
5
+ //# sourceMappingURL=mcp.js.map