@ms-cloudpack/common-types 0.26.3 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -109,6 +109,11 @@ export interface PackageSettings {
109
109
  * Paths used for file monitoring and input hashing. Supports glob matching.
110
110
  * Defaults are under `@ms-cloudpack/path-utilities` in `sourceFilesGlobs`.
111
111
  * Use `...` to include the default paths.
112
+ *
113
+ * For input hashing, both positive and negative globs are considered.
114
+ * For file watching, behavior depends on the watcher backend:
115
+ * - Parcel watcher (default): only negative globs are respected for ignoring files
116
+ * - Chokidar watcher: both positive and negative globs are supported
112
117
  */
113
118
  inputPaths?: string[];
114
119
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"PackageSettings.d.ts","sourceRoot":"","sources":["../src/PackageSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,0BAA0B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,KAAK,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;IAErD;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAAC,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;IAElE;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAElC;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,eAAe,EACf,sBAAsB,GAAG,sBAAsB,GAAG,gBAAgB,CACnE,GAAG;IACF;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IAErD;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC"}
1
+ {"version":3,"file":"PackageSettings.d.ts","sourceRoot":"","sources":["../src/PackageSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,0BAA0B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,KAAK,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;IAErD;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAAC,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;IAElE;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAElC;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,eAAe,EACf,sBAAsB,GAAG,sBAAsB,GAAG,gBAAgB,CACnE,GAAG;IACF;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IAErD;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"PackageSettings.js","sourceRoot":"","sources":["../src/PackageSettings.ts"],"names":[],"mappings":"","sourcesContent":["import type { LinkOptions } from './LinkOptions.js';\nimport type { BundlerCapabilitiesOptions } from './BundlerCapability.js';\nimport type { PackageJsonExports, GeneratedExports } from './PackageJson.js';\n\nexport interface PackageSettingsMatchObject {\n /**\n * Name of the package. Can use a trailing wildcard (e.g. `@scope/*`). `*` to match any name.\n *\n * To negate a match, use `!` as the first character (e.g. `!@scope/foo` or `!@scope/*`).\n */\n name: string;\n\n /**\n * Version of the package. Unspecified matches any version.\n *\n * Note that if the package version is a prerelease, it will only match `*` or ranges that\n * explicitly include prereleases. For example, `^1.0.0` will not match `1.0.1-beta.0`.\n */\n version?: string;\n}\n\n/**\n * Which package(s) the settings should be applied to.\n * A string is a shorthand for matching the name with any version (`*` to match any name).\n */\nexport type PackageSettingsMatch = string | PackageSettingsMatchObject;\n\n/**\n * Settings overrides for bundling a package (or multiple packages, depending on `match`).\n */\nexport interface PackageSettings {\n /**\n * Which package(s) the settings should be applied to.\n * A string is a shorthand for matching the name with any version (`*` to match any name).\n * An array allows multiple matches to be specified.\n */\n match: PackageSettingsMatch | PackageSettingsMatch[];\n\n /**\n * The dependencies which should be included when computing the import map. This is primarily used when\n * devDependencies are needed by the app. This often happens when a library has a demo app which relies\n * on devDependencies.\n *\n * Accepts `$devDependencies` as a special value to include all devDependencies.\n */\n includedDependencies?: string[];\n\n /**\n * The dependencies which should be ignored by Cloudpack verbs. For example, if \"react-native\" is a dependency\n * which should not be included in the import map or evaluated during `init`, it can be listed here to ignore it.\n *\n * Accepts `$peerDependencies` as a special value to exclude all peerDependencies.\n */\n excludedDependencies?: string[];\n\n /**\n * Dependencies which should be inlined in the library bundled by Cloudpack. This is useful for\n * libraries which are small and don't need to be loaded separately, have issues being resolved\n * by the browser, or provide reusable scss files.\n */\n inlinedDependencies?: string[];\n\n /**\n * Use this exports map instead of the original entry points from package.json. (Any Cloudpack-\n * generated exports will be merged.) This is useful if a library's exports map is missing\n * or broken, or to skip bundling entries which aren't needed at runtime.\n *\n * Generally, keys should be relative import paths starting with ./ (use . for the top-level import).\n * Other standard exports map syntax (such as conditions) is also supported.\n * For example:\n * ```json\n * {\n * \".\": \"./lib/index.js\",\n * \"./foo\": \"./lib/foo.js\",\n * }\n * ```\n */\n exports?: PackageJsonExports;\n\n /**\n * If specified, Cloudpack will not attempt to auto-generate ESM stubs for the package, but will\n * instead use the array of named exports you provide (per entry key). Any keys not included\n * will have a default export, but no named exports (so `{}` means that all entries should have\n * only a default export).\n * An entry key is the output file path, relative to `outputPath` (with forward slashes and leading `./`)\n * and *without* the extension (unless it's non-JS).\n *\n * You can also use the special value `'types'` to generate stubs based on the TypeScript declaration file\n * if it exists. This will generate named exports for all types in the declaration file and relative imported files.\n *\n * Note: This is an escape hatch and should be used with caution, as it can lead to unexpected behavior.\n */\n unsafeCjsExportNames?: { [entryKey: string]: string[] } | 'types';\n\n /**\n * Forces the package to be bundled using a specific bundler.\n */\n bundler?: string;\n\n /**\n * @deprecated Use `bundler`.\n *\n * This should be removed once repo configs are updated to use `bundler`.\n */\n bundlerType?: string;\n\n /**\n * Any bundler-specific options to be merged with the calculated bundler options.\n * `bundler` is also required if this is specified.\n *\n * This is an escape hatch which is generally not recommended, since it locks the package to\n * a specific bundler implementation. It's better to use built-in or custom bundler capabilities.\n *\n * WARNING: When merging package settings, `bundlerOptions` will be **overwritten** with\n * the last specified value.\n */\n bundlerOptions?: Record<string, unknown>;\n\n /**\n * Paths used for file monitoring and input hashing. Supports glob matching.\n * Defaults are under `@ms-cloudpack/path-utilities` in `sourceFilesGlobs`.\n * Use `...` to include the default paths.\n */\n inputPaths?: string[];\n\n /**\n * Controls the behavior of the `verifyExports` feature when checking consumed exports from this package:\n * - If true, don't check this package's exports at all.\n * - If an object, this is a mapping from package import paths to export names to ignore. Examples:\n * - To ignore top-level exports: `{ \".\": [\"badName\"] }`\n * - To ignore exports from another path: `{ \"./lib/foo\": [\"badName\"] }`\n */\n ignoreMissingExports?: boolean | Record<string, string[]>;\n\n /**\n * Only relevant for packages bundled with rollup: globs of files that include dynamic (async)\n * imports with non-literal paths, to be processed by `@rollup/plugin-dynamic-import-vars` (subject to\n * that plugin's [limitations](https://www.npmjs.com/package/\\@rollup/plugin-dynamic-import-vars#limitations)).\n * Files matching `*.dynamic.*` are automatically included.\n *\n * This is not needed for ori/esbuild and webpack because they should handle these types of imports automatically.\n */\n dynamicImports?: string[];\n\n /**\n * Ignore these warning messages from the bundler (partial string matches).\n * This is intended for non-actionable messages from external dependencies which can't easily\n * be fixed, to avoid confusing users.\n */\n ignoredBundlerWarnings?: string[];\n\n /**\n * Settings to control how the package is linked in the resolve map.\n */\n link?: LinkOptions;\n\n /**\n * Setting to control the bundler capabilities for this package.\n * This is used to enable or disable specific bundler capabilities.\n */\n bundlerCapabilities?: BundlerCapabilitiesOptions;\n}\n\n/**\n * Subset of PackageSettings used in the generated config.\n */\nexport type GeneratedPackageSettings = Pick<\n PackageSettings,\n 'includedDependencies' | 'excludedDependencies' | 'dynamicImports'\n> & {\n /**\n * This will be a string (name) for internal packages, or match with name and version for external.\n * The match in this case will NOT contain wildcards in the name.\n */\n match: string | Required<PackageSettingsMatchObject>;\n\n /**\n * Generated exports. This will always be a simple object with import paths.\n */\n exports?: GeneratedExports;\n};\n"]}
1
+ {"version":3,"file":"PackageSettings.js","sourceRoot":"","sources":["../src/PackageSettings.ts"],"names":[],"mappings":"","sourcesContent":["import type { LinkOptions } from './LinkOptions.js';\nimport type { BundlerCapabilitiesOptions } from './BundlerCapability.js';\nimport type { PackageJsonExports, GeneratedExports } from './PackageJson.js';\n\nexport interface PackageSettingsMatchObject {\n /**\n * Name of the package. Can use a trailing wildcard (e.g. `@scope/*`). `*` to match any name.\n *\n * To negate a match, use `!` as the first character (e.g. `!@scope/foo` or `!@scope/*`).\n */\n name: string;\n\n /**\n * Version of the package. Unspecified matches any version.\n *\n * Note that if the package version is a prerelease, it will only match `*` or ranges that\n * explicitly include prereleases. For example, `^1.0.0` will not match `1.0.1-beta.0`.\n */\n version?: string;\n}\n\n/**\n * Which package(s) the settings should be applied to.\n * A string is a shorthand for matching the name with any version (`*` to match any name).\n */\nexport type PackageSettingsMatch = string | PackageSettingsMatchObject;\n\n/**\n * Settings overrides for bundling a package (or multiple packages, depending on `match`).\n */\nexport interface PackageSettings {\n /**\n * Which package(s) the settings should be applied to.\n * A string is a shorthand for matching the name with any version (`*` to match any name).\n * An array allows multiple matches to be specified.\n */\n match: PackageSettingsMatch | PackageSettingsMatch[];\n\n /**\n * The dependencies which should be included when computing the import map. This is primarily used when\n * devDependencies are needed by the app. This often happens when a library has a demo app which relies\n * on devDependencies.\n *\n * Accepts `$devDependencies` as a special value to include all devDependencies.\n */\n includedDependencies?: string[];\n\n /**\n * The dependencies which should be ignored by Cloudpack verbs. For example, if \"react-native\" is a dependency\n * which should not be included in the import map or evaluated during `init`, it can be listed here to ignore it.\n *\n * Accepts `$peerDependencies` as a special value to exclude all peerDependencies.\n */\n excludedDependencies?: string[];\n\n /**\n * Dependencies which should be inlined in the library bundled by Cloudpack. This is useful for\n * libraries which are small and don't need to be loaded separately, have issues being resolved\n * by the browser, or provide reusable scss files.\n */\n inlinedDependencies?: string[];\n\n /**\n * Use this exports map instead of the original entry points from package.json. (Any Cloudpack-\n * generated exports will be merged.) This is useful if a library's exports map is missing\n * or broken, or to skip bundling entries which aren't needed at runtime.\n *\n * Generally, keys should be relative import paths starting with ./ (use . for the top-level import).\n * Other standard exports map syntax (such as conditions) is also supported.\n * For example:\n * ```json\n * {\n * \".\": \"./lib/index.js\",\n * \"./foo\": \"./lib/foo.js\",\n * }\n * ```\n */\n exports?: PackageJsonExports;\n\n /**\n * If specified, Cloudpack will not attempt to auto-generate ESM stubs for the package, but will\n * instead use the array of named exports you provide (per entry key). Any keys not included\n * will have a default export, but no named exports (so `{}` means that all entries should have\n * only a default export).\n * An entry key is the output file path, relative to `outputPath` (with forward slashes and leading `./`)\n * and *without* the extension (unless it's non-JS).\n *\n * You can also use the special value `'types'` to generate stubs based on the TypeScript declaration file\n * if it exists. This will generate named exports for all types in the declaration file and relative imported files.\n *\n * Note: This is an escape hatch and should be used with caution, as it can lead to unexpected behavior.\n */\n unsafeCjsExportNames?: { [entryKey: string]: string[] } | 'types';\n\n /**\n * Forces the package to be bundled using a specific bundler.\n */\n bundler?: string;\n\n /**\n * @deprecated Use `bundler`.\n *\n * This should be removed once repo configs are updated to use `bundler`.\n */\n bundlerType?: string;\n\n /**\n * Any bundler-specific options to be merged with the calculated bundler options.\n * `bundler` is also required if this is specified.\n *\n * This is an escape hatch which is generally not recommended, since it locks the package to\n * a specific bundler implementation. It's better to use built-in or custom bundler capabilities.\n *\n * WARNING: When merging package settings, `bundlerOptions` will be **overwritten** with\n * the last specified value.\n */\n bundlerOptions?: Record<string, unknown>;\n\n /**\n * Paths used for file monitoring and input hashing. Supports glob matching.\n * Defaults are under `@ms-cloudpack/path-utilities` in `sourceFilesGlobs`.\n * Use `...` to include the default paths.\n *\n * For input hashing, both positive and negative globs are considered.\n * For file watching, behavior depends on the watcher backend:\n * - Parcel watcher (default): only negative globs are respected for ignoring files\n * - Chokidar watcher: both positive and negative globs are supported\n */\n inputPaths?: string[];\n\n /**\n * Controls the behavior of the `verifyExports` feature when checking consumed exports from this package:\n * - If true, don't check this package's exports at all.\n * - If an object, this is a mapping from package import paths to export names to ignore. Examples:\n * - To ignore top-level exports: `{ \".\": [\"badName\"] }`\n * - To ignore exports from another path: `{ \"./lib/foo\": [\"badName\"] }`\n */\n ignoreMissingExports?: boolean | Record<string, string[]>;\n\n /**\n * Only relevant for packages bundled with rollup: globs of files that include dynamic (async)\n * imports with non-literal paths, to be processed by `@rollup/plugin-dynamic-import-vars` (subject to\n * that plugin's [limitations](https://www.npmjs.com/package/\\@rollup/plugin-dynamic-import-vars#limitations)).\n * Files matching `*.dynamic.*` are automatically included.\n *\n * This is not needed for ori/esbuild and webpack because they should handle these types of imports automatically.\n */\n dynamicImports?: string[];\n\n /**\n * Ignore these warning messages from the bundler (partial string matches).\n * This is intended for non-actionable messages from external dependencies which can't easily\n * be fixed, to avoid confusing users.\n */\n ignoredBundlerWarnings?: string[];\n\n /**\n * Settings to control how the package is linked in the resolve map.\n */\n link?: LinkOptions;\n\n /**\n * Setting to control the bundler capabilities for this package.\n * This is used to enable or disable specific bundler capabilities.\n */\n bundlerCapabilities?: BundlerCapabilitiesOptions;\n}\n\n/**\n * Subset of PackageSettings used in the generated config.\n */\nexport type GeneratedPackageSettings = Pick<\n PackageSettings,\n 'includedDependencies' | 'excludedDependencies' | 'dynamicImports'\n> & {\n /**\n * This will be a string (name) for internal packages, or match with name and version for external.\n * The match in this case will NOT contain wildcards in the name.\n */\n match: string | Required<PackageSettingsMatchObject>;\n\n /**\n * Generated exports. This will always be a simple object with import paths.\n */\n exports?: GeneratedExports;\n};\n"]}
@@ -7,15 +7,18 @@ import type { Session } from './Session.js';
7
7
  * A custom server render function that can be used to override the default HTML response.
8
8
  */
9
9
  export type RenderFunction = (options: RenderFunctionOptions) => Promise<RenderFunctionResult> | RenderFunctionResult;
10
- export interface ServerRenderFunctionOptions {
11
- _forFutureUser?: never;
12
- }
13
10
  /**
14
11
  * Input for a `serverEntry`/`renderScript` custom server render function.
15
12
  */
16
13
  export interface RenderFunctionOptions {
17
- /** Info about the current app session */
14
+ /**
15
+ * Info about the current app session.
16
+ * @deprecated Use top-level properties instead (see comment on `requestInfo` for reasoning).
17
+ * Please talk to the team if you need a property that isn't listed.
18
+ */
18
19
  session: Session;
20
+ /** Path to the root of the app package */
21
+ appPath: string;
19
22
  /** Processed route being rendered */
20
23
  route: RenderedRoute;
21
24
  /** Base URL of the app server, including port */
@@ -30,37 +33,94 @@ export interface RenderFunctionOptions {
30
33
  entryScripts?: string[];
31
34
  /** Inline script tag contents used for Cloudpack initialization (will be injected into a returned HTML response) */
32
35
  inlineScripts?: string[];
33
- /** Current request */
36
+ /**
37
+ * Subset of properties from the current HTTP request (talk to the team if you need something additional).
38
+ *
39
+ * Previously, we passed the original `Request` object to the render function, but going forward
40
+ * (with the `enableSSR` feature and eventually by default), the renderer will run in a separate
41
+ * process, and `Request`s aren't serializable.
42
+ */
43
+ requestInfo: RequestInfo;
44
+ /**
45
+ * Current request
46
+ * @deprecated Use `requestInfo` instead (see comment there for details).
47
+ * Please talk to the team if you need a property that isn't listed there.
48
+ */
34
49
  req: Request;
35
- /** Current response */
50
+ /**
51
+ * Current response
52
+ * @deprecated Return properties from the function instead. Please talk to the team if you need
53
+ * to do something that isn't supported by `RenderFunctionResult`.
54
+ */
36
55
  res: Response;
37
56
  }
57
+ /**
58
+ * Subset of properties from the current HTTP request (talk to the team if you need something additional).
59
+ */
60
+ export interface RequestInfo extends Pick<Request, 'url' | 'hostname' | 'headers' | 'originalUrl' | 'params' | 'query'> {
61
+ /** Whether this is an encrypted connection per `req.socket.encrypted` */
62
+ isEncrypted: boolean;
63
+ }
38
64
  /**
39
65
  * The complete expected result of the `serverEntry`/`renderScript` custom server render function.
40
66
  */
41
67
  export interface ExpandedRenderFunctionResult {
42
- /** Response body */
43
- content: string;
68
+ /**
69
+ * Response body. If non-HTML, `contentType` must be set.
70
+ * `content` is required except for status codes such as 304 that don't have a body.
71
+ * (Support for other value types could be added in the future if needed.)
72
+ */
73
+ content?: string | object;
44
74
  /** Standard HTTP status code - https://developer.mozilla.org/en-US/docs/Web/HTTP/Status */
45
75
  statusCode: number;
46
76
  /** MIME type for the response - https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types */
47
77
  contentType: string;
78
+ /** Extra headers to include in the response */
79
+ headers?: Record<string, string>;
80
+ /**
81
+ * For HTML responses in advanced scenarios only: set to `false` to prevent Cloudpack from
82
+ * injecting default scripts and import map into the returned content. If this is `false`,
83
+ * it's assumed you've manually handled injecting these scripts from the passed options.
84
+ * @default true
85
+ */
86
+ injectScripts?: boolean;
48
87
  }
49
88
  /**
50
89
  * The expected result of the `serverEntry`/`renderScript` custom server render function.
51
90
  *
52
91
  * - If a string, it's assumed to be the HTML content.
53
92
  * - If an object and the `content` is non-HTML, `contentType` must be set.
54
- * - If null, this means the function fully handled the request (sent a response using
55
- * `options.res.send('...')` or other methods).
93
+ * `content` is required except for status codes such as 304 that don't have a body.
94
+ * - (Returning `null` is deprecated.)
56
95
  */
57
- export type RenderFunctionResult = string | null | ({
58
- content: string;
59
- } & Partial<ExpandedRenderFunctionResult>);
96
+ export type RenderFunctionResult = string | null | Partial<ExpandedRenderFunctionResult>;
60
97
  /**
61
98
  * The expected shape of the `serverEntry`/`renderScript` custom server render function JS file.
62
99
  */
63
100
  export type RenderFunctionScript = {
64
101
  default: RenderFunction;
65
102
  };
103
+ /**
104
+ * `serverEntry` function options with `enableSSR` feature on.
105
+ */
106
+ export type ServerEntryFunctionOptions = Omit<RenderFunctionOptions, 'session' | 'req' | 'res'>;
107
+ /**
108
+ * `serverEntry` function result with `enableSSR` feature on.
109
+ * Right now this can return the same values, except for `null` since that indicates the renderer
110
+ * fully handled the request, and the worker-based renderer can't do that because it doesn't have
111
+ * access to the response object.
112
+ *
113
+ * Please talk to the team if you need additional properties or other custom response behavior.
114
+ */
115
+ export type ServerEntryFunctionResult = Exclude<RenderFunctionResult, null>;
116
+ /**
117
+ * `serverEntry` function with `enableSSR` feature on.
118
+ */
119
+ export type ServerEntryFunction = (options: ServerEntryFunctionOptions) => Promise<ServerEntryFunctionResult> | ServerEntryFunctionResult;
120
+ /**
121
+ * The expected shape of the `serverEntry` custom server render function JS file.
122
+ */
123
+ export type ServerEntryFunctionScript = {
124
+ default: ServerEntryFunction;
125
+ };
66
126
  //# sourceMappingURL=RenderFunction.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"RenderFunction.d.ts","sourceRoot":"","sources":["../src/RenderFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;AAGtH,MAAM,WAAW,2BAA2B;IAC1C,cAAc,CAAC,EAAE,KAAK,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,aAAa,CAAC;IACrB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,WAAW,CAAC;IACxB,0GAA0G;IAC1G,SAAS,EAAE,SAAS,CAAC;IACrB,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oHAAoH;IACpH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,uBAAuB;IACvB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,UAAU,EAAE,MAAM,CAAC;IACnB,4HAA4H;IAC5H,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC;AAEjH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC"}
1
+ {"version":3,"file":"RenderFunction.d.ts","sourceRoot":"","sources":["../src/RenderFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;AAEtH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,EAAE,aAAa,CAAC;IACrB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,WAAW,CAAC;IACxB,0GAA0G;IAC1G,SAAS,EAAE,SAAS,CAAC;IACrB,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oHAAoH;IACpH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;OAMG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;;;OAIG;IACH,GAAG,EAAE,OAAO,CAAC;IACb;;;;OAIG;IACH,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WACf,SAAQ,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC1F,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,2FAA2F;IAC3F,UAAU,EAAE,MAAM,CAAC;IACnB,4HAA4H;IAC5H,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC;AAEhG;;;;;;;GAOG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,yBAAyB,CAAC,GAAG,yBAAyB,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IAAE,OAAO,EAAE,mBAAmB,CAAA;CAAE,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"RenderFunction.js","sourceRoot":"","sources":["../src/RenderFunction.ts"],"names":[],"mappings":"","sourcesContent":["import type { Request, Response } from 'express';\nimport type { ImportMap } from './ImportMap.js';\nimport type { PackageJson } from './PackageJson.js';\nimport type { RenderedRoute } from './Route.js';\nimport type { Session } from './Session.js';\n\n/**\n * A custom server render function that can be used to override the default HTML response.\n */\nexport type RenderFunction = (options: RenderFunctionOptions) => Promise<RenderFunctionResult> | RenderFunctionResult;\n\n// TODO: Determine what SSR options are appropriate for Render Function Options in SSR Mode.\nexport interface ServerRenderFunctionOptions {\n _forFutureUser?: never;\n}\n\n/**\n * Input for a `serverEntry`/`renderScript` custom server render function.\n */\nexport interface RenderFunctionOptions {\n /** Info about the current app session */\n session: Session;\n /** Processed route being rendered */\n route: RenderedRoute;\n /** Base URL of the app server, including port */\n baseUrl: string;\n /** `package.json` for the app */\n definition: PackageJson;\n /** Import map that will be used by the app at runtime (will be injected into a returned HTML response) */\n importMap: ImportMap;\n /** URL for the Cloudpack overlay script bundle (will be injected into a returned HTML response) */\n overlayScript?: string;\n /** Additional script bundle URLs from `route.entry` (will be injected into a returned HTML response) */\n entryScripts?: string[];\n /** Inline script tag contents used for Cloudpack initialization (will be injected into a returned HTML response) */\n inlineScripts?: string[];\n /** Current request */\n req: Request;\n /** Current response */\n res: Response;\n}\n\n/**\n * The complete expected result of the `serverEntry`/`renderScript` custom server render function.\n */\nexport interface ExpandedRenderFunctionResult {\n /** Response body */\n content: string;\n /** Standard HTTP status code - https://developer.mozilla.org/en-US/docs/Web/HTTP/Status */\n statusCode: number;\n /** MIME type for the response - https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types */\n contentType: string;\n}\n\n/**\n * The expected result of the `serverEntry`/`renderScript` custom server render function.\n *\n * - If a string, it's assumed to be the HTML content.\n * - If an object and the `content` is non-HTML, `contentType` must be set.\n * - If null, this means the function fully handled the request (sent a response using\n * `options.res.send('...')` or other methods).\n */\nexport type RenderFunctionResult = string | null | ({ content: string } & Partial<ExpandedRenderFunctionResult>);\n\n/**\n * The expected shape of the `serverEntry`/`renderScript` custom server render function JS file.\n */\nexport type RenderFunctionScript = { default: RenderFunction };\n"]}
1
+ {"version":3,"file":"RenderFunction.js","sourceRoot":"","sources":["../src/RenderFunction.ts"],"names":[],"mappings":"","sourcesContent":["import type { Request, Response } from 'express';\nimport type { ImportMap } from './ImportMap.js';\nimport type { PackageJson } from './PackageJson.js';\nimport type { RenderedRoute } from './Route.js';\nimport type { Session } from './Session.js';\n\n/**\n * A custom server render function that can be used to override the default HTML response.\n */\nexport type RenderFunction = (options: RenderFunctionOptions) => Promise<RenderFunctionResult> | RenderFunctionResult;\n\n/**\n * Input for a `serverEntry`/`renderScript` custom server render function.\n */\nexport interface RenderFunctionOptions {\n /**\n * Info about the current app session.\n * @deprecated Use top-level properties instead (see comment on `requestInfo` for reasoning).\n * Please talk to the team if you need a property that isn't listed.\n */\n session: Session;\n /** Path to the root of the app package */\n appPath: string;\n /** Processed route being rendered */\n route: RenderedRoute;\n /** Base URL of the app server, including port */\n baseUrl: string;\n /** `package.json` for the app */\n definition: PackageJson;\n /** Import map that will be used by the app at runtime (will be injected into a returned HTML response) */\n importMap: ImportMap;\n /** URL for the Cloudpack overlay script bundle (will be injected into a returned HTML response) */\n overlayScript?: string;\n /** Additional script bundle URLs from `route.entry` (will be injected into a returned HTML response) */\n entryScripts?: string[];\n /** Inline script tag contents used for Cloudpack initialization (will be injected into a returned HTML response) */\n inlineScripts?: string[];\n /**\n * Subset of properties from the current HTTP request (talk to the team if you need something additional).\n *\n * Previously, we passed the original `Request` object to the render function, but going forward\n * (with the `enableSSR` feature and eventually by default), the renderer will run in a separate\n * process, and `Request`s aren't serializable.\n */\n requestInfo: RequestInfo;\n /**\n * Current request\n * @deprecated Use `requestInfo` instead (see comment there for details).\n * Please talk to the team if you need a property that isn't listed there.\n */\n req: Request;\n /**\n * Current response\n * @deprecated Return properties from the function instead. Please talk to the team if you need\n * to do something that isn't supported by `RenderFunctionResult`.\n */\n res: Response;\n}\n\n/**\n * Subset of properties from the current HTTP request (talk to the team if you need something additional).\n */\nexport interface RequestInfo\n extends Pick<Request, 'url' | 'hostname' | 'headers' | 'originalUrl' | 'params' | 'query'> {\n /** Whether this is an encrypted connection per `req.socket.encrypted` */\n isEncrypted: boolean;\n}\n\n/**\n * The complete expected result of the `serverEntry`/`renderScript` custom server render function.\n */\nexport interface ExpandedRenderFunctionResult {\n /**\n * Response body. If non-HTML, `contentType` must be set.\n * `content` is required except for status codes such as 304 that don't have a body.\n * (Support for other value types could be added in the future if needed.)\n */\n content?: string | object;\n /** Standard HTTP status code - https://developer.mozilla.org/en-US/docs/Web/HTTP/Status */\n statusCode: number;\n /** MIME type for the response - https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types */\n contentType: string;\n /** Extra headers to include in the response */\n headers?: Record<string, string>;\n /**\n * For HTML responses in advanced scenarios only: set to `false` to prevent Cloudpack from\n * injecting default scripts and import map into the returned content. If this is `false`,\n * it's assumed you've manually handled injecting these scripts from the passed options.\n * @default true\n */\n injectScripts?: boolean;\n}\n\n/**\n * The expected result of the `serverEntry`/`renderScript` custom server render function.\n *\n * - If a string, it's assumed to be the HTML content.\n * - If an object and the `content` is non-HTML, `contentType` must be set.\n * `content` is required except for status codes such as 304 that don't have a body.\n * - (Returning `null` is deprecated.)\n */\nexport type RenderFunctionResult = string | null | Partial<ExpandedRenderFunctionResult>;\n\n/**\n * The expected shape of the `serverEntry`/`renderScript` custom server render function JS file.\n */\nexport type RenderFunctionScript = { default: RenderFunction };\n\n/**\n * `serverEntry` function options with `enableSSR` feature on.\n */\nexport type ServerEntryFunctionOptions = Omit<RenderFunctionOptions, 'session' | 'req' | 'res'>;\n\n/**\n * `serverEntry` function result with `enableSSR` feature on.\n * Right now this can return the same values, except for `null` since that indicates the renderer\n * fully handled the request, and the worker-based renderer can't do that because it doesn't have\n * access to the response object.\n *\n * Please talk to the team if you need additional properties or other custom response behavior.\n */\nexport type ServerEntryFunctionResult = Exclude<RenderFunctionResult, null>;\n\n/**\n * `serverEntry` function with `enableSSR` feature on.\n */\nexport type ServerEntryFunction = (\n options: ServerEntryFunctionOptions,\n) => Promise<ServerEntryFunctionResult> | ServerEntryFunctionResult;\n\n/**\n * The expected shape of the `serverEntry` custom server render function JS file.\n */\nexport type ServerEntryFunctionScript = { default: ServerEntryFunction };\n"]}
@@ -21,11 +21,16 @@ export declare const allFeatures: {
21
21
  * To use this feature, the package with the worker must be bundled with webpack (default: true).
22
22
  */
23
23
  enableModuleWorkers: Feature;
24
+ /** Enables the use of `@parcel/watcher` for file watching (default: true). */
25
+ enableParcelWatcher: Feature;
24
26
  /**
25
27
  * Enables downloading bundles from remote cache instead of bundling.
26
28
  */
27
29
  enableRemoteCacheDownloads: Feature;
28
- /** Enables server-side rendering (SSR) for the application. This is experimental and may not work in all cases. */
30
+ /**
31
+ * Enables server-side rendering (SSR) for the application, including Node import map support.
32
+ * This is experimental and may not work in all cases.
33
+ */
29
34
  enableSSR: Feature;
30
35
  /** Enables the file watcher to be spawned in a forked process (default: true). */
31
36
  enableWatcherInFork: Feature;
@@ -1 +1 @@
1
- {"version":3,"file":"allFeatures.d.ts","sourceRoot":"","sources":["../src/allFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;KAAG,GAAG,IAAI,MAAM,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO;CAAE,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,WAAW;IAGtB,mHAAmH;uBAK9G,OAAO;IAEZ,2DAA2D;uBACmC,OAAO;IAErG,uCAAuC;uBACoC,OAAO;IAElF;;;OAGG;yBAKE,OAAO;IAEZ;;OAEG;gCAGE,OAAO;IAEZ,mHAAmH;eAI9G,OAAO;IAEZ,mFAAmF;yBAI9E,OAAO;IAEZ,sEAAsE;yBACqC,OAAO;IAElH,6FAA6F;4BAGxF,OAAO;IAEZ;;;OAGG;0BAKE,OAAO;IAEZ,sHAAsH;4BAKjH,OAAO;IAEZ,+GAA+G;yBAI1G,OAAO;IAEZ,+IAA+I;0BACvC,OAAO;IAE/G,sCAAsC;iBAC6B,OAAO;IAE1E,gDAAgD;0BACsC,OAAO;IAE7F,2EAA2E;wBAItE,OAAO;IAEZ,uDAAuD;mBAC+B,OAAO;CAI9F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAIvB,QAAQ,CAAC"}
1
+ {"version":3,"file":"allFeatures.d.ts","sourceRoot":"","sources":["../src/allFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;KAAG,GAAG,IAAI,MAAM,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO;CAAE,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,WAAW;IAGtB,mHAAmH;uBAK9G,OAAO;IAEZ,2DAA2D;uBACmC,OAAO;IAErG,uCAAuC;uBACoC,OAAO;IAElF;;;OAGG;yBAKE,OAAO;IAEZ,8EAA8E;yBAIzE,OAAO;IAEZ;;OAEG;gCAGE,OAAO;IAEZ;;;OAGG;eAIE,OAAO;IAEZ,mFAAmF;yBAI9E,OAAO;IAEZ,sEAAsE;yBACqC,OAAO;IAElH,6FAA6F;4BAGxF,OAAO;IAEZ;;;OAGG;0BAKE,OAAO;IAEZ,sHAAsH;4BAKjH,OAAO;IAEZ,+GAA+G;yBAI1G,OAAO;IAEZ,+IAA+I;0BACvC,OAAO;IAE/G,sCAAsC;iBAC6B,OAAO;IAE1E,gDAAgD;0BACsC,OAAO;IAE7F,2EAA2E;wBAItE,OAAO;IAEZ,uDAAuD;mBAC+B,OAAO;CAI9F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAIvB,QAAQ,CAAC"}
@@ -21,15 +21,23 @@ export const allFeatures = {
21
21
  description: 'Enables support of import maps for workers. To use this feature, the package with the worker must be bundled with webpack (default: true).',
22
22
  default: true,
23
23
  },
24
+ /** Enables the use of `@parcel/watcher` for file watching (default: true). */
25
+ enableParcelWatcher: {
26
+ description: 'Enables the use of @parcel/watcher for file watching (default: true).',
27
+ default: true,
28
+ },
24
29
  /**
25
30
  * Enables downloading bundles from remote cache instead of bundling.
26
31
  */
27
32
  enableRemoteCacheDownloads: {
28
33
  description: 'Enables downloading bundles from remote cache instead of bundling.',
29
34
  },
30
- /** Enables server-side rendering (SSR) for the application. This is experimental and may not work in all cases. */
35
+ /**
36
+ * Enables server-side rendering (SSR) for the application, including Node import map support.
37
+ * This is experimental and may not work in all cases.
38
+ */
31
39
  enableSSR: {
32
- description: 'Enables server-side rendering (SSR) for the application. This is experimental and may not work in all cases.',
40
+ description: 'Enables server-side rendering (SSR) for the application, including Node import map support. This is experimental and may not work in all cases.',
33
41
  },
34
42
  /** Enables the file watcher to be spawned in a forked process (default: true). */
35
43
  enableWatcherInFork: {
@@ -1 +1 @@
1
- {"version":3,"file":"allFeatures.js","sourceRoot":"","sources":["../src/allFeatures.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,8FAA8F;IAE9F,mHAAmH;IACnH,iBAAiB,EAAE;QACjB,WAAW,EACT,8GAA8G;QAChH,OAAO,EAAE,IAAI;KACH;IAEZ,2DAA2D;IAC3D,iBAAiB,EAAE,EAAE,WAAW,EAAE,sDAAsD,EAAa;IAErG,uCAAuC;IACvC,iBAAiB,EAAE,EAAE,WAAW,EAAE,mCAAmC,EAAa;IAElF;;;OAGG;IACH,mBAAmB,EAAE;QACnB,WAAW,EACT,4IAA4I;QAC9I,OAAO,EAAE,IAAI;KACH;IAEZ;;OAEG;IACH,0BAA0B,EAAE;QAC1B,WAAW,EAAE,oEAAoE;KACvE;IAEZ,mHAAmH;IACnH,SAAS,EAAE;QACT,WAAW,EACT,8GAA8G;KACtG;IAEZ,mFAAmF;IACnF,mBAAmB,EAAE;QACnB,WAAW,EAAE,6EAA6E;QAC1F,OAAO,EAAE,IAAI;KACH;IAEZ,sEAAsE;IACtE,mBAAmB,EAAE,EAAE,WAAW,EAAE,iEAAiE,EAAa;IAElH,6FAA6F;IAC7F,sBAAsB,EAAE;QACtB,WAAW,EAAE,wFAAwF;KAC3F;IAEZ;;;OAGG;IACH,oBAAoB,EAAE;QACpB,WAAW;QACT,0EAA0E;QAC1E,iKAAiK;KACzJ;IAEZ,sHAAsH;IACtH,sBAAsB,EAAE;QACtB,WAAW,EACT,iHAAiH;QACnH,OAAO,EAAE,IAAI;KACH;IAEZ,+GAA+G;IAC/G,mBAAmB,EAAE;QACnB,WAAW,EACT,0GAA0G;KAClG;IAEZ,+IAA+I;IAC/I,oBAAoB,EAAE,EAAE,WAAW,EAAE,6DAA6D,EAAa;IAE/G,sCAAsC;IACtC,WAAW,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAa;IAE1E,gDAAgD;IAChD,oBAAoB,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAa;IAE7F,2EAA2E;IAC3E,kBAAkB,EAAE;QAClB,WAAW,EAAE,sEAAsE;QACnF,OAAO,EAAE,IAAI;KACH;IAEZ,uDAAuD;IACvD,aAAa,EAAE,EAAE,WAAW,EAAE,kDAAkD,EAAa;IAE7F,iDAAiD;IACjD,oDAAoD;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAC/C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;KACxB,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;KACzC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CACrB,CAAC","sourcesContent":["import type { Feature } from './Feature.js';\n\n/**\n * Represents all features that can be enabled or disabled for Cloudpack.\n */\nexport type Features = { [key in keyof typeof allFeatures]?: boolean };\n\n/**\n * A set of options for configuring the experience.\n * Features can be set to true to change the default behavior.\n */\nexport const allFeatures = {\n // The comments provide intellisense, and the description strings are used in the help output.\n\n /** Automatically updates the generated config when an unknown import path is used during start (default: true). */\n autoUpdateEntries: {\n description:\n 'Automatically updates the generated config when an unknown import path is used during start (default: true).',\n default: true,\n } as Feature,\n\n /** Disables the generation of source-maps during build. */\n disableSourceMaps: { description: 'Disables the generation of source-maps during build.' } as Feature,\n\n /** Enabled cloud-hosted application */\n enableCloudHosted: { description: 'Enables cloud-hosted application.' } as Feature,\n\n /**\n * Enables support of import maps for workers.\n * To use this feature, the package with the worker must be bundled with webpack (default: true).\n */\n enableModuleWorkers: {\n description:\n 'Enables support of import maps for workers. To use this feature, the package with the worker must be bundled with webpack (default: true).',\n default: true,\n } as Feature,\n\n /**\n * Enables downloading bundles from remote cache instead of bundling.\n */\n enableRemoteCacheDownloads: {\n description: 'Enables downloading bundles from remote cache instead of bundling.',\n } as Feature,\n\n /** Enables server-side rendering (SSR) for the application. This is experimental and may not work in all cases. */\n enableSSR: {\n description:\n 'Enables server-side rendering (SSR) for the application. This is experimental and may not work in all cases.',\n } as Feature,\n\n /** Enables the file watcher to be spawned in a forked process (default: true). */\n enableWatcherInFork: {\n description: 'Enables the file watcher to be spawned in a forked process (default: true).',\n default: true,\n } as Feature,\n\n /** Enables the preemptive enqueueing of dependencies during build. */\n enqueueDependencies: { description: 'Enables the preemptive enqueueing of dependencies during build.' } as Feature,\n\n /** Check for dynamic (async) imports with non-literal paths in bundle output during init. */\n evaluateDynamicImports: {\n description: 'Check for dynamic (async) imports with non-literal paths in bundle output during init.',\n } as Feature,\n\n /**\n * Excludes unused dependencies in the generated config during an init run.\n * This helps trim the dependency graph, reduce the import map, and speed up performance.\n */\n optimizeDependencies: {\n description:\n // breaking up this string causes an exception in ts-json-schema-generator\n 'Excludes unused dependencies in the generated config during an init run. This helps trim the dependency graph, reduce the import map, and speed up performance.',\n } as Feature,\n\n /** Enables relative resource paths to be used in import map paths when useSingleWebServer is true. (default: true) */\n relativeImportMapPaths: {\n description:\n 'Enables relative resource paths to be used in import map paths when useSingleWebServer is true. (default: true)',\n default: true,\n } as Feature,\n\n /** Creates null entries for unused exports in generated config so that they are not included when bundling. */\n removeUnusedExports: {\n description:\n 'Creates null entries for unused exports in generated config so that they are not included when bundling.',\n } as Feature,\n\n /** @deprecated Removed in favor of `resolve-web-extensions` bundler capability. Enables React Native type resolution of .web.ts extensions. */\n resolveWebExtensions: { description: 'Enables React Native type resolution of .web.ts extensions.' } as Feature,\n\n /** Enables the syncing of bundles. */\n syncBundles: { description: 'Enables the syncing of bundles.' } as Feature,\n\n /** Enables the syncing of internal packages. */\n syncInternalPackages: { description: 'Enables the syncing of internal packages.' } as Feature,\n\n /** Use a single server for both bundles and app assets (default: true). */\n useSingleWebServer: {\n description: 'Use a single server for both bundles and app assets (default: true).',\n default: true,\n } as Feature,\n\n /** Enables the verification of exports during init. */\n verifyExports: { description: 'Enables the verification of exports during init.' } as Feature,\n\n // Please add new features in alphabetical order!\n // Don't forget to add them to the doc site as well!\n};\n\n/**\n * Record of features that are enabled by default.\n */\nexport const defaultFeatures = Object.fromEntries(\n Object.entries(allFeatures)\n .filter(([_, feature]) => feature.default)\n .map(([name]) => [name, true]),\n) as Features;\n"]}
1
+ {"version":3,"file":"allFeatures.js","sourceRoot":"","sources":["../src/allFeatures.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,8FAA8F;IAE9F,mHAAmH;IACnH,iBAAiB,EAAE;QACjB,WAAW,EACT,8GAA8G;QAChH,OAAO,EAAE,IAAI;KACH;IAEZ,2DAA2D;IAC3D,iBAAiB,EAAE,EAAE,WAAW,EAAE,sDAAsD,EAAa;IAErG,uCAAuC;IACvC,iBAAiB,EAAE,EAAE,WAAW,EAAE,mCAAmC,EAAa;IAElF;;;OAGG;IACH,mBAAmB,EAAE;QACnB,WAAW,EACT,4IAA4I;QAC9I,OAAO,EAAE,IAAI;KACH;IAEZ,8EAA8E;IAC9E,mBAAmB,EAAE;QACnB,WAAW,EAAE,uEAAuE;QACpF,OAAO,EAAE,IAAI;KACH;IAEZ;;OAEG;IACH,0BAA0B,EAAE;QAC1B,WAAW,EAAE,oEAAoE;KACvE;IAEZ;;;OAGG;IACH,SAAS,EAAE;QACT,WAAW,EACT,iJAAiJ;KACzI;IAEZ,mFAAmF;IACnF,mBAAmB,EAAE;QACnB,WAAW,EAAE,6EAA6E;QAC1F,OAAO,EAAE,IAAI;KACH;IAEZ,sEAAsE;IACtE,mBAAmB,EAAE,EAAE,WAAW,EAAE,iEAAiE,EAAa;IAElH,6FAA6F;IAC7F,sBAAsB,EAAE;QACtB,WAAW,EAAE,wFAAwF;KAC3F;IAEZ;;;OAGG;IACH,oBAAoB,EAAE;QACpB,WAAW;QACT,0EAA0E;QAC1E,iKAAiK;KACzJ;IAEZ,sHAAsH;IACtH,sBAAsB,EAAE;QACtB,WAAW,EACT,iHAAiH;QACnH,OAAO,EAAE,IAAI;KACH;IAEZ,+GAA+G;IAC/G,mBAAmB,EAAE;QACnB,WAAW,EACT,0GAA0G;KAClG;IAEZ,+IAA+I;IAC/I,oBAAoB,EAAE,EAAE,WAAW,EAAE,6DAA6D,EAAa;IAE/G,sCAAsC;IACtC,WAAW,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAa;IAE1E,gDAAgD;IAChD,oBAAoB,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAa;IAE7F,2EAA2E;IAC3E,kBAAkB,EAAE;QAClB,WAAW,EAAE,sEAAsE;QACnF,OAAO,EAAE,IAAI;KACH;IAEZ,uDAAuD;IACvD,aAAa,EAAE,EAAE,WAAW,EAAE,kDAAkD,EAAa;IAE7F,iDAAiD;IACjD,oDAAoD;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAC/C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;KACxB,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;KACzC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CACrB,CAAC","sourcesContent":["import type { Feature } from './Feature.js';\n\n/**\n * Represents all features that can be enabled or disabled for Cloudpack.\n */\nexport type Features = { [key in keyof typeof allFeatures]?: boolean };\n\n/**\n * A set of options for configuring the experience.\n * Features can be set to true to change the default behavior.\n */\nexport const allFeatures = {\n // The comments provide intellisense, and the description strings are used in the help output.\n\n /** Automatically updates the generated config when an unknown import path is used during start (default: true). */\n autoUpdateEntries: {\n description:\n 'Automatically updates the generated config when an unknown import path is used during start (default: true).',\n default: true,\n } as Feature,\n\n /** Disables the generation of source-maps during build. */\n disableSourceMaps: { description: 'Disables the generation of source-maps during build.' } as Feature,\n\n /** Enabled cloud-hosted application */\n enableCloudHosted: { description: 'Enables cloud-hosted application.' } as Feature,\n\n /**\n * Enables support of import maps for workers.\n * To use this feature, the package with the worker must be bundled with webpack (default: true).\n */\n enableModuleWorkers: {\n description:\n 'Enables support of import maps for workers. To use this feature, the package with the worker must be bundled with webpack (default: true).',\n default: true,\n } as Feature,\n\n /** Enables the use of `@parcel/watcher` for file watching (default: true). */\n enableParcelWatcher: {\n description: 'Enables the use of @parcel/watcher for file watching (default: true).',\n default: true,\n } as Feature,\n\n /**\n * Enables downloading bundles from remote cache instead of bundling.\n */\n enableRemoteCacheDownloads: {\n description: 'Enables downloading bundles from remote cache instead of bundling.',\n } as Feature,\n\n /**\n * Enables server-side rendering (SSR) for the application, including Node import map support.\n * This is experimental and may not work in all cases.\n */\n enableSSR: {\n description:\n 'Enables server-side rendering (SSR) for the application, including Node import map support. This is experimental and may not work in all cases.',\n } as Feature,\n\n /** Enables the file watcher to be spawned in a forked process (default: true). */\n enableWatcherInFork: {\n description: 'Enables the file watcher to be spawned in a forked process (default: true).',\n default: true,\n } as Feature,\n\n /** Enables the preemptive enqueueing of dependencies during build. */\n enqueueDependencies: { description: 'Enables the preemptive enqueueing of dependencies during build.' } as Feature,\n\n /** Check for dynamic (async) imports with non-literal paths in bundle output during init. */\n evaluateDynamicImports: {\n description: 'Check for dynamic (async) imports with non-literal paths in bundle output during init.',\n } as Feature,\n\n /**\n * Excludes unused dependencies in the generated config during an init run.\n * This helps trim the dependency graph, reduce the import map, and speed up performance.\n */\n optimizeDependencies: {\n description:\n // breaking up this string causes an exception in ts-json-schema-generator\n 'Excludes unused dependencies in the generated config during an init run. This helps trim the dependency graph, reduce the import map, and speed up performance.',\n } as Feature,\n\n /** Enables relative resource paths to be used in import map paths when useSingleWebServer is true. (default: true) */\n relativeImportMapPaths: {\n description:\n 'Enables relative resource paths to be used in import map paths when useSingleWebServer is true. (default: true)',\n default: true,\n } as Feature,\n\n /** Creates null entries for unused exports in generated config so that they are not included when bundling. */\n removeUnusedExports: {\n description:\n 'Creates null entries for unused exports in generated config so that they are not included when bundling.',\n } as Feature,\n\n /** @deprecated Removed in favor of `resolve-web-extensions` bundler capability. Enables React Native type resolution of .web.ts extensions. */\n resolveWebExtensions: { description: 'Enables React Native type resolution of .web.ts extensions.' } as Feature,\n\n /** Enables the syncing of bundles. */\n syncBundles: { description: 'Enables the syncing of bundles.' } as Feature,\n\n /** Enables the syncing of internal packages. */\n syncInternalPackages: { description: 'Enables the syncing of internal packages.' } as Feature,\n\n /** Use a single server for both bundles and app assets (default: true). */\n useSingleWebServer: {\n description: 'Use a single server for both bundles and app assets (default: true).',\n default: true,\n } as Feature,\n\n /** Enables the verification of exports during init. */\n verifyExports: { description: 'Enables the verification of exports during init.' } as Feature,\n\n // Please add new features in alphabetical order!\n // Don't forget to add them to the doc site as well!\n};\n\n/**\n * Record of features that are enabled by default.\n */\nexport const defaultFeatures = Object.fromEntries(\n Object.entries(allFeatures)\n .filter(([_, feature]) => feature.default)\n .map(([name]) => [name, true]),\n) as Features;\n"]}
package/lib/index.d.ts CHANGED
@@ -27,7 +27,7 @@ export type { TelemetryConfig } from './TelemetryConfig.js';
27
27
  export type { AppConfig } from './AppConfig.js';
28
28
  export type { BundlerCapability, InternalBundlerCapabilityImplementations, InternalBundlerCapabilitiesMetaData, BundlerCapabilitiesOptions, ExternalBundlerCapabilityModule, BundlerCapabilityFunction, } from './BundlerCapability.js';
29
29
  export type { RemoteCacheConfig } from './RemoteCacheConfig.js';
30
- export type { RenderFunction, RenderFunctionOptions, RenderFunctionResult, ServerRenderFunctionOptions, ExpandedRenderFunctionResult, RenderFunctionScript, } from './RenderFunction.js';
30
+ export type { RenderFunction, RenderFunctionOptions, RenderFunctionResult, ExpandedRenderFunctionResult, RenderFunctionScript, RequestInfo, ServerEntryFunction, ServerEntryFunctionOptions, ServerEntryFunctionResult, ServerEntryFunctionScript, } from './RenderFunction.js';
31
31
  export type { Request, Response, RequestHandler } from 'express';
32
32
  export type { Session } from './Session.js';
33
33
  export type { ResolveMap } from './ResolveMap.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/lib/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAiB,MAAM,kBAAkB,CAAC;AA0D/E,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,YAAY,CAAC","sourcesContent":["export { allFeatures, defaultFeatures, type Features } from './allFeatures.js';\nexport type {\n GetPackageDefinitionOptions,\n PackageDefinitionTransform,\n PackageDefinitionTransformFactory,\n PackageDefinitionsCache,\n PackageImporterContext,\n SerializablePackageDefinitionsCache,\n} from './PackageDefinitionsCache.js';\nexport type {\n LiteralOrString,\n PackageJson,\n PackageJsonCloudpackMeta,\n PackageJsonDependencies,\n PackageJsonExportCondition,\n PackageJsonExports,\n PackageJsonExportsObject,\n GeneratedExports,\n PackageJsonExportsValue,\n} from './PackageJson.js';\nexport type { BundleContext } from './BundleContext.js';\nexport type { BundleMessage } from './BundleMessage.js';\nexport type { BundleMessageLocation } from './BundleMessageLocation.js';\nexport type { BundleMessageNote } from './BundleMessageNote.js';\nexport type { BundleMode } from './BundleMode.js';\nexport type { BundleOptions } from './BundleOptions.js';\nexport type { BundleOutputFile } from './BundleOutputFile.js';\nexport type { BundleResult } from './BundleResult.js';\nexport type { BundlerResult } from './BundlerResult.js';\nexport type { Bundler } from './Bundler.js';\nexport type { CloudpackConfig, CloudpackLinkConfig } from './CloudpackConfig.js';\nexport type { ServerConfig } from './ServerConfig.js';\nexport type { ExpandedSourcePath } from './ExpandedSourcePath.js';\nexport type { Feature } from './Feature.js';\nexport type { GeneratedConfig } from './GeneratedConfig.js';\nexport type { HttpsConfig } from './HttpsConfig.js';\nexport type { LinkOptions } from './LinkOptions.js';\nexport type { ModuleType } from './ModuleType.js';\nexport type { PackageHashesCache, PackageHashOptions, SerializablePackageHashesCache } from './PackageHashesCache.js';\nexport type {\n PackageSettings,\n PackageSettingsMatch,\n PackageSettingsMatchObject,\n GeneratedPackageSettings,\n} from './PackageSettings.js';\nexport type {\n BootstrapRoute,\n ProxyRoute,\n RedirectRoute,\n RenderedRoute,\n Route,\n RouteMatch,\n SharedRouteOptions,\n ShorthandRenderedRoute,\n ShorthandBootstrapRoute,\n ShorthandRoute,\n StaticRoute,\n} from './Route.js';\nexport {\n isBootstrapRoute,\n isProxyRoute,\n isRenderedRoute,\n isStaticRoute,\n isRedirectRoute,\n isShorthandBootstrapRoute,\n isShorthandRenderedRoute,\n} from './Route.js';\nexport type { TelemetryConfig } from './TelemetryConfig.js';\nexport type { AppConfig } from './AppConfig.js';\nexport type {\n BundlerCapability,\n InternalBundlerCapabilityImplementations,\n InternalBundlerCapabilitiesMetaData,\n BundlerCapabilitiesOptions,\n ExternalBundlerCapabilityModule,\n BundlerCapabilityFunction,\n} from './BundlerCapability.js';\nexport type { RemoteCacheConfig } from './RemoteCacheConfig.js';\nexport type {\n RenderFunction,\n RenderFunctionOptions,\n RenderFunctionResult,\n ServerRenderFunctionOptions,\n ExpandedRenderFunctionResult,\n RenderFunctionScript,\n} from './RenderFunction.js';\nexport type { Request, Response, RequestHandler } from 'express';\nexport type { Session } from './Session.js';\nexport type { ResolveMap } from './ResolveMap.js';\nexport type { ResolveMapEntry } from './ResolveMapEntry.js';\nexport type { LinkedPath } from './LinkedPath.js';\nexport type { ImportMap } from './ImportMap.js';\nexport type { UserPreferences } from './UserPreferences.js';\nexport type { TargetEnvironment } from './TargetEnvironment.js';\nexport type { NestedPartial } from './NestedPartial.js';\nexport type { WithOptional } from './WithOptional.js';\nexport type { WithRequired } from './WithRequired.js';\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAiB,MAAM,kBAAkB,CAAC;AA0D/E,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,YAAY,CAAC","sourcesContent":["export { allFeatures, defaultFeatures, type Features } from './allFeatures.js';\nexport type {\n GetPackageDefinitionOptions,\n PackageDefinitionTransform,\n PackageDefinitionTransformFactory,\n PackageDefinitionsCache,\n PackageImporterContext,\n SerializablePackageDefinitionsCache,\n} from './PackageDefinitionsCache.js';\nexport type {\n LiteralOrString,\n PackageJson,\n PackageJsonCloudpackMeta,\n PackageJsonDependencies,\n PackageJsonExportCondition,\n PackageJsonExports,\n PackageJsonExportsObject,\n GeneratedExports,\n PackageJsonExportsValue,\n} from './PackageJson.js';\nexport type { BundleContext } from './BundleContext.js';\nexport type { BundleMessage } from './BundleMessage.js';\nexport type { BundleMessageLocation } from './BundleMessageLocation.js';\nexport type { BundleMessageNote } from './BundleMessageNote.js';\nexport type { BundleMode } from './BundleMode.js';\nexport type { BundleOptions } from './BundleOptions.js';\nexport type { BundleOutputFile } from './BundleOutputFile.js';\nexport type { BundleResult } from './BundleResult.js';\nexport type { BundlerResult } from './BundlerResult.js';\nexport type { Bundler } from './Bundler.js';\nexport type { CloudpackConfig, CloudpackLinkConfig } from './CloudpackConfig.js';\nexport type { ServerConfig } from './ServerConfig.js';\nexport type { ExpandedSourcePath } from './ExpandedSourcePath.js';\nexport type { Feature } from './Feature.js';\nexport type { GeneratedConfig } from './GeneratedConfig.js';\nexport type { HttpsConfig } from './HttpsConfig.js';\nexport type { LinkOptions } from './LinkOptions.js';\nexport type { ModuleType } from './ModuleType.js';\nexport type { PackageHashesCache, PackageHashOptions, SerializablePackageHashesCache } from './PackageHashesCache.js';\nexport type {\n PackageSettings,\n PackageSettingsMatch,\n PackageSettingsMatchObject,\n GeneratedPackageSettings,\n} from './PackageSettings.js';\nexport type {\n BootstrapRoute,\n ProxyRoute,\n RedirectRoute,\n RenderedRoute,\n Route,\n RouteMatch,\n SharedRouteOptions,\n ShorthandRenderedRoute,\n ShorthandBootstrapRoute,\n ShorthandRoute,\n StaticRoute,\n} from './Route.js';\nexport {\n isBootstrapRoute,\n isProxyRoute,\n isRenderedRoute,\n isStaticRoute,\n isRedirectRoute,\n isShorthandBootstrapRoute,\n isShorthandRenderedRoute,\n} from './Route.js';\nexport type { TelemetryConfig } from './TelemetryConfig.js';\nexport type { AppConfig } from './AppConfig.js';\nexport type {\n BundlerCapability,\n InternalBundlerCapabilityImplementations,\n InternalBundlerCapabilitiesMetaData,\n BundlerCapabilitiesOptions,\n ExternalBundlerCapabilityModule,\n BundlerCapabilityFunction,\n} from './BundlerCapability.js';\nexport type { RemoteCacheConfig } from './RemoteCacheConfig.js';\nexport type {\n RenderFunction,\n RenderFunctionOptions,\n RenderFunctionResult,\n ExpandedRenderFunctionResult,\n RenderFunctionScript,\n RequestInfo,\n ServerEntryFunction,\n ServerEntryFunctionOptions,\n ServerEntryFunctionResult,\n ServerEntryFunctionScript,\n} from './RenderFunction.js';\nexport type { Request, Response, RequestHandler } from 'express';\nexport type { Session } from './Session.js';\nexport type { ResolveMap } from './ResolveMap.js';\nexport type { ResolveMapEntry } from './ResolveMapEntry.js';\nexport type { LinkedPath } from './LinkedPath.js';\nexport type { ImportMap } from './ImportMap.js';\nexport type { UserPreferences } from './UserPreferences.js';\nexport type { TargetEnvironment } from './TargetEnvironment.js';\nexport type { NestedPartial } from './NestedPartial.js';\nexport type { WithOptional } from './WithOptional.js';\nexport type { WithRequired } from './WithRequired.js';\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ms-cloudpack/common-types",
3
- "version": "0.26.3",
3
+ "version": "0.27.0",
4
4
  "description": "Common types for Cloudpack.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -825,6 +825,9 @@
825
825
  "enableModuleWorkers": {
826
826
  "type": "boolean"
827
827
  },
828
+ "enableParcelWatcher": {
829
+ "type": "boolean"
830
+ },
828
831
  "enableRemoteCacheDownloads": {
829
832
  "type": "boolean"
830
833
  },
@@ -946,7 +949,7 @@
946
949
  "items": {
947
950
  "type": "string"
948
951
  },
949
- "description": "Paths used for file monitoring and input hashing. Supports glob matching. Defaults are under `@ms-cloudpack/path-utilities` in `sourceFilesGlobs`. Use `...` to include the default paths."
952
+ "description": "Paths used for file monitoring and input hashing. Supports glob matching. Defaults are under `@ms-cloudpack/path-utilities` in `sourceFilesGlobs`. Use `...` to include the default paths.\n\nFor input hashing, both positive and negative globs are considered. For file watching, behavior depends on the watcher backend:\n- Parcel watcher (default): only negative globs are respected for ignoring files\n- Chokidar watcher: both positive and negative globs are supported"
950
953
  },
951
954
  "ignoreMissingExports": {
952
955
  "anyOf": [
@@ -826,6 +826,9 @@
826
826
  "enableModuleWorkers": {
827
827
  "type": "boolean"
828
828
  },
829
+ "enableParcelWatcher": {
830
+ "type": "boolean"
831
+ },
829
832
  "enableRemoteCacheDownloads": {
830
833
  "type": "boolean"
831
834
  },
@@ -947,7 +950,7 @@
947
950
  "items": {
948
951
  "type": "string"
949
952
  },
950
- "description": "Paths used for file monitoring and input hashing. Supports glob matching. Defaults are under `@ms-cloudpack/path-utilities` in `sourceFilesGlobs`. Use `...` to include the default paths."
953
+ "description": "Paths used for file monitoring and input hashing. Supports glob matching. Defaults are under `@ms-cloudpack/path-utilities` in `sourceFilesGlobs`. Use `...` to include the default paths.\n\nFor input hashing, both positive and negative globs are considered. For file watching, behavior depends on the watcher backend:\n- Parcel watcher (default): only negative globs are respected for ignoring files\n- Chokidar watcher: both positive and negative globs are supported"
951
954
  },
952
955
  "ignoreMissingExports": {
953
956
  "anyOf": [