@protobase/config 0.49.0 → 0.49.2

package/dist/config.d.ts

@@ -1,7 +1,10 @@
 import { AdminOptions, AppIdentity, AssistantOptions, AuthSettings, AuthenticateSettings, EventsOptions, FileProviderSettings, FilesOptions, HistoryOptions, JobDeclaration, MobileConfig, NotificationsOptions, WebhooksOptions } from "@protobase/server";
 //#region src/config.d.ts
-/** `auth`: sign-in (see `AuthSettings`). Its URL, secret and name are the app's (`url`, `secret`, `name`). */
-export type AuthConfig = Omit<AuthSettings, 'baseURL' | 'secret' | 'appName'>;
+/**
+ * `auth`: sign-in (see `AuthSettings`). Its URL, secrets and name are the app's (`url`, `secret`, `previousSecrets`,
+ * `name`), and so are its signing keys' (`signingKeyDays`, `signingKeyGraceDays`).
+ */
+export type AuthConfig = Omit<AuthSettings, 'baseURL' | 'secret' | 'appName' | 'previousSecrets' | 'signingKeyDays' | 'signingKeyGraceDays'>;
 /** `files`: where file fields keep their bytes (see `FilesOptions`), with the providers as data. */
 export type FilesConfig = Omit<FilesOptions, 'providers' | 'sharp'> & {
   /**
@@ -28,6 +31,16 @@ type AppKeys = AppIdentity & {
    * and public forms' bot checks, and encrypts the token signing keys. Default `PROTOBASE_SECRET`; required with sign-in.
    */
   secret?: string;
+  /**
+   * The app's secrets before `secret`, newest first: what they encrypted still decrypts, so the token signing keys keep
+   * signing after the secret changes. Keep one listed while the keys it encrypted sign (`signingKeyDays`), and while
+   * two-factor authenticator apps set up with it are in use. Default `PROTOBASE_PREVIOUS_SECRETS`, comma separated.
+   */
+  previousSecrets?: string[];
+  /** Days a token signing key signs before a new one takes over. Default 30. */
+  signingKeyDays?: number;
+  /** Days a replaced signing key still verifies the tokens it signed. Default 7, at least 1. */
+  signingKeyGraceDays?: number;
   /** The language of the admin app's built-in screens and of its numbers and dates, for every user: `'en'` or `'nl'`; unset, each user's browser's. */
   locale?: NonNullable<AdminOptions['locale']>;
   /** The time zone the jobs' schedules are read in unless a job names its own, such as `Europe/Amsterdam`. Default `UTC`. */

package/dist/index.d.ts

@@ -1,10 +1,15 @@
 import { AuthConfig, ConfigCommand, ConfigEnv, ConfigFunction, ConfigInput, FilesConfig, ProtobaseConfig } from "./config.js";
+import { JobDeclaration } from "@protobase/server";
 //#region src/index.d.ts
+type WithJobs<Jobs> = Omit<ProtobaseConfig, 'jobs'> & {
+  jobs?: Jobs;
+};
 /**
  * Types `protobase.config.ts`'s default export and returns it as it is: a config, or a function of the command and the
- * environment that returns one, at once or as a promise.
+ * environment that returns one, at once or as a promise. Its type keeps the jobs as written, so
+ * `EnqueueJob<typeof config>` of `@protobase/server` knows their names and arguments.
  */
-export declare function defineConfig(config: ProtobaseConfig): ProtobaseConfig;
-export declare function defineConfig(config: ConfigFunction): ConfigFunction;
+export declare function defineConfig<const Jobs extends Record<string, JobDeclaration> = {}>(config: WithJobs<Jobs>): WithJobs<Jobs>;
+export declare function defineConfig<const Jobs extends Record<string, JobDeclaration> = {}>(config: (configEnv: ConfigEnv) => WithJobs<Jobs> | Promise<WithJobs<Jobs>>): (configEnv: ConfigEnv) => WithJobs<Jobs> | Promise<WithJobs<Jobs>>;
 //#endregion
 export type { AuthConfig, ConfigCommand, ConfigEnv, ConfigFunction, ConfigInput, FilesConfig, ProtobaseConfig };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@protobase/config",
-  "version": "0.49.0",
-  "description": "defineConfig and the types of a Protobase project's protobase.config.ts.",
+  "version": "0.49.2",
+  "description": "defineConfig and the types of a Protobase project's protobase.config.ts, and the JSON Schema of protobase.config.json.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -15,11 +15,13 @@
     "node": ">=22.12.0"
   },
   "exports": {
-    ".": "./dist/index.js"
+    ".": "./dist/index.js",
+    "./schema.json": "./schema.json"
   },
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "schema.json"
   ],
   "scripts": {
     "build": "tsdown",
@@ -29,6 +31,6 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@protobase/server": "0.49.0"
+    "@protobase/server": "0.49.2"
   }
 }