@adobe/aio-commerce-lib-app 1.9.0 → 1.10.0-beta-20260805105734

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @adobe/aio-commerce-lib-app
 
+## 1.10.0-beta-20260805105734
+### Minor Changes
+
+
+
+- [#606](https://github.com/adobe/aio-commerce-sdk/pull/606) [`a18a250`](https://github.com/adobe/aio-commerce-sdk/commit/a18a2506b9d6fafb0b96ca8b7960208e51546dc3) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Custom installation step scripts can now be TypeScript (`.ts`) files, not just JavaScript.
+
+
+
+- [#606](https://github.com/adobe/aio-commerce-sdk/pull/606) [`a18a250`](https://github.com/adobe/aio-commerce-sdk/commit/a18a2506b9d6fafb0b96ca8b7960208e51546dc3) Thanks [@iivvaannxx](https://github.com/iivvaannxx)! - Add TypeScript project scaffolding and support TypeScript Commerce configuration in generated Runtime actions.
+
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @adobe/aio-commerce-lib-admin-ui@1.0.0
+  - @adobe/aio-commerce-lib-auth@1.1.2
+  - @adobe/aio-commerce-lib-config@1.6.0
+  - @adobe/aio-commerce-lib-events@1.3.0
+  - @adobe/aio-commerce-lib-webhooks@1.2.0
+
 ## 1.9.0
 
 ### Minor Changes

package/README.md

@@ -2,7 +2,7 @@
 
 App configuration management library for Adobe Commerce applications.
 
-This library provides tools for defining, validating, and managing configurations for Adobe Commerce applications. It defines the configuration schema, provides validation, and supports multiple configuration file formats with built-in TypeScript support.
+This library provides tools for defining, validating, and managing configurations for Adobe Commerce applications. It defines the configuration schema, provides validation, and can scaffold App Builder projects with TypeScript configuration support, build configuration, and type checking.
 
 ## Installation
 

package/dist/cjs/actions/app-config/index.cjs

@@ -13,10 +13,10 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../../rolldown-runtime-Cozy-1ZF.cjs');
-const require_environment = require('../../environment-B7EnozSg.cjs');
-const require_validate = require('../../validate-Dt0Fdj1L.cjs');
-const require_router = require('../../router-hA_Y9gZ1.cjs');
+const require_rolldown_runtime = require('../../rolldown-runtime-CDQd2xEI.cjs');
+const require_environment = require('../../environment-B6533pAY.cjs');
+const require_validate = require('../../validate-C6424wM6.cjs');
+const require_router = require('../../router-CxDTb6r1.cjs');
 let _adobe_aio_commerce_lib_config = require("@adobe/aio-commerce-lib-config");
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);
@@ -29,7 +29,7 @@ let crypto = require("crypto");
 * Loads the committed OpenAPI spec via dynamic import so it
 * lands in its own chunk and is not parsed on every cold start.
 */
-const importOpenApi = () => Promise.resolve().then(() => require("../../openapi-BzRN5Lc6.cjs"));
+const importOpenApi = () => Promise.resolve().then(() => require("../../openapi-BwlVkeez.cjs"));
 /** Matches component schema `$ref` strings, capturing the schema name. */
 const SCHEMA_REF_PATTERN = /"#\/components\/schemas\/(\w+)"/g;
 /**
@@ -80,7 +80,7 @@ function pruneUnusedTags(spec) {
 * @param domains - The active config domains.
 */
 function getOpenApiCacheKey(domains) {
-	const input = `1.9.0:${[...domains].sort().join(",")}:2.0.0`;
+	const input = `1.10.0-beta-20260805105734:${[...domains].sort().join(",")}:2.0.0`;
 	return (0, crypto.createHash)("sha256").update(input).digest("hex").slice(0, 8);
 }
 /** Returns the server URL to be set in the OpenAPI spec, based on the current namespace. */

package/dist/cjs/actions/app-config/index.d.cts

@@ -13,7 +13,7 @@
  */
 
 import "../../index-DWEigxhy.cjs";
-import { n as CommerceAppConfig } from "../../app-e4bCHpek.cjs";
+import { n as CommerceAppConfig } from "../../app-CSqkACEm.cjs";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 //#region source/actions/app-config/router.d.ts
 /** The arguments required to create the runtime action for the app-config action. */

package/dist/cjs/actions/association/index.cjs

@@ -13,9 +13,9 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../../rolldown-runtime-Cozy-1ZF.cjs');
+const require_rolldown_runtime = require('../../rolldown-runtime-CDQd2xEI.cjs');
 const require_repository = require('../../repository-CbceYZqc.cjs');
-const require_router = require('../../router-hA_Y9gZ1.cjs');
+const require_router = require('../../router-CxDTb6r1.cjs');
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);
 let _adobe_aio_commerce_lib_core_commerce = require("@adobe/aio-commerce-lib-core/commerce");

package/dist/cjs/actions/config/index.cjs

@@ -13,10 +13,10 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../../rolldown-runtime-Cozy-1ZF.cjs');
-const require_schemas = require('../../schemas-mLxMh_ko.cjs');
-const require_environment = require('../../environment-B7EnozSg.cjs');
-const require_router = require('../../router-hA_Y9gZ1.cjs');
+const require_rolldown_runtime = require('../../rolldown-runtime-CDQd2xEI.cjs');
+const require_schemas = require('../../schemas-3e49M8zz.cjs');
+const require_environment = require('../../environment-B6533pAY.cjs');
+const require_router = require('../../router-CxDTb6r1.cjs');
 let _adobe_aio_commerce_lib_config = require("@adobe/aio-commerce-lib-config");
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);
@@ -118,7 +118,8 @@ router.put("/", {
 			params: rawParams,
 			schema: rawParams.configSchema
 		});
-		const result = await (0, _adobe_aio_commerce_lib_config.setConfiguration)({ config: config.filter((item) => item.value !== MASKED_PASSWORD_VALUE) }, (0, _adobe_aio_commerce_lib_config.byScopeId)(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
+		const updatedFields = config.filter((item) => item.value !== MASKED_PASSWORD_VALUE);
+		const result = await (0, _adobe_aio_commerce_lib_config.setConfiguration)({ config: updatedFields }, (0, _adobe_aio_commerce_lib_config.byScopeId)(scopeId), { encryptionKey: rawParams.AIO_COMMERCE_CONFIG_ENCRYPTION_KEY });
 		result.config = filterPasswordFields(configSchema, result.config);
 		return (0, _adobe_aio_commerce_lib_core_responses.ok)({
 			body: result,

package/dist/cjs/actions/installation/index.cjs

@@ -13,11 +13,11 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../../rolldown-runtime-Cozy-1ZF.cjs');
-const require_schemas = require('../../schemas-mLxMh_ko.cjs');
-const require_validate = require('../../validate-Dt0Fdj1L.cjs');
-const require_management = require('../../management-DmH7fVxy.cjs');
-const require_router = require('../../router-hA_Y9gZ1.cjs');
+const require_rolldown_runtime = require('../../rolldown-runtime-CDQd2xEI.cjs');
+const require_schemas = require('../../schemas-3e49M8zz.cjs');
+const require_validate = require('../../validate-C6424wM6.cjs');
+const require_management = require('../../management-BeVfzKuc.cjs');
+const require_router = require('../../router-CxDTb6r1.cjs');
 let _adobe_aio_lib_state = require("@adobe/aio-lib-state");
 let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot, 1);
@@ -628,6 +628,13 @@ async function getInstallationSnapshot() {
 //#endregion
 //#region source/actions/installation/index.ts
 /**
+* Defines a type-safe custom installation scripts loader.
+* @param loader - The custom scripts loader implementation.
+*/
+function defineCustomScriptsLoader(loader) {
+	return loader;
+}
+/**
 * Factory to create the route handler for the `installation` action.
 * @param args - The arguments required to create the runtime action.
 */
@@ -642,4 +649,5 @@ const installationRuntimeAction = (args) => async (params) => {
 };
 
 //#endregion
+exports.defineCustomScriptsLoader = defineCustomScriptsLoader;
 exports.installationRuntimeAction = installationRuntimeAction;

package/dist/cjs/actions/installation/index.d.cts

@@ -13,10 +13,11 @@
  */
 
 import "../../index-DWEigxhy.cjs";
-import { n as CommerceAppConfig, r as CommerceAppConfigOutputModel } from "../../app-e4bCHpek.cjs";
-import { Y as InstallationContext } from "../../index-Ds7AyoNv.cjs";
+import { n as CommerceAppConfig, r as CommerceAppConfigOutputModel } from "../../app-CSqkACEm.cjs";
+import { Y as InstallationContext } from "../../index-NxK_-lg1.cjs";
 import { RuntimeActionParams } from "@adobe/aio-commerce-lib-core/params";
 //#region source/actions/installation/router.d.ts
+/** Loads generated custom installation script modules. */
 type CustomScriptsLoader = (config: CommerceAppConfigOutputModel, logger: InstallationContext["logger"]) => Record<string, unknown>;
 /** Arguments for the runtime action factory. */
 type RuntimeActionFactoryArgs = {
@@ -25,10 +26,15 @@ type RuntimeActionFactoryArgs = {
 };
 //#endregion
 //#region source/actions/installation/index.d.ts
+/**
+ * Defines a type-safe custom installation scripts loader.
+ * @param loader - The custom scripts loader implementation.
+ */
+declare function defineCustomScriptsLoader(loader: CustomScriptsLoader): CustomScriptsLoader;
 /**
  * Factory to create the route handler for the `installation` action.
  * @param args - The arguments required to create the runtime action.
  */
 declare const installationRuntimeAction: (args: RuntimeActionFactoryArgs) => (params: RuntimeActionParams) => Promise<import("@adobe/aio-commerce-lib-core/responses").ActionResponse>;
 //#endregion
-export { installationRuntimeAction };
+export { type CustomScriptsLoader, defineCustomScriptsLoader, installationRuntimeAction };

package/dist/cjs/actions/scope-tree/index.cjs

@@ -13,10 +13,10 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('../../rolldown-runtime-Cozy-1ZF.cjs');
-const require_schemas = require('../../schemas-mLxMh_ko.cjs');
-const require_logging = require('../../logging-udPuAJPt.cjs');
-const require_router = require('../../router-hA_Y9gZ1.cjs');
+const require_rolldown_runtime = require('../../rolldown-runtime-CDQd2xEI.cjs');
+const require_schemas = require('../../schemas-3e49M8zz.cjs');
+const require_logging = require('../../logging-QTsrSwPc.cjs');
+const require_router = require('../../router-CxDTb6r1.cjs');
 let _adobe_aio_commerce_lib_api = require("@adobe/aio-commerce-lib-api");
 let _adobe_aio_commerce_lib_config = require("@adobe/aio-commerce-lib-config");
 let valibot = require("valibot");
@@ -97,11 +97,13 @@ router.post("/commerce", {
 		const { logger } = ctx;
 		logger.debug("Syncing commerce scopes...");
 		const { commerceBaseUrl, commerceEnv } = req.body;
-		const result = await (0, _adobe_aio_commerce_lib_config.syncCommerceScopes)((0, _adobe_aio_commerce_lib_api.resolveCommerceHttpClientParams)({
+		const paramsWithCommerceConfig = {
 			...ctx.rawParams,
 			AIO_COMMERCE_API_BASE_URL: commerceBaseUrl,
 			...commerceEnv && { AIO_COMMERCE_API_FLAVOR: commerceEnv }
-		}, { tryForwardAuthProvider: true }));
+		};
+		const commerceConfig = (0, _adobe_aio_commerce_lib_api.resolveCommerceHttpClientParams)(paramsWithCommerceConfig, { tryForwardAuthProvider: true });
+		const result = await (0, _adobe_aio_commerce_lib_config.syncCommerceScopes)(commerceConfig);
 		if (result.error) {
 			logger.error(`Error syncing commerce scopes: ${require_logging.inspect(result.error)}`);
 			return (0, _adobe_aio_commerce_lib_core_responses.internalServerError)({ body: {

package/dist/cjs/{app-e4bCHpek.d.cts → app-CSqkACEm.d.cts}

@@ -927,7 +927,7 @@ declare const CommerceAppConfigSchemas: {
     readonly customInstallationSteps: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
       readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 255, "The step description must not be longer than 255 characters">]>;
       readonly name: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 255, "The step name must not be longer than 255 characters">]>;
-      readonly script: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "Script path must end with .js (e.g., \"./setup.js\", \"./scripts/setup.js\", or \"../../scripts/setup.js\")">]>;
+      readonly script: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "Script path must end with .js or .ts (e.g., \"./setup.js\", \"./scripts/setup.ts\", or \"../../scripts/setup.js\")">]>;
     }, undefined>, "Expected an array of custom installation steps">, undefined>, v.CheckAction<{
       description: string;
       name: string;
@@ -941,7 +941,7 @@ declare const CommerceAppConfigSchemas: {
   readonly "installation.customInstallationSteps": v.ArraySchema<v.ObjectSchema<{
     readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 255, "The step description must not be longer than 255 characters">]>;
     readonly name: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 255, "The step name must not be longer than 255 characters">]>;
-    readonly script: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "Script path must end with .js (e.g., \"./setup.js\", \"./scripts/setup.js\", or \"../../scripts/setup.js\")">]>;
+    readonly script: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "Script path must end with .js or .ts (e.g., \"./setup.js\", \"./scripts/setup.ts\", or \"../../scripts/setup.js\")">]>;
   }, undefined>, "Expected an array of custom installation steps">;
   readonly metadata: v.ObjectSchema<{
     readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string for the ${string}`>, v.NonEmptyAction<string, `The ${string} must not be empty`>]>, v.MaxLengthAction<string, 255, "The metadata description must not be longer than 255 characters">]>;
@@ -1671,7 +1671,7 @@ declare const CommerceAppConfigSchema: v.LooseObjectSchema<{
     readonly customInstallationSteps: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
       readonly description: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 255, "The step description must not be longer than 255 characters">]>;
       readonly name: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.MaxLengthAction<string, 255, "The step name must not be longer than 255 characters">]>;
-      readonly script: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "Script path must end with .js (e.g., \"./setup.js\", \"./scripts/setup.js\", or \"../../scripts/setup.js\")">]>;
+      readonly script: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<`Expected a string value for '${string}'`>, v.NonEmptyAction<string, `The value of "${string}" must not be empty`>]>, v.RegexAction<string, "Script path must end with .js or .ts (e.g., \"./setup.js\", \"./scripts/setup.ts\", or \"../../scripts/setup.js\")">]>;
     }, undefined>, "Expected an array of custom installation steps">, undefined>, v.CheckAction<{
       description: string;
       name: string;