@valbuild/shared 0.120.0 → 0.122.0

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.
@@ -1,6 +1,21 @@
1
1
  import { z } from "zod";
2
2
  import { type ModuleFilePath } from "@valbuild/core";
3
3
  declare const ModuleFilePath: z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>;
4
+ /**
5
+ * A patch group: the set of patches one user has chosen to publish.
6
+ *
7
+ * Not a patch *set* — a patch set is computed from the schema and says which
8
+ * patches must move together; a patch group is curated and says which ones this
9
+ * user wants live. See `docs/independent-publish/PLAN.md`.
10
+ */
11
+ export declare const PatchGroup: z.ZodObject<{
12
+ patchGroupId: z.ZodString;
13
+ authorId: z.ZodNullable<z.ZodString>;
14
+ createdAt: z.ZodString;
15
+ publishedAt: z.ZodNullable<z.ZodString>;
16
+ patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
17
+ }, z.core.$strip>;
18
+ export type PatchGroupT = z.infer<typeof PatchGroup>;
4
19
  declare const cookies: z.ZodUnion<readonly [z.ZodLiteral<"val_session">, z.ZodLiteral<"val_enable">, z.ZodLiteral<"val_state">]>;
5
20
  type Cookies = z.infer<typeof cookies>;
6
21
  declare const enableCookieValue: z.ZodObject<{
@@ -258,46 +273,6 @@ export declare const Api: {
258
273
  }, z.core.$strip>;
259
274
  };
260
275
  };
261
- "/session": {
262
- GET: {
263
- req: {
264
- cookies: {
265
- val_session: z.ZodOptional<z.ZodString>;
266
- };
267
- };
268
- res: z.ZodUnion<readonly [z.ZodObject<{
269
- status: z.ZodLiteral<200>;
270
- json: z.ZodObject<{
271
- mode: z.ZodUnion<readonly [z.ZodLiteral<"local">, z.ZodLiteral<"proxy">]>;
272
- enabled: z.ZodBoolean;
273
- }, z.core.$strip>;
274
- }, z.core.$strip>, z.ZodObject<{
275
- status: z.ZodUnion<readonly [z.ZodLiteral<400>, z.ZodLiteral<401>, z.ZodLiteral<403>, z.ZodLiteral<404>, z.ZodLiteral<500>, z.ZodLiteral<501>]>;
276
- json: z.ZodObject<{
277
- message: z.ZodString;
278
- }, z.core.$strip>;
279
- }, z.core.$strip>, z.ZodObject<{
280
- status: z.ZodLiteral<401>;
281
- json: z.ZodObject<{
282
- message: z.ZodString;
283
- details: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
284
- reason: z.ZodString;
285
- }, z.core.$strip>, z.ZodObject<{
286
- sub: z.ZodString;
287
- exp: z.ZodNumber;
288
- token: z.ZodString;
289
- org: z.ZodString;
290
- project: z.ZodString;
291
- }, z.core.$strip>]>;
292
- }, z.core.$strip>;
293
- }, z.core.$strip>, z.ZodObject<{
294
- status: z.ZodLiteral<500>;
295
- json: z.ZodObject<{
296
- message: z.ZodString;
297
- }, z.core.$strip>;
298
- }, z.core.$strip>]>;
299
- };
300
- };
301
276
  "/logout": {
302
277
  GET: {
303
278
  req: {
@@ -430,6 +405,8 @@ export declare const Api: {
430
405
  schemaSha: z.ZodString;
431
406
  sourcesSha: z.ZodString;
432
407
  patches: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
408
+ appliedPatches: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
409
+ headCommitSha: z.ZodOptional<z.ZodString>;
433
410
  removed: z.ZodOptional<z.ZodArray<z.ZodObject<{
434
411
  patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
435
412
  reason: z.ZodString;
@@ -455,6 +432,8 @@ export declare const Api: {
455
432
  sourcesSha: z.ZodString;
456
433
  commitSha: z.ZodString;
457
434
  patches: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
435
+ appliedPatches: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
436
+ headCommitSha: z.ZodOptional<z.ZodString>;
458
437
  commits: z.ZodArray<z.ZodObject<{
459
438
  commitSha: z.ZodString;
460
439
  clientCommitSha: z.ZodString;
@@ -551,6 +530,9 @@ export declare const Api: {
551
530
  query: {
552
531
  id: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
553
532
  };
533
+ body: z.ZodOptional<z.ZodObject<{
534
+ unstagePatchIds: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
535
+ }, z.core.$strip>>;
554
536
  cookies: {
555
537
  val_session: z.ZodOptional<z.ZodString>;
556
538
  };
@@ -593,6 +575,8 @@ export declare const Api: {
593
575
  patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
594
576
  patch: z.ZodAny;
595
577
  }, z.core.$strip>>;
578
+ patchGroupId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
579
+ withPatchIds: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
596
580
  }, z.core.$strip>;
597
581
  cookies: {
598
582
  val_session: z.ZodOptional<z.ZodString>;
@@ -631,6 +615,7 @@ export declare const Api: {
631
615
  type: z.ZodLiteral<"patch">;
632
616
  patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
633
617
  }, z.core.$strip>]>;
618
+ patchGroupId: z.ZodOptional<z.ZodString>;
634
619
  }, z.core.$strip>;
635
620
  }, z.core.$strip>]>;
636
621
  };
@@ -639,6 +624,15 @@ export declare const Api: {
639
624
  query: {
640
625
  patch_id: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
641
626
  exclude_patch_ops: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
627
+ /**
628
+ * Include the patch group annotation in the answer.
629
+ *
630
+ * Off by default because the client CHUNKS this request — a long
631
+ * chain is several round trips — and the groups are a property of the
632
+ * branch, identical in every chunk. Asking on each one is N identical
633
+ * lookups against the content API to learn the same thing.
634
+ */
635
+ include_patch_groups: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
642
636
  };
643
637
  cookies: {
644
638
  val_session: z.ZodOptional<z.ZodString>;
@@ -712,7 +706,15 @@ export declare const Api: {
712
706
  appliedAt: z.ZodNullable<z.ZodObject<{
713
707
  commitSha: z.ZodString;
714
708
  }, z.core.$strip>>;
709
+ patchGroupIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
715
710
  }, z.core.$strip>>;
711
+ patchGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
712
+ patchGroupId: z.ZodString;
713
+ authorId: z.ZodNullable<z.ZodString>;
714
+ createdAt: z.ZodString;
715
+ publishedAt: z.ZodNullable<z.ZodString>;
716
+ patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
717
+ }, z.core.$strip>>>;
716
718
  baseSha: z.ZodString;
717
719
  error: z.ZodOptional<z.ZodObject<{
718
720
  message: z.ZodString;
@@ -724,6 +726,86 @@ export declare const Api: {
724
726
  }, z.core.$strip>]>;
725
727
  };
726
728
  };
729
+ "/patch-groups/~/patches": {
730
+ PUT: {
731
+ req: {
732
+ body: z.ZodObject<{
733
+ patchGroupId: z.ZodString;
734
+ patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
735
+ withPatchIds: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
736
+ }, z.core.$strip>;
737
+ cookies: {
738
+ val_session: z.ZodOptional<z.ZodString>;
739
+ };
740
+ };
741
+ res: z.ZodUnion<readonly [z.ZodObject<{
742
+ status: z.ZodLiteral<401>;
743
+ json: z.ZodObject<{
744
+ message: z.ZodString;
745
+ }, z.core.$strip>;
746
+ }, z.core.$strip>, z.ZodObject<{
747
+ status: z.ZodLiteral<403>;
748
+ json: z.ZodObject<{
749
+ message: z.ZodString;
750
+ }, z.core.$strip>;
751
+ }, z.core.$strip>, z.ZodObject<{
752
+ status: z.ZodLiteral<409>;
753
+ json: z.ZodObject<{
754
+ message: z.ZodString;
755
+ }, z.core.$strip>;
756
+ }, z.core.$strip>, z.ZodObject<{
757
+ status: z.ZodLiteral<500>;
758
+ json: z.ZodObject<{
759
+ message: z.ZodString;
760
+ }, z.core.$strip>;
761
+ }, z.core.$strip>, z.ZodObject<{
762
+ status: z.ZodLiteral<200>;
763
+ json: z.ZodObject<{
764
+ patchGroupId: z.ZodString;
765
+ patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
766
+ }, z.core.$strip>;
767
+ }, z.core.$strip>]>;
768
+ };
769
+ DELETE: {
770
+ req: {
771
+ body: z.ZodObject<{
772
+ patchGroupId: z.ZodString;
773
+ patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
774
+ withPatchIds: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
775
+ }, z.core.$strip>;
776
+ cookies: {
777
+ val_session: z.ZodOptional<z.ZodString>;
778
+ };
779
+ };
780
+ res: z.ZodUnion<readonly [z.ZodObject<{
781
+ status: z.ZodLiteral<401>;
782
+ json: z.ZodObject<{
783
+ message: z.ZodString;
784
+ }, z.core.$strip>;
785
+ }, z.core.$strip>, z.ZodObject<{
786
+ status: z.ZodLiteral<403>;
787
+ json: z.ZodObject<{
788
+ message: z.ZodString;
789
+ }, z.core.$strip>;
790
+ }, z.core.$strip>, z.ZodObject<{
791
+ status: z.ZodLiteral<409>;
792
+ json: z.ZodObject<{
793
+ message: z.ZodString;
794
+ }, z.core.$strip>;
795
+ }, z.core.$strip>, z.ZodObject<{
796
+ status: z.ZodLiteral<500>;
797
+ json: z.ZodObject<{
798
+ message: z.ZodString;
799
+ }, z.core.$strip>;
800
+ }, z.core.$strip>, z.ZodObject<{
801
+ status: z.ZodLiteral<200>;
802
+ json: z.ZodObject<{
803
+ patchGroupId: z.ZodString;
804
+ patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
805
+ }, z.core.$strip>;
806
+ }, z.core.$strip>]>;
807
+ };
808
+ };
727
809
  "/schema": {
728
810
  GET: {
729
811
  req: {
@@ -771,6 +853,33 @@ export declare const Api: {
771
853
  validate_binary_files: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
772
854
  exclude_patches: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
773
855
  apply_patches: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
856
+ /**
857
+ * Apply ONLY these patches, rather than everything pending.
858
+ *
859
+ * This is what makes a draft-mode render match the caller's staged
860
+ * view. Without it `/sources/~` replays every pending patch on the
861
+ * branch, so a server-rendered preview shows other people's
862
+ * unpublished work — the one thing independent publish is for.
863
+ *
864
+ * Omitted means everything pending, which is the behaviour every
865
+ * existing caller has and must keep. An EMPTY array is a different
866
+ * answer and is honoured as one: a group holding nothing renders
867
+ * base.
868
+ */
869
+ patch_id: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>>;
870
+ /**
871
+ * Apply only the patches in the CALLER'S OWN patch groups.
872
+ *
873
+ * The server resolves them from the session, so a draft render does
874
+ * not have to know its own group ids — which it cannot, since it has
875
+ * no client state. This is what makes `fetchVal` in draft mode show
876
+ * the person their own staged work rather than everybody's.
877
+ *
878
+ * Ignored when `patch_id` is given: an explicit list is a caller that
879
+ * already knows what it wants, and silently intersecting the two
880
+ * would make the narrower one invisible.
881
+ */
882
+ own_patch_groups_only: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
774
883
  };
775
884
  cookies: {
776
885
  val_session: z.ZodOptional<z.ZodString>;
@@ -831,7 +940,7 @@ export declare const Api: {
831
940
  message: z.ZodString;
832
941
  value: z.ZodOptional<z.ZodUnknown>;
833
942
  fatal: z.ZodOptional<z.ZodBoolean>;
834
- fixes: z.ZodOptional<z.ZodArray<z.ZodType<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "keyof:check-keys" | "router:check-route" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "jsonValues:extract-entry", unknown, z.core.$ZodTypeInternals<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "keyof:check-keys" | "router:check-route" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "jsonValues:extract-entry", unknown>>>>;
943
+ fixes: z.ZodOptional<z.ZodArray<z.ZodType<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "keyof:check-keys" | "router:check-route" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "jsonValues:extract-entry" | "external:upload", unknown, z.core.$ZodTypeInternals<"image:add-metadata" | "image:check-metadata" | "image:upload-remote" | "image:download-remote" | "image:check-remote" | "images:check-remote" | "images:upload-remote" | "file:add-metadata" | "file:check-metadata" | "file:upload-remote" | "file:download-remote" | "file:check-remote" | "files:check-remote" | "files:upload-remote" | "keyof:check-keys" | "router:check-route" | "images:check-unique-folder" | "files:check-unique-folder" | "images:check-all-files" | "files:check-all-files" | "jsonValues:extract-entry" | "external:upload", unknown>>>>;
835
944
  }, z.core.$strip>>>>;
836
945
  }, z.core.$strip>>;
837
946
  }, z.core.$strip>;
@@ -876,6 +985,8 @@ export declare const Api: {
876
985
  body: z.ZodObject<{
877
986
  message: z.ZodOptional<z.ZodString>;
878
987
  patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
988
+ patchGroupId: z.ZodOptional<z.ZodString>;
989
+ expectedHeadCommitSha: z.ZodOptional<z.ZodString>;
879
990
  }, z.core.$strip>;
880
991
  cookies: {
881
992
  val_session: z.ZodOptional<z.ZodString>;
@@ -889,6 +1000,7 @@ export declare const Api: {
889
1000
  }, z.core.$strip>, z.ZodObject<{
890
1001
  status: z.ZodLiteral<200>;
891
1002
  json: z.ZodObject<{
1003
+ commitSha: z.ZodOptional<z.ZodString>;
892
1004
  removed: z.ZodOptional<z.ZodArray<z.ZodObject<{
893
1005
  patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
894
1006
  moduleFilePath: z.ZodString & z.ZodType<ModuleFilePath, string, z.core.$ZodTypeInternals<ModuleFilePath, string>>;
@@ -896,11 +1008,29 @@ export declare const Api: {
896
1008
  }, z.core.$strip>>>;
897
1009
  }, z.core.$strip>;
898
1010
  }, z.core.$strip>, z.ZodObject<{
899
- status: z.ZodLiteral<409>;
1011
+ status: z.ZodLiteral<403>;
1012
+ json: z.ZodObject<{
1013
+ message: z.ZodString;
1014
+ }, z.core.$strip>;
1015
+ }, z.core.$strip>, z.ZodObject<{
1016
+ status: z.ZodLiteral<500>;
900
1017
  json: z.ZodObject<{
901
1018
  message: z.ZodString;
902
- isNotFastForward: z.ZodLiteral<true>;
903
1019
  }, z.core.$strip>;
1020
+ }, z.core.$strip>, z.ZodObject<{
1021
+ status: z.ZodLiteral<409>;
1022
+ json: z.ZodUnion<readonly [z.ZodObject<{
1023
+ message: z.ZodString;
1024
+ }, z.core.$strip>, z.ZodObject<{
1025
+ message: z.ZodString;
1026
+ isNotFastForward: z.ZodLiteral<true>;
1027
+ }, z.core.$strip>, z.ZodObject<{
1028
+ message: z.ZodString;
1029
+ headMoved: z.ZodLiteral<true>;
1030
+ }, z.core.$strip>, z.ZodObject<{
1031
+ message: z.ZodString;
1032
+ patchGroupPublished: z.ZodLiteral<true>;
1033
+ }, z.core.$strip>]>;
904
1034
  }, z.core.$strip>, z.ZodObject<{
905
1035
  status: z.ZodLiteral<400>;
906
1036
  json: z.ZodUnion<readonly [z.ZodObject<{
@@ -926,6 +1056,309 @@ export declare const Api: {
926
1056
  }, z.core.$strip>]>;
927
1057
  };
928
1058
  };
1059
+ "/history/commits": {
1060
+ GET: {
1061
+ req: {
1062
+ query: {
1063
+ branch: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>;
1064
+ limit: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>, z.ZodTransform<number, string>>>;
1065
+ /** The previous page's `nextCursor`. */
1066
+ cursor: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>>;
1067
+ };
1068
+ cookies: {
1069
+ val_session: z.ZodOptional<z.ZodString>;
1070
+ };
1071
+ };
1072
+ res: z.ZodUnion<readonly [z.ZodObject<{
1073
+ status: z.ZodLiteral<401>;
1074
+ json: z.ZodObject<{
1075
+ message: z.ZodString;
1076
+ }, z.core.$strip>;
1077
+ }, z.core.$strip>, z.ZodObject<{
1078
+ status: z.ZodLiteral<404>;
1079
+ json: z.ZodObject<{
1080
+ message: z.ZodString;
1081
+ }, z.core.$strip>;
1082
+ }, z.core.$strip>, z.ZodObject<{
1083
+ status: z.ZodLiteral<400>;
1084
+ json: z.ZodIntersection<z.ZodObject<{
1085
+ message: z.ZodString;
1086
+ }, z.core.$strip>, z.ZodObject<{
1087
+ kind: z.ZodOptional<z.ZodString>;
1088
+ }, z.core.$strip>>;
1089
+ }, z.core.$strip>, z.ZodObject<{
1090
+ status: z.ZodLiteral<500>;
1091
+ json: z.ZodIntersection<z.ZodObject<{
1092
+ message: z.ZodString;
1093
+ }, z.core.$strip>, z.ZodObject<{
1094
+ kind: z.ZodOptional<z.ZodString>;
1095
+ }, z.core.$strip>>;
1096
+ }, z.core.$strip>, z.ZodObject<{
1097
+ status: z.ZodLiteral<200>;
1098
+ json: z.ZodObject<{
1099
+ commits: z.ZodArray<z.ZodObject<{
1100
+ commitSha: z.ZodString;
1101
+ parentCommitSha: z.ZodString;
1102
+ clientCommitSha: z.ZodString;
1103
+ branch: z.ZodString;
1104
+ createdBranch: z.ZodNullable<z.ZodString>;
1105
+ creator: z.ZodNullable<z.ZodString>;
1106
+ message: z.ZodNullable<z.ZodString>;
1107
+ createdAt: z.ZodString;
1108
+ seqNum: z.ZodString;
1109
+ patchCount: z.ZodNumber;
1110
+ hasArchive: z.ZodBoolean;
1111
+ }, z.core.$strip>>;
1112
+ nextCursor: z.ZodNullable<z.ZodString>;
1113
+ }, z.core.$strip>;
1114
+ }, z.core.$strip>]>;
1115
+ };
1116
+ };
1117
+ /**
1118
+ * One commit, reconstructed. IMMUTABLE for a given sha - it says nothing
1119
+ * about the current source or schema, which is what lets it be cached
1120
+ * forever and what makes comparing many commits cheap.
1121
+ */
1122
+ "/history/commit": {
1123
+ GET: {
1124
+ req: {
1125
+ query: {
1126
+ commit_sha: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>;
1127
+ };
1128
+ cookies: {
1129
+ val_session: z.ZodOptional<z.ZodString>;
1130
+ };
1131
+ };
1132
+ res: z.ZodUnion<readonly [z.ZodObject<{
1133
+ status: z.ZodLiteral<401>;
1134
+ json: z.ZodObject<{
1135
+ message: z.ZodString;
1136
+ }, z.core.$strip>;
1137
+ }, z.core.$strip>, z.ZodObject<{
1138
+ status: z.ZodLiteral<404>;
1139
+ json: z.ZodObject<{
1140
+ message: z.ZodString;
1141
+ }, z.core.$strip>;
1142
+ }, z.core.$strip>, z.ZodObject<{
1143
+ status: z.ZodLiteral<400>;
1144
+ json: z.ZodObject<{
1145
+ message: z.ZodString;
1146
+ }, z.core.$strip>;
1147
+ }, z.core.$strip>, z.ZodObject<{
1148
+ status: z.ZodLiteral<500>;
1149
+ json: z.ZodIntersection<z.ZodObject<{
1150
+ message: z.ZodString;
1151
+ }, z.core.$strip>, z.ZodObject<{
1152
+ kind: z.ZodOptional<z.ZodString>;
1153
+ }, z.core.$strip>>;
1154
+ }, z.core.$strip>, z.ZodObject<{
1155
+ status: z.ZodLiteral<200>;
1156
+ json: z.ZodObject<{
1157
+ commit: z.ZodObject<{
1158
+ commitSha: z.ZodString;
1159
+ parentCommitSha: z.ZodString;
1160
+ clientCommitSha: z.ZodString;
1161
+ branch: z.ZodString;
1162
+ createdBranch: z.ZodNullable<z.ZodString>;
1163
+ creator: z.ZodNullable<z.ZodString>;
1164
+ message: z.ZodNullable<z.ZodString>;
1165
+ createdAt: z.ZodString;
1166
+ seqNum: z.ZodString;
1167
+ patchCount: z.ZodNumber;
1168
+ hasArchive: z.ZodBoolean;
1169
+ }, z.core.$strip>;
1170
+ modules: z.ZodRecord<z.ZodString, z.ZodObject<{
1171
+ source: z.ZodNullable<z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>>;
1172
+ schema: z.ZodNullable<z.ZodType<import("@valbuild/core").SerializedSchema, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").SerializedSchema, unknown>>>;
1173
+ patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
1174
+ changedPaths: z.ZodArray<z.ZodString>;
1175
+ failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1176
+ kind: z.ZodLiteral<"commit-not-found">;
1177
+ commitSha: z.ZodString;
1178
+ }, z.core.$strip>, z.ZodObject<{
1179
+ kind: z.ZodLiteral<"archive-unreadable">;
1180
+ commitSha: z.ZodString;
1181
+ message: z.ZodString;
1182
+ }, z.core.$strip>, z.ZodObject<{
1183
+ kind: z.ZodLiteral<"source-unavailable">;
1184
+ moduleFilePath: z.ZodString;
1185
+ }, z.core.$strip>, z.ZodObject<{
1186
+ kind: z.ZodLiteral<"schema-unreadable">;
1187
+ moduleFilePath: z.ZodString;
1188
+ message: z.ZodString;
1189
+ }, z.core.$strip>, z.ZodObject<{
1190
+ kind: z.ZodLiteral<"file-unavailable">;
1191
+ gitPath: z.ZodString;
1192
+ message: z.ZodString;
1193
+ }, z.core.$strip>, z.ZodObject<{
1194
+ kind: z.ZodLiteral<"not-supported-in-fs-mode">;
1195
+ }, z.core.$strip>, z.ZodObject<{
1196
+ kind: z.ZodLiteral<"transport">;
1197
+ message: z.ZodString;
1198
+ }, z.core.$strip>], "kind">>;
1199
+ }, z.core.$strip>>;
1200
+ patches: z.ZodArray<z.ZodObject<{
1201
+ patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
1202
+ moduleFilePath: z.ZodString;
1203
+ patch: z.ZodUnknown;
1204
+ authorId: z.ZodNullable<z.ZodString>;
1205
+ createdAt: z.ZodString;
1206
+ baseSha: z.ZodString;
1207
+ coreVersion: z.ZodString;
1208
+ }, z.core.$strip>>;
1209
+ jsonEntries: z.ZodRecord<z.ZodString, z.ZodUnknown>;
1210
+ binaryFiles: z.ZodArray<z.ZodObject<{
1211
+ gitPath: z.ZodString;
1212
+ change: z.ZodUnion<readonly [z.ZodLiteral<"added">, z.ZodLiteral<"modified">, z.ZodLiteral<"deleted">]>;
1213
+ remote: z.ZodBoolean;
1214
+ url: z.ZodString;
1215
+ }, z.core.$strip>>;
1216
+ warnings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1217
+ kind: z.ZodLiteral<"commit-not-found">;
1218
+ commitSha: z.ZodString;
1219
+ }, z.core.$strip>, z.ZodObject<{
1220
+ kind: z.ZodLiteral<"archive-unreadable">;
1221
+ commitSha: z.ZodString;
1222
+ message: z.ZodString;
1223
+ }, z.core.$strip>, z.ZodObject<{
1224
+ kind: z.ZodLiteral<"source-unavailable">;
1225
+ moduleFilePath: z.ZodString;
1226
+ }, z.core.$strip>, z.ZodObject<{
1227
+ kind: z.ZodLiteral<"schema-unreadable">;
1228
+ moduleFilePath: z.ZodString;
1229
+ message: z.ZodString;
1230
+ }, z.core.$strip>, z.ZodObject<{
1231
+ kind: z.ZodLiteral<"file-unavailable">;
1232
+ gitPath: z.ZodString;
1233
+ message: z.ZodString;
1234
+ }, z.core.$strip>, z.ZodObject<{
1235
+ kind: z.ZodLiteral<"not-supported-in-fs-mode">;
1236
+ }, z.core.$strip>, z.ZodObject<{
1237
+ kind: z.ZodLiteral<"transport">;
1238
+ message: z.ZodString;
1239
+ }, z.core.$strip>], "kind">>;
1240
+ }, z.core.$strip>;
1241
+ }, z.core.$strip>]>;
1242
+ };
1243
+ };
1244
+ /**
1245
+ * ONE module, as of a commit — including a commit that did not change it.
1246
+ *
1247
+ * `/history/commit` covers what a commit changed, which is the narrow case:
1248
+ * navigate the history pane to anything else and there would be nothing to
1249
+ * show. This answers "how did this module look at that point", which is the
1250
+ * question someone comparing two panes is actually asking. Immutable for the
1251
+ * same reason: what a commit left behind cannot change.
1252
+ */
1253
+ "/history/module": {
1254
+ GET: {
1255
+ req: {
1256
+ query: {
1257
+ commit_sha: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>;
1258
+ module_file_path: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>;
1259
+ };
1260
+ cookies: {
1261
+ val_session: z.ZodOptional<z.ZodString>;
1262
+ };
1263
+ };
1264
+ res: z.ZodUnion<readonly [z.ZodObject<{
1265
+ status: z.ZodLiteral<401>;
1266
+ json: z.ZodObject<{
1267
+ message: z.ZodString;
1268
+ }, z.core.$strip>;
1269
+ }, z.core.$strip>, z.ZodObject<{
1270
+ status: z.ZodLiteral<404>;
1271
+ json: z.ZodObject<{
1272
+ message: z.ZodString;
1273
+ }, z.core.$strip>;
1274
+ }, z.core.$strip>, z.ZodObject<{
1275
+ status: z.ZodLiteral<400>;
1276
+ json: z.ZodObject<{
1277
+ message: z.ZodString;
1278
+ }, z.core.$strip>;
1279
+ }, z.core.$strip>, z.ZodObject<{
1280
+ status: z.ZodLiteral<500>;
1281
+ json: z.ZodIntersection<z.ZodObject<{
1282
+ message: z.ZodString;
1283
+ }, z.core.$strip>, z.ZodObject<{
1284
+ kind: z.ZodOptional<z.ZodString>;
1285
+ }, z.core.$strip>>;
1286
+ }, z.core.$strip>, z.ZodObject<{
1287
+ status: z.ZodLiteral<200>;
1288
+ json: z.ZodObject<{
1289
+ moduleFilePath: z.ZodString;
1290
+ module: z.ZodNullable<z.ZodObject<{
1291
+ source: z.ZodNullable<z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>>;
1292
+ schema: z.ZodNullable<z.ZodType<import("@valbuild/core").SerializedSchema, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").SerializedSchema, unknown>>>;
1293
+ patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
1294
+ changedPaths: z.ZodArray<z.ZodString>;
1295
+ failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1296
+ kind: z.ZodLiteral<"commit-not-found">;
1297
+ commitSha: z.ZodString;
1298
+ }, z.core.$strip>, z.ZodObject<{
1299
+ kind: z.ZodLiteral<"archive-unreadable">;
1300
+ commitSha: z.ZodString;
1301
+ message: z.ZodString;
1302
+ }, z.core.$strip>, z.ZodObject<{
1303
+ kind: z.ZodLiteral<"source-unavailable">;
1304
+ moduleFilePath: z.ZodString;
1305
+ }, z.core.$strip>, z.ZodObject<{
1306
+ kind: z.ZodLiteral<"schema-unreadable">;
1307
+ moduleFilePath: z.ZodString;
1308
+ message: z.ZodString;
1309
+ }, z.core.$strip>, z.ZodObject<{
1310
+ kind: z.ZodLiteral<"file-unavailable">;
1311
+ gitPath: z.ZodString;
1312
+ message: z.ZodString;
1313
+ }, z.core.$strip>, z.ZodObject<{
1314
+ kind: z.ZodLiteral<"not-supported-in-fs-mode">;
1315
+ }, z.core.$strip>, z.ZodObject<{
1316
+ kind: z.ZodLiteral<"transport">;
1317
+ message: z.ZodString;
1318
+ }, z.core.$strip>], "kind">>;
1319
+ }, z.core.$strip>>;
1320
+ }, z.core.$strip>;
1321
+ }, z.core.$strip>]>;
1322
+ };
1323
+ };
1324
+ /**
1325
+ * One file as it was at one commit.
1326
+ *
1327
+ * The lazy half: `/history/commit` NAMES a commit's binary files and this is
1328
+ * where their bytes come from, so nothing is fetched until an `<img>`
1329
+ * actually mounts. A file at a fixed commit cannot change, so the response is
1330
+ * immutable and the browser's own cache handles flipping between commits.
1331
+ */
1332
+ "/history/files": {
1333
+ GET: {
1334
+ req: {
1335
+ query: {
1336
+ commit_sha: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>;
1337
+ path: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>;
1338
+ remote: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>>;
1339
+ };
1340
+ };
1341
+ res: z.ZodUnion<readonly [z.ZodObject<{
1342
+ status: z.ZodLiteral<401>;
1343
+ json: z.ZodObject<{
1344
+ message: z.ZodString;
1345
+ }, z.core.$strip>;
1346
+ }, z.core.$strip>, z.ZodObject<{
1347
+ status: z.ZodLiteral<404>;
1348
+ json: z.ZodObject<{
1349
+ message: z.ZodString;
1350
+ }, z.core.$strip>;
1351
+ }, z.core.$strip>, z.ZodObject<{
1352
+ status: z.ZodLiteral<400>;
1353
+ json: z.ZodObject<{
1354
+ message: z.ZodString;
1355
+ }, z.core.$strip>;
1356
+ }, z.core.$strip>, z.ZodObject<{
1357
+ status: z.ZodLiteral<200>;
1358
+ body: z.ZodCustom<import("node:stream/web").ReadableStream<unknown>, import("node:stream/web").ReadableStream<unknown>>;
1359
+ }, z.core.$strip>]>;
1360
+ };
1361
+ };
929
1362
  "/files": {
930
1363
  GET: {
931
1364
  req: {
@@ -965,6 +1398,15 @@ export declare const Api: {
965
1398
  offset: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>, z.ZodTransform<number, string>>>;
966
1399
  limit: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>, z.ZodTransform<number, string>>>;
967
1400
  apply_patches: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
1401
+ /**
1402
+ * The caller's own staged work, and nobody else's.
1403
+ *
1404
+ * The same flag `/sources/~` takes, and for the same reason — a draft
1405
+ * page renders both, so a scoped module beside an unscoped
1406
+ * `jsonValues` entry showed one person's view and everybody's pending
1407
+ * work on the same screen.
1408
+ */
1409
+ own_patch_groups_only: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>> & z.ZodType<"true" | "false", string[], z.core.$ZodTypeInternals<"true" | "false", string[]>>, z.ZodTransform<boolean, "true" | "false">>>;
968
1410
  };
969
1411
  cookies: {
970
1412
  val_session: z.ZodOptional<z.ZodString>;