@ultimat3/core 28.0.0 → 29.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/core",
-  "version": "28.0.0",
+  "version": "29.0.0",
   "description": "Ultimate's foundation: errors, context, env, config, clock, ids, logging, telemetry, lifecycle",
   "license": "MIT",
   "type": "module",
@@ -30,13 +30,13 @@
     "LICENSE"
   ],
   "engines": {
-    "bun": ">=1.4.3"
+    "bun": ">=1.4.4"
   },
   "scripts": {
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/schema": "28.0.0"
+    "@ultimat3/schema": "29.0.0"
   }
 }

package/src/config-keys.ts

@@ -2,6 +2,7 @@
 // at any depth and in any layer, is refused by path with the key it most likely meant. A key that
 // is merged and read by nothing is the switch with no wire, and a typo (`drian`) is the same defect.
 
+import type { JobsConfig } from './config';
 import { BASE_FIX } from './config-fixes';
 import type { MailRetainMimeConfig } from './config-mail';
 import type { NavigationConfig, SpeculationConfig } from './config-navigation';
@@ -14,6 +15,7 @@ import type {
   PwaShortcut,
   PwaVapidConfig,
 } from './config-pwa';
+import type { SiteConfig } from './config-site';
 import { ConfigInvalidError } from './errors';
 import { isJsonObject } from './json-object';
 import { nearestName } from './nearest-name';
@@ -60,6 +62,18 @@ export const SECTION_KEYS: Readonly<Record<string, readonly string[]>> = Object.
   'pwa.shortcuts[].icons[]': keysOf<PwaImage>()(['src', 'sizes', 'type', 'purpose']),
   'pwa.screenshots[]': keysOf<PwaScreenshot>()(['src', 'sizes', 'type', 'formFactor', 'label']),
   'mail.retainMime': keysOf<MailRetainMimeConfig>()(['maxBytes']),
+  jobs: keysOf<JobsConfig>()([
+    'queues',
+    'concurrency',
+    'maxInFlight',
+    'maxAttempts',
+    'backoff',
+    'visibilityTimeoutMs',
+    'doneRetentionMs',
+    'deadRetentionMs',
+    'outboxRetentionMs',
+  ]),
+  site: keysOf<SiteConfig>()(['origin', 'favicon']),
   navigation: keysOf<NavigationConfig>()(['client', 'speculation']),
   'navigation.speculation': keysOf<SpeculationConfig>()(['prefetch', 'exclude']),
 });

package/src/config-site.ts

@@ -11,6 +11,8 @@ import {
 } from './config-sitemap';
 import { describeValue } from './error-render';
 
+export type SiteFavicon = `assets/${string}.svg`;
+
 export interface SiteConfig {
   /**
    * `https://www.example.com` — canonical, `og:url`, hreflang and the sitemap are absolute against
@@ -19,6 +21,11 @@ export interface SiteConfig {
    * host or a preview domain.
    */
   readonly origin: string | null;
+  /**
+   * The app-level SVG favicon, named as a site asset path (`assets/brand/icon.svg`). The renderer
+   * resolves it once at boot into the content-hashed URL every document carries.
+   */
+  readonly favicon?: SiteFavicon | undefined;
 }
 
 /**
@@ -105,7 +112,7 @@ export interface SiteSectionsInput {
 export function mergeSite(layers: readonly SiteSectionsInput[]): SiteSections {
   return {
     site: layered<SiteConfig>(
-      { origin: null },
+      { origin: null, favicon: undefined },
       layers.map((layer) => layer.site),
     ),
     seo: {
@@ -141,6 +148,21 @@ function originIssue(origin: string): string | undefined {
   return undefined;
 }
 
+/** A favicon names one SVG under the app's site assets, never an arbitrary URL or path. */
+function faviconIssue(favicon: string): string | undefined {
+  if (!favicon.startsWith('assets/')) {
+    return `site.favicon "${favicon}" must be a site asset path starting with assets/`;
+  }
+  if (!favicon.endsWith('.svg')) {
+    return `site.favicon "${favicon}" must name an SVG asset`;
+  }
+  const segments = favicon.split('/');
+  if (segments.some((segment) => segment === '' || segment === '.' || segment === '..')) {
+    return `site.favicon "${favicon}" has an empty, "." or ".." segment`;
+  }
+  return undefined;
+}
+
 /** Appends every refusal the two sections earn to `issues`, `config.ts`' one list. */
 export function siteIssues(config: SiteSections, issues: string[]): void {
   const origin = config.site.origin;
@@ -148,6 +170,11 @@ export function siteIssues(config: SiteSections, issues: string[]): void {
     const issue = originIssue(origin);
     if (issue !== undefined) issues.push(issue);
   }
+  const favicon = config.site.favicon;
+  if (favicon !== undefined) {
+    const issue = faviconIssue(favicon);
+    if (issue !== undefined) issues.push(issue);
+  }
   issues.push(...robotsPathIssues('seo.robots.disallow', config.seo.robots.disallow));
   issues.push(...robotsGroupIssues(config.seo.robots.groups ?? []));
   for (const path of config.seo.sitemap.extra as readonly unknown[]) {

package/src/config.ts

@@ -160,6 +160,11 @@ export interface JobsConfig {
    * (`{ banks: 4, 'banks-long': 2 }`, a queue it does not name at `JOBS_CONCURRENCY_DEFAULT`).
    */
   readonly concurrency: JobsConcurrency;
+  /**
+   * Runs one worker process holds at once across every queue it serves (`jobWorker`'s
+   * `maxInFlight`), the per-queue `concurrency` still bounding each under it. Unset: no process cap.
+   */
+  readonly maxInFlight?: number | undefined;
   readonly maxAttempts: number;
   readonly backoff: (typeof JOB_BACKOFFS)[number];
   readonly visibilityTimeoutMs: number;
@@ -283,6 +288,9 @@ function validate(config: AppConfig): void {
   const perKey: readonly (string | undefined)[] = [
     ...config.roles.map((role) => oneOfIssue('roles', role, ROLES)),
     ...jobsConcurrencyIssues(config.jobs.concurrency),
+    config.jobs.maxInFlight === undefined
+      ? undefined
+      : countIssue('jobs.maxInFlight', config.jobs.maxInFlight, 1),
     countIssue('jobs.maxAttempts', config.jobs.maxAttempts, 1),
     countIssue('jobs.visibilityTimeoutMs', config.jobs.visibilityTimeoutMs, 1),
     ...(['doneRetentionMs', 'deadRetentionMs', 'outboxRetentionMs'] as const).map((key) =>

package/src/index.ts

@@ -197,6 +197,7 @@ export type {
   SeoRobotsGroup,
   SeoSitemapConfig,
   SiteConfig,
+  SiteFavicon,
   SitemapLastmod,
   SiteSections,
   SiteSectionsInput,