@lwrjs/types 0.10.0-alpha.2 → 0.10.0-alpha.20

package/build/config.d.ts

@@ -1,4 +1,4 @@
-import { AssetProvider, AssetTransformPlugin, BundleProvider, CacheResponse, LwrService, ModuleProvider, RenderOptions, ResourceProvider, RouteHandlerViewResponse, RuntimeEnvironment, ServerTypes, ServiceCtor, Specifier, ViewParams, ViewProvider, ViewRequest, ViewResponse, ViewTransformPlugin } from './index';
+import type { AssetProvider, AssetTransformPlugin, BundleProvider, CacheResponse, LwrService, ModuleProvider, RenderOptions, ResourceProvider, RouteHandlerViewResponse, RuntimeEnvironment, ServerTypes, ServiceCtor, Specifier, UriTransformPlugin, ViewParams, ViewProvider, ViewRequest, ViewResponse, ViewTransformPlugin } from './index';
 export interface View {
     id: string;
     rootComponent?: string;
@@ -8,7 +8,7 @@ export interface View {
 }
 export interface LwrBaseRoute extends View {
     properties?: Record<string, any>;
-    routeHandler?: string;
+    routeHandler?: ServiceConfig;
     cache?: CacheResponse;
     subRoutes?: string;
 }
@@ -18,12 +18,14 @@ export interface LwrRoute extends LwrBaseRoute {
 }
 export interface NormalizedLwrRoute extends LwrRoute {
     bootstrap: NormalizedLwrAppBootstrapConfig;
+    routeHandler?: ServiceEntry;
 }
 export interface LwrErrorRoute extends LwrBaseRoute {
     status: 404 | 500;
 }
 export interface NormalizedLwrErrorRoute extends LwrErrorRoute {
     bootstrap: NormalizedLwrAppBootstrapConfig;
+    routeHandler?: ServiceEntry;
 }
 export interface NormalizedLwrAppBootstrapConfig {
     autoBoot: boolean;
@@ -37,29 +39,32 @@ export interface NormalizedLwrAppBootstrapConfig {
     module: string | undefined;
     preloadModules: string[];
 }
-export declare type LwrAppBootstrapConfig = Partial<NormalizedLwrAppBootstrapConfig>;
+export type LwrAppBootstrapConfig = Partial<NormalizedLwrAppBootstrapConfig>;
 export interface LwrLockerConfig {
     enabled: boolean;
     trustedComponents?: string[];
     clientOnly?: boolean;
 }
 export interface RouteHandlersConfig {
-    [id: string]: string;
+    [id: string]: ServiceConfig;
+}
+export interface NormalizedRouteHandlersConfig {
+    [id: string]: ServiceEntry;
 }
 export interface LocalizedViewRequest extends ViewRequest {
     locale?: string;
 }
-export declare type RouteHandlerFunction = (viewRequest: LocalizedViewRequest, handlerContext: HandlerContext) => Promise<RouteHandlerViewResponse>;
+export type RouteHandlerFunction = (viewRequest: LocalizedViewRequest, handlerContext: HandlerContext, routeHandlerOptions?: any) => Promise<RouteHandlerViewResponse> | RouteHandlerViewResponse;
 export interface ResourcePaths {
     rootDir: string;
     assets: AssetConfig[];
     layoutsDir: string;
     contentDir: string;
 }
-export declare type RouteHandlerView = Pick<View, 'contentTemplate' | 'layoutTemplate' | 'rootComponent'>;
+export type RouteHandlerView = Pick<View, 'contentTemplate' | 'layoutTemplate' | 'rootComponent'>;
 export interface RouteHandlerViewApi {
     hasViewResponse(view: RouteHandlerView, viewParams?: ViewParams, renderOptions?: RenderOptions): boolean;
-    getViewResponse(view: RouteHandlerView, viewParams?: ViewParams, renderOptions?: RenderOptions): Promise<ViewResponse | undefined>;
+    getViewResponse(view: RouteHandlerView, viewParams?: ViewParams, renderOptions?: RenderOptions): Promise<ViewResponse>;
 }
 export interface HandlerContext extends ResourcePaths {
     route: LwrRoute | LwrErrorRoute;
@@ -100,6 +105,7 @@ export interface LwrGlobalConfig {
     serverType?: ServerTypes;
     staticSiteGenerator?: StaticSiteGenerator;
     locker?: LwrLockerConfig;
+    uriTransformers?: ServiceConfig[];
 }
 export interface BuildOptions {
     target?: string;
@@ -114,6 +120,7 @@ export interface BuildOptions {
 export interface NormalizedLwrGlobalConfig extends Required<Omit<LwrGlobalConfig, 'lwc'>> {
     routes: NormalizedLwrRoute[];
     errorRoutes: NormalizedLwrErrorRoute[];
+    routeHandlers: NormalizedRouteHandlersConfig;
     assets: AssetConfig[];
     lwrVersion: string;
     amdLoader: string;
@@ -126,6 +133,7 @@ export interface NormalizedLwrGlobalConfig extends Required<Omit<LwrGlobalConfig
     resourceProviders: ServiceEntry[];
     assetProviders: ServiceEntry[];
     assetTransformers: ServiceEntry[];
+    uriTransformers: ServiceEntry[];
     lwc: NormalizedLwcConfig;
 }
 export interface StaticSiteGenerator {
@@ -153,43 +161,51 @@ export interface Services {
     resourceProviders: ResolvedServiceEntry<ResourceProvider>[];
     assetProviders: ResolvedServiceEntry<AssetProvider>[];
     assetTransformers: ResolvedServiceEntry<AssetTransformPlugin>[];
+    uriTransformers: ResolvedServiceEntry<UriTransformPlugin>[];
 }
 export interface RouteHandlers {
-    [id: string]: RouteHandlerFunction;
+    [id: string]: [RouteHandlerFunction, any?];
 }
 interface AssetConfigCommon {
-    urlPath: string;
+    urlPath?: string;
     alias?: string;
 }
 export interface AssetDirConfig extends AssetConfigCommon {
     dir: string;
+    root?: boolean;
+}
+export interface AssetRootDirConfig extends AssetDirConfig {
+    dir: string;
+    root: true;
 }
 export interface AssetFileConfig extends AssetConfigCommon {
     file: string;
 }
-export declare type AssetConfig = AssetDirConfig | AssetFileConfig;
+export type AssetConfig = AssetRootDirConfig | AssetDirConfig | AssetFileConfig;
 export interface LwcConfig {
     modules: ResolverModuleRecord[];
     interchangeable?: string[];
     interchangeableModules?: InterchangeableModuleRecord[];
 }
-export declare type InterchangeableModuleMap = Map<Specifier, Map<Environment, Specifier>>;
+export type InterchangeableModuleMap = Map<Specifier, Map<Environment, Specifier>>;
 export interface NormalizedLwcConfig extends Omit<LwcConfig, 'interchangeableModules'> {
     interchangeableModulesMap?: InterchangeableModuleMap;
 }
-export declare type ServiceEntry = [string, any?];
-export declare type ServiceConfig = string | ServiceEntry;
-export declare type ResolvedServiceEntry<T extends LwrService> = [ServiceCtor<T>, any?];
+export type ServiceEntry = [string, any?];
+export type ServiceConfig = string | ServiceEntry;
+export type ResolvedServiceEntry<T extends LwrService> = [ServiceCtor<T>, any?];
 export interface BundleConfig {
     exclude?: string[];
     UNSAFE_lwrDefaultExclude?: string[];
     external?: Record<string, string>;
     alias?: Record<string, string>;
+    groups?: BundleGroups;
 }
 export interface BundleConfigOverrides extends BundleConfig {
     appendExcludes?: boolean;
 }
-export declare type Environment = string;
+export type BundleGroups = Record<string, string[]>;
+export type Environment = string;
 export interface EnvironmentConfig {
     default?: Environment;
     supported?: Environment[];
@@ -233,6 +249,14 @@ export interface HooksPlugin {
      *
      */
     initConfigs?: (lwrConfig: NormalizedLwrGlobalConfig, dataConfig: GlobalData, runtimeConfig: RuntimeEnvironment) => Promise<void> | void;
+    /**
+     * Setup instrumentation utilities
+     *
+     * @remarks
+     * - When running LWR server, these hooks are invoked after `initConfigs` hooks and before `onStart` hooks
+     * - When running LWR handler, these hooks are invoked before config normalization and `onStart` hooks
+     */
+    initInstrumentation?: () => void;
     /**
      * Load routes on application start up.
      *

package/build/index.d.ts

@@ -3,11 +3,11 @@
 /// <reference types="node" />
 /// <reference types="node" />
 import type { WatchOptions } from 'chokidar';
-import { EventEmitter } from 'events';
-import fs from 'fs';
-import { Readable } from 'stream';
-import { BundleConfig, EnvironmentConfig, HooksPlugin, LwrLockerConfig, NormalizedLwrErrorRoute, NormalizedLwrGlobalConfig, NormalizedLwrRoute, ResolverModuleRecord, BundleConfigOverrides, RouteHandlers, AssetConfig } from './config.js';
-import { AssetReference, CompiledView, PublicViewRegistry, ViewProvider, ViewRegistry, ViewTransformPlugin } from './views.js';
+import type { EventEmitter } from 'events';
+import type fs from 'fs';
+import type { Readable } from 'stream';
+import type { BundleConfig, EnvironmentConfig, HooksPlugin, LwrLockerConfig, NormalizedLwrErrorRoute, NormalizedLwrGlobalConfig, NormalizedLwrRoute, ResolverModuleRecord, BundleConfigOverrides, RouteHandlers, AssetConfig } from './config.js';
+import type { AssetReference, CompiledView, PublicViewRegistry, ViewProvider, ViewRegistry, ViewTransformPlugin } from './views.js';
 export * from './lwr-shim.js';
 export * from './config.js';
 export * from './server.js';
@@ -16,16 +16,16 @@ export * from './serviceAPI/serviceAPI.js';
 export * from './serviceAPI/loaderPlugins/loaderPlugins.js';
 export * from './serviceAPI/handleStaleModule/handleStaleModule.js';
 export * from './serviceAPI/appMetadata/appMetadata.js';
-export declare type Json = undefined | null | boolean | number | string | Json[] | {
+export type Json = undefined | null | boolean | number | string | Json[] | {
     [prop: string]: Json;
 };
-export declare type Dict<T> = Record<string, T>;
-export declare type JsonCompatible<T> = {
+export type Dict<T> = Record<string, T>;
+export type JsonCompatible<T> = {
     [P in keyof T]: T[P] extends Json ? T[P] : Pick<T, P> extends Required<Pick<T, P>> ? never : JsonCompatible<T[P]>;
 };
-export declare type WithOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-export declare type Specifier = string;
-export declare type Version = string;
+export type WithOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+export type Specifier = string;
+export type Version = string;
 export interface AbstractModuleId {
     specifier: string;
     namespace?: string;
@@ -68,7 +68,7 @@ export interface ImportMetadataImports {
 export interface ImportMetadataIndex {
     [specifier: string]: string;
 }
-export declare type ModuleEntry = FsModuleEntry | VirtualModuleEntry;
+export type ModuleEntry = FsModuleEntry | VirtualModuleEntry;
 interface BaseModuleEntry {
     id: string;
     entry: string;
@@ -111,6 +111,7 @@ export interface DynamicImportReference extends BaseDynamicModuleReference {
 export interface ModuleRecord {
     imports?: ImportModuleReference[];
     dynamicImports?: DynamicImportReference[];
+    importMeta?: ImportMeta[];
 }
 export interface ChildHashObject {
     [specifier: string]: string;
@@ -147,8 +148,8 @@ export interface CodeSource {
 export interface SignedSource extends CodeSource {
     signedCode?: string;
 }
-export declare type CompatMode = '0' | '1';
-export declare type ModuleFormat = 'esm' | 'amd';
+export type CompatMode = '0' | '1';
+export type ModuleFormat = 'esm' | 'amd';
 export interface ServerModeConfig {
     format: ModuleFormat;
     bundle: boolean;
@@ -165,10 +166,11 @@ export interface ServerModeConfig {
     featureFlags: FeatureFlags;
 }
 export interface FeatureFlags extends Record<string, boolean | undefined> {
+    ASSETS_ON_LAMBDA?: boolean;
     LEGACY_LOADER?: boolean;
-    SSR_STATIC_BUNDLES?: boolean;
     SSR_SANDBOX_WORKER?: boolean;
-    ASSETS_ON_LAMBDA?: boolean;
+    SSR_STATIC_BUNDLES?: boolean;
+    EXPERIMENTAL_UNVERSIONED_ALIASES?: boolean;
 }
 export interface RuntimeEnvironment extends ServerModeConfig {
     apiVersion: string;
@@ -180,7 +182,7 @@ export interface RuntimeEnvironment extends ServerModeConfig {
 export interface SourceMapRuntimeEnvironment extends RuntimeEnvironment {
     sourceMapUrl?: string;
 }
-export declare type RuntimeParams = Record<string, string | number | boolean | null | undefined | Record<string, string>>;
+export type RuntimeParams = Record<string, string | number | boolean | null | undefined | Record<string, string>>;
 export interface ModuleIdentity {
     signature: string;
     moduleId: AbstractModuleId;
@@ -236,14 +238,14 @@ export interface LwrAppEmitter {
     notifyViewSourceChanged(payload: CompiledView): void;
     notifyAssetSourceChanged(payload: AssetSource): void;
 }
-export declare type EVENT_MODULE_DEFINITION_CHANGED = 'module_definition_changed';
+export type EVENT_MODULE_DEFINITION_CHANGED = 'module_definition_changed';
 export interface ModuleDefinitionChangedEvent {
     eventType: EVENT_MODULE_DEFINITION_CHANGED;
     payload: LinkedModuleDefinition;
 }
-export declare type EVENT_MODULE_SOURCE_CHANGED = 'module_source_changed';
-export declare type EVENT_ASSET_SOURCE_CHANGED = 'asset_source_changed';
-export declare type EVENT_VIEW_SOURCE_CHANGED = 'view_source_changed';
+export type EVENT_MODULE_SOURCE_CHANGED = 'module_source_changed';
+export type EVENT_ASSET_SOURCE_CHANGED = 'asset_source_changed';
+export type EVENT_VIEW_SOURCE_CHANGED = 'view_source_changed';
 export interface ModuleSourceChangedEvent {
     eventType: EVENT_MODULE_SOURCE_CHANGED;
     payload: ModuleCompiled;
@@ -261,7 +263,7 @@ export interface ModuleProvider {
     getModule<T extends AbstractModuleId>(moduleId: T, runtimeParams?: RuntimeParams): Promise<ModuleCompiled | undefined>;
     getModuleEntry<T extends AbstractModuleId>(moduleId: T, runtimeParams?: RuntimeParams): Promise<ModuleEntry | undefined>;
 }
-export declare type LwrService = ModuleProvider | ResourceProvider | ViewProvider | AssetProvider | HooksPlugin | AssetTransformPlugin | ViewTransformPlugin;
+export type LwrService = ModuleProvider | ResourceProvider | ViewProvider | AssetProvider | HooksPlugin | AssetTransformPlugin | ViewTransformPlugin;
 export interface ServiceCtor<T extends LwrService, R extends Record<string, Json> = {}> {
     new (providerConfig: R, serviceProviderConfig?: any, ...args: any[]): T;
 }
@@ -275,18 +277,19 @@ export interface ModuleRegistry {
     resolveModuleUriSync<R extends RuntimeEnvironment, S extends string | undefined>(moduleId: Required<Pick<ModuleId, 'specifier' | 'version'>>, signature: S, runtimeEnvironment: R, runtimeParams?: RuntimeParams): string;
     getPublicApi(): PublicModuleRegistry;
 }
-export declare type PublicModuleRegistry = Pick<ModuleRegistry, 'getModule' | 'getModuleEntry' | 'getLinkedModule' | 'resolveModuleUri'>;
+export type PublicModuleRegistry = Pick<ModuleRegistry, 'getModule' | 'getModuleEntry' | 'getLinkedModule' | 'resolveModuleUri'>;
 export interface BundleProvider {
     name: string;
     bundle<T extends AbstractModuleId, R extends RuntimeEnvironment>(moduleId: T, runtimeEnvironment: R, runtimeParams: RuntimeParams, configOverrides?: BundleConfig): Promise<BundleDefinition | undefined>;
 }
 export interface ModuleBundler {
     addBundleProviders(providers: BundleProvider[]): void;
+    addBundleTransformers(transformers: UriTransformPlugin[]): void;
     getModuleBundle<T extends AbstractModuleId, R extends RuntimeEnvironment>(moduleId: T, runtimeEnvironment: R, runtimeParams?: RuntimeParams, bundleConfigOverrides?: BundleConfigOverrides): Promise<BundleDefinition>;
     resolveModuleUri(moduleId: Required<Pick<ModuleId, 'specifier' | 'version'>>, runtimeEnvironment: RuntimeEnvironment, runtimeParams?: RuntimeParams, signature?: string): Promise<string>;
     getPublicApi(): PublicModuleBundler;
 }
-export declare type PublicModuleBundler = Pick<ModuleBundler, 'getModuleBundle' | 'resolveModuleUri'>;
+export type PublicModuleBundler = Pick<ModuleBundler, 'getModuleBundle' | 'resolveModuleUri'>;
 export interface BundleRecord {
     imports?: BaseModuleReference[];
     dynamicImports?: BaseDynamicModuleReference[];
@@ -337,13 +340,14 @@ export interface AssetIdentifier {
     type?: AssetType;
     importer?: string;
 }
-export interface AssetUri {
+export interface UriDefinition {
     uri: string;
     immutable: boolean;
+    artifactType: ArtifactType;
     entry: string;
     external?: boolean;
 }
-export declare type ResourceType = 'application/javascript' | 'application/json' | 'text/css' | 'lwr-importmap' | 'module' | string;
+export type ResourceType = 'application/javascript' | 'application/json' | 'text/css' | 'lwr-importmap' | 'module' | string;
 export interface ResourceDefinition {
     specifier?: string;
     type: ResourceType;
@@ -370,13 +374,13 @@ export interface AssetSource {
     type?: AssetType;
     noTransform?: boolean;
 }
-export declare type AssetType = 'asset' | 'content-asset' | 'external' | 'unknown';
+export type AssetType = 'asset' | 'content-asset' | 'external' | 'unknown';
 export interface AssetDefinition extends AssetSource {
     uri: string;
     type: AssetType;
     stream: (encoding?: BufferEncoding) => Readable;
 }
-export declare type ResourceJson = Pick<ResourceDefinition, 'type' | 'src'>;
+export type ResourceJson = Pick<ResourceDefinition, 'type' | 'src'>;
 export interface ResourceProvider {
     name: string;
     getResource<R extends ResourceIdentifier, T extends BootstrapRuntimeEnvironment>(resourceIdentity: R, runtimeEnvironment: T, runtimeParams?: RuntimeParams): Promise<ResourceDefinition | undefined>;
@@ -385,27 +389,25 @@ export interface AssetProvider {
     name: string;
     getAsset(assetIdentifier: AssetIdentifier): Promise<AssetSource | undefined>;
 }
-export declare type TransformPluginContext = Record<string, any>;
-declare type AssetPluginTransformHook = (code: string | Buffer, assetSource: AssetSource, context?: TransformPluginContext) => Promise<AssetPluginTransformHookReturn>;
-declare type AssetPluginTransformHookReturn = null | undefined | false | string | Buffer | {
-    code: string | Buffer;
-    context?: TransformPluginContext;
-};
-declare type AssetPluginExtractMetaHook = (code: string | Buffer, assetSource: AssetSource, context?: TransformPluginContext) => Promise<AssetPluginExtractMetaHookReturn>;
-declare type AssetPluginExtractMetaHookReturn = null | undefined | false | {
+export type ArtifactType = 'asset' | 'bundle' | 'resource';
+export type ArtifactDefinition = AssetDefinition | BundleDefinition | ResourceDefinition;
+export type AssetTransformSourceHook = (assetSource: AssetSource, runtimeEnvironment: RuntimeEnvironment) => Promise<AssetTransformSourceHookReturn>;
+export type AssetTransformSourceHookReturn = undefined | {
+    source: string | Buffer;
     metadata?: AssetMetadata;
-    context?: TransformPluginContext;
-};
-declare type AssetPluginOptimizeHook = (code: string | Buffer, assetSource: AssetSource, context?: TransformPluginContext) => Promise<AssetPluginOptimizeHookReturn>;
-declare type AssetPluginOptimizeHookReturn = null | undefined | false | string | Buffer | {
-    code: string | Buffer;
-    map?: any;
-    context?: TransformPluginContext;
 };
+export type UriTransformHook = (uri: UriDefinition, artifactDef?: ArtifactDefinition, runtimeEnvironment?: RuntimeEnvironment) => Promise<UriTransformHookReturn>;
+export type UriTransformHookReturn = undefined | UriDefinition;
+export interface UriTransformHooks {
+    transformUri: UriTransformHook;
+}
+export interface UriTransformPlugin extends UriTransformHooks {
+    name: string;
+}
+export type AssetUriTransformHook = (uri: UriDefinition, assetDef: AssetDefinition, runtimeEnvironment: RuntimeEnvironment) => Promise<UriTransformHookReturn>;
 export interface AssetTransformHooks {
-    transform: AssetPluginTransformHook;
-    extractMetadata: AssetPluginExtractMetaHook;
-    optimize: AssetPluginOptimizeHook;
+    transformUri: AssetUriTransformHook;
+    transformSource: AssetTransformSourceHook;
 }
 export interface AssetTransformPlugin extends Partial<AssetTransformHooks> {
     name: string;
@@ -413,30 +415,32 @@ export interface AssetTransformPlugin extends Partial<AssetTransformHooks> {
 export interface ResourceRegistry {
     name: string;
     addResourceProviders(provider: ResourceProvider[]): void;
+    addResourceTransformers(provider: UriTransformPlugin[]): void;
     getResource<R extends ResourceIdentifier, T extends RuntimeEnvironment>(resourceIdentity: R, runtimeEnvironment: T, runtimeParams?: RuntimeParams): Promise<ResourceDefinition | undefined>;
-    resolveResourceUri<R extends ResourceIdentifier, T extends RuntimeEnvironment>(resourceIdentity: R, runtimeEnvironment: T): string;
+    resolveResourceUri<R extends ResourceIdentifier, T extends RuntimeEnvironment>(resourceIdentity: R, runtimeEnvironment: T): Promise<string>;
     getPublicApi(): PublicResourceRegistry;
 }
-export declare type PublicResourceRegistry = Pick<ResourceRegistry, 'getResource' | 'resolveResourceUri'>;
+export type PublicResourceRegistry = Pick<ResourceRegistry, 'getResource' | 'resolveResourceUri'>;
 export interface AssetRegistry {
     name: string;
     addAssetProviders(provider: AssetProvider[]): void;
-    addAssetTransformers(transformers: AssetTransformPlugin[]): void;
+    addAssetTransformers(transformers: (AssetTransformPlugin | UriTransformPlugin)[]): void;
     getAsset<R extends AssetIdentifier, T extends RuntimeEnvironment>(resourceIdentity: R, runtimeEnvironment: T, includeMetadata?: boolean): Promise<AssetDefinition>;
-    resolveAssetUri<R extends AssetIdentifier, T extends RuntimeEnvironment>(resourceIdentity: R, runtimeEnvironment: T): Promise<AssetUri>;
+    resolveAssetUri<R extends AssetIdentifier, T extends RuntimeEnvironment>(resourceIdentity: R, runtimeEnvironment: T): Promise<UriDefinition>;
     getPublicApi(): PublicAssetRegistry;
 }
-export declare type PublicAssetRegistry = Pick<AssetRegistry, 'getAsset' | 'resolveAssetUri'>;
+export type PublicAssetRegistry = Pick<AssetRegistry, 'getAsset' | 'resolveAssetUri'>;
 export interface LwcCompilerConfig {
     name: string;
     namespace?: string;
     filename: string;
     scopedStyles?: boolean;
 }
-export declare type SourceMap = string | null | undefined;
+export type SourceMap = string | null | undefined;
 export interface CompiledMetadata {
     imports?: Import[];
     dynamicImports?: DynamicImport[];
+    importMeta?: ImportMeta[];
 }
 export interface SourceLocation {
     startColumn: number;
@@ -446,13 +450,17 @@ export interface Import {
     moduleSpecifier: string;
     location: SourceLocation;
 }
-export declare type ModuleNameType = 'string' | 'unresolved';
+export type ModuleNameType = 'string' | 'unresolved';
 export interface DynamicImport {
     moduleSpecifier: string;
     location: SourceLocation;
     importLocation: SourceLocation;
     moduleNameType: ModuleNameType;
 }
+export interface ImportMeta {
+    statement: string;
+    location: SourceLocation;
+}
 export interface CompilerResult {
     code: string;
     map?: SourceMap;
@@ -461,6 +469,15 @@ export interface CompilerResult {
 export interface BundleFiles {
     [filename: string]: string;
 }
+interface ImportMetaEnv {
+    [key: string]: any;
+    SSR: boolean;
+}
+declare global {
+    interface ImportMeta {
+        readonly env: ImportMetaEnv;
+    }
+}
 export interface ClientBootstrapConfig {
     appId?: string;
     bootstrapModule: string;
@@ -541,7 +558,7 @@ export interface GraphDepthOptions {
     dynamic: number;
     includeId?: IncludeIdHook;
 }
-export declare type GraphDepth = 'all' | 'direct' | 'none';
+export type GraphDepth = 'all' | 'direct' | 'none';
 export interface FlatGraphNode {
     specifier: Specifier;
     static: Specifier[];
@@ -551,14 +568,14 @@ export interface GraphNode {
     static: Specifier[];
     dynamic: Specifier[];
 }
-export declare type URIMap = Record<string, string>;
-export declare type LinkedModuleDefinitionMap = Record<string, LinkedModuleDefinition | BundleDefinition>;
+export type URIMap = Record<string, string>;
+export type LinkedModuleDefinitionMap = Record<string, LinkedModuleDefinition | BundleDefinition>;
 export interface FlattenedModuleGraphs {
     graphs: FlatGraphNode[];
     uriMap: URIMap;
     linkedDefinitions: LinkedModuleDefinitionMap;
 }
-export declare type ImportMapImports = {
+export type ImportMapImports = {
     [key: string]: string;
 };
 export interface LwrBuilderOverwriteOptions {
@@ -617,7 +634,7 @@ export interface SiteBundles {
     bundles: Record<string, SiteBundle>;
 }
 export interface SiteResources {
-    resources: Record<string, SiteArtifact>;
+    resources: Record<string, SiteResource>;
 }
 export interface SiteAssets {
     assets: Record<string, SiteArtifact>;
@@ -626,6 +643,9 @@ export interface SiteArtifact {
     path: string;
     mimeType?: string;
 }
+export interface SiteResource extends SiteArtifact {
+    inline?: boolean;
+}
 export interface SiteBundle extends SiteArtifact {
     version?: Version;
     imports: string[];

package/build/lwr-shim.d.ts

@@ -1,4 +1,4 @@
-import { AssetProvider, HooksPlugin, ModuleProvider, ProviderContext, ResourceProvider, ViewProvider, ViewTransformPlugin } from './index';
+import type { AssetProvider, HooksPlugin, ModuleProvider, ProviderContext, ResourceProvider, ViewProvider, ViewTransformPlugin } from './index';
 interface LwrShim {
     LWC_VERSION: string;
     LEGACY_LOADER: boolean;

package/build/server.d.ts

@@ -1,12 +1,12 @@
 /// <reference types="node" />
 /// <reference types="node" />
-import { Application as ExpressApp } from 'express';
-import Koa, { Context } from 'koa';
-import http from 'http';
-import { Readable } from 'stream';
+import type { Application as ExpressApp } from 'express';
+import type { default as Koa, Context } from 'koa';
+import type http from 'http';
+import type { Readable } from 'stream';
 import type { NormalizedLwrGlobalConfig, RuntimeContext, RuntimeEnvironment } from './index.js';
-export declare type ServerTypes = 'koa' | 'express' | 'fs';
-export declare type ServerTypeImpl<T extends ServerTypes> = T extends 'koa' ? Koa : T extends 'express' ? ExpressApp : T extends 'fs' ? LwrDispatcher : never;
+export type ServerTypes = 'koa' | 'express' | 'fs';
+export type ServerTypeImpl<T extends ServerTypes> = T extends 'koa' ? Koa : T extends 'express' ? ExpressApp : T extends 'fs' ? LwrDispatcher : never;
 export interface FsContext extends Context {
     fs?: {
         headers?: http.IncomingHttpHeaders;
@@ -35,8 +35,8 @@ export interface InternalAppServer<T extends ServerTypes> {
     useCompression(): void;
     getRegexWildcard(): string;
 }
-export declare type PublicAppServer<T extends ServerTypes> = Pick<InternalAppServer<T>, 'use' | 'all' | 'get' | 'post' | 'getRegexWildcard'>;
-export declare type InternalAppServerOptions = {
+export type PublicAppServer<T extends ServerTypes> = Pick<InternalAppServer<T>, 'use' | 'all' | 'get' | 'post' | 'getRegexWildcard'>;
+export type InternalAppServerOptions = {
     app?: ServerTypeImpl<ServerTypes>;
     basePath?: string;
 };
@@ -46,7 +46,7 @@ export interface InternalAppServerConstructable {
 export interface MiddlewareFunction {
     (req: MiddlewareRequest, res: MiddlewareResponse, next: Function): void;
 }
-export declare type Headers = http.IncomingHttpHeaders;
+export type Headers = http.IncomingHttpHeaders;
 export interface MiddlewareRequest {
     params: any;
     originalUrl: string;

package/build/serviceAPI/appMetadata/appMetadata.d.ts

@@ -1,4 +1,4 @@
-export declare type AppMetadata = {
+export type AppMetadata = {
     appId?: string;
     bootstrapModule: string;
     rootComponent?: string;

package/build/serviceAPI/handleStaleModule/handleStaleModule.d.ts

@@ -1,12 +1,12 @@
 export interface RegisterHandleStaleModuleHook {
     (hook: HandleStaleModuleHook): void;
 }
-export declare type HandleStaleModuleHookArgs = {
+export type HandleStaleModuleHookArgs = {
     name: string;
     oldUrl: string;
     newUrl: string;
 };
-export declare type DEPRECIATEDHandleStaleModuleHookArgs = {
+export type DEPRECIATEDHandleStaleModuleHookArgs = {
     name: string;
     oldHash: string;
     newHash: string;

package/build/serviceAPI/loaderPlugins/loaderPlugins.d.ts

@@ -1,11 +1,11 @@
-import { ImportMetadata } from '../..';
-declare type ResolveParams = {
+import type { ImportMetadata } from '../..';
+type ResolveParams = {
     parentUrl: string;
 };
 export interface RegisterLoaderHooks {
     (hook: LoaderHooks): void;
 }
-export declare type LoaderHooks = {
+export type LoaderHooks = {
     resolveModule?: ResolveModuleHook;
     loadModule?: LoadModuleHook;
     loadMapping?: LoadMappingHook;
@@ -19,19 +19,19 @@ export interface LoadModuleHook {
 export interface LoadMappingHook {
     (specifier: string, params: MappingResolveParams): Promise<MappingResponse> | MappingResponse;
 }
-export declare type MappingResolveParams = {
+export type MappingResolveParams = {
     knownModules: string[];
 };
-export declare type MappingResponse = ImportMetadata | null;
-export declare type URLResponse = {
+export type MappingResponse = ImportMetadata | null;
+export type URLResponse = {
     url: string;
 };
-export declare type CustomResponse = {
+export type CustomResponse = {
     data: string;
     status: number;
     statusText?: string;
 };
-export declare type LoadHookResponse = CustomResponse | globalThis.Response | null;
-export declare type ResolveHookResponse = URLResponse | string | null;
+export type LoadHookResponse = CustomResponse | globalThis.Response | null;
+export type ResolveHookResponse = URLResponse | string | null;
 export {};
 //# sourceMappingURL=loaderPlugins.d.ts.map

package/build/serviceAPI/serviceAPI.d.ts

@@ -1,6 +1,6 @@
-import { RegisterLoaderHooks } from './loaderPlugins/loaderPlugins';
-import { RegisterHandleStaleModuleHook } from './handleStaleModule/handleStaleModule';
-import { AppMetadata } from './appMetadata/appMetadata';
+import type { RegisterLoaderHooks } from './loaderPlugins/loaderPlugins';
+import type { RegisterHandleStaleModuleHook } from './handleStaleModule/handleStaleModule';
+import type { AppMetadata } from './appMetadata/appMetadata';
 export interface ServiceAPI {
     addLoaderPlugin: NoOp | RegisterLoaderHooks;
     handleStaleModule: RegisterHandleStaleModuleHook;

package/build/views.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
-import { LwrErrorRoute, LwrRoute, RouteHandlerFunction, RouteHandlerView, View } from './config.js';
-import { AssetSource, AssetUri, Endpoints, FlattenedModuleGraphs, ImportMetadata, Json, LwrStringBuilder, ResourceDefinition, RuntimeEnvironment, RuntimeParams, Specifier, TransformPluginContext } from './index.js';
-export declare type ViewIdentity = Pick<View, 'rootComponent' | 'contentTemplate'>;
+import type { LwrErrorRoute, LwrRoute, RouteHandlerFunction, RouteHandlerView, View } from './config.js';
+import type { AssetSource, UriDefinition, Endpoints, FlattenedModuleGraphs, ImportMetadata, Json, LwrStringBuilder, ResourceDefinition, RuntimeEnvironment, RuntimeParams, Specifier } from './index.js';
+export type ViewIdentity = Pick<View, 'rootComponent' | 'contentTemplate'>;
 export interface ViewSource {
     name: string;
     slug: string;
@@ -18,7 +18,7 @@ export interface CompiledView extends ViewSource {
     };
     render: (context?: any) => Promise<RenderingResult>;
 }
-export declare type NormalizedRenderingResult = Required<RenderingResult>;
+export type NormalizedRenderingResult = Required<RenderingResult>;
 export interface RenderingResult {
     renderedView: string;
     metadata?: RenderedViewMetadata;
@@ -48,7 +48,7 @@ export interface RenderedViewMetadata {
 export interface RenderedAssetReference {
     url: string;
     tagName?: string;
-    override?: AssetUri;
+    override?: UriDefinition;
 }
 export interface AssetReference extends RenderedAssetReference {
     importer?: string;
@@ -107,7 +107,7 @@ export interface ViewResponse {
         viewDefinition?: LinkedViewDefinition;
     };
 }
-export declare type RouteHandlerViewResponse = ViewDefinitionResponse | ViewResponse;
+export type RouteHandlerViewResponse = ViewDefinitionResponse | ViewResponse;
 export interface ViewDefinitionResponse {
     status?: number;
     view: RouteHandlerView;
@@ -122,7 +122,7 @@ export interface ViewProvider {
     initialize(): Promise<void>;
     getView(viewId: ViewIdentity): Promise<CompiledView | undefined>;
 }
-export interface ViewTranformPluginContext {
+export interface ViewTransformPluginContext {
     view: View;
     viewParams: ViewParams;
     runtimeEnvironment: RuntimeEnvironment;
@@ -133,17 +133,15 @@ export interface ViewTranformPluginContext {
     };
     importer?: string;
 }
-declare type ViewPluginLinkHook = (builder: LwrStringBuilder, viewContext: ViewTranformPluginContext, viewMetadata: RenderedViewMetadata, context?: TransformPluginContext) => Promise<ViewPluginLinkHookReturn>;
-declare type ViewPluginLinkHookReturn = void | null | undefined | false | LwrStringBuilder | {
+type ViewPluginLinkHook = (builder: LwrStringBuilder, viewContext: ViewTransformPluginContext, viewMetadata: RenderedViewMetadata) => Promise<ViewPluginLinkHookReturn>;
+type ViewPluginLinkHookReturn = void | null | undefined | false | LwrStringBuilder | {
     builder?: LwrStringBuilder;
-    context?: TransformPluginContext;
     cache?: CacheResponse;
 };
-declare type ViewPluginOptimizeHook = (code: string, assetSource: AssetSource, context?: TransformPluginContext) => Promise<ViewPluginOptimizeHookReturn>;
-declare type ViewPluginOptimizeHookReturn = null | undefined | false | string | {
+type ViewPluginOptimizeHook = (code: string, assetSource: AssetSource) => Promise<ViewPluginOptimizeHookReturn>;
+type ViewPluginOptimizeHookReturn = null | undefined | false | string | {
     code: string;
     map?: any;
-    context?: TransformPluginContext;
 };
 export interface ViewTransformHooks {
     link: ViewPluginLinkHook;
@@ -152,7 +150,7 @@ export interface ViewTransformHooks {
 export interface ViewTransformPlugin extends Partial<ViewTransformHooks> {
     name: string;
 }
-export declare type ViewParams = Record<string, Json>;
+export type ViewParams = Record<string, Json>;
 export interface ViewInfo {
     id: string;
     url: string;
@@ -169,7 +167,7 @@ export interface ViewPageContext {
     title?: string;
     url: string;
 }
-export declare type ViewModuleResourceContext = {
+export type ViewModuleResourceContext = {
     isPreload?: boolean;
     isSSR?: boolean;
     async?: boolean;
@@ -183,7 +181,7 @@ export interface ViewRegistry {
     hasViewDefinition<R extends RuntimeEnvironment>(view: View, viewParams: ViewParams, runtimeEnvironment: R, runtimeParams?: RuntimeParams, renderOptions?: RenderOptions): boolean;
     getPublicApi(): PublicViewRegistry;
 }
-export declare type PublicViewRegistry = Pick<ViewRegistry, 'getView' | 'getViewDefinition'>;
+export type PublicViewRegistry = Pick<ViewRegistry, 'getView' | 'getViewDefinition'>;
 export interface ViewHandler {
     getViewContent(viewRequest: ViewRequest, route: LwrRoute | LwrErrorRoute, runtimeEnvironment: RuntimeEnvironment, runtimeParams: RuntimeParams): Promise<ViewResponse>;
     getViewJson(viewRequest: ViewRequest, route: LwrRoute | LwrErrorRoute, runtimeEnvironment: RuntimeEnvironment, runtimeParams: RuntimeParams): Promise<ViewResponse>;

package/package.json

@@ -8,7 +8,7 @@
         "build": "tsc -b"
     },
     "type": "module",
-    "version": "0.10.0-alpha.2",
+    "version": "0.10.0-alpha.20",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -27,7 +27,7 @@
         "chokidar": "^3.5.3"
     },
     "engines": {
-        "node": ">=16.0.0 <20"
+        "node": ">=16.0.0"
     },
-    "gitHead": "592cda0637513885477829beea35a86407b342d4"
+    "gitHead": "45a867fc54e98f77dd442ccd5f668e23027b9246"
 }