@karmaniverous/jeeves-server-core 0.1.5 → 0.1.6

package/dist/src/index.d.ts

@@ -5,5 +5,5 @@
  */
 export { computeDeepShareKey, computeInsiderKey, computeOutsiderKeyWithExpiry, computePathKey, type DeepShareParams, timingSafeEqual, } from './crypto.js';
 export { type EndpointEntry, serverEndpoints } from './endpoints.js';
-export { type AuthMode, authModeSchema, authSchema, DEPRECATED_CONFIG_PROPS, eventConfigSchema, googleAuthSchema, insiderEntrySchema, isScopeName, type JeevesConfig, jeevesConfigSchema, keyEntrySchema, type LoggingConfig, loggingConfigSchema, oauthProviderSchema, oauthSchema, scopesObjectSchema, scopesSchema, } from './schema.js';
+export { type AuthMode, authModeSchema, authSchema, type Branding, brandingSchema, DEFAULT_BRANDING, DEPRECATED_CONFIG_PROPS, emailAuthSchema, eventConfigSchema, googleAuthSchema, insiderEntrySchema, isScopeName, type JeevesConfig, jeevesConfigSchema, keyEntrySchema, type LoggingConfig, loggingConfigSchema, oauthProviderSchema, oauthSchema, scopesObjectSchema, scopesSchema, themeOverridesSchema, } from './schema.js';
 export type { AuthStatusResponse, DriveEntry, ExportCacheClearResponse, ExportLink, FileMutationAction, LinkInfoResponse, OAuthStartRequest, OAuthStartResponse, RotateKeyResponse, ShareForRequest, ShareForResponse, ShareRequest, ShareResponse, } from './types.js';

package/dist/src/index.js

@@ -1,3 +1,3 @@
 export { computeDeepShareKey, computeInsiderKey, computeOutsiderKeyWithExpiry, computePathKey, timingSafeEqual } from './crypto.js';
 export { serverEndpoints } from './endpoints.js';
-export { DEPRECATED_CONFIG_PROPS, authModeSchema, authSchema, eventConfigSchema, googleAuthSchema, insiderEntrySchema, isScopeName, jeevesConfigSchema, keyEntrySchema, loggingConfigSchema, oauthProviderSchema, oauthSchema, scopesObjectSchema, scopesSchema } from './schema.js';
+export { DEFAULT_BRANDING, DEPRECATED_CONFIG_PROPS, authModeSchema, authSchema, brandingSchema, emailAuthSchema, eventConfigSchema, googleAuthSchema, insiderEntrySchema, isScopeName, jeevesConfigSchema, keyEntrySchema, loggingConfigSchema, oauthProviderSchema, oauthSchema, scopesObjectSchema, scopesSchema, themeOverridesSchema } from './schema.js';

package/dist/src/schema.d.ts

@@ -5,23 +5,34 @@ export declare const DEPRECATED_CONFIG_PROPS: readonly ["host", "runnerUrl", "wa
 export declare const authModeSchema: z.ZodEnum<{
     keys: "keys";
     google: "google";
+    email: "email";
 }>;
 /** Google OAuth configuration */
 export declare const googleAuthSchema: z.ZodObject<{
     clientId: z.ZodString;
     clientSecret: z.ZodString;
 }, z.core.$strip>;
+/** Email (magic link) authentication configuration */
+export declare const emailAuthSchema: z.ZodObject<{
+    smtpUrl: z.ZodString;
+    fromAddress: z.ZodEmail;
+}, z.core.$strip>;
 /** Auth configuration */
 export declare const authSchema: z.ZodObject<{
     modes: z.ZodArray<z.ZodEnum<{
         keys: "keys";
         google: "google";
+        email: "email";
     }>>;
     google: z.ZodOptional<z.ZodObject<{
         clientId: z.ZodString;
         clientSecret: z.ZodString;
     }, z.core.$strip>>;
     sessionSecret: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodObject<{
+        smtpUrl: z.ZodString;
+        fromAddress: z.ZodEmail;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /** Event webhook configuration */
 export declare const eventConfigSchema: z.ZodObject<{
@@ -99,6 +110,18 @@ export declare const oauthSchema: z.ZodObject<{
         defaultScopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+/** Theme overrides for light and dark modes */
+export declare const themeOverridesSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+/** Instance branding configuration */
+export declare const brandingSchema: z.ZodObject<{
+    name: z.ZodDefault<z.ZodString>;
+    emoji: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodObject<{
+        light: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        dark: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    emailTemplate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /** Top-level Jeeves Server configuration */
 export declare const jeevesConfigSchema: z.ZodObject<{
     port: z.ZodDefault<z.ZodNumber>;
@@ -107,12 +130,17 @@ export declare const jeevesConfigSchema: z.ZodObject<{
         modes: z.ZodArray<z.ZodEnum<{
             keys: "keys";
             google: "google";
+            email: "email";
         }>>;
         google: z.ZodOptional<z.ZodObject<{
             clientId: z.ZodString;
             clientSecret: z.ZodString;
         }, z.core.$strip>>;
         sessionSecret: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodObject<{
+            smtpUrl: z.ZodString;
+            fromAddress: z.ZodEmail;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     scopes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -172,8 +200,24 @@ export declare const jeevesConfigSchema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     go: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    branding: z.ZodOptional<z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        emoji: z.ZodDefault<z.ZodString>;
+        theme: z.ZodOptional<z.ZodObject<{
+            light: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            dark: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>>;
+        emailTemplate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /** Inferred config type */
 export type JeevesConfig = z.infer<typeof jeevesConfigSchema>;
 /** Auth mode type */
 export type AuthMode = z.infer<typeof authModeSchema>;
+/** Inferred branding type */
+export type Branding = z.infer<typeof brandingSchema>;
+/** Default branding values. Single source of truth for all fallbacks. */
+export declare const DEFAULT_BRANDING: {
+    readonly name: "Jeeves Server";
+    readonly emoji: "🎩";
+};

package/dist/src/schema.js

@@ -9,12 +9,19 @@ const DEPRECATED_CONFIG_PROPS = [
     'metaUrl',
 ];
 /** Supported authentication methods */
-const authModeSchema = z.enum(['google', 'keys']);
+const authModeSchema = z.enum(['google', 'keys', 'email']);
 /** Google OAuth configuration */
 const googleAuthSchema = z.object({
     clientId: z.string().min(1),
     clientSecret: z.string().min(1),
 });
+/** Email (magic link) authentication configuration */
+const emailAuthSchema = z.object({
+    /** SMTP connection string (e.g. smtps://user:pass@smtp.example.com:465) */
+    smtpUrl: z.string().min(1),
+    /** Sender email address for magic link emails */
+    fromAddress: z.email(),
+});
 /** Auth configuration */
 const authSchema = z.object({
     /** Active authentication methods. Order determines priority. */
@@ -25,6 +32,8 @@ const authSchema = z.object({
     google: googleAuthSchema.optional(),
     /** Session cookie signing secret. Required if modes includes "google". */
     sessionSecret: z.string().min(1).optional(),
+    /** Email (magic link) auth config. Required if modes includes "email". */
+    email: emailAuthSchema.optional(),
 });
 /** Event webhook configuration */
 const eventConfigSchema = z.object({
@@ -126,6 +135,24 @@ const oauthSchema = z.object({
     credentialDir: z.string(),
     providers: z.record(z.string(), oauthProviderSchema).default({}),
 });
+/** Theme overrides for light and dark modes */
+const themeOverridesSchema = z.record(z.string(), z.string());
+/** Instance branding configuration */
+const brandingSchema = z.object({
+    /** Instance display name (used in page title, navbar, emails) */
+    name: z.string().default('Jeeves Server'),
+    /** Instance emoji (used as home icon in navbar) */
+    emoji: z.string().default('🎩'),
+    /** CSS variable overrides grouped by theme mode */
+    theme: z
+        .object({
+        light: themeOverridesSchema.optional(),
+        dark: themeOverridesSchema.optional(),
+    })
+        .optional(),
+    /** Handlebars template for magic link emails. Supports {{magicLink}}, {{branding.name}}, {{branding.emoji}} */
+    emailTemplate: z.string().optional(),
+});
 /** Top-level Jeeves Server configuration */
 const jeevesConfigSchema = z
     .object({
@@ -198,6 +225,8 @@ const jeevesConfigSchema = z
         message: 'Target must be a relative path starting with / or an absolute URL',
     }))
         .default({}),
+    /** Instance branding (name, emoji, theme overrides, email template) */
+    branding: brandingSchema.optional(),
 })
     .superRefine((config, ctx) => {
     // Google auth mode requires google config + sessionSecret
@@ -217,6 +246,23 @@ const jeevesConfigSchema = z
             });
         }
     }
+    // Email auth mode requires email config
+    if (config.auth.modes.includes('email')) {
+        if (!config.auth.email) {
+            ctx.addIssue({
+                code: 'custom',
+                message: 'auth.email is required when auth.modes includes "email"',
+                path: ['auth', 'email'],
+            });
+        }
+        if (!config.auth.sessionSecret) {
+            ctx.addIssue({
+                code: 'custom',
+                message: 'auth.sessionSecret is required when auth.modes includes "email"',
+                path: ['auth', 'sessionSecret'],
+            });
+        }
+    }
     // Keys auth mode requires at least one key
     if (config.auth.modes.includes('keys') &&
         Object.keys(config.keys).length === 0) {
@@ -266,5 +312,10 @@ const jeevesConfigSchema = z
     if (outsiderRefs.length > 0)
         validateRefs(outsiderRefs, ['outsiderPolicy']);
 });
+/** Default branding values. Single source of truth for all fallbacks. */
+const DEFAULT_BRANDING = {
+    name: 'Jeeves Server',
+    emoji: '🎩',
+};
 
-export { DEPRECATED_CONFIG_PROPS, authModeSchema, authSchema, eventConfigSchema, googleAuthSchema, insiderEntrySchema, isScopeName, jeevesConfigSchema, keyEntrySchema, loggingConfigSchema, oauthProviderSchema, oauthSchema, scopesObjectSchema, scopesSchema };
+export { DEFAULT_BRANDING, DEPRECATED_CONFIG_PROPS, authModeSchema, authSchema, brandingSchema, emailAuthSchema, eventConfigSchema, googleAuthSchema, insiderEntrySchema, isScopeName, jeevesConfigSchema, keyEntrySchema, loggingConfigSchema, oauthProviderSchema, oauthSchema, scopesObjectSchema, scopesSchema, themeOverridesSchema };

package/package.json

@@ -86,5 +86,5 @@
   },
   "type": "module",
   "types": "dist/src/index.d.ts",
-  "version": "0.1.5"
+  "version": "0.1.6"
 }