@valbuild/shared 0.141.0 → 0.142.0

package/dist/declarations/src/internal/server/types.d.ts

@@ -1,7 +1,7 @@
 import { Json } from "@valbuild/core";
-export declare const VAL_SESSION_COOKIE: "val_session";
-export declare const VAL_STATE_COOKIE: "val_state";
-export declare const VAL_ENABLE_COOKIE_NAME: "val_enable";
+export declare const VAL_SESSION_COOKIE: any;
+export declare const VAL_STATE_COOKIE: any;
+export declare const VAL_ENABLE_COOKIE_NAME: any;
 export type VAL_SESSION_COOKIE = typeof VAL_SESSION_COOKIE;
 export type VAL_STATE_COOKIE = typeof VAL_STATE_COOKIE;
 export type VAL_ENABLE_COOKIE_NAME = typeof VAL_ENABLE_COOKIE_NAME;

package/dist/declarations/src/internal/zod/History.d.ts

@@ -64,9 +64,9 @@ export declare const BinaryFileRef: z.ZodObject<{
 }, z.core.$strip>;
 export type BinaryFileRef = z.infer<typeof BinaryFileRef>;
 export declare const HistoricalModule: z.ZodObject<{
-    source: z.ZodNullable<z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>>;
-    schema: z.ZodNullable<z.ZodType<import("@valbuild/core").SerializedSchema, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").SerializedSchema, unknown>>>;
-    patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
+    source: z.ZodNullable<z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>>;
+    schema: z.ZodNullable<z.ZodType<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, unknown>>>;
+    patchIds: z.ZodArray<z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>>;
     changedPaths: z.ZodArray<z.ZodString>;
     failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"commit-not-found">;
@@ -109,9 +109,9 @@ export declare const HistoricalPatchSet: z.ZodObject<{
         hasArchive: z.ZodBoolean;
     }, z.core.$strip>;
     modules: z.ZodRecord<z.ZodString, z.ZodObject<{
-        source: z.ZodNullable<z.ZodType<import("@valbuild/core/patch").JSONValue, unknown, z.core.$ZodTypeInternals<import("@valbuild/core/patch").JSONValue, unknown>>>;
-        schema: z.ZodNullable<z.ZodType<import("@valbuild/core").SerializedSchema, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").SerializedSchema, unknown>>>;
-        patchIds: z.ZodArray<z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>>;
+        source: z.ZodNullable<z.ZodType<JSONValueT, unknown, z.core.$ZodTypeInternals<JSONValueT, unknown>>>;
+        schema: z.ZodNullable<z.ZodType<SerializedSchemaT, unknown, z.core.$ZodTypeInternals<SerializedSchemaT, unknown>>>;
+        patchIds: z.ZodArray<z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>>;
         changedPaths: z.ZodArray<z.ZodString>;
         failures: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"commit-not-found">;
@@ -139,7 +139,7 @@ export declare const HistoricalPatchSet: z.ZodObject<{
         }, z.core.$strip>], "kind">>;
     }, z.core.$strip>>;
     patches: z.ZodArray<z.ZodObject<{
-        patchId: z.ZodString & z.ZodType<import("@valbuild/core").PatchId, string, z.core.$ZodTypeInternals<import("@valbuild/core").PatchId, string>>;
+        patchId: z.ZodString & z.ZodType<PatchIdT, string, z.core.$ZodTypeInternals<PatchIdT, string>>;
         moduleFilePath: z.ZodString;
         patch: z.ZodUnknown;
         authorId: z.ZodNullable<z.ZodString>;

package/dist/declarations/src/internal/zod/Patch.d.ts

@@ -1,5 +1,4 @@
 import type { JSONValue as JSONValueT, PatchJSON as PatchJSONT, PatchBlock as PatchBlockT, ParentRef as ParentRefT } from "@valbuild/core/patch";
-import type { PatchId as PatchIdT } from "@valbuild/core";
 import { z } from "zod";
 /**
  * JSON, recursively — the shape of a Source over the wire.

package/dist/declarations/src/internal/zod/SerializedSchema.d.ts

@@ -66,25 +66,7 @@ export declare const ColorOptions: z.ZodObject<{
 export declare const SerializedColorSchema: z.ZodType<SerializedColorSchemaT>;
 export declare const CodeOptions: z.ZodObject<{
     language: z.ZodOptional<z.ZodEnum<{
-        json: "json";
-        typescript: "typescript";
-        javascript: "javascript";
-        javascriptreact: "javascriptreact";
-        typescriptreact: "typescriptreact";
-        java: "java";
-        html: "html";
-        css: "css";
-        xml: "xml";
-        markdown: "markdown";
-        sql: "sql";
-        python: "python";
-        rust: "rust";
-        php: "php";
-        go: "go";
-        cpp: "cpp";
-        sass: "sass";
-        vue: "vue";
-        angular: "angular";
+        [x: string]: any;
     }>>;
 }, z.core.$strip>;
 export declare const SerializedCodeSchema: z.ZodType<SerializedCodeSchemaT>;
@@ -101,7 +83,7 @@ export declare const SerializedSettingsSchema: z.ZodType<SerializedSettingsSchem
  */
 export declare const SerializedValViewSchema: z.ZodObject<{
     type: z.ZodLiteral<"view">;
-    moduleFilePath: z.ZodType<import("@valbuild/core").ModuleFilePath, unknown, z.core.$ZodTypeInternals<import("@valbuild/core").ModuleFilePath, unknown>>;
+    moduleFilePath: z.ZodType<ModuleFilePathT, unknown, z.core.$ZodTypeInternals<ModuleFilePathT, unknown>>;
     opt: z.ZodLiteral<false>;
     readonly: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;

package/internal/dist/valbuild-shared-internal.cjs.dev.js

@@ -1602,6 +1602,14 @@ var PublishRefusal = zod.z.object({
   message: zod.z.string()
 });
 
+/** See `proposal` on `/stat`. */
+var StatProposal = zod.z.object({
+  /** Twenty hex characters, the hash of what it was made from. */
+  name: zod.z.string(),
+  /** `val/p/<name>`. */
+  branch: zod.z.string()
+});
+
 /**
  * A patch group: the set of patches one user has chosen to publish.
  *
@@ -2032,7 +2040,13 @@ var Api = {
            * connected ones by commit.
            */
           publishJobs: zod.z["boolean"]().optional(),
-          publishRefusal: PublishRefusal.optional()
+          publishRefusal: PublishRefusal.optional(),
+          /**
+           * The proposal this server runs at the address of, or absent
+           * on the site. What the Studio's switcher says it is in, and
+           * where its Save goes (valbuild/home `docs/proposals.md`).
+           */
+          proposal: StatProposal.optional()
         }), zod.z.object({
           type: zod.z.literal("use-websocket"),
           url: zod.z.string(),
@@ -2150,7 +2164,13 @@ var Api = {
            * connected ones by commit.
            */
           publishJobs: zod.z["boolean"]().optional(),
-          publishRefusal: PublishRefusal.optional()
+          publishRefusal: PublishRefusal.optional(),
+          /**
+           * The proposal this server runs at the address of, or absent
+           * on the site. What the Studio's switcher says it is in, and
+           * where its Save goes (valbuild/home `docs/proposals.md`).
+           */
+          proposal: StatProposal.optional()
         })])
       })])
     }
@@ -2236,6 +2256,60 @@ var Api = {
       })
     }
   },
+  /**
+   * The content service's proposals API, reached through this deployment:
+   * list, open, read, rename, close, reopen and retry a setup
+   * (valbuild/home `docs/proposals.md`, Flow B).
+   *
+   * The same arrangement as `/publish-api`, for the same reasons: the browser
+   * holds a session for this origin and no credential content accepts, so
+   * this server checks the session, sends the project's key with the person's
+   * profile id beside it -- a proposal is opened, renamed and closed by
+   * somebody -- and carries content's status and body back unread. The sub-path
+   * is content's, after `/proposals`; `ValOpsHttp.proposalsApi` holds the
+   * allow list. A save is not here: it is `/save`, which a proposal's server
+   * sends to the proposal's own route.
+   */
+  "/proposals-api": {
+    GET: {
+      req: {
+        path: zod.z.string().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    },
+    POST: {
+      req: {
+        path: zod.z.string().optional(),
+        body: zod.z.unknown().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    },
+    PATCH: {
+      req: {
+        path: zod.z.string().optional(),
+        body: zod.z.unknown().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    }
+  },
   "/upload/patches": {
     POST: {
       req: {
@@ -2765,6 +2839,32 @@ var Api = {
       })])
     }
   },
+  /**
+   * In a proposal: the SITE's Source for every module the proposal has saved,
+   * as the build it is based on has it. What Compare with the site diffs the
+   * proposal against -- saved and unsaved alike -- because the Studio's own
+   * base Source there is the proposal's last save. 404 anywhere that is not a
+   * proposal's address. valbuild/home `docs/proposals.md`.
+   */
+  "/proposal-site-sources": {
+    GET: {
+      req: {
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, zod.z.object({
+        status: zod.z.literal(404),
+        json: GenericError
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          /** By module file path. A module absent here is the same in both. */
+          modules: zod.z.record(zod.z.string(), zod.z.unknown())
+        })
+      })])
+    }
+  },
   "/profiles": {
     GET: {
       req: {

package/internal/dist/valbuild-shared-internal.cjs.prod.js

@@ -1602,6 +1602,14 @@ var PublishRefusal = zod.z.object({
   message: zod.z.string()
 });
 
+/** See `proposal` on `/stat`. */
+var StatProposal = zod.z.object({
+  /** Twenty hex characters, the hash of what it was made from. */
+  name: zod.z.string(),
+  /** `val/p/<name>`. */
+  branch: zod.z.string()
+});
+
 /**
  * A patch group: the set of patches one user has chosen to publish.
  *
@@ -2032,7 +2040,13 @@ var Api = {
            * connected ones by commit.
            */
           publishJobs: zod.z["boolean"]().optional(),
-          publishRefusal: PublishRefusal.optional()
+          publishRefusal: PublishRefusal.optional(),
+          /**
+           * The proposal this server runs at the address of, or absent
+           * on the site. What the Studio's switcher says it is in, and
+           * where its Save goes (valbuild/home `docs/proposals.md`).
+           */
+          proposal: StatProposal.optional()
         }), zod.z.object({
           type: zod.z.literal("use-websocket"),
           url: zod.z.string(),
@@ -2150,7 +2164,13 @@ var Api = {
            * connected ones by commit.
            */
           publishJobs: zod.z["boolean"]().optional(),
-          publishRefusal: PublishRefusal.optional()
+          publishRefusal: PublishRefusal.optional(),
+          /**
+           * The proposal this server runs at the address of, or absent
+           * on the site. What the Studio's switcher says it is in, and
+           * where its Save goes (valbuild/home `docs/proposals.md`).
+           */
+          proposal: StatProposal.optional()
         })])
       })])
     }
@@ -2236,6 +2256,60 @@ var Api = {
       })
     }
   },
+  /**
+   * The content service's proposals API, reached through this deployment:
+   * list, open, read, rename, close, reopen and retry a setup
+   * (valbuild/home `docs/proposals.md`, Flow B).
+   *
+   * The same arrangement as `/publish-api`, for the same reasons: the browser
+   * holds a session for this origin and no credential content accepts, so
+   * this server checks the session, sends the project's key with the person's
+   * profile id beside it -- a proposal is opened, renamed and closed by
+   * somebody -- and carries content's status and body back unread. The sub-path
+   * is content's, after `/proposals`; `ValOpsHttp.proposalsApi` holds the
+   * allow list. A save is not here: it is `/save`, which a proposal's server
+   * sends to the proposal's own route.
+   */
+  "/proposals-api": {
+    GET: {
+      req: {
+        path: zod.z.string().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    },
+    POST: {
+      req: {
+        path: zod.z.string().optional(),
+        body: zod.z.unknown().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    },
+    PATCH: {
+      req: {
+        path: zod.z.string().optional(),
+        body: zod.z.unknown().optional(),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.object({
+        status: zod.z.number(),
+        json: zod.z.unknown()
+      })
+    }
+  },
   "/upload/patches": {
     POST: {
       req: {
@@ -2765,6 +2839,32 @@ var Api = {
       })])
     }
   },
+  /**
+   * In a proposal: the SITE's Source for every module the proposal has saved,
+   * as the build it is based on has it. What Compare with the site diffs the
+   * proposal against -- saved and unsaved alike -- because the Studio's own
+   * base Source there is the proposal's last save. 404 anywhere that is not a
+   * proposal's address. valbuild/home `docs/proposals.md`.
+   */
+  "/proposal-site-sources": {
+    GET: {
+      req: {
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, zod.z.object({
+        status: zod.z.literal(404),
+        json: GenericError
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          /** By module file path. A module absent here is the same in both. */
+          modules: zod.z.record(zod.z.string(), zod.z.unknown())
+        })
+      })])
+    }
+  },
   "/profiles": {
     GET: {
       req: {

package/internal/dist/valbuild-shared-internal.esm.js

@@ -1595,6 +1595,14 @@ var PublishRefusal = z.object({
   message: z.string()
 });
 
+/** See `proposal` on `/stat`. */
+var StatProposal = z.object({
+  /** Twenty hex characters, the hash of what it was made from. */
+  name: z.string(),
+  /** `val/p/<name>`. */
+  branch: z.string()
+});
+
 /**
  * A patch group: the set of patches one user has chosen to publish.
  *
@@ -2025,7 +2033,13 @@ var Api = {
            * connected ones by commit.
            */
           publishJobs: z["boolean"]().optional(),
-          publishRefusal: PublishRefusal.optional()
+          publishRefusal: PublishRefusal.optional(),
+          /**
+           * The proposal this server runs at the address of, or absent
+           * on the site. What the Studio's switcher says it is in, and
+           * where its Save goes (valbuild/home `docs/proposals.md`).
+           */
+          proposal: StatProposal.optional()
         }), z.object({
           type: z.literal("use-websocket"),
           url: z.string(),
@@ -2143,7 +2157,13 @@ var Api = {
            * connected ones by commit.
            */
           publishJobs: z["boolean"]().optional(),
-          publishRefusal: PublishRefusal.optional()
+          publishRefusal: PublishRefusal.optional(),
+          /**
+           * The proposal this server runs at the address of, or absent
+           * on the site. What the Studio's switcher says it is in, and
+           * where its Save goes (valbuild/home `docs/proposals.md`).
+           */
+          proposal: StatProposal.optional()
         })])
       })])
     }
@@ -2229,6 +2249,60 @@ var Api = {
       })
     }
   },
+  /**
+   * The content service's proposals API, reached through this deployment:
+   * list, open, read, rename, close, reopen and retry a setup
+   * (valbuild/home `docs/proposals.md`, Flow B).
+   *
+   * The same arrangement as `/publish-api`, for the same reasons: the browser
+   * holds a session for this origin and no credential content accepts, so
+   * this server checks the session, sends the project's key with the person's
+   * profile id beside it -- a proposal is opened, renamed and closed by
+   * somebody -- and carries content's status and body back unread. The sub-path
+   * is content's, after `/proposals`; `ValOpsHttp.proposalsApi` holds the
+   * allow list. A save is not here: it is `/save`, which a proposal's server
+   * sends to the proposal's own route.
+   */
+  "/proposals-api": {
+    GET: {
+      req: {
+        path: z.string().optional(),
+        cookies: {
+          val_session: z.string().optional()
+        }
+      },
+      res: z.object({
+        status: z.number(),
+        json: z.unknown()
+      })
+    },
+    POST: {
+      req: {
+        path: z.string().optional(),
+        body: z.unknown().optional(),
+        cookies: {
+          val_session: z.string().optional()
+        }
+      },
+      res: z.object({
+        status: z.number(),
+        json: z.unknown()
+      })
+    },
+    PATCH: {
+      req: {
+        path: z.string().optional(),
+        body: z.unknown().optional(),
+        cookies: {
+          val_session: z.string().optional()
+        }
+      },
+      res: z.object({
+        status: z.number(),
+        json: z.unknown()
+      })
+    }
+  },
   "/upload/patches": {
     POST: {
       req: {
@@ -2758,6 +2832,32 @@ var Api = {
       })])
     }
   },
+  /**
+   * In a proposal: the SITE's Source for every module the proposal has saved,
+   * as the build it is based on has it. What Compare with the site diffs the
+   * proposal against -- saved and unsaved alike -- because the Studio's own
+   * base Source there is the proposal's last save. 404 anywhere that is not a
+   * proposal's address. valbuild/home `docs/proposals.md`.
+   */
+  "/proposal-site-sources": {
+    GET: {
+      req: {
+        cookies: {
+          val_session: z.string().optional()
+        }
+      },
+      res: z.union([unauthorizedResponse, z.object({
+        status: z.literal(404),
+        json: GenericError
+      }), z.object({
+        status: z.literal(200),
+        json: z.object({
+          /** By module file path. A module absent here is the same in both. */
+          modules: z.record(z.string(), z.unknown())
+        })
+      })])
+    }
+  },
   "/profiles": {
     GET: {
       req: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.141.0",
+  "version": "0.142.0",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {