@webiny/project 6.0.0-rc.0 → 6.0.0-rc.2

package/extensions/AdminExtension.js

@@ -0,0 +1,99 @@
+import { defineExtension, zodSrcPath } from "./index.js";
+import { ExtensionSrcResolver } from "@webiny/project";
+import { z } from "zod";
+import path from "path";
+import { Node, Project } from "ts-morph";
+import crypto from "crypto";
+export const AdminExtension = defineExtension({
+  type: "Admin/Extension",
+  tags: {
+    runtimeContext: "app-build",
+    appName: "admin"
+  },
+  description: "Extend the Admin application with custom functionality.",
+  multiple: true,
+  paramsSchema: ({
+    project
+  }) => {
+    return z.object({
+      src: zodSrcPath({
+        project
+      }),
+      exportName: z.string().optional()
+    });
+  },
+  async build(params, ctx) {
+    const extensionsTsxFilePath = ctx.project.paths.workspaceFolder.join("apps", "admin", "src", "Extensions.tsx").toString();
+    const {
+      src: extensionFilePath
+    } = params;
+
+    // Resolve to absolute path for file operations.
+    const absoluteExtensionFilePath = ExtensionSrcResolver.resolvePath(extensionFilePath, ctx.project);
+    const extensionFileName = path.basename(absoluteExtensionFilePath);
+
+    // Export name can be customized or defaults to the file name without extension.
+    const exportName = params.exportName ?? path.parse(extensionFileName).name;
+
+    // Generate a constant hash-based component name to avoid using timestamps.
+    const hash = crypto.createHash("sha256").update(extensionFilePath).digest("hex");
+    const componentName = `AdminExtension_${hash.slice(-10)}`;
+    const project = new Project();
+    const importPath = path.relative(path.dirname(extensionsTsxFilePath), absoluteExtensionFilePath).replace(/\.tsx?$/, ".js");
+    project.addSourceFileAtPath(extensionsTsxFilePath);
+    const source = project.getSourceFileOrThrow(extensionsTsxFilePath);
+    const existingImportDeclaration = source.getImportDeclaration(importPath);
+    if (existingImportDeclaration) {
+      return;
+    }
+
+    // Check if the extension file has a default export or named export.
+    const extensionProject = new Project();
+    extensionProject.addSourceFileAtPath(absoluteExtensionFilePath);
+    const extensionSource = extensionProject.getSourceFileOrThrow(absoluteExtensionFilePath);
+    const hasDefaultExport = extensionSource.getDefaultExportSymbol() !== undefined;
+    let index = 1;
+    const importDeclarations = source.getImportDeclarations();
+    if (importDeclarations.length) {
+      const last = importDeclarations[importDeclarations.length - 1];
+      index = last.getChildIndex() + 1;
+    }
+
+    // Import as default export if available, otherwise import named export.
+    if (hasDefaultExport) {
+      source.insertImportDeclaration(index, {
+        defaultImport: componentName,
+        moduleSpecifier: importPath
+      });
+    } else {
+      source.insertImportDeclaration(index, {
+        namedImports: [{
+          name: exportName,
+          alias: componentName
+        }],
+        moduleSpecifier: importPath
+      });
+    }
+    const extensionsIdentifier = source.getFirstDescendant(node => {
+      if (!Node.isIdentifier(node)) {
+        return false;
+      }
+      return node.getText() === "Extensions";
+    });
+    if (!extensionsIdentifier) {
+      throw new Error(`Could not find the "Extensions" React component in "${extensionsTsxFilePath}". Did you maybe change the name of the component?`);
+    }
+    const extensionsArrowFn = extensionsIdentifier.getNextSibling(node => Node.isArrowFunction(node));
+    if (!extensionsArrowFn) {
+      throw new Error(`Could not find the "Extensions" React component in "${extensionsTsxFilePath}". Did you maybe change its definition? It should be an arrow function.`);
+    }
+    const extensionsArrowFnFragment = extensionsArrowFn.getFirstDescendant(node => {
+      return Node.isJsxFragment(node);
+    });
+    const extensionsArrowFnFragmentChildrenText = extensionsArrowFnFragment.getFullText().replace("<>", "").replace("</>", "").trim();
+    extensionsArrowFnFragment.replaceWithText(`<><${componentName}/>${extensionsArrowFnFragmentChildrenText}</>`);
+    await source.save();
+  }
+});
+
+//# sourceMappingURL=AdminExtension.js.map

package/extensions/AdminExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defineExtension","zodSrcPath","ExtensionSrcResolver","z","path","Node","Project","crypto","AdminExtension","type","tags","runtimeContext","appName","description","multiple","paramsSchema","project","object","src","exportName","string","optional","build","params","ctx","extensionsTsxFilePath","paths","workspaceFolder","join","toString","extensionFilePath","absoluteExtensionFilePath","resolvePath","extensionFileName","basename","parse","name","hash","createHash","update","digest","componentName","slice","importPath","relative","dirname","replace","addSourceFileAtPath","source","getSourceFileOrThrow","existingImportDeclaration","getImportDeclaration","extensionProject","extensionSource","hasDefaultExport","getDefaultExportSymbol","undefined","index","importDeclarations","getImportDeclarations","length","last","getChildIndex","insertImportDeclaration","defaultImport","moduleSpecifier","namedImports","alias","extensionsIdentifier","getFirstDescendant","node","isIdentifier","getText","Error","extensionsArrowFn","getNextSibling","isArrowFunction","extensionsArrowFnFragment","isJsxFragment","extensionsArrowFnFragmentChildrenText","getFullText","trim","replaceWithText","save"],"sources":["AdminExtension.ts"],"sourcesContent":["import { defineExtension, zodSrcPath } from \"~/extensions/index.js\";\nimport { ExtensionSrcResolver } from \"@webiny/project\";\nimport { z } from \"zod\";\nimport path from \"path\";\nimport { type JsxFragment, Node, Project } from \"ts-morph\";\nimport crypto from \"crypto\";\n\nexport const AdminExtension = defineExtension({\n    type: \"Admin/Extension\",\n    tags: { runtimeContext: \"app-build\", appName: \"admin\" },\n    description: \"Extend the Admin application with custom functionality.\",\n    multiple: true,\n    paramsSchema: ({ project }) => {\n        return z.object({\n            src: zodSrcPath({ project }),\n            exportName: z.string().optional()\n        });\n    },\n    async build(params, ctx) {\n        const extensionsTsxFilePath = ctx.project.paths.workspaceFolder\n            .join(\"apps\", \"admin\", \"src\", \"Extensions.tsx\")\n            .toString();\n\n        const { src: extensionFilePath } = params;\n\n        // Resolve to absolute path for file operations.\n        const absoluteExtensionFilePath = ExtensionSrcResolver.resolvePath(\n            extensionFilePath,\n            ctx.project\n        );\n\n        const extensionFileName = path.basename(absoluteExtensionFilePath);\n\n        // Export name can be customized or defaults to the file name without extension.\n        const exportName = params.exportName ?? path.parse(extensionFileName).name;\n\n        // Generate a constant hash-based component name to avoid using timestamps.\n        const hash = crypto.createHash(\"sha256\").update(extensionFilePath).digest(\"hex\");\n        const componentName = `AdminExtension_${hash.slice(-10)}`;\n\n        const project = new Project();\n\n        const importPath = path\n            .relative(path.dirname(extensionsTsxFilePath), absoluteExtensionFilePath)\n            .replace(/\\.tsx?$/, \".js\");\n\n        project.addSourceFileAtPath(extensionsTsxFilePath);\n\n        const source = project.getSourceFileOrThrow(extensionsTsxFilePath);\n\n        const existingImportDeclaration = source.getImportDeclaration(importPath);\n        if (existingImportDeclaration) {\n            return;\n        }\n\n        // Check if the extension file has a default export or named export.\n        const extensionProject = new Project();\n        extensionProject.addSourceFileAtPath(absoluteExtensionFilePath);\n        const extensionSource = extensionProject.getSourceFileOrThrow(absoluteExtensionFilePath);\n        const hasDefaultExport = extensionSource.getDefaultExportSymbol() !== undefined;\n\n        let index = 1;\n\n        const importDeclarations = source.getImportDeclarations();\n        if (importDeclarations.length) {\n            const last = importDeclarations[importDeclarations.length - 1];\n            index = last.getChildIndex() + 1;\n        }\n\n        // Import as default export if available, otherwise import named export.\n        if (hasDefaultExport) {\n            source.insertImportDeclaration(index, {\n                defaultImport: componentName,\n                moduleSpecifier: importPath\n            });\n        } else {\n            source.insertImportDeclaration(index, {\n                namedImports: [{ name: exportName, alias: componentName }],\n                moduleSpecifier: importPath\n            });\n        }\n\n        const extensionsIdentifier = source.getFirstDescendant(node => {\n            if (!Node.isIdentifier(node)) {\n                return false;\n            }\n\n            return node.getText() === \"Extensions\";\n        });\n\n        if (!extensionsIdentifier) {\n            throw new Error(\n                `Could not find the \"Extensions\" React component in \"${extensionsTsxFilePath}\". Did you maybe change the name of the component?`\n            );\n        }\n\n        const extensionsArrowFn = extensionsIdentifier.getNextSibling(node =>\n            Node.isArrowFunction(node)\n        );\n        if (!extensionsArrowFn) {\n            throw new Error(\n                `Could not find the \"Extensions\" React component in \"${extensionsTsxFilePath}\". Did you maybe change its definition? It should be an arrow function.`\n            );\n        }\n\n        const extensionsArrowFnFragment = extensionsArrowFn.getFirstDescendant(node => {\n            return Node.isJsxFragment(node);\n        }) as JsxFragment;\n\n        const extensionsArrowFnFragmentChildrenText = extensionsArrowFnFragment\n            .getFullText()\n            .replace(\"<>\", \"\")\n            .replace(\"</>\", \"\")\n            .trim();\n\n        extensionsArrowFnFragment.replaceWithText(\n            `<><${componentName}/>${extensionsArrowFnFragmentChildrenText}</>`\n        );\n\n        await source.save();\n    }\n});\n"],"mappings":"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","ignoreList":[]}

package/extensions/ApiBuildParam.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const BuildParam: import("~/defineExtension/index.js").ExtensionComponent<z.ZodObject<{
+    paramName: z.ZodString;
+    value: z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny, "many">, z.ZodNumber, z.ZodBoolean]>;
+}, "strip", z.ZodTypeAny, {
+    value: string | number | boolean | any[] | Record<string, any>;
+    paramName: string;
+}, {
+    value: string | number | boolean | any[] | Record<string, any>;
+    paramName: string;
+}>>;

package/extensions/ApiBuildParam.js

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import { Node, Project } from "ts-morph";
+import { defineExtension } from "../defineExtension/index.js";
+import crypto from "crypto";
+import path from "path";
+import fs from "fs";
+export const BuildParam = defineExtension({
+  type: "Api/BuildParam",
+  tags: {
+    runtimeContext: "app-build",
+    appName: "api"
+  },
+  description: "Add build-time parameter to API app.",
+  multiple: true,
+  paramsSchema: () => {
+    return z.object({
+      paramName: z.string(),
+      value: z.union([z.string(), z.record(z.any()), z.array(z.any()), z.number(), z.boolean()])
+    });
+  },
+  async build(params, ctx) {
+    const extensionsTsFilePath = ctx.project.paths.workspaceFolder.join("apps", "api", "graphql", "src", "extensions.ts").toString();
+    const buildParamsDir = ctx.project.paths.workspaceFolder.join("apps", "api", "graphql", "src", "buildParams").toString();
+    const {
+      paramName,
+      value
+    } = params;
+
+    // Serialize value to a TypeScript literal.
+    const valueStr = JSON.stringify(value, null, 4);
+
+    // Generate a unique class name based on the paramName.
+    const hash = crypto.createHash("sha256").update(paramName).digest("hex");
+    const className = `BuildParam_${hash.slice(-10)}`;
+    const fileName = `${className}.ts`;
+    const filePath = path.join(buildParamsDir, fileName);
+
+    // Ensure buildParams directory exists.
+    if (!fs.existsSync(buildParamsDir)) {
+      fs.mkdirSync(buildParamsDir, {
+        recursive: true
+      });
+    }
+
+    // Check if file already exists.
+    if (fs.existsSync(filePath)) {
+      // File exists, just ensure it's imported in extensions.ts
+    } else {
+      // Create the BuildParam implementation file.
+      const fileContent = `import { BuildParam } from "webiny/api/buildParams";
+
+class ${className} implements BuildParam.Interface {
+    key = "${paramName}";
+    value = ${valueStr};
+}
+
+export default BuildParam.createImplementation({
+    implementation: ${className},
+    dependencies: []
+});
+`;
+      fs.writeFileSync(filePath, fileContent, "utf8");
+    }
+
+    // Now update extensions.ts to import and register this BuildParam.
+    const project = new Project();
+    project.addSourceFileAtPath(extensionsTsFilePath);
+    const source = project.getSourceFileOrThrow(extensionsTsFilePath);
+
+    // Calculate import path relative to extensions.ts.
+    let importPath = path.relative(path.dirname(extensionsTsFilePath), filePath).replace(/\.tsx?$/, ".js");
+
+    // Ensure the path starts with ./
+    if (!importPath.startsWith(".")) {
+      importPath = "./" + importPath;
+    }
+
+    // Check if import already exists.
+    const existingImportDeclaration = source.getImportDeclaration(importPath);
+    if (existingImportDeclaration) {
+      return;
+    }
+    let index = 1;
+    const importDeclarations = source.getImportDeclarations();
+    if (importDeclarations.length) {
+      const last = importDeclarations[importDeclarations.length - 1];
+      index = last.getChildIndex() + 1;
+    }
+
+    // Add import for the BuildParam implementation.
+    source.insertImportDeclaration(index, {
+      defaultImport: className,
+      moduleSpecifier: importPath
+    });
+
+    // Add the registration to the plugins array.
+    const pluginsArray = source.getFirstDescendant(node => Node.isArrayLiteralExpression(node));
+    pluginsArray.addElement(`\ncreateContextPlugin(ctx => {\n\tregisterExtension(ctx.container, ${className});\n})`);
+    {
+      let index = 1;
+      const importDeclarations = source.getImportDeclarations();
+      if (importDeclarations.length) {
+        const last = importDeclarations[importDeclarations.length - 1];
+        index = last.getChildIndex() + 1;
+      }
+      const contextPluginImportPath = "@webiny/api/plugins/ContextPlugin";
+      const existingContextPluginImport = source.getImportDeclaration(contextPluginImportPath);
+      if (!existingContextPluginImport) {
+        source.insertImportDeclaration(index, {
+          namedImports: ["createContextPlugin"],
+          moduleSpecifier: contextPluginImportPath
+        });
+      }
+    }
+    await source.save();
+  }
+});
+
+//# sourceMappingURL=ApiBuildParam.js.map

package/extensions/ApiBuildParam.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["z","Node","Project","defineExtension","crypto","path","fs","BuildParam","type","tags","runtimeContext","appName","description","multiple","paramsSchema","object","paramName","string","value","union","record","any","array","number","boolean","build","params","ctx","extensionsTsFilePath","project","paths","workspaceFolder","join","toString","buildParamsDir","valueStr","JSON","stringify","hash","createHash","update","digest","className","slice","fileName","filePath","existsSync","mkdirSync","recursive","fileContent","writeFileSync","addSourceFileAtPath","source","getSourceFileOrThrow","importPath","relative","dirname","replace","startsWith","existingImportDeclaration","getImportDeclaration","index","importDeclarations","getImportDeclarations","length","last","getChildIndex","insertImportDeclaration","defaultImport","moduleSpecifier","pluginsArray","getFirstDescendant","node","isArrayLiteralExpression","addElement","contextPluginImportPath","existingContextPluginImport","namedImports","save"],"sources":["ApiBuildParam.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { Node, Project, ArrayLiteralExpression } from \"ts-morph\";\nimport { defineExtension } from \"~/defineExtension/index.js\";\nimport crypto from \"crypto\";\nimport path from \"path\";\nimport fs from \"fs\";\n\nexport const BuildParam = defineExtension({\n    type: \"Api/BuildParam\",\n    tags: { runtimeContext: \"app-build\", appName: \"api\" },\n    description: \"Add build-time parameter to API app.\",\n    multiple: true,\n    paramsSchema: () => {\n        return z.object({\n            paramName: z.string(),\n            value: z.union([\n                z.string(),\n                z.record(z.any()),\n                z.array(z.any()),\n                z.number(),\n                z.boolean()\n            ])\n        });\n    },\n    async build(params, ctx) {\n        const extensionsTsFilePath = ctx.project.paths.workspaceFolder\n            .join(\"apps\", \"api\", \"graphql\", \"src\", \"extensions.ts\")\n            .toString();\n\n        const buildParamsDir = ctx.project.paths.workspaceFolder\n            .join(\"apps\", \"api\", \"graphql\", \"src\", \"buildParams\")\n            .toString();\n\n        const { paramName, value } = params;\n\n        // Serialize value to a TypeScript literal.\n        const valueStr = JSON.stringify(value, null, 4);\n\n        // Generate a unique class name based on the paramName.\n        const hash = crypto.createHash(\"sha256\").update(paramName).digest(\"hex\");\n        const className = `BuildParam_${hash.slice(-10)}`;\n        const fileName = `${className}.ts`;\n        const filePath = path.join(buildParamsDir, fileName);\n\n        // Ensure buildParams directory exists.\n        if (!fs.existsSync(buildParamsDir)) {\n            fs.mkdirSync(buildParamsDir, { recursive: true });\n        }\n\n        // Check if file already exists.\n        if (fs.existsSync(filePath)) {\n            // File exists, just ensure it's imported in extensions.ts\n        } else {\n            // Create the BuildParam implementation file.\n            const fileContent = `import { BuildParam } from \"webiny/api/buildParams\";\n\nclass ${className} implements BuildParam.Interface {\n    key = \"${paramName}\";\n    value = ${valueStr};\n}\n\nexport default BuildParam.createImplementation({\n    implementation: ${className},\n    dependencies: []\n});\n`;\n            fs.writeFileSync(filePath, fileContent, \"utf8\");\n        }\n\n        // Now update extensions.ts to import and register this BuildParam.\n        const project = new Project();\n        project.addSourceFileAtPath(extensionsTsFilePath);\n\n        const source = project.getSourceFileOrThrow(extensionsTsFilePath);\n\n        // Calculate import path relative to extensions.ts.\n        let importPath = path\n            .relative(path.dirname(extensionsTsFilePath), filePath)\n            .replace(/\\.tsx?$/, \".js\");\n\n        // Ensure the path starts with ./\n        if (!importPath.startsWith(\".\")) {\n            importPath = \"./\" + importPath;\n        }\n\n        // Check if import already exists.\n        const existingImportDeclaration = source.getImportDeclaration(importPath);\n        if (existingImportDeclaration) {\n            return;\n        }\n\n        let index = 1;\n\n        const importDeclarations = source.getImportDeclarations();\n        if (importDeclarations.length) {\n            const last = importDeclarations[importDeclarations.length - 1];\n            index = last.getChildIndex() + 1;\n        }\n\n        // Add import for the BuildParam implementation.\n        source.insertImportDeclaration(index, {\n            defaultImport: className,\n            moduleSpecifier: importPath\n        });\n\n        // Add the registration to the plugins array.\n        const pluginsArray = source.getFirstDescendant(node =>\n            Node.isArrayLiteralExpression(node)\n        ) as ArrayLiteralExpression;\n\n        pluginsArray.addElement(\n            `\\ncreateContextPlugin(ctx => {\\n\\tregisterExtension(ctx.container, ${className});\\n})`\n        );\n\n        {\n            let index = 1;\n\n            const importDeclarations = source.getImportDeclarations();\n            if (importDeclarations.length) {\n                const last = importDeclarations[importDeclarations.length - 1];\n                index = last.getChildIndex() + 1;\n            }\n\n            const contextPluginImportPath = \"@webiny/api/plugins/ContextPlugin\";\n            const existingContextPluginImport =\n                source.getImportDeclaration(contextPluginImportPath);\n            if (!existingContextPluginImport) {\n                source.insertImportDeclaration(index, {\n                    namedImports: [\"createContextPlugin\"],\n                    moduleSpecifier: contextPluginImportPath\n                });\n            }\n        }\n\n        await source.save();\n    }\n});\n"],"mappings":"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","ignoreList":[]}

package/extensions/ApiExtension.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const ApiExtension: import("~/extensions/index.js").ExtensionComponent<z.ZodObject<{
+    src: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    exportName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    src: string;
+    exportName?: string | undefined;
+}, {
+    src: string;
+    exportName?: string | undefined;
+}>>;

package/{defineExtension/defineApiExtension.js → extensions/ApiExtension.js}

@@ -1,25 +1,23 @@
+import { defineExtension, zodSrcPath } from "./index.js";
+import { ExtensionSrcResolver } from "@webiny/project";
 import { z } from "zod";
-import { Node, Project } from "ts-morph";
-import { defineExtension } from "./index.js";
-import { zodSrcPath } from "./zodTypes/zodSrcPath.js";
-import { ExtensionSrcResolver } from "../utils/index.js";
 import path from "path";
+import { Node, Project } from "ts-morph";
 import crypto from "crypto";
-export const defineApiExtension = params => defineExtension({
-  type: params.type,
+export const ApiExtension = defineExtension({
+  type: "Api/Extension",
   tags: {
     runtimeContext: "app-build",
     appName: "api"
   },
-  description: params.description,
+  description: "Add any API extension.",
   multiple: true,
   paramsSchema: ({
     project
   }) => {
     return z.object({
       src: zodSrcPath({
-        project,
-        abstraction: params.abstraction
+        project
       }),
       exportName: z.string().optional()
     });
@@ -30,19 +28,19 @@ export const defineApiExtension = params => defineExtension({
       src: extensionFilePath
     } = params;
 
-    // Resolve to absolute path for file operations
+    // Resolve to absolute path for file operations.
     const absoluteExtensionFilePath = ExtensionSrcResolver.resolvePath(extensionFilePath, ctx.project);
     const extensionFileName = path.basename(absoluteExtensionFilePath);
 
-    // 1. Export name is always the file name without extension.
+    // Export name is always the file name without extension.
     const exportName = params.exportName ?? path.parse(extensionFileName).name;
 
-    // 2. Alias name is "ApiExtension_" + hash of the file path. This way we
-    //    avoid potential naming conflicts and keep the identifier constant.
+    // Alias name is "ApiExtension_" + hash of the file path. This way we
+    // avoid potential naming conflicts and keep the identifier constant.
     const hash = crypto.createHash("sha256").update(extensionFilePath).digest("hex");
     const exportNameAlias = `ApiExtension_${hash.slice(-10)}`;
 
-    // 3. Calculate import path relative to `extensions.ts` file.
+    // Calculate import path relative to `extensions.ts` file.
     const importPath = path.relative(path.dirname(extensionsTsFilePath), absoluteExtensionFilePath).replace(/\.tsx?$/, ".js");
     const project = new Project();
     project.addSourceFileAtPath(extensionsTsFilePath);
@@ -101,4 +99,4 @@ export const defineApiExtension = params => defineExtension({
   }
 });
 
-//# sourceMappingURL=defineApiExtension.js.map
+//# sourceMappingURL=ApiExtension.js.map

package/extensions/ApiExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defineExtension","zodSrcPath","ExtensionSrcResolver","z","path","Node","Project","crypto","ApiExtension","type","tags","runtimeContext","appName","description","multiple","paramsSchema","project","object","src","exportName","string","optional","build","params","ctx","extensionsTsFilePath","paths","workspaceFolder","join","toString","extensionFilePath","absoluteExtensionFilePath","resolvePath","extensionFileName","basename","parse","name","hash","createHash","update","digest","exportNameAlias","slice","importPath","relative","dirname","replace","addSourceFileAtPath","source","getSourceFileOrThrow","existingImportDeclaration","getImportDeclaration","index","importDeclarations","getImportDeclarations","length","last","getChildIndex","extensionProject","extensionSource","hasDefaultExport","getDefaultExportSymbol","undefined","insertImportDeclaration","defaultImport","moduleSpecifier","namedImports","alias","pluginsArray","getFirstDescendant","node","isArrayLiteralExpression","addElement","contextPluginImportPath","existingContextPluginImport","save"],"sources":["ApiExtension.ts"],"sourcesContent":["import { defineExtension, zodSrcPath } from \"~/extensions/index.js\";\nimport { ExtensionSrcResolver } from \"@webiny/project\";\nimport { z } from \"zod\";\nimport path from \"path\";\nimport { Node, Project, ArrayLiteralExpression } from \"ts-morph\";\nimport crypto from \"crypto\";\n\nexport const ApiExtension = defineExtension({\n    type: \"Api/Extension\",\n    tags: { runtimeContext: \"app-build\", appName: \"api\" },\n    description: \"Add any API extension.\",\n    multiple: true,\n    paramsSchema: ({ project }) => {\n        return z.object({\n            src: zodSrcPath({ project }),\n            exportName: z.string().optional()\n        });\n    },\n    async build(params, ctx) {\n        const extensionsTsFilePath = ctx.project.paths.workspaceFolder\n            .join(\"apps\", \"api\", \"graphql\", \"src\", \"extensions.ts\")\n            .toString();\n\n        const { src: extensionFilePath } = params;\n\n        // Resolve to absolute path for file operations.\n        const absoluteExtensionFilePath = ExtensionSrcResolver.resolvePath(\n            extensionFilePath,\n            ctx.project\n        );\n\n        const extensionFileName = path.basename(absoluteExtensionFilePath);\n\n        // Export name is always the file name without extension.\n        const exportName = params.exportName ?? path.parse(extensionFileName).name;\n\n        // Alias name is \"ApiExtension_\" + hash of the file path. This way we\n        // avoid potential naming conflicts and keep the identifier constant.\n        const hash = crypto.createHash(\"sha256\").update(extensionFilePath).digest(\"hex\");\n        const exportNameAlias = `ApiExtension_${hash.slice(-10)}`;\n\n        // Calculate import path relative to `extensions.ts` file.\n        const importPath = path\n            .relative(path.dirname(extensionsTsFilePath), absoluteExtensionFilePath)\n            .replace(/\\.tsx?$/, \".js\");\n\n        const project = new Project();\n        project.addSourceFileAtPath(extensionsTsFilePath);\n\n        const source = project.getSourceFileOrThrow(extensionsTsFilePath);\n\n        const existingImportDeclaration = source.getImportDeclaration(importPath);\n        if (existingImportDeclaration) {\n            return;\n        }\n\n        let index = 1;\n\n        const importDeclarations = source.getImportDeclarations();\n        if (importDeclarations.length) {\n            const last = importDeclarations[importDeclarations.length - 1];\n            index = last.getChildIndex() + 1;\n        }\n\n        // Check if the file has a default export using AST parsing.\n        const extensionProject = new Project();\n        extensionProject.addSourceFileAtPath(absoluteExtensionFilePath);\n        const extensionSource = extensionProject.getSourceFileOrThrow(absoluteExtensionFilePath);\n        const hasDefaultExport = extensionSource.getDefaultExportSymbol() !== undefined;\n\n        // Support both default and named exports.\n        if (hasDefaultExport) {\n            source.insertImportDeclaration(index, {\n                defaultImport: exportNameAlias,\n                moduleSpecifier: importPath\n            });\n        } else {\n            source.insertImportDeclaration(index, {\n                namedImports: [{ name: exportName, alias: exportNameAlias }],\n                moduleSpecifier: importPath\n            });\n        }\n\n        const pluginsArray = source.getFirstDescendant(node =>\n            Node.isArrayLiteralExpression(node)\n        ) as ArrayLiteralExpression;\n\n        pluginsArray.addElement(\n            `\\ncreateContextPlugin(ctx => {\\n\\tregisterExtension(ctx.container, ${exportNameAlias});\\n})`\n        );\n\n        {\n            let index = 1;\n\n            const importDeclarations = source.getImportDeclarations();\n            if (importDeclarations.length) {\n                const last = importDeclarations[importDeclarations.length - 1];\n                index = last.getChildIndex() + 1;\n            }\n\n            const contextPluginImportPath = \"@webiny/api/plugins/ContextPlugin\";\n            const existingContextPluginImport =\n                source.getImportDeclaration(contextPluginImportPath);\n            if (!existingContextPluginImport) {\n                source.insertImportDeclaration(index, {\n                    namedImports: [\"createContextPlugin\"],\n                    moduleSpecifier: contextPluginImportPath\n                });\n            }\n        }\n\n        await source.save();\n    }\n});\n"],"mappings":"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","ignoreList":[]}

package/extensions/FeatureFlags.d.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+export declare const FeatureFlags: import("~/defineExtension/index.js").ExtensionComponent<z.ZodObject<{
+    features: z.ZodObject<{
+        multiTenancy: z.ZodOptional<z.ZodBoolean>;
+        advancedPublishingWorkflow: z.ZodOptional<z.ZodBoolean>;
+        advancedAccessControlLayer: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            teams: z.ZodOptional<z.ZodBoolean>;
+            privateFiles: z.ZodOptional<z.ZodBoolean>;
+            folderLevelPermissions: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        }, {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        }>]>>;
+        auditLogs: z.ZodOptional<z.ZodBoolean>;
+        recordLocking: z.ZodOptional<z.ZodBoolean>;
+        fileManager: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            threatDetection: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            threatDetection?: boolean | undefined;
+        }, {
+            threatDetection?: boolean | undefined;
+        }>]>>;
+    }, "strip", z.ZodTypeAny, {
+        multiTenancy?: boolean | undefined;
+        advancedPublishingWorkflow?: boolean | undefined;
+        advancedAccessControlLayer?: boolean | {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        } | undefined;
+        auditLogs?: boolean | undefined;
+        recordLocking?: boolean | undefined;
+        fileManager?: boolean | {
+            threatDetection?: boolean | undefined;
+        } | undefined;
+    }, {
+        multiTenancy?: boolean | undefined;
+        advancedPublishingWorkflow?: boolean | undefined;
+        advancedAccessControlLayer?: boolean | {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        } | undefined;
+        auditLogs?: boolean | undefined;
+        recordLocking?: boolean | undefined;
+        fileManager?: boolean | {
+            threatDetection?: boolean | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    features: {
+        multiTenancy?: boolean | undefined;
+        advancedPublishingWorkflow?: boolean | undefined;
+        advancedAccessControlLayer?: boolean | {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        } | undefined;
+        auditLogs?: boolean | undefined;
+        recordLocking?: boolean | undefined;
+        fileManager?: boolean | {
+            threatDetection?: boolean | undefined;
+        } | undefined;
+    };
+}, {
+    features: {
+        multiTenancy?: boolean | undefined;
+        advancedPublishingWorkflow?: boolean | undefined;
+        advancedAccessControlLayer?: boolean | {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        } | undefined;
+        auditLogs?: boolean | undefined;
+        recordLocking?: boolean | undefined;
+        fileManager?: boolean | {
+            threatDetection?: boolean | undefined;
+        } | undefined;
+    };
+}>>;

package/extensions/FeatureFlags.js

@@ -0,0 +1,42 @@
+import React from "react";
+import { z } from "zod";
+import { BuildParam } from "./ApiBuildParam.js";
+import { AdminBuildParam } from "./AdminBuildParam.js";
+import { defineExtension } from "../defineExtension/index.js";
+export const FeatureFlags = defineExtension({
+  type: "FeatureFlags",
+  tags: {
+    runtimeContext: "project"
+  },
+  description: "Enable or disable WCP features.",
+  paramsSchema: z.object({
+    // Follows `IFeatureFlagsDto` from `packages/feature-flags/src/index.ts`.
+    features: z.object({
+      multiTenancy: z.boolean().optional(),
+      advancedPublishingWorkflow: z.boolean().optional(),
+      advancedAccessControlLayer: z.union([z.boolean(), z.object({
+        teams: z.boolean().optional(),
+        privateFiles: z.boolean().optional(),
+        folderLevelPermissions: z.boolean().optional()
+      })]).optional(),
+      auditLogs: z.boolean().optional(),
+      recordLocking: z.boolean().optional(),
+      fileManager: z.union([z.boolean(), z.object({
+        threatDetection: z.boolean().optional()
+      })]).optional()
+    })
+  }),
+  render: ({
+    features = {}
+  }) => {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(BuildParam, {
+      paramName: "FeatureFlags",
+      value: features
+    }), /*#__PURE__*/React.createElement(AdminBuildParam, {
+      paramName: "FeatureFlags",
+      value: features
+    }));
+  }
+});
+
+//# sourceMappingURL=FeatureFlags.js.map

package/extensions/FeatureFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","z","BuildParam","AdminBuildParam","defineExtension","FeatureFlags","type","tags","runtimeContext","description","paramsSchema","object","features","multiTenancy","boolean","optional","advancedPublishingWorkflow","advancedAccessControlLayer","union","teams","privateFiles","folderLevelPermissions","auditLogs","recordLocking","fileManager","threatDetection","render","createElement","Fragment","paramName","value"],"sources":["FeatureFlags.tsx"],"sourcesContent":["import React from \"react\";\nimport { z } from \"zod\";\nimport { BuildParam } from \"./ApiBuildParam.js\";\nimport { AdminBuildParam } from \"./AdminBuildParam.js\";\nimport { defineExtension } from \"~/defineExtension/index.js\";\n\nexport const FeatureFlags = defineExtension({\n    type: \"FeatureFlags\",\n    tags: { runtimeContext: \"project\" },\n    description: \"Enable or disable WCP features.\",\n    paramsSchema: z.object({\n        // Follows `IFeatureFlagsDto` from `packages/feature-flags/src/index.ts`.\n        features: z.object({\n            multiTenancy: z.boolean().optional(),\n            advancedPublishingWorkflow: z.boolean().optional(),\n            advancedAccessControlLayer: z\n                .union([\n                    z.boolean(),\n                    z.object({\n                        teams: z.boolean().optional(),\n                        privateFiles: z.boolean().optional(),\n                        folderLevelPermissions: z.boolean().optional()\n                    })\n                ])\n                .optional(),\n            auditLogs: z.boolean().optional(),\n            recordLocking: z.boolean().optional(),\n            fileManager: z\n                .union([\n                    z.boolean(),\n                    z.object({\n                        threatDetection: z.boolean().optional()\n                    })\n                ])\n                .optional()\n        })\n    }),\n    render: ({ features = {} }) => {\n        return (\n            <>\n                <BuildParam paramName=\"FeatureFlags\" value={features} />\n                <AdminBuildParam paramName=\"FeatureFlags\" value={features} />\n            </>\n        );\n    }\n});\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,CAAC,QAAQ,KAAK;AACvB,SAASC,UAAU;AACnB,SAASC,eAAe;AACxB,SAASC,eAAe;AAExB,OAAO,MAAMC,YAAY,GAAGD,eAAe,CAAC;EACxCE,IAAI,EAAE,cAAc;EACpBC,IAAI,EAAE;IAAEC,cAAc,EAAE;EAAU,CAAC;EACnCC,WAAW,EAAE,iCAAiC;EAC9CC,YAAY,EAAET,CAAC,CAACU,MAAM,CAAC;IACnB;IACAC,QAAQ,EAAEX,CAAC,CAACU,MAAM,CAAC;MACfE,YAAY,EAAEZ,CAAC,CAACa,OAAO,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC;MACpCC,0BAA0B,EAAEf,CAAC,CAACa,OAAO,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC;MAClDE,0BAA0B,EAAEhB,CAAC,CACxBiB,KAAK,CAAC,CACHjB,CAAC,CAACa,OAAO,CAAC,CAAC,EACXb,CAAC,CAACU,MAAM,CAAC;QACLQ,KAAK,EAAElB,CAAC,CAACa,OAAO,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC;QAC7BK,YAAY,EAAEnB,CAAC,CAACa,OAAO,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC;QACpCM,sBAAsB,EAAEpB,CAAC,CAACa,OAAO,CAAC,CAAC,CAACC,QAAQ,CAAC;MACjD,CAAC,CAAC,CACL,CAAC,CACDA,QAAQ,CAAC,CAAC;MACfO,SAAS,EAAErB,CAAC,CAACa,OAAO,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC;MACjCQ,aAAa,EAAEtB,CAAC,CAACa,OAAO,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC;MACrCS,WAAW,EAAEvB,CAAC,CACTiB,KAAK,CAAC,CACHjB,CAAC,CAACa,OAAO,CAAC,CAAC,EACXb,CAAC,CAACU,MAAM,CAAC;QACLc,eAAe,EAAExB,CAAC,CAACa,OAAO,CAAC,CAAC,CAACC,QAAQ,CAAC;MAC1C,CAAC,CAAC,CACL,CAAC,CACDA,QAAQ,CAAC;IAClB,CAAC;EACL,CAAC,CAAC;EACFW,MAAM,EAAEA,CAAC;IAAEd,QAAQ,GAAG,CAAC;EAAE,CAAC,KAAK;IAC3B,oBACIZ,KAAA,CAAA2B,aAAA,CAAA3B,KAAA,CAAA4B,QAAA,qBACI5B,KAAA,CAAA2B,aAAA,CAACzB,UAAU;MAAC2B,SAAS,EAAC,cAAc;MAACC,KAAK,EAAElB;IAAS,CAAE,CAAC,eACxDZ,KAAA,CAAA2B,aAAA,CAACxB,eAAe;MAAC0B,SAAS,EAAC,cAAc;MAACC,KAAK,EAAElB;IAAS,CAAE,CAC9D,CAAC;EAEX;AACJ,CAAC,CAAC","ignoreList":[]}

package/extensions/index.d.ts

@@ -5,6 +5,11 @@ import { ProjectId } from "./ProjectId.js";
 import { Telemetry } from "./Telemetry.js";
 import { EnvVar } from "./EnvVar.js";
 import { DatabaseSetup } from "./DatabaseSetup.js";
+import { FeatureFlags } from "./FeatureFlags.js";
+import { BuildParam } from "./ApiBuildParam.js";
+import { AdminBuildParam } from "./AdminBuildParam.js";
+import { AdminExtension } from "./AdminExtension.js";
+import { ApiExtension } from "./ApiExtension.js";
 import { AdminAfterBuild, AdminAfterDeploy, AdminBeforeBuild, AdminBeforeDeploy, AdminBeforeWatch, AfterBuild, AfterDeploy, BeforeDeploy, BeforeWatch, ApiAfterBuild, ApiAfterDeploy, ApiBeforeBuild, ApiBeforeDeploy, ApiBeforeWatch, BeforeBuild, CoreAfterBuild, CoreAfterDeploy, CoreBeforeBuild, CoreBeforeDeploy, CoreBeforeWatch } from "./hooks/index.js";
 import { AdminPulumi, ApiPulumi, CorePulumi, ProductionEnvironments, PulumiResourceNamePrefix, CoreStackOutputValue, ApiStackOutputValue, AdminStackOutputValue } from "./pulumi/index.js";
 export { Telemetry };
@@ -13,7 +18,12 @@ export { ProjectDecorator };
 export { ProjectImplementation };
 export { ExtensionDefinitions };
 export { EnvVar };
+export { FeatureFlags };
 export { DatabaseSetup };
+export { BuildParam };
+export { AdminBuildParam };
+export { AdminExtension };
+export { ApiExtension };
 export { BeforeBuild };
 export { BeforeDeploy };
 export { BeforeWatch };
@@ -75,6 +85,89 @@ export declare const definitions: (import("../defineExtension/index.js").Extensi
 }, {
     value: string;
     varName: string;
+}>> | import("../defineExtension/index.js").ExtensionDefinitionModel<import("zod").ZodObject<{
+    features: import("zod").ZodObject<{
+        multiTenancy: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        advancedPublishingWorkflow: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        advancedAccessControlLayer: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodBoolean, import("zod").ZodObject<{
+            teams: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            privateFiles: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            folderLevelPermissions: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, "strip", import("zod").ZodTypeAny, {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        }, {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        }>]>>;
+        auditLogs: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        recordLocking: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        fileManager: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodBoolean, import("zod").ZodObject<{
+            threatDetection: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, "strip", import("zod").ZodTypeAny, {
+            threatDetection?: boolean | undefined;
+        }, {
+            threatDetection?: boolean | undefined;
+        }>]>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        multiTenancy?: boolean | undefined;
+        advancedPublishingWorkflow?: boolean | undefined;
+        advancedAccessControlLayer?: boolean | {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        } | undefined;
+        auditLogs?: boolean | undefined;
+        recordLocking?: boolean | undefined;
+        fileManager?: boolean | {
+            threatDetection?: boolean | undefined;
+        } | undefined;
+    }, {
+        multiTenancy?: boolean | undefined;
+        advancedPublishingWorkflow?: boolean | undefined;
+        advancedAccessControlLayer?: boolean | {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        } | undefined;
+        auditLogs?: boolean | undefined;
+        recordLocking?: boolean | undefined;
+        fileManager?: boolean | {
+            threatDetection?: boolean | undefined;
+        } | undefined;
+    }>;
+}, "strip", import("zod").ZodTypeAny, {
+    features: {
+        multiTenancy?: boolean | undefined;
+        advancedPublishingWorkflow?: boolean | undefined;
+        advancedAccessControlLayer?: boolean | {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        } | undefined;
+        auditLogs?: boolean | undefined;
+        recordLocking?: boolean | undefined;
+        fileManager?: boolean | {
+            threatDetection?: boolean | undefined;
+        } | undefined;
+    };
+}, {
+    features: {
+        multiTenancy?: boolean | undefined;
+        advancedPublishingWorkflow?: boolean | undefined;
+        advancedAccessControlLayer?: boolean | {
+            teams?: boolean | undefined;
+            privateFiles?: boolean | undefined;
+            folderLevelPermissions?: boolean | undefined;
+        } | undefined;
+        auditLogs?: boolean | undefined;
+        recordLocking?: boolean | undefined;
+        fileManager?: boolean | {
+            threatDetection?: boolean | undefined;
+        } | undefined;
+    };
 }>> | import("../defineExtension/index.js").ExtensionDefinitionModel<import("zod").ZodObject<{
     prefix: import("zod").ZodString;
 }, "strip", import("zod").ZodTypeAny, {
@@ -102,6 +195,15 @@ export declare const definitions: (import("../defineExtension/index.js").Extensi
     setupName: "ddb" | "ddb+es" | "ddb+os";
 }, {
     setupName: "ddb" | "ddb+es" | "ddb+os";
+}>> | import("../defineExtension/index.js").ExtensionDefinitionModel<import("zod").ZodObject<{
+    paramName: import("zod").ZodString;
+    value: import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>, import("zod").ZodArray<import("zod").ZodAny, "many">, import("zod").ZodNumber, import("zod").ZodBoolean]>;
+}, "strip", import("zod").ZodTypeAny, {
+    value: string | number | boolean | any[] | Record<string, any>;
+    paramName: string;
+}, {
+    value: string | number | boolean | any[] | Record<string, any>;
+    paramName: string;
 }>>)[];
 export { Project } from "./Project.js";
 export * from "../defineExtension/index.js";