datanotes 3.4.0 → 3.4.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.
@@ -19,6 +19,7 @@
19
19
  | 200 | Done. | `object` (application/json) |
20
20
  | 400 | Bad input: the body is not a JSON object, or an argument is unknown, missing or of the wrong type. | `Error` (application/json) |
21
21
  | 401 | Missing or wrong bearer token. | `Error` (application/json) |
22
+ | 403 | The `session` belongs to another named token: the first token to report a session owns it (compared on its first 16 characters), and only that token and the owner may report it again. Nothing is stored. | `Error` (application/json) |
22
23
  | 500 | Unexpected error. | `Error` (application/json) |
23
24
 
24
25
  The schemas named here are in [openapi.json](https://datanotes.dev/openapi.json) (`components.schemas`).
@@ -32,6 +32,7 @@
32
32
  | 200 | Done. | `object` (application/json) |
33
33
  | 400 | Bad input: the body is not a JSON object, or an argument is unknown, missing or of the wrong type. | `Error` (application/json) |
34
34
  | 401 | Missing or wrong bearer token. | `Error` (application/json) |
35
+ | 403 | The `session` belongs to another named token: the first token to report a session owns it (compared on its first 16 characters), and only that token and the owner may report it again. Nothing is stored. | `Error` (application/json) |
35
36
  | 500 | Unexpected error. | `Error` (application/json) |
36
37
 
37
38
  The schemas named here are in [openapi.json](https://datanotes.dev/openapi.json) (`components.schemas`).
package/dist/docs/api.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Datanotes HTTP API
2
2
 
3
- > OpenAPI 3.1.0 description of the Datanotes 3.4.0 HTTP API: https://datanotes.dev/openapi.json
3
+ > OpenAPI 3.1.0 description of the Datanotes 3.4.1 HTTP API: https://datanotes.dev/openapi.json
4
4
 
5
5
  Database of Markdown notes: tables of notes, rows, queries, history, a change feed and the vault's notes.
6
6
 
@@ -29,7 +29,7 @@ Answer:
29
29
  "commits": [
30
30
  { "table": "diary.classics.film", "version": 8, "operation": "ADD CONSTRAINT" }
31
31
  ],
32
- "migration_id": "20261024T063921-add_constraint-add-constraint-rated_when_watc"
32
+ "migration_id": "20261024T081203-add_constraint-add-constraint-rated_when_watc"
33
33
  }
34
34
  ```
35
35
 
@@ -86,7 +86,7 @@ Answer:
86
86
  "files_created": 1,
87
87
  "planned_creates": ["datanotes/diary/classics/film/His Girl Friday.md"],
88
88
  "commits": [{ "table": "diary.classics.film", "version": 10, "operation": "WRITE" }],
89
- "migration_id": "20261024T063921-insert_row-insert-into-film"
89
+ "migration_id": "20261024T081203-insert_row-insert-into-film-2"
90
90
  }
91
91
  ```
92
92
 
@@ -108,7 +108,7 @@ Answer:
108
108
  "commits": [
109
109
  { "table": "diary.classics.film", "version": 11, "operation": "DROP CONSTRAINT" }
110
110
  ],
111
- "migration_id": "20261024T063921-drop_constraint-drop-constraint-at_most_three_"
111
+ "migration_id": "20261024T081203-drop_constraint-drop-constraint-at_most_three_"
112
112
  }
113
113
  ```
114
114
 
@@ -149,7 +149,7 @@ Answer:
149
149
  "commits": [
150
150
  { "table": "main.public.genre", "version": 4, "operation": "ADD CONSTRAINT" }
151
151
  ],
152
- "migration_id": "20261024T063906-add_constraint-add-constraint-parent_by_level"
152
+ "migration_id": "20261024T081149-add_constraint-add-constraint-parent_by_level"
153
153
  }
154
154
  ```
155
155
 
@@ -228,34 +228,34 @@ Answer:
228
228
  "ok": true,
229
229
  "op": "batch",
230
230
  "dry_run": false,
231
- "migration_id": "20261024T063906-batch-add-the-silent-era-and-slapsti",
231
+ "migration_id": "20261024T081149-batch-add-the-silent-era-and-slapsti",
232
232
  "steps": [
233
233
  {
234
234
  "index": 0,
235
235
  "op": "insert_row",
236
236
  "ok": true,
237
- "migration_id": "20261024T063906-insert_row-insert-into-genre",
237
+ "migration_id": "20261024T081149-insert_row-insert-into-genre-4",
238
238
  "result": {
239
239
  "ok": true,
240
240
  "op": "insert_row",
241
241
  "files_created": 1,
242
242
  "planned_creates": ["datanotes/main/public/genre/Silent cinema.md"],
243
243
  "commits": [{ "table": "main.public.genre", "version": 5, "operation": "WRITE" }],
244
- "migration_id": "20261024T063906-insert_row-insert-into-genre"
244
+ "migration_id": "20261024T081149-insert_row-insert-into-genre-4"
245
245
  }
246
246
  },
247
247
  {
248
248
  "index": 1,
249
249
  "op": "insert_row",
250
250
  "ok": true,
251
- "migration_id": "20261024T063906-insert_row-insert-into-genre-2",
251
+ "migration_id": "20261024T081149-insert_row-insert-into-genre-5",
252
252
  "result": {
253
253
  "ok": true,
254
254
  "op": "insert_row",
255
255
  "files_created": 1,
256
256
  "planned_creates": ["datanotes/main/public/genre/Slapstick comedy.md"],
257
257
  "commits": [{ "table": "main.public.genre", "version": 6, "operation": "WRITE" }],
258
- "migration_id": "20261024T063906-insert_row-insert-into-genre-2"
258
+ "migration_id": "20261024T081149-insert_row-insert-into-genre-5"
259
259
  }
260
260
  }
261
261
  ]
@@ -343,7 +343,7 @@ Answer:
343
343
  }
344
344
  ],
345
345
  "commits": [{ "table": "main.public.genre", "version": 7, "operation": "UPDATE" }],
346
- "migration_id": "20261024T063906-update_row-update-genre"
346
+ "migration_id": "20261024T081149-update_row-update-genre"
347
347
  }
348
348
  ```
349
349
 
@@ -35,7 +35,7 @@ You edit `datanotes/main/public/genre/Silent film.md` by hand, outside the engin
35
35
  ```markdown
36
36
  ---
37
37
  table: main.public.genre
38
- id: 01a16ca2-6b55-78e6-a355-a9890248c59d
38
+ id: 01a16cf7-4fdb-728b-a68f-7e167b3b5a58
39
39
  name: Silent film
40
40
  kind: cinema
41
41
  parent: "[[Cinema]]"
@@ -152,7 +152,7 @@ Answer:
152
152
  }
153
153
  ],
154
154
  "commits": [{ "table": "main.public.genre", "version": 9, "operation": "UPDATE" }],
155
- "migration_id": "20261024T063907-update_row-update-genre"
155
+ "migration_id": "20261024T081151-update_row-update-genre"
156
156
  }
157
157
  ```
158
158
 
@@ -167,7 +167,7 @@ You edit `datanotes/main/public/watch/2026-10-03T2130.md` by hand, outside the e
167
167
  ```markdown
168
168
  ---
169
169
  table: main.public.watch
170
- id: 01a16ca2-6327-778b-85f9-d586c0c733a8
170
+ id: 01a16cf7-481b-7d97-bd70-f521486d2c67
171
171
  film: His Girl Friday
172
172
  occurred_at: 2026-10-03T21:30
173
173
  where: cinema
@@ -226,7 +226,7 @@ Answer:
226
226
  }
227
227
  ],
228
228
  "commits": [{ "table": "main.public.watch", "version": 3, "operation": "RECOMPUTE" }],
229
- "migration_id": "20261024T063905-recompute_columns-recompute-id-day-label-of-watc"
229
+ "migration_id": "20261024T081149-recompute_columns-recompute-id-day-label-of-watc"
230
230
  }
231
231
  ```
232
232
 
@@ -292,7 +292,7 @@ Answer:
292
292
  ```markdown
293
293
  ---
294
294
  table: main.public.watch
295
- id: 01a16ca2-ca05-74ee-97ba-2dcfcbb41703
295
+ id: 01a16cf7-adee-720a-ad18-7e59d48b411b
296
296
  occurred_at: 2026-09-25T21:00
297
297
  film: "[[Charade]]"
298
298
  where: home
@@ -311,7 +311,7 @@ You edit `datanotes/main/public/film/Metropolis.md` by hand, outside the engine.
311
311
  ```markdown
312
312
  ---
313
313
  table: main.public.film
314
- id: 01a16ca2-8b18-71f0-92e4-4e2492953fa5
314
+ id: 01a16cf7-6b1e-7e74-9fb2-5f094a71a39f
315
315
  year: 1927
316
316
  minutes: 153
317
317
  status: to watch
@@ -384,7 +384,7 @@ You edit `datanotes/main/public/film/Sherlock Jr..md` by hand, outside the engin
384
384
  ```markdown
385
385
  ---
386
386
  table: main.public.film
387
- id: 01a16ca2-719a-7e26-8d8b-e4471d2b154f
387
+ id: 01a16cf7-5643-7af3-888a-fbbab87f32ae
388
388
  title: Sherlock Jr.: the projectionist
389
389
  year: 1924
390
390
  status: watched
@@ -471,7 +471,7 @@ You edit `datanotes/main/public/film/Sherlock Jr..md` by hand, outside the engin
471
471
  ```markdown
472
472
  ---
473
473
  table: main.public.film
474
- id: 01a16ca2-719a-7e26-8d8b-e4471d2b154f
474
+ id: 01a16cf7-5643-7af3-888a-fbbab87f32ae
475
475
  title: "Sherlock Jr.: the projectionist"
476
476
  year: 1924
477
477
  status: watched
@@ -30,7 +30,7 @@ Answer:
30
30
  "ok": true,
31
31
  "op": "define_base",
32
32
  "planned_texts": ["datanotes/metastore.yaml"],
33
- "migration_id": "20261024T063920-define_base-create-base-entry"
33
+ "migration_id": "20261024T081203-define_base-create-base-entry"
34
34
  }
35
35
  ```
36
36
 
@@ -50,7 +50,7 @@ Answer:
50
50
  "commits": [
51
51
  { "table": "diary.classics.film", "version": 6, "operation": "SET TABLE BASES" }
52
52
  ],
53
- "migration_id": "20261024T063920-set_table_bases-diary-classics-film-extends-en"
53
+ "migration_id": "20261024T081203-set_table_bases-diary-classics-film-extends-en"
54
54
  }
55
55
  ```
56
56
 
@@ -118,14 +118,14 @@ Answer:
118
118
  "rows": [
119
119
  {
120
120
  "path": "datanotes/diary/classics/actors/Max Schreck.md",
121
- "id": "01a16ca2-a55f-7ea9-a62e-541b9f025578",
121
+ "id": "01a16cf7-863f-7e8b-a6ba-88298d804353",
122
122
  "added_on": "2026-10-05",
123
123
  "note": "The face of Nosferatu",
124
124
  "_source": "diary.classics.actors"
125
125
  },
126
126
  {
127
127
  "path": "datanotes/diary/classics/film/Nosferatu.md",
128
- "id": "01a16ca2-a508-7d01-9bb0-9773a3a6a511",
128
+ "id": "01a16cf7-85ca-7d5a-8952-a21fee1584a0",
129
129
  "added_on": "2026-10-05",
130
130
  "note": null,
131
131
  "_source": "diary.classics.film"
@@ -169,7 +169,7 @@ Answer:
169
169
  "commits": [
170
170
  { "table": "diary.classics.actors", "version": 3, "operation": "DEFINE BASE" }
171
171
  ],
172
- "migration_id": "20261024T063920-define_base-alter-base-entry"
172
+ "migration_id": "20261024T081203-define_base-alter-base-entry"
173
173
  }
174
174
  ```
175
175
 
@@ -246,7 +246,7 @@ Answer:
246
246
  "commits": [
247
247
  { "table": "diary.classics.actors", "version": 4, "operation": "DEFINE BASE" }
248
248
  ],
249
- "migration_id": "20261024T063920-define_base-alter-base-entry-2"
249
+ "migration_id": "20261024T081203-define_base-alter-base-entry-2"
250
250
  }
251
251
  ```
252
252
 
@@ -280,7 +280,7 @@ Answer:
280
280
  "ok": true,
281
281
  "op": "define_base",
282
282
  "planned_texts": ["datanotes/metastore.yaml"],
283
- "migration_id": "20261024T063920-define_base-create-base-credited"
283
+ "migration_id": "20261024T081203-define_base-create-base-credited"
284
284
  }
285
285
  ```
286
286
 
@@ -300,7 +300,7 @@ Answer:
300
300
  "commits": [
301
301
  { "table": "diary.classics.actors", "version": 5, "operation": "SET TABLE BASES" }
302
302
  ],
303
- "migration_id": "20261024T063920-set_table_bases-diary-classics-actors-extends--2"
303
+ "migration_id": "20261024T081203-set_table_bases-diary-classics-actors-extends--2"
304
304
  }
305
305
  ```
306
306
 
@@ -329,7 +329,7 @@ Answer:
329
329
  "ok": true,
330
330
  "op": "define_base",
331
331
  "planned_texts": ["datanotes/metastore.yaml"],
332
- "migration_id": "20261024T063921-define_base-create-base-tree"
332
+ "migration_id": "20261024T081203-define_base-create-base-tree"
333
333
  }
334
334
  ```
335
335
 
@@ -369,7 +369,7 @@ Answer:
369
369
  "commits": [
370
370
  { "table": "diary.classics.genre", "version": 1, "operation": "SET TABLE BASES" }
371
371
  ],
372
- "migration_id": "20261024T063921-set_table_bases-diary-classics-genre-extends-t"
372
+ "migration_id": "20261024T081203-set_table_bases-diary-classics-genre-extends-t"
373
373
  }
374
374
  ```
375
375
 
@@ -475,6 +475,6 @@ Answer:
475
475
  "operation": "SET TABLE BASES"
476
476
  }
477
477
  ],
478
- "migration_id": "20261024T063921-set_table_bases-diary-classics-genre_draft-ext"
478
+ "migration_id": "20261024T081203-set_table_bases-diary-classics-genre_draft-ext"
479
479
  }
480
480
  ```
@@ -63,7 +63,7 @@ Answer:
63
63
  "commits": [
64
64
  { "table": "diary.classics.film", "version": 0, "operation": "CREATE TABLE" }
65
65
  ],
66
- "migration_id": "20261024T063920-create_table-create-table-diary-classics-fi"
66
+ "migration_id": "20261024T081203-create_table-create-table-diary-classics-fi"
67
67
  }
68
68
  ```
69
69
 
@@ -91,7 +91,7 @@ Answer:
91
91
  "files_created": 1,
92
92
  "planned_creates": ["datanotes/diary/classics/film/Nosferatu.md"],
93
93
  "commits": [{ "table": "diary.classics.film", "version": 1, "operation": "WRITE" }],
94
- "migration_id": "20261024T063920-insert_row-insert-into-film"
94
+ "migration_id": "20261024T081203-insert_row-insert-into-film"
95
95
  }
96
96
  ```
97
97
 
@@ -127,7 +127,7 @@ Answer:
127
127
  "commits": [
128
128
  { "table": "diary.classics.film", "version": 3, "operation": "ALTER TABLE" }
129
129
  ],
130
- "migration_id": "20261024T063920-alter_table-alter-table-diary-classics-fil-2"
130
+ "migration_id": "20261024T081203-alter_table-alter-table-diary-classics-fil-2"
131
131
  }
132
132
  ```
133
133
 
@@ -144,7 +144,7 @@ Answer:
144
144
  "ok": true,
145
145
  "op": "comment_on",
146
146
  "planned_texts": ["datanotes/metastore.yaml"],
147
- "migration_id": "20261024T063920-comment_on-comment-on-catalog-diary"
147
+ "migration_id": "20261024T081203-comment_on-comment-on-catalog-diary"
148
148
  }
149
149
  ```
150
150
 
@@ -165,7 +165,7 @@ Answer:
165
165
  "ok": true,
166
166
  "op": "comment_on",
167
167
  "planned_texts": ["datanotes/metastore.yaml"],
168
- "migration_id": "20261024T063920-comment_on-comment-on-schema-diary-classi"
168
+ "migration_id": "20261024T081203-comment_on-comment-on-schema-diary-classi"
169
169
  }
170
170
  ```
171
171
 
@@ -173,7 +173,7 @@ Answer:
173
173
 
174
174
  ```yaml
175
175
  # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
176
- id: 01a16ca2-a4fb-7845-9268-3bc0a21e629e
176
+ id: 01a16cf7-85ba-7448-adb2-79a7636a1226
177
177
  config:
178
178
  history: true
179
179
 
@@ -270,7 +270,7 @@ Answer:
270
270
  "commits": [
271
271
  { "table": "diary.classics.film", "version": 4, "operation": "ALTER TABLE" }
272
272
  ],
273
- "migration_id": "20261024T063920-alter_table-alter-table-diary-classics-fil-3"
273
+ "migration_id": "20261024T081203-alter_table-alter-table-diary-classics-fil-3"
274
274
  }
275
275
  ```
276
276
 
@@ -287,7 +287,7 @@ Answer:
287
287
  "ok": true,
288
288
  "op": "comment_on",
289
289
  "planned_texts": ["datanotes/metastore.yaml"],
290
- "migration_id": "20261024T063920-comment_on-remove-the-comment-on-schema-d"
290
+ "migration_id": "20261024T081203-comment_on-remove-the-comment-on-schema-d"
291
291
  }
292
292
  ```
293
293
 
@@ -309,7 +309,7 @@ Answer:
309
309
  "commits": [
310
310
  { "table": "diary.classics.film", "version": 5, "operation": "ALTER TABLE" }
311
311
  ],
312
- "migration_id": "20261024T063920-alter_table-alter-table-diary-classics-fil-4"
312
+ "migration_id": "20261024T081203-alter_table-alter-table-diary-classics-fil-4"
313
313
  }
314
314
  ```
315
315
 
@@ -593,7 +593,7 @@ This is the database of this page as the engine wrote it. `metastore.yaml` holds
593
593
 
594
594
  ```yaml
595
595
  # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
596
- id: 01a16ca2-a4fb-7845-9268-3bc0a21e629e
596
+ id: 01a16cf7-85ba-7448-adb2-79a7636a1226
597
597
  config:
598
598
  history: true
599
599
  default_catalog: diary