@camox/api-contract 0.57.0 → 0.58.1

package/dist/router.d.ts

@@ -6225,7 +6225,19 @@ type EnvAnswer = {
   };
 };
 //#endregion
+//#region ../../apps/api/src/lib/timing.d.ts
+/** What a span's line says beside its name and duration. Undefined fields are left out. */
+type SpanFields = Record<string, string | number | boolean | null | undefined>;
+//#endregion
 //#region ../../apps/api/src/durable-objects/draft-code.d.ts
+/** A revision of the draft whose build goes up as its publish script. */
+type PublishUpload = {
+  /** The project's Project ID. */
+  project: string;
+  revision: string;
+  /** Its build in `REVISION_BUILDS`. */
+  archiveKey: string;
+};
 /** A commit `prepareCommit` made, not on the branch yet. */
 type PreparedCommit = {
   commit: string;
@@ -6319,6 +6331,23 @@ declare class DraftCode extends DurableObject<Bindings> {
    * clashed: unless the files still hold a merge no commit landed.
    */
   settleClash(): Promise<void>;
+  /**
+   * Uploads the build of the draft's revision `revision` as the draft's publish script, ahead of
+   * its publish, unless the script holds it already: its publish then only checks it's there
+   * (`uploadForPublish`). Nothing once a publish took the script, until that publish ends, nor
+   * once the draft ended. A draft that ended during the upload, deleted, loses the script.
+   */
+  prepareUpload(toUpload: PublishUpload): Promise<void>;
+  /**
+   * The draft's publish script holding the build of `revision`, which the publish `instanceId`
+   * ships, taking it: no upload ahead replaces it until that publish ends. Uploads it unless the
+   * script holds it already, as the upload ahead left it. Returns its name, and whether this
+   * uploaded it.
+   */
+  uploadForPublish(toUpload: PublishUpload, instanceId: string, span?: SpanFields): Promise<{
+    script: string;
+    uploaded: boolean;
+  }>;
   /** Records that a build of the draft's code started, or ended. */
   markBuilding(building: boolean): Promise<void>;
   /**
@@ -6352,6 +6381,12 @@ declare class DraftCode extends DurableObject<Bindings> {
    * only files the branch's head doesn't hold as they are, since no commit holds markers.
    */
   conflicts(): Promise<string[]>;
+  /**
+   * The working copy's files that installing its dependencies reads, as a tar archive, with its
+   * lockfile: what its sandbox needs to install ahead of a build, which `prepareCommit` would
+   * give only once it staged and committed every change.
+   */
+  installFiles(): Promise<Pick<PreparedCommit, "files" | "lockfile">>;
   /**
    * Stages the working copy's every change and makes, without moving the branch, the commit it
    * would be: `message` on top of the branch's head. Returns the commit and its tree, with the
@@ -6460,22 +6495,30 @@ type RevisionToLoad = {
 };
 /** Dispatch's `CamoxRevisions` entrypoint. */
 type Dispatch = {
-  /** A revision's Definition Set, as its build's entrypoint gives it: JSON, not yet checked. */
-  readDefinitionSet(revision: RevisionToLoad): Promise<unknown>;
   /**
-   * Readies a revision before its draft's viewers are told of it: dispatch serves its client
-   * assets from then on, and has loaded and rendered it once. Says how many client assets it
-   * stored and how long that and the render took, for the API's timing logs (none from a
-   * dispatch older than that).
+   * Readies a revision before its draft's viewers are told of it, reading its build once:
+   * dispatch serves its client assets from then on, and has loaded and rendered it once. Returns
+   * its Definition Set (JSON, not yet checked), with what each part took, for the API's timing
+   * logs.
    */
-  prewarm(revision: RevisionToLoad): Promise<PrewarmTimings | void>;
+  prepare(revision: RevisionToLoad): Promise<PreparedRevision>;
 };
-/** What a prewarm took. Mirrored in apps/dispatch/src/revisions.ts: keep the two in sync. */
-type PrewarmTimings = {
+/**
+ * What preparing a revision took: reading its build, then, at once, storing its client assets
+ * (how many) and reading its Definition Set, then the first render. Mirrored in
+ * apps/dispatch/src/revisions.ts: keep the two in sync.
+ */
+type PrepareTimings = {
   assets: number;
+  readMs: number;
   assetsMs: number;
+  definitionSetMs: number;
   renderMs: number;
 };
+/** A prepared revision's Definition Set, with what preparing it took. */
+type PreparedRevision = PrepareTimings & {
+  definitionSet: unknown;
+};
 //#endregion
 //#region ../../apps/api/src/types.d.ts
 type Bindings = {
@@ -6904,6 +6947,8 @@ type BlockRow = typeof blocks.$inferSelect;
 type ShownBlock = Conformed<BlockRow> & {
   summary: string;
   title: string;
+  /** The hash of each artifact source in its content, by field (`artifactHashesOf`). */
+  artifactHashes: Record<string, string>;
 };
 //#endregion
 //#region ../../apps/api/src/domains/content/structured-data.d.ts
@@ -7173,8 +7218,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7262,8 +7307,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7349,8 +7394,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7440,8 +7485,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7548,8 +7593,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7639,8 +7684,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7698,8 +7743,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7787,8 +7832,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7875,8 +7920,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7938,8 +7983,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -7992,8 +8037,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -8097,6 +8142,7 @@ declare const router: {
         afterBlockIds: string[];
       } | null;
       blocks: (Omit<{
+        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -8104,7 +8150,6 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
-        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -8122,6 +8167,7 @@ declare const router: {
       } & {
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -8152,6 +8198,7 @@ declare const router: {
         blockId: string;
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -8202,6 +8249,7 @@ declare const router: {
         afterBlockIds: string[];
       } | null;
       blocks: (Omit<{
+        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -8209,7 +8257,6 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
-        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -8227,6 +8274,7 @@ declare const router: {
       } & {
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -8257,6 +8305,7 @@ declare const router: {
         blockId: string;
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -8687,8 +8736,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -8723,8 +8772,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -8833,8 +8882,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -8869,8 +8918,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -8971,8 +9020,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9007,8 +9056,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9106,8 +9155,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9142,8 +9191,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9244,8 +9293,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9280,8 +9329,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9378,8 +9427,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9450,6 +9499,7 @@ declare const router: {
       id: import("zod").ZodUUID;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
       block: Omit<{
+        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -9457,7 +9507,6 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
-        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9475,6 +9524,7 @@ declare const router: {
       } & {
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       };
@@ -9505,12 +9555,14 @@ declare const router: {
         blockId: string;
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
       files: FileView[];
     }, {
       block: Omit<{
+        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -9518,7 +9570,6 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
-        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9536,6 +9587,7 @@ declare const router: {
       } & {
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       };
@@ -9566,6 +9618,7 @@ declare const router: {
         blockId: string;
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -9646,6 +9699,7 @@ declare const router: {
       type: import("zod").ZodString;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
       block: Omit<{
+        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -9653,7 +9707,6 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
-        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9671,6 +9724,7 @@ declare const router: {
       } & {
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       };
@@ -9701,12 +9755,14 @@ declare const router: {
         blockId: string;
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
       files: FileView[];
     } | null, {
       block: Omit<{
+        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -9714,7 +9770,6 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
-        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -9732,6 +9787,7 @@ declare const router: {
       } & {
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       };
@@ -9762,6 +9818,7 @@ declare const router: {
         blockId: string;
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -9804,8 +9861,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9840,8 +9897,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9866,6 +9923,7 @@ declare const router: {
         position: import("zod").ZodString;
       }, import("zod/v4/core").$strip>>>;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<Omit<{
+      type: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
@@ -9873,7 +9931,6 @@ declare const router: {
       locale: string;
       pageId: string | null;
       layoutId: string | null;
-      type: string;
       content: unknown;
       createdAt: number;
       updatedAt: number;
@@ -9891,9 +9948,11 @@ declare const router: {
     } & {
       summary: string;
       title: string;
+      artifactHashes: Record<string, string>;
     } & {
       warnings?: string[];
     }, Omit<{
+      type: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
@@ -9901,7 +9960,6 @@ declare const router: {
       locale: string;
       pageId: string | null;
       layoutId: string | null;
-      type: string;
       content: unknown;
       createdAt: number;
       updatedAt: number;
@@ -9919,6 +9977,7 @@ declare const router: {
     } & {
       summary: string;
       title: string;
+      artifactHashes: Record<string, string>;
     } & {
       warnings?: string[];
     }>, Record<never, never>, Record<never, never>>;
@@ -9959,8 +10018,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -9995,8 +10054,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10045,8 +10104,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10081,8 +10140,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10131,8 +10190,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10167,8 +10226,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10218,8 +10277,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10254,8 +10313,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10303,8 +10362,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10339,8 +10398,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10386,8 +10445,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10435,8 +10494,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10471,8 +10530,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10508,6 +10567,7 @@ declare const router: {
         afterBlockIds: string[];
       };
       blocks: (Omit<{
+        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -10515,7 +10575,6 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
-        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -10533,6 +10592,7 @@ declare const router: {
       } & {
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -10563,6 +10623,7 @@ declare const router: {
         blockId: string;
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -10585,6 +10646,7 @@ declare const router: {
         afterBlockIds: string[];
       };
       blocks: (Omit<{
+        type: string;
         draftId: string | null;
         id: string;
         deleted: boolean;
@@ -10592,7 +10654,6 @@ declare const router: {
         locale: string;
         pageId: string | null;
         layoutId: string | null;
-        type: string;
         content: unknown;
         createdAt: number;
         updatedAt: number;
@@ -10610,6 +10671,7 @@ declare const router: {
       } & {
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -10640,6 +10702,7 @@ declare const router: {
         blockId: string;
         summary: string;
         title: string;
+        artifactHashes: Record<string, string>;
       } & {
         references: ResolvedReferences;
       })[];
@@ -10728,8 +10791,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10764,8 +10827,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10814,8 +10877,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10850,8 +10913,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10898,8 +10961,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -10946,8 +11009,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11001,8 +11064,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11037,8 +11100,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11069,10 +11132,10 @@ declare const router: {
     }>, import("zod").ZodObject<{
       projectId: import("zod").ZodNumber;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11093,10 +11156,10 @@ declare const router: {
       height: number | null;
       blobId: string;
     }>[], FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11124,10 +11187,10 @@ declare const router: {
     }>, import("zod").ZodObject<{
       id: import("zod").ZodUUID;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11148,10 +11211,10 @@ declare const router: {
       height: number | null;
       blobId: string;
     }>, FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11220,8 +11283,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11256,8 +11319,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11269,10 +11332,10 @@ declare const router: {
       id: import("zod").ZodUUID;
       alt: import("zod").ZodString;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11293,10 +11356,10 @@ declare const router: {
       height: number | null;
       blobId: string;
     }>, FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11354,8 +11417,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11390,8 +11453,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11403,10 +11466,10 @@ declare const router: {
       id: import("zod").ZodUUID;
       filename: import("zod").ZodString;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11427,10 +11490,10 @@ declare const router: {
       height: number | null;
       blobId: string;
     }>, FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11488,8 +11551,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11524,8 +11587,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11536,10 +11599,10 @@ declare const router: {
     }>, Record<never, never>>, import("zod").ZodObject<{
       id: import("zod").ZodUUID;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11560,10 +11623,10 @@ declare const router: {
       height: number | null;
       blobId: string;
     }, {
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11621,8 +11684,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11657,8 +11720,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11706,8 +11769,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11742,8 +11805,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11755,10 +11818,10 @@ declare const router: {
       id: import("zod").ZodUUID;
       enabled: import("zod").ZodBoolean;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11779,10 +11842,10 @@ declare const router: {
       height: number | null;
       blobId: string;
     }>, FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11838,8 +11901,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -11850,10 +11913,10 @@ declare const router: {
     }>, import("zod").ZodObject<{
       id: import("zod").ZodUUID;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11874,10 +11937,10 @@ declare const router: {
       height: number | null;
       blobId: string;
     }> | undefined, FileView<{
+      path: string;
       draftId: string | null;
       id: string;
       deleted: boolean;
-      path: string;
       createdAt: number;
       updatedAt: number;
       projectId: number;
@@ -11912,6 +11975,9 @@ declare const router: {
         blockId: string | null;
         summary: string;
         title: string;
+        artifactHashes: {
+          [k: string]: string;
+        };
         references: ResolvedReferences;
         draftId: string | null;
         id: string;
@@ -11939,6 +12005,9 @@ declare const router: {
         blockId: string | null;
         summary: string;
         title: string;
+        artifactHashes: {
+          [k: string]: string;
+        };
         references: ResolvedReferences;
         draftId: string | null;
         id: string;
@@ -11998,8 +12067,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12034,8 +12103,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12143,8 +12212,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12179,8 +12248,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12275,8 +12344,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12311,8 +12380,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12407,8 +12476,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12443,8 +12512,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12540,8 +12609,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12576,8 +12645,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12669,8 +12738,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12764,8 +12833,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12800,8 +12869,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12936,8 +13005,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -12995,8 +13064,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13057,8 +13126,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13115,8 +13184,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13180,8 +13249,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13300,8 +13369,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13336,8 +13405,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13404,8 +13473,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13440,8 +13509,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13508,8 +13577,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13544,8 +13613,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13625,14 +13694,14 @@ declare const router: {
             properties: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
               fieldType: import("zod").ZodEnum<{
                 String: "String";
+                Embed: "Embed";
+                Link: "Link";
                 Boolean: "Boolean";
                 Enum: "Enum";
-                Embed: "Embed";
                 Image: "Image";
                 File: "File";
                 ImageList: "ImageList";
                 FileList: "FileList";
-                Link: "Link";
                 Repeater: "Repeater";
                 Reference: "Reference";
                 ReferenceList: "ReferenceList";
@@ -13675,7 +13744,7 @@ declare const router: {
           contentSchema: {
             type: "object";
             properties: Record<string, {
-              fieldType: "String" | "Boolean" | "Enum" | "Embed" | "Image" | "File" | "ImageList" | "FileList" | "Link" | "Repeater" | "Reference" | "ReferenceList";
+              fieldType: "String" | "Embed" | "Link" | "Boolean" | "Enum" | "Image" | "File" | "ImageList" | "FileList" | "Repeater" | "Reference" | "ReferenceList";
               type?: string | undefined;
               anyOf?: unknown;
               title?: string | undefined;
@@ -13712,7 +13781,7 @@ declare const router: {
           contentSchema: {
             type: "object";
             properties: Record<string, {
-              fieldType: "String" | "Boolean" | "Enum" | "Embed" | "Image" | "File" | "ImageList" | "FileList" | "Link" | "Repeater" | "Reference" | "ReferenceList";
+              fieldType: "String" | "Embed" | "Link" | "Boolean" | "Enum" | "Image" | "File" | "ImageList" | "FileList" | "Repeater" | "Reference" | "ReferenceList";
               type?: string | undefined;
               anyOf?: unknown;
               title?: string | undefined;
@@ -13856,8 +13925,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13917,8 +13986,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -13965,8 +14034,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14012,8 +14081,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14060,8 +14129,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14151,8 +14220,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14198,8 +14267,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14248,8 +14317,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14299,8 +14368,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14359,8 +14428,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14408,8 +14477,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;
@@ -14457,8 +14526,8 @@ declare const router: {
         studio?: boolean | null | undefined;
       };
       db: Database;
-      env: Bindings;
       headers: Headers;
+      env: Bindings;
       client: string;
       telemetryDisabled: boolean;
       waitUntil: (promise: Promise<unknown>) => void;