@enonic-types/core 8.0.4 → 8.1.0-B2

package/index.d.ts

@@ -16,19 +16,21 @@ declare global {
     type XpMixin = Record<string, Record<string, Record<string, unknown>>>;
 }
 
+export type AppConfig = Readonly<Record<string, string | undefined>>;
+
 export interface App {
     /**
      * The name of the application.
      *
      * @type string
      */
-    name: string;
+    readonly name: string;
     /**
      * Version of the application.
      *
      * @type string
      */
-    version: string;
+    readonly version: string;
     /**
      * Values from the application’s configuration file.
      * This can be set using $XP_HOME/config/<app.name>.cfg.
@@ -36,7 +38,7 @@ export interface App {
      *
      * @type Object
      */
-    config: Record<string, string | undefined>;
+    readonly config: AppConfig;
 }
 
 export interface DoubleUnderscore {
@@ -278,6 +280,13 @@ export interface DefaultRequestHeaders
 export interface RequestConstructorParams {
     body?: string;
     branch?: LiteralUnion<RequestBranch>;
+    /**
+     * Path of the content being rendered. Set by the site service.
+     *
+     * Assigning it in a site mapping filter, on the request passed to `next`, re-routes rendering to
+     * that content: the requested URL is unchanged, but content, site and context path are re-resolved.
+     */
+    contentPath?: string;
     contentType?: string;
     contextPath?: string;
     cookies: RequestCookies;
@@ -834,6 +843,15 @@ export type ByteSource = Brand<object, 'ByteSource'>;
 export interface Resource {
     getSize(): number;
 
+    /**
+     * @deprecated Not a dependable measure of when a resource last changed. A resource served from an
+     * application bundle reports the time recorded in its jar entry, and build tools normalize that value
+     * to a constant so that builds are reproducible — Gradle does so by default as of version 9. Two
+     * different builds of an application therefore report identical timestamps, making the value a
+     * property of the build rather than of the file. Only resources backed by a repository node carry a
+     * genuine modification time; for file-backed resources the value is meaningful in development mode
+     * alone.
+     */
     getTimestamp(): number;
 
     getStream(): ByteSource;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@enonic-types/core",
-    "version": "8.0.4",
+    "version": "8.1.0-B2",
     "description": "Shared type definition for core libraries.",
     "types": "index.d.ts",
     "files": [