@lwrjs/types 0.7.0-alpha.1 → 0.7.0-alpha.12

package/build/config.d.ts

@@ -108,6 +108,7 @@ export interface StaticSiteGenerator {
     outputDir?: string;
     locales?: string[];
     _additionalRoutePaths?: string[];
+    _additionalModules?: string[];
 }
 interface AssetConfigCommon {
     urlPath: string;

package/build/index.d.ts

@@ -3,9 +3,11 @@ import { EventEmitter } from 'events';
 import fs from 'fs';
 import { Server } from 'http';
 import { Readable } from 'stream';
-import { BundleConfig, EnvironmentConfig, HooksPlugin, LwrLockerConfig, NormalizedLwrErrorRoute, NormalizedLwrGlobalConfig, NormalizedLwrRoute, ResolverModuleRecord, RouteHandlerFunction, RouteHandlerView, View } from './config.js';
+import { BundleConfig, EnvironmentConfig, HooksPlugin, LwrLockerConfig, NormalizedLwrErrorRoute, NormalizedLwrGlobalConfig, NormalizedLwrRoute, ResolverModuleRecord } from './config.js';
+import { AssetReference, CompiledView, PublicViewRegistry, ViewProvider, ViewRegistry, ViewTransformPlugin } from './views.js';
 export * from './config.js';
 export * from './server.js';
+export * from './views.js';
 export * from './serviceAPI/serviceAPI.js';
 export * from './serviceAPI/loaderPlugins/loaderPlugins.js';
 export * from './serviceAPI/handleStaleModule/handleStaleModule.js';
@@ -152,6 +154,9 @@ export interface ServerModeConfig {
     defaultLocale: string;
     hmrEnabled: boolean;
     immutableAssets: boolean;
+    env: {
+        NODE_ENV: string;
+    };
     featureFlags: FeatureFlags;
 }
 export interface FeatureFlags {
@@ -167,7 +172,7 @@ export interface RuntimeEnvironment extends ServerModeConfig {
 export interface SourceMapRuntimeEnvironment extends RuntimeEnvironment {
     sourceMapUrl?: string;
 }
-export declare type RuntimeParams = Record<string, string | number | boolean | null | undefined>;
+export declare type RuntimeParams = Record<string, string | number | boolean | null | undefined | Record<string, string>>;
 export interface ModuleIdentity {
     signature: string;
     moduleId: AbstractModuleId;
@@ -323,13 +328,6 @@ export interface ResourceDefinition {
     stream?: Readable;
     isPreload?: boolean;
 }
-export interface AssetReference {
-    url: string;
-    location: {
-        startOffset: number;
-        endOffset: number;
-    };
-}
 export interface AssetMetadata {
     assetReferences?: AssetReference[];
 }
@@ -357,7 +355,7 @@ export interface AssetProvider {
     name: string;
     getAsset(fileAssetPath: string): Promise<AssetSource | undefined>;
 }
-declare type TransformPluginContext = Record<string, any>;
+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;
@@ -382,177 +380,6 @@ export interface AssetTransformHooks {
 export interface AssetTransformPlugin extends Partial<AssetTransformHooks> {
     name: string;
 }
-export declare type ViewIdentity = Pick<View, 'rootComponent' | 'contentTemplate'>;
-export interface ViewSource {
-    name: string;
-    slug: string;
-    ownHash: string;
-    originalSource: string;
-    filePath: string;
-}
-export interface CompiledView extends ViewSource {
-    viewId: ViewIdentity;
-    layoutTemplate?: string;
-    immutable?: boolean;
-    properties?: {
-        [key: string]: unknown;
-    };
-    render: (context?: any) => Promise<RenderingResult>;
-}
-export declare type NormalizedRenderingResult = Required<RenderingResult>;
-export interface RenderingResult {
-    renderedView: string;
-    metadata?: RenderedViewMetadata;
-    options?: RenderOptions;
-}
-export interface RenderedView {
-    compiledView: CompiledView;
-    renderedView: string;
-    metadata: RenderedViewMetadata;
-    options: RenderOptions;
-}
-export interface CustomElementReference {
-    tagName: string;
-    children?: CustomElementReference[];
-    location?: {
-        startOffset: number;
-        endOffset: number;
-    };
-}
-export interface RenderedViewMetadata {
-    customElements: CustomElementReference[];
-    assetReferences: AssetReference[];
-}
-export interface RenderedAssetReference {
-    url: string;
-    tagName?: string;
-    override?: AssetUri;
-}
-export interface AssetReference extends RenderedAssetReference {
-    importer?: string;
-    location: {
-        startOffset: number;
-        endOffset: number;
-    };
-}
-export interface LinkedViewDefinitionMetaData {
-    customElements: string[];
-    assetReferences: RenderedAssetReference[];
-}
-export interface CustomElementRecord {
-    elementName: string;
-    flatGraph: FlattenedModuleGraphs;
-}
-export interface RenderedViewRecord {
-    resources?: ResourceDefinition[];
-    assetReferences?: RenderedAssetReference[];
-    customElements?: CustomElementRecord[];
-    endpoints?: Endpoints;
-    importMetadata?: ImportMetadata;
-    bootstrapModule?: {
-        specifier: Specifier;
-        flatGraph: FlattenedModuleGraphs;
-        resources?: ResourceDefinition[];
-    };
-}
-export interface LinkedViewDefinition {
-    renderedView: string;
-    viewRecord: RenderedViewRecord;
-    immutable: boolean;
-}
-interface ViewRequestQs {
-    [key: string]: undefined | string | string[];
-}
-export interface ViewRequest {
-    url: string;
-    requestPath: string;
-    params?: any;
-    query?: ViewRequestQs;
-    routeHandlerFunction?: RouteHandlerFunction;
-}
-export interface CacheResponse {
-    ttl?: string | number;
-}
-export interface ViewResponse {
-    status?: number;
-    body: Buffer | string | boolean | Json;
-    cache?: CacheResponse;
-    headers?: Record<string, string>;
-    cookie?: 'wip';
-    metadata?: {
-        viewDefinition?: LinkedViewDefinition;
-    };
-}
-export declare type RouteHandlerViewResponse = ViewDefinitionResponse | ViewResponse;
-export interface ViewDefinitionResponse {
-    status?: number;
-    view: RouteHandlerView;
-    viewParams: ViewParams;
-    renderOptions?: RenderOptions;
-    cache?: CacheResponse;
-    headers?: Record<string, string>;
-    cookie?: 'wip';
-}
-export interface ViewProvider {
-    name: string;
-    initialize(): Promise<void>;
-    getView(viewId: ViewIdentity): Promise<CompiledView | undefined>;
-}
-export interface ViewTranformPluginContext {
-    view: View;
-    viewParams: ViewParams;
-    runtimeEnvironment: RuntimeEnvironment;
-    runtimeParams: RuntimeParams;
-    renderOptions: Required<RenderOptions>;
-    contentIds: {
-        lwrResourcesId: string;
-    };
-    importer?: string;
-}
-declare type ViewPluginLinkHook = (builder: LwrStringBuilder, viewContext: ViewTranformPluginContext, viewMetadata: RenderedViewMetadata, context?: TransformPluginContext) => Promise<ViewPluginLinkHookReturn>;
-declare type ViewPluginLinkHookReturn = void | null | undefined | false | LwrStringBuilder | {
-    builder?: LwrStringBuilder;
-    context?: TransformPluginContext;
-};
-declare type ViewPluginOptimizeHook = (code: string, assetSource: AssetSource, context?: TransformPluginContext) => Promise<ViewPluginOptimizeHookReturn>;
-declare type ViewPluginOptimizeHookReturn = null | undefined | false | string | {
-    code: string;
-    map?: any;
-    context?: TransformPluginContext;
-};
-export interface ViewTransformHooks {
-    link: ViewPluginLinkHook;
-    optimize: ViewPluginOptimizeHook;
-}
-export interface ViewTransformPlugin extends Partial<ViewTransformHooks> {
-    name: string;
-}
-export declare type ViewParams = Record<string, Json>;
-export interface ViewInfo {
-    id: string;
-    url: string;
-    configAsSrc: boolean;
-}
-export interface RenderOptions {
-    skipMetadataCollection?: boolean;
-    freezeAssets?: boolean;
-    skipCaching?: boolean;
-    viewParamCacheKey?: Json;
-}
-export interface ViewPageContext {
-    id: string;
-    title?: string;
-    url: string;
-}
-export interface ViewRegistry {
-    addViewProviders(providers: ViewProvider[]): void;
-    initializeViewProviders(): Promise<void[]>;
-    getView(viewId: ViewIdentity, skipCaching?: boolean): Promise<CompiledView>;
-    getViewDefinition<R extends RuntimeEnvironment>(view: View, viewParams: ViewParams, runtimeEnvironment: R, runtimeParams?: RuntimeParams, renderOptions?: RenderOptions): Promise<LinkedViewDefinition>;
-    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 interface ResourceRegistry {
     name: string;
     addResourceProviders(provider: ResourceProvider[]): void;
@@ -610,8 +437,12 @@ export interface Compiler {
     getModuleMetadata(compiledSource: string): Promise<Partial<CompiledMetadata>>;
     lockerize(compiledModule: ModuleCompiled, lockerConfig: LwrLockerConfig, sourcemap: boolean): CompilerResult;
     minifyJavascript(source: string): Promise<CompilerResult>;
+    parseJavascript(source: string, options: ParseOptions): Promise<CompilerResult>;
     minifyCSS(source: string): Promise<CompilerResult>;
 }
+export interface ParseOptions {
+    envMode: string;
+}
 export interface CompilerContext {
     runtimeEnvironment: RuntimeEnvironment;
 }
@@ -623,6 +454,7 @@ export interface ClientBootstrapConfig {
     preloadModules?: string[];
     rootComponent?: string;
     rootComponents?: string[];
+    ssrProps?: Json;
     customInit?: Function;
     onError?: Function;
     baseUrl?: string;

package/build/index.js

@@ -1,5 +1,6 @@
 export * from './config.js';
 export * from './server.js';
+export * from './views.js';
 // -- ServiceAPI --------------------------------
 export * from './serviceAPI/serviceAPI.js';
 export * from './serviceAPI/loaderPlugins/loaderPlugins.js';

package/build/server.d.ts

@@ -46,6 +46,7 @@ export interface InternalAppServerConstructable {
 export interface MiddlewareFunction {
     (req: MiddlewareRequest, res: MiddlewareResponse, next: Function): void;
 }
+export declare type Headers = http.IncomingHttpHeaders;
 export interface MiddlewareRequest {
     params: any;
     originalUrl: string;
@@ -53,6 +54,7 @@ export interface MiddlewareRequest {
     query: any;
     body: any;
     method: string;
+    headers: Headers;
     protocol: string;
     locale: string;
     acceptsLanguages(): string[];

package/build/views.d.ts

@@ -0,0 +1,190 @@
+/// <reference types="node" />
+import { 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'>;
+export interface ViewSource {
+    name: string;
+    slug: string;
+    ownHash: string;
+    originalSource: string;
+    filePath: string;
+}
+export interface CompiledView extends ViewSource {
+    viewId: ViewIdentity;
+    layoutTemplate?: string;
+    immutable?: boolean;
+    properties?: {
+        [key: string]: unknown;
+    };
+    render: (context?: any) => Promise<RenderingResult>;
+}
+export declare type NormalizedRenderingResult = Required<RenderingResult>;
+export interface RenderingResult {
+    renderedView: string;
+    metadata?: RenderedViewMetadata;
+    options?: RenderOptions;
+}
+export interface RenderedView {
+    compiledView: CompiledView;
+    renderedView: string;
+    metadata: RenderedViewMetadata;
+    options: RenderOptions;
+}
+export interface CustomElementReference {
+    tagName: string;
+    props?: {
+        [name: string]: string;
+    };
+    children?: CustomElementReference[];
+    location?: {
+        startOffset: number;
+        endOffset: number;
+    };
+}
+export interface RenderedViewMetadata {
+    customElements: CustomElementReference[];
+    assetReferences: AssetReference[];
+}
+export interface RenderedAssetReference {
+    url: string;
+    tagName?: string;
+    override?: AssetUri;
+}
+export interface AssetReference extends RenderedAssetReference {
+    importer?: string;
+    location: {
+        startOffset: number;
+        endOffset: number;
+    };
+}
+export interface LinkedViewDefinitionMetaData {
+    customElements: string[];
+    assetReferences: RenderedAssetReference[];
+}
+export interface CustomElementRecord {
+    elementName: string;
+    flatGraph: FlattenedModuleGraphs;
+}
+export interface RenderedViewRecord {
+    resources?: ResourceDefinition[];
+    assetReferences?: RenderedAssetReference[];
+    customElements?: CustomElementRecord[];
+    endpoints?: Endpoints;
+    importMetadata?: ImportMetadata;
+    bootstrapModule?: {
+        specifier: Specifier;
+        flatGraph: FlattenedModuleGraphs;
+        resources?: ResourceDefinition[];
+    };
+}
+export interface LinkedViewDefinition {
+    renderedView: string;
+    viewRecord: RenderedViewRecord;
+    immutable: boolean;
+}
+interface ViewRequestQs {
+    [key: string]: undefined | string | string[];
+}
+export interface ViewRequest {
+    url: string;
+    requestPath: string;
+    params?: any;
+    query?: ViewRequestQs;
+    routeHandlerFunction?: RouteHandlerFunction;
+}
+export interface CacheResponse {
+    ttl?: string | number;
+}
+export interface ViewResponse {
+    status?: number;
+    body: Buffer | string | boolean | Json;
+    cache?: CacheResponse;
+    headers?: Record<string, string>;
+    cookie?: 'wip';
+    metadata?: {
+        viewDefinition?: LinkedViewDefinition;
+    };
+}
+export declare type RouteHandlerViewResponse = ViewDefinitionResponse | ViewResponse;
+export interface ViewDefinitionResponse {
+    status?: number;
+    view: RouteHandlerView;
+    viewParams: ViewParams;
+    renderOptions?: RenderOptions;
+    cache?: CacheResponse;
+    headers?: Record<string, string>;
+    cookie?: 'wip';
+}
+export interface ViewProvider {
+    name: string;
+    initialize(): Promise<void>;
+    getView(viewId: ViewIdentity): Promise<CompiledView | undefined>;
+}
+export interface ViewTranformPluginContext {
+    view: View;
+    viewParams: ViewParams;
+    runtimeEnvironment: RuntimeEnvironment;
+    runtimeParams: RuntimeParams;
+    renderOptions: Required<RenderOptions>;
+    contentIds: {
+        lwrResourcesId: string;
+    };
+    importer?: string;
+}
+declare type ViewPluginLinkHook = (builder: LwrStringBuilder, viewContext: ViewTranformPluginContext, viewMetadata: RenderedViewMetadata, context?: TransformPluginContext) => Promise<ViewPluginLinkHookReturn>;
+declare type ViewPluginLinkHookReturn = void | null | undefined | false | LwrStringBuilder | {
+    builder?: LwrStringBuilder;
+    context?: TransformPluginContext;
+};
+declare type ViewPluginOptimizeHook = (code: string, assetSource: AssetSource, context?: TransformPluginContext) => Promise<ViewPluginOptimizeHookReturn>;
+declare type ViewPluginOptimizeHookReturn = null | undefined | false | string | {
+    code: string;
+    map?: any;
+    context?: TransformPluginContext;
+};
+export interface ViewTransformHooks {
+    link: ViewPluginLinkHook;
+    optimize: ViewPluginOptimizeHook;
+}
+export interface ViewTransformPlugin extends Partial<ViewTransformHooks> {
+    name: string;
+}
+export declare type ViewParams = Record<string, Json>;
+export interface ViewInfo {
+    id: string;
+    url: string;
+    configAsSrc: boolean;
+}
+export interface RenderOptions {
+    skipMetadataCollection?: boolean;
+    freezeAssets?: boolean;
+    skipCaching?: boolean;
+    viewParamCacheKey?: Json;
+}
+export interface ViewPageContext {
+    id: string;
+    title?: string;
+    url: string;
+}
+export interface ViewRegistry {
+    addViewProviders(providers: ViewProvider[]): void;
+    initializeViewProviders(): Promise<void[]>;
+    getView(viewId: ViewIdentity, skipCaching?: boolean): Promise<CompiledView>;
+    getViewDefinition<R extends RuntimeEnvironment>(view: View, viewParams: ViewParams, runtimeEnvironment: R, runtimeParams?: RuntimeParams, renderOptions?: RenderOptions): Promise<LinkedViewDefinition>;
+    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 interface PropsRequestContext {
+    props: Json;
+    params: {
+        [key: string]: string;
+    };
+    locale: string;
+    fetch: Function;
+}
+export interface PropsResponse {
+    props: Json;
+}
+export {};
+//# sourceMappingURL=views.d.ts.map

package/build/views.js

@@ -0,0 +1,3 @@
+export {};
+// END types for SSR data
+//# sourceMappingURL=views.js.map

package/package.json

@@ -8,7 +8,7 @@
         "build": "tsc -b"
     },
     "type": "module",
-    "version": "0.7.0-alpha.1",
+    "version": "0.7.0-alpha.12",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -27,5 +27,5 @@
     "engines": {
         "node": ">=14.15.4 <17"
     },
-    "gitHead": "24245670d6908d37e465f2316f92385df63d22aa"
+    "gitHead": "785b8380a821b43b7320783dddaf20d1433216e2"
 }