@coffre/core 0.1.18 → 0.2.0

package/dist/pages.d.ts

@@ -0,0 +1,19 @@
+//#region src/pages.d.ts
+/**
+ * How the visitor has coffre's pages drawn: the theme they chose, `system`
+ * when none, and whether the sidebar is folded.
+ */
+export type Preferences = {
+  theme: 'system' | 'light' | 'dark';
+  sidebar: 'expanded' | 'collapsed';
+};
+/** The cookies that hold them. */
+export declare const PREFERENCE_COOKIES: {
+  readonly theme: "coffre-theme";
+  readonly sidebar: "coffre-sidebar";
+};
+/** The preferences in a `Cookie` header, or in `document.cookie`, which reads the same. */
+export declare function preferencesIn(cookies: string | null): Preferences;
+/** What a server route or a page says, rendered without coffre's request middleware. */
+export declare const NO_MIDDLEWARE: string;
+//#endregion

package/dist/pages.js

@@ -0,0 +1,24 @@
+//#region src/pages.ts
+/** The cookies that hold them. */
+const PREFERENCE_COOKIES = {
+	theme: "coffre-theme",
+	sidebar: "coffre-sidebar"
+};
+/** The preferences in a `Cookie` header, or in `document.cookie`, which reads the same. */
+function preferencesIn(cookies) {
+	const value = (name) => {
+		for (const pair of (cookies ?? "").split(";")) {
+			const at = pair.indexOf("=");
+			if (at !== -1 && pair.slice(0, at).trim() === name) return pair.slice(at + 1).trim();
+		}
+	};
+	const theme = value(PREFERENCE_COOKIES.theme);
+	return {
+		theme: theme === "light" || theme === "dark" ? theme : "system",
+		sidebar: value(PREFERENCE_COOKIES.sidebar) === "collapsed" ? "collapsed" : "expanded"
+	};
+}
+/** What a server route or a page says, rendered without coffre's request middleware. */
+const NO_MIDDLEWARE = "coffre's request middleware is not installed: add coffreMiddleware, from @coffre/server/start, to createStart(() => ({ requestMiddleware: [coffreMiddleware] })) in the app's src/start.ts";
+//#endregion
+export { NO_MIDDLEWARE, PREFERENCE_COOKIES, preferencesIn };

package/dist/schemas.d.ts

@@ -9,8 +9,8 @@ export declare const principalType: z.ZodEnum<{
 }>;
 export declare const principalId: z.ZodString;
 export declare const instanceRole: z.ZodEnum<{
-  user: "user";
   owner: "owner";
+  user: "user";
 }>;
 export declare const grantId: z.ZodString;
 export declare const emailAddress: z.ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffre/core",
-  "version": "0.1.18",
+  "version": "0.2.0",
   "description": "What coffre's packages share: roles, envelopes, identity, the audit chain and the vault's contract.",
   "license": "MIT",
   "repository": {
@@ -62,6 +62,11 @@
       "types": "./dist/workloads.d.ts",
       "default": "./dist/workloads.js"
     },
+    "./pages": {
+      "coffre:source": "./src/pages.ts",
+      "types": "./dist/pages.d.ts",
+      "default": "./dist/pages.js"
+    },
     "./package.json": "./package.json"
   },
   "dependencies": {
@@ -74,7 +79,7 @@
     "@types/node": "26.1.1",
     "tsdown": "0.23.0",
     "typescript": "5.9.3",
-    "@coffre/conformance": "0.1.18"
+    "@coffre/conformance": "0.2.0"
   },
   "scripts": {
     "build": "tsdown",

package/src/pages.ts

@@ -0,0 +1,34 @@
+// What coffre's server and its pages agree on outside the API: the
+// visitor's preferences, which the server reads from a request's cookies
+// and the browser from its own, to draw the same page; and what either says
+// when coffre's request middleware is missing.
+
+/**
+ * How the visitor has coffre's pages drawn: the theme they chose, `system`
+ * when none, and whether the sidebar is folded.
+ */
+export type Preferences = { theme: 'system' | 'light' | 'dark'; sidebar: 'expanded' | 'collapsed' };
+
+/** The cookies that hold them. */
+export const PREFERENCE_COOKIES = { theme: 'coffre-theme', sidebar: 'coffre-sidebar' } as const;
+
+/** The preferences in a `Cookie` header, or in `document.cookie`, which reads the same. */
+export function preferencesIn(cookies: string | null): Preferences {
+  const value = (name: string) => {
+    for (const pair of (cookies ?? '').split(';')) {
+      const at = pair.indexOf('=');
+      if (at !== -1 && pair.slice(0, at).trim() === name) return pair.slice(at + 1).trim();
+    }
+    return undefined;
+  };
+  const theme = value(PREFERENCE_COOKIES.theme);
+  return {
+    theme: theme === 'light' || theme === 'dark' ? theme : 'system',
+    sidebar: value(PREFERENCE_COOKIES.sidebar) === 'collapsed' ? 'collapsed' : 'expanded',
+  };
+}
+
+/** What a server route or a page says, rendered without coffre's request middleware. */
+export const NO_MIDDLEWARE =
+  "coffre's request middleware is not installed: add coffreMiddleware, from @coffre/server/start, to " +
+  "createStart(() => ({ requestMiddleware: [coffreMiddleware] })) in the app's src/start.ts";