adrian/webiny-root-exports-2026-04-02

extensions/MyApiKeyAfterUpdate.ts

@@ -1,6 +1,5 @@
 import { ApiKeyAfterUpdateEventHandler } from "webiny/api/security/api-key";
-import { Logger } from "webiny/api/logger";
-import { BuildParams } from "webiny/api/build-params";
+import { Logger, BuildParams } from "webiny/api";
 
 class MyApiKeyAfterUpdateImpl implements ApiKeyAfterUpdateEventHandler.Interface {
     constructor(

packages/api-core/src/exports/api.ts

@@ -0,0 +1,2 @@
+export { Logger } from "~/features/logger/index.js";
+export { BuildParam, BuildParams } from "~/features/buildParams/index.js";

packages/api-core/src/exports/api/build-params.ts

@@ -1 +1,2 @@
+/** @deprecated Import from "webiny/api" instead. */
 export { BuildParam, BuildParams } from "~/features/buildParams/index.js";

packages/api-core/src/exports/api/logger.ts

@@ -1 +1,2 @@
+/** @deprecated Import from "webiny/api" instead. */
 export { Logger } from "~/features/logger/index.js";

packages/webiny/package.json

@@ -77,6 +77,7 @@
     "./api/system": "./api/system.js",
     "./api/tasks": "./api/tasks.js",
     "./api/tenancy": "./api/tenancy.js",
+    "./api": "./api.js",
     "./api/file-manager/file": "./api/file-manager/file.js",
     "./api/file-manager/permissions": "./api/file-manager/permissions.js",
     "./api/file-manager/settings": "./api/file-manager/settings.js",
@@ -118,7 +119,6 @@
     "./admin/website-builder": "./admin/website-builder.js",
     "./cli/command": "./cli/command.js",
     "./cli": "./cli.js",
-    "./api": "./api.js",
     "./admin/lexical": "./admin/lexical.js",
     "./infra/admin": "./infra/admin.js",
     "./infra/api": "./infra/api.js",

packages/webiny/src/api.ts

@@ -1 +1,3 @@
+export { Logger } from "@webiny/api-core/features/logger/index.js";
+export { BuildParam, BuildParams } from "@webiny/api-core/features/buildParams/index.js";
 export { createFeature, createAbstraction, Result, BaseError } from "@webiny/feature/api/index.js";

packages/webiny/src/api/build-params.ts

@@ -1 +1,2 @@
+/** @deprecated Import from "webiny/api" instead. */
 export { BuildParam, BuildParams } from "@webiny/api-core/features/buildParams/index.js";

packages/webiny/src/api/logger.ts

@@ -1 +1,2 @@
+/** @deprecated Import from "webiny/api" instead. */
 export { Logger } from "@webiny/api-core/features/logger/index.js";

scripts/cli/src/abstractions/services/ParseExportsFileService.ts

@@ -11,6 +11,7 @@ export interface ExportStatement {
     source: string;
     isWildcard: boolean;
     isTypeOnly: boolean;
+    jsdoc?: string;
 }
 
 export interface IParseExportsFileService {

scripts/cli/src/services/MergeExportsService/MergeExportsService.ts

@@ -12,6 +12,7 @@ export class DefaultMergeExportsService implements MergeExportsServiceNamespace.
             source: string;
             isWildcard: boolean;
             isTypeOnly: boolean;
+            jsdoc?: string;
         }> = [];
 
         for (const input of inputs) {
@@ -35,13 +36,17 @@ export class DefaultMergeExportsService implements MergeExportsServiceNamespace.
                     namedExports: statement.namedExports,
                     source: sourceWithPackageName,
                     isWildcard: statement.isWildcard,
-                    isTypeOnly: statement.isTypeOnly
+                    isTypeOnly: statement.isTypeOnly,
+                    jsdoc: statement.jsdoc
                 });
             }
         }
 
         let output = "";
         for (const exportStatement of mergedExports) {
+            if (exportStatement.jsdoc) {
+                output += `${exportStatement.jsdoc}\n`;
+            }
             if (exportStatement.isWildcard) {
                 output += `export * from "${exportStatement.source}";\n`;
             } else {

scripts/cli/src/services/ParseExportsFileService/ParseExportsFileService.ts

@@ -45,11 +45,17 @@ export class DefaultParseExportsFileService implements ParseExportsFileService.I
                     });
                 }
 
+                const fullText = exportDeclaration.getFullText();
+                const text = exportDeclaration.getText();
+                const leading = fullText.substring(0, fullText.lastIndexOf(text)).trim();
+                const jsdoc = leading.includes("@deprecated") ? leading : undefined;
+
                 exportStatements.push({
                     namedExports,
                     source: moduleSpecifier,
                     isWildcard: false,
-                    isTypeOnly: isExportTypeOnly
+                    isTypeOnly: isExportTypeOnly,
+                    jsdoc
                 });
             }
         }

skills/user-skills/api/api-architect/SKILL.md

@@ -426,7 +426,7 @@ export const CreateEntityFeature = createFeature({
 A deployed API must **NEVER** use `process.env` to read configuration. All configuration flows through `BuildParams` via DI:
 
 ```ts
-import { BuildParams } from "webiny/api/build-params";
+import { BuildParams } from "webiny/api";
 
 class MyServiceImpl implements MyService.Interface {
   constructor(private buildParams: BuildParams.Interface) {}

skills/user-skills/dependency-injection/SKILL.md

@@ -20,8 +20,7 @@ Every Webiny extension type uses the same DI pattern: define a class implementin
 
 ```typescript
 import { SomeFactory } from "webiny/some/path";
-import { Logger } from "webiny/api/logger";
-import { BuildParams } from "webiny/api/build-params";
+import { Logger, BuildParams } from "webiny/api";
 
 class MyImplementation implements SomeFactory.Interface {
   constructor(

skills/user-skills/generated/api/build-params/SKILL.md

@@ -18,13 +18,13 @@ description: >
 
 ---
 **Name:** `BuildParam`
-**Import:** `import { BuildParam } from "webiny/api/build-params"`
+**Import:** `import { BuildParam } from "webiny/api"`
 **Source:** `@webiny/api-core/features/buildParams/index.ts`
 **Description:** A single build-time configuration parameter.
 
 ---
 **Name:** `BuildParams`
-**Import:** `import { BuildParams } from "webiny/api/build-params"`
+**Import:** `import { BuildParams } from "webiny/api"`
 **Source:** `@webiny/api-core/features/buildParams/index.ts`
 **Description:** Access build-time configuration parameters.
 

skills/user-skills/generated/api/logger/SKILL.md

@@ -18,7 +18,7 @@ description: >
 
 ---
 **Name:** `Logger`
-**Import:** `import { Logger } from "webiny/api/logger"`
+**Import:** `import { Logger } from "webiny/api"`
 **Source:** `@webiny/api-core/features/logger/index.ts`
 **Description:** Structured logging with multiple log levels.
 

skills/user-skills/local-development/SKILL.md

@@ -170,7 +170,7 @@ During `yarn webiny watch api`:
 - Use `Logger` (DI-injected) for production logging to CloudWatch
 
 ```typescript
-import { Logger } from "webiny/api/logger";
+import { Logger } from "webiny/api";
 
 // In your extension class
 this.logger.info("Processing request...");