@webiny/project 0.0.0-unstable.6f45466a1d → 0.0.0-unstable.7be00a75a9

package/extensions/AdminBuildParam.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+import { defineExtension } from "../defineExtension/index.js";
+import crypto_0 from "crypto";
+import path from "path";
+import fs from "fs";
+import { Node, Project } from "ts-morph";
+async function generateBuildParamsFeature(buildParamsDir, ctx) {
+    const featureFilePath = path.join(buildParamsDir, "feature.ts");
+    const files = fs.readdirSync(buildParamsDir).filter((f)=>f.startsWith("BuildParam_") && f.endsWith(".ts") && "feature.ts" !== f);
+    const imports = files.map((file)=>{
+        const className = path.parse(file).name;
+        return `import ${className} from "./${className}.js";`;
+    }).join("\n");
+    const registrations = files.map((file)=>{
+        const className = path.parse(file).name;
+        return `        container.register(${className});`;
+    }).join("\n");
+    const featureContent = `import { createFeature } from "@webiny/feature/admin";
+import { Container } from "@webiny/di";
+${imports}
+
+export const BuildParamsInternalFeature = createFeature({
+    name: "BuildParamsInternal",
+    register(container: Container) {
+${registrations}
+    }
+});
+`;
+    fs.writeFileSync(featureFilePath, featureContent, "utf8");
+    await updateExtensionsTsx(ctx);
+}
+async function updateExtensionsTsx(ctx) {
+    const extensionsTsxFilePath = ctx.project.paths.workspaceFolder.join("apps", "admin", "src", "Extensions.tsx").toString();
+    const project = new Project();
+    project.addSourceFileAtPath(extensionsTsxFilePath);
+    const source = project.getSourceFileOrThrow(extensionsTsxFilePath);
+    const buildParamsFeatureImport = "./buildParams/feature.js";
+    const existingFeatureImport = source.getImportDeclaration(buildParamsFeatureImport);
+    if (!existingFeatureImport) {
+        let index = 1;
+        const importDeclarations = source.getImportDeclarations();
+        if (importDeclarations.length) {
+            const last = importDeclarations[importDeclarations.length - 1];
+            index = last.getChildIndex() + 1;
+        }
+        source.insertImportDeclaration(index, {
+            namedImports: [
+                "BuildParamsInternalFeature"
+            ],
+            moduleSpecifier: buildParamsFeatureImport
+        });
+        const buildParamsFeatureImportPath = "@webiny/app-admin";
+        const existingBuildParamsImport = source.getImportDeclaration(buildParamsFeatureImportPath);
+        if (existingBuildParamsImport) {
+            const namedImports = existingBuildParamsImport.getNamedImports();
+            const hasBuildParamsFeature = namedImports.some((ni)=>"BuildParamsFeature" === ni.getName());
+            if (!hasBuildParamsFeature) existingBuildParamsImport.addNamedImport("BuildParamsFeature");
+        } else source.insertImportDeclaration(index, {
+            namedImports: [
+                "BuildParamsFeature"
+            ],
+            moduleSpecifier: buildParamsFeatureImportPath
+        });
+        const registerFeatureImportPath = "@webiny/app-admin";
+        const existingRegisterFeatureImport = source.getImportDeclaration(registerFeatureImportPath);
+        if (existingRegisterFeatureImport) {
+            const namedImports = existingRegisterFeatureImport.getNamedImports();
+            const hasRegisterFeature = namedImports.some((ni)=>"RegisterFeature" === ni.getName());
+            if (!hasRegisterFeature) existingRegisterFeatureImport.addNamedImport("RegisterFeature");
+        } else source.insertImportDeclaration(index, {
+            namedImports: [
+                "RegisterFeature"
+            ],
+            moduleSpecifier: registerFeatureImportPath
+        });
+    }
+    const extensionsIdentifier = source.getFirstDescendant((node)=>{
+        if (!Node.isIdentifier(node)) return false;
+        return "Extensions" === node.getText();
+    });
+    if (!extensionsIdentifier) throw new Error(`Could not find the "Extensions" React component in "${extensionsTsxFilePath}".`);
+    const extensionsArrowFn = extensionsIdentifier.getNextSibling((node)=>Node.isArrowFunction(node));
+    if (!extensionsArrowFn) throw new Error('Could not find the "Extensions" React component arrow function.');
+    const extensionsArrowFnFragment = extensionsArrowFn.getFirstDescendant((node)=>Node.isJsxFragment(node));
+    if (!extensionsArrowFnFragment) throw new Error("Could not find JSX fragment in Extensions component.");
+    const currentContent = extensionsArrowFnFragment.getFullText().replace("<>", "").replace("</>", "").trim();
+    if (!currentContent.includes("BuildParamsFeature")) {
+        const newContent = `<><RegisterFeature feature={BuildParamsFeature} /><RegisterFeature feature={BuildParamsInternalFeature} />${currentContent}</>`;
+        extensionsArrowFnFragment.replaceWithText(newContent);
+    }
+    await source.save();
+}
+const AdminBuildParam = defineExtension({
+    type: "Admin/BuildParam",
+    tags: {
+        runtimeContext: "app-build",
+        appName: "admin"
+    },
+    description: "Add build-time parameter to Admin app.",
+    multiple: true,
+    paramsSchema: ()=>z.object({
+            paramName: z.string(),
+            value: z.union([
+                z.string(),
+                z.record(z.string(), z.any()),
+                z.array(z.any()),
+                z.number(),
+                z.boolean()
+            ])
+        }),
+    async build (params, ctx) {
+        const buildParamsDir = ctx.project.paths.workspaceFolder.join("apps", "admin", "src", "buildParams").toString();
+        const { paramName, value } = params;
+        const valueStr = JSON.stringify(value, null, 4);
+        const hash = crypto_0.createHash("sha256").update(paramName).digest("hex");
+        const className = `BuildParam_${hash.slice(-10)}`;
+        const fileName = `${className}.ts`;
+        const filePath = path.join(buildParamsDir, fileName);
+        if (!fs.existsSync(buildParamsDir)) fs.mkdirSync(buildParamsDir, {
+            recursive: true
+        });
+        if (!fs.existsSync(filePath)) {
+            const fileContent = `import { BuildParam } from "webiny/admin/build-params";
+
+class ${className} implements BuildParam.Interface {
+    key = "${paramName}";
+    value = ${valueStr};
+}
+
+export default BuildParam.createImplementation({
+    implementation: ${className},
+    dependencies: []
+});
+`;
+            fs.writeFileSync(filePath, fileContent, "utf8");
+        }
+        await generateBuildParamsFeature(buildParamsDir, ctx);
+    }
+});
+export { AdminBuildParam };
+
+//# sourceMappingURL=AdminBuildParam.js.map

package/extensions/AdminBuildParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions/AdminBuildParam.js","sources":["../../src/extensions/AdminBuildParam.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { defineExtension } from \"~/defineExtension/index.js\";\nimport crypto from \"crypto\";\nimport path from \"path\";\nimport fs from \"fs\";\nimport { Node, Project } from \"ts-morph\";\n\nasync function generateBuildParamsFeature(buildParamsDir: string, ctx: any) {\n    const featureFilePath = path.join(buildParamsDir, \"feature.ts\");\n\n    // Get all BuildParam_*.ts files.\n    const files = fs\n        .readdirSync(buildParamsDir)\n        .filter(f => f.startsWith(\"BuildParam_\") && f.endsWith(\".ts\") && f !== \"feature.ts\");\n\n    // Generate imports and registrations.\n    const imports = files\n        .map(file => {\n            const className = path.parse(file).name;\n            return `import ${className} from \"./${className}.js\";`;\n        })\n        .join(\"\\n\");\n\n    const registrations = files\n        .map(file => {\n            const className = path.parse(file).name;\n            return `        container.register(${className});`;\n        })\n        .join(\"\\n\");\n\n    const featureContent = `import { createFeature } from \"@webiny/feature/admin\";\nimport { Container } from \"@webiny/di\";\n${imports}\n\nexport const BuildParamsInternalFeature = createFeature({\n    name: \"BuildParamsInternal\",\n    register(container: Container) {\n${registrations}\n    }\n});\n`;\n\n    fs.writeFileSync(featureFilePath, featureContent, \"utf8\");\n\n    // Now we need to update Extensions.tsx to use RegisterFeature with this feature.\n    await updateExtensionsTsx(ctx);\n}\n\nasync function updateExtensionsTsx(ctx: any) {\n    const extensionsTsxFilePath = ctx.project.paths.workspaceFolder\n        .join(\"apps\", \"admin\", \"src\", \"Extensions.tsx\")\n        .toString();\n\n    const project = new Project();\n    project.addSourceFileAtPath(extensionsTsxFilePath);\n\n    const source = project.getSourceFileOrThrow(extensionsTsxFilePath);\n\n    // Check if we already have the imports.\n    const buildParamsFeatureImport = \"./buildParams/feature.js\";\n    const existingFeatureImport = source.getImportDeclaration(buildParamsFeatureImport);\n\n    if (!existingFeatureImport) {\n        let index = 1;\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 BuildParamsInternalFeature.\n        source.insertImportDeclaration(index, {\n            namedImports: [\"BuildParamsInternalFeature\"],\n            moduleSpecifier: buildParamsFeatureImport\n        });\n\n        // Add import for BuildParamsFeature.\n        const buildParamsFeatureImportPath = \"@webiny/app-admin\";\n        const existingBuildParamsImport = source.getImportDeclaration(buildParamsFeatureImportPath);\n\n        if (!existingBuildParamsImport) {\n            source.insertImportDeclaration(index, {\n                namedImports: [\"BuildParamsFeature\"],\n                moduleSpecifier: buildParamsFeatureImportPath\n            });\n        } else {\n            // Add to existing import if BuildParamsFeature not already there.\n            const namedImports = existingBuildParamsImport.getNamedImports();\n            const hasBuildParamsFeature = namedImports.some(\n                ni => ni.getName() === \"BuildParamsFeature\"\n            );\n            if (!hasBuildParamsFeature) {\n                existingBuildParamsImport.addNamedImport(\"BuildParamsFeature\");\n            }\n        }\n\n        // Add import for RegisterFeature if not present.\n        const registerFeatureImportPath = \"@webiny/app-admin\";\n        const existingRegisterFeatureImport =\n            source.getImportDeclaration(registerFeatureImportPath);\n\n        if (existingRegisterFeatureImport) {\n            const namedImports = existingRegisterFeatureImport.getNamedImports();\n            const hasRegisterFeature = namedImports.some(ni => ni.getName() === \"RegisterFeature\");\n            if (!hasRegisterFeature) {\n                existingRegisterFeatureImport.addNamedImport(\"RegisterFeature\");\n            }\n        } else {\n            source.insertImportDeclaration(index, {\n                namedImports: [\"RegisterFeature\"],\n                moduleSpecifier: registerFeatureImportPath\n            });\n        }\n    }\n\n    // Now add <RegisterFeature> components to the Extensions component.\n    const extensionsIdentifier = source.getFirstDescendant(node => {\n        if (!Node.isIdentifier(node)) {\n            return false;\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}\".`\n        );\n    }\n\n    const extensionsArrowFn = extensionsIdentifier.getNextSibling(node =>\n        Node.isArrowFunction(node)\n    );\n\n    if (!extensionsArrowFn) {\n        throw new Error(`Could not find the \"Extensions\" React component arrow function.`);\n    }\n\n    const extensionsArrowFnFragment = extensionsArrowFn.getFirstDescendant(node => {\n        return Node.isJsxFragment(node);\n    });\n\n    if (!extensionsArrowFnFragment) {\n        throw new Error(`Could not find JSX fragment in Extensions component.`);\n    }\n\n    const currentContent = extensionsArrowFnFragment\n        .getFullText()\n        .replace(\"<>\", \"\")\n        .replace(\"</>\", \"\")\n        .trim();\n\n    // Check if we already have the RegisterFeature components.\n    if (!currentContent.includes(\"BuildParamsFeature\")) {\n        const newContent = `<><RegisterFeature feature={BuildParamsFeature} /><RegisterFeature feature={BuildParamsInternalFeature} />${currentContent}</>`;\n        extensionsArrowFnFragment.replaceWithText(newContent);\n    }\n\n    await source.save();\n}\n\nexport const AdminBuildParam = defineExtension({\n    type: \"Admin/BuildParam\",\n    tags: { runtimeContext: \"app-build\", appName: \"admin\" },\n    description: \"Add build-time parameter to Admin 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.string(), z.any()),\n                z.array(z.any()),\n                z.number(),\n                z.boolean()\n            ])\n        });\n    },\n    async build(params, ctx) {\n        const buildParamsDir = ctx.project.paths.workspaceFolder\n            .join(\"apps\", \"admin\", \"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            // Create the BuildParam implementation file.\n            const fileContent = `import { BuildParam } from \"webiny/admin/build-params\";\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 we need to generate/update the feature file that imports all BuildParams.\n        await generateBuildParamsFeature(buildParamsDir, ctx);\n    }\n});\n"],"names":["generateBuildParamsFeature","buildParamsDir","ctx","featureFilePath","path","files","fs","f","imports","file","className","registrations","featureContent","updateExtensionsTsx","extensionsTsxFilePath","project","Project","source","buildParamsFeatureImport","existingFeatureImport","index","importDeclarations","last","buildParamsFeatureImportPath","existingBuildParamsImport","namedImports","hasBuildParamsFeature","ni","registerFeatureImportPath","existingRegisterFeatureImport","hasRegisterFeature","extensionsIdentifier","node","Node","Error","extensionsArrowFn","extensionsArrowFnFragment","currentContent","newContent","AdminBuildParam","defineExtension","z","params","paramName","value","valueStr","JSON","hash","crypto","fileName","filePath","fileContent"],"mappings":"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"}

package/extensions/AdminExtension.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const AdminExtension: import("~/extensions/index.js").ExtensionComponent<z.ZodObject<{
+    src: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    exportName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;

package/extensions/AdminExtension.js

@@ -0,0 +1,73 @@
+import { defineExtension, zodSrcPath } from "./index.js";
+import { ExtensionSrcResolver } from "../index.js";
+import { z } from "zod";
+import path from "path";
+import { Node, Project } from "ts-morph";
+import crypto_0 from "crypto";
+const AdminExtension = defineExtension({
+    type: "Admin/Extension",
+    tags: {
+        runtimeContext: "app-build",
+        appName: "admin"
+    },
+    description: "Extend the Admin application with custom functionality.",
+    multiple: true,
+    paramsSchema: ({ project })=>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;
+        const absoluteExtensionFilePath = ExtensionSrcResolver.resolvePath(extensionFilePath, ctx.project);
+        const extensionFileName = path.basename(absoluteExtensionFilePath);
+        const exportName = params.exportName ?? path.parse(extensionFileName).name;
+        const hash = crypto_0.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;
+        const extensionProject = new Project();
+        extensionProject.addSourceFileAtPath(absoluteExtensionFilePath);
+        const extensionSource = extensionProject.getSourceFileOrThrow(absoluteExtensionFilePath);
+        const hasDefaultExport = void 0 !== extensionSource.getDefaultExportSymbol();
+        let index = 1;
+        const importDeclarations = source.getImportDeclarations();
+        if (importDeclarations.length) {
+            const last = importDeclarations[importDeclarations.length - 1];
+            index = last.getChildIndex() + 1;
+        }
+        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 "Extensions" === node.getText();
+        });
+        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)=>Node.isJsxFragment(node));
+        const extensionsArrowFnFragmentChildrenText = extensionsArrowFnFragment.getFullText().replace("<>", "").replace("</>", "").trim();
+        extensionsArrowFnFragment.replaceWithText(`<><${componentName}/>${extensionsArrowFnFragmentChildrenText}</>`);
+        await source.save();
+    }
+});
+export { AdminExtension };
+
+//# sourceMappingURL=AdminExtension.js.map

package/extensions/AdminExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions/AdminExtension.js","sources":["../../src/extensions/AdminExtension.ts"],"sourcesContent":["import { defineExtension, zodSrcPath } from \"~/extensions/index.js\";\nimport { ExtensionSrcResolver } from \"~/index.js\";\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"],"names":["AdminExtension","defineExtension","project","z","zodSrcPath","params","ctx","extensionsTsxFilePath","extensionFilePath","absoluteExtensionFilePath","ExtensionSrcResolver","extensionFileName","path","exportName","hash","crypto","componentName","Project","importPath","source","existingImportDeclaration","extensionProject","extensionSource","hasDefaultExport","undefined","index","importDeclarations","last","extensionsIdentifier","node","Node","Error","extensionsArrowFn","extensionsArrowFnFragment","extensionsArrowFnFragmentChildrenText"],"mappings":";;;;;;AAOO,MAAMA,iBAAiBC,gBAAgB;IAC1C,MAAM;IACN,MAAM;QAAE,gBAAgB;QAAa,SAAS;IAAQ;IACtD,aAAa;IACb,UAAU;IACV,cAAc,CAAC,EAAEC,OAAO,EAAE,GACfC,EAAE,MAAM,CAAC;YACZ,KAAKC,WAAW;gBAAEF;YAAQ;YAC1B,YAAYC,EAAE,MAAM,GAAG,QAAQ;QACnC;IAEJ,MAAM,OAAME,MAAM,EAAEC,GAAG;QACnB,MAAMC,wBAAwBD,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAC1D,IAAI,CAAC,QAAQ,SAAS,OAAO,kBAC7B,QAAQ;QAEb,MAAM,EAAE,KAAKE,iBAAiB,EAAE,GAAGH;QAGnC,MAAMI,4BAA4BC,qBAAqB,WAAW,CAC9DF,mBACAF,IAAI,OAAO;QAGf,MAAMK,oBAAoBC,KAAK,QAAQ,CAACH;QAGxC,MAAMI,aAAaR,OAAO,UAAU,IAAIO,KAAK,KAAK,CAACD,mBAAmB,IAAI;QAG1E,MAAMG,OAAOC,SAAAA,UAAiB,CAAC,UAAU,MAAM,CAACP,mBAAmB,MAAM,CAAC;QAC1E,MAAMQ,gBAAgB,CAAC,eAAe,EAAEF,KAAK,KAAK,CAAC,MAAM;QAEzD,MAAMZ,UAAU,IAAIe;QAEpB,MAAMC,aAAaN,KAAAA,QACN,CAACA,KAAK,OAAO,CAACL,wBAAwBE,2BAC9C,OAAO,CAAC,WAAW;QAExBP,QAAQ,mBAAmB,CAACK;QAE5B,MAAMY,SAASjB,QAAQ,oBAAoB,CAACK;QAE5C,MAAMa,4BAA4BD,OAAO,oBAAoB,CAACD;QAC9D,IAAIE,2BACA;QAIJ,MAAMC,mBAAmB,IAAIJ;QAC7BI,iBAAiB,mBAAmB,CAACZ;QACrC,MAAMa,kBAAkBD,iBAAiB,oBAAoB,CAACZ;QAC9D,MAAMc,mBAAmBD,AAA6CE,WAA7CF,gBAAgB,sBAAsB;QAE/D,IAAIG,QAAQ;QAEZ,MAAMC,qBAAqBP,OAAO,qBAAqB;QACvD,IAAIO,mBAAmB,MAAM,EAAE;YAC3B,MAAMC,OAAOD,kBAAkB,CAACA,mBAAmB,MAAM,GAAG,EAAE;YAC9DD,QAAQE,KAAK,aAAa,KAAK;QACnC;QAGA,IAAIJ,kBACAJ,OAAO,uBAAuB,CAACM,OAAO;YAClC,eAAeT;YACf,iBAAiBE;QACrB;aAEAC,OAAO,uBAAuB,CAACM,OAAO;YAClC,cAAc;gBAAC;oBAAE,MAAMZ;oBAAY,OAAOG;gBAAc;aAAE;YAC1D,iBAAiBE;QACrB;QAGJ,MAAMU,uBAAuBT,OAAO,kBAAkB,CAACU,CAAAA;YACnD,IAAI,CAACC,KAAK,YAAY,CAACD,OACnB,OAAO;YAGX,OAAOA,AAAmB,iBAAnBA,KAAK,OAAO;QACvB;QAEA,IAAI,CAACD,sBACD,MAAM,IAAIG,MACN,CAAC,oDAAoD,EAAExB,sBAAsB,kDAAkD,CAAC;QAIxI,MAAMyB,oBAAoBJ,qBAAqB,cAAc,CAACC,CAAAA,OAC1DC,KAAK,eAAe,CAACD;QAEzB,IAAI,CAACG,mBACD,MAAM,IAAID,MACN,CAAC,oDAAoD,EAAExB,sBAAsB,uEAAuE,CAAC;QAI7J,MAAM0B,4BAA4BD,kBAAkB,kBAAkB,CAACH,CAAAA,OAC5DC,KAAK,aAAa,CAACD;QAG9B,MAAMK,wCAAwCD,0BACzC,WAAW,GACX,OAAO,CAAC,MAAM,IACd,OAAO,CAAC,OAAO,IACf,IAAI;QAETA,0BAA0B,eAAe,CACrC,CAAC,GAAG,EAAEjB,cAAc,EAAE,EAAEkB,sCAAsC,GAAG,CAAC;QAGtE,MAAMf,OAAO,IAAI;IACrB;AACJ"}

package/extensions/ApiBuildParam.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const BuildParam: import("~/defineExtension/index.js").ExtensionComponent<z.ZodObject<{
+    paramName: z.ZodString;
+    value: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>, z.ZodNumber, z.ZodBoolean]>;
+}, z.core.$strip>>;

package/extensions/ApiBuildParam.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { Node, Project } from "ts-morph";
+import { defineExtension } from "../defineExtension/index.js";
+import crypto_0 from "crypto";
+import path from "path";
+import fs from "fs";
+const BuildParam = defineExtension({
+    type: "Api/BuildParam",
+    tags: {
+        runtimeContext: "app-build",
+        appName: "api"
+    },
+    description: "Add build-time parameter to API app.",
+    multiple: true,
+    paramsSchema: ()=>z.object({
+            paramName: z.string(),
+            value: z.union([
+                z.string(),
+                z.record(z.string(), 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;
+        const valueStr = JSON.stringify(value, null, 4);
+        const hash = crypto_0.createHash("sha256").update(paramName).digest("hex");
+        const className = `BuildParam_${hash.slice(-10)}`;
+        const fileName = `${className}.ts`;
+        const filePath = path.join(buildParamsDir, fileName);
+        if (!fs.existsSync(buildParamsDir)) fs.mkdirSync(buildParamsDir, {
+            recursive: true
+        });
+        if (fs.existsSync(filePath)) ;
+        else {
+            const fileContent = `import { BuildParam } from "webiny/api/build-params";
+
+class ${className} implements BuildParam.Interface {
+    key = "${paramName}";
+    value = ${valueStr};
+}
+
+export default BuildParam.createImplementation({
+    implementation: ${className},
+    dependencies: []
+});
+`;
+            fs.writeFileSync(filePath, fileContent, "utf8");
+        }
+        const project = new Project();
+        project.addSourceFileAtPath(extensionsTsFilePath);
+        const source = project.getSourceFileOrThrow(extensionsTsFilePath);
+        let importPath = path.relative(path.dirname(extensionsTsFilePath), filePath).replace(/\.tsx?$/, ".js");
+        if (!importPath.startsWith(".")) importPath = "./" + importPath;
+        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;
+        }
+        source.insertImportDeclaration(index, {
+            defaultImport: className,
+            moduleSpecifier: importPath
+        });
+        const pluginsArray = source.getFirstDescendant((node)=>Node.isArrayLiteralExpression(node));
+        pluginsArray.addElement(`\ncreateRegisterExtensionPlugin(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/handler/plugins/RegisterExtensionPlugin.js";
+            const existingContextPluginImport = source.getImportDeclaration(contextPluginImportPath);
+            if (!existingContextPluginImport) source.insertImportDeclaration(index, {
+                namedImports: [
+                    "createRegisterExtensionPlugin"
+                ],
+                moduleSpecifier: contextPluginImportPath
+            });
+        }
+        await source.save();
+    }
+});
+export { BuildParam };
+
+//# sourceMappingURL=ApiBuildParam.js.map

package/extensions/ApiBuildParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions/ApiBuildParam.js","sources":["../../src/extensions/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.string(), 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/build-params\";\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            `\\ncreateRegisterExtensionPlugin(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/handler/plugins/RegisterExtensionPlugin.js\";\n            const existingContextPluginImport =\n                source.getImportDeclaration(contextPluginImportPath);\n            if (!existingContextPluginImport) {\n                source.insertImportDeclaration(index, {\n                    namedImports: [\"createRegisterExtensionPlugin\"],\n                    moduleSpecifier: contextPluginImportPath\n                });\n            }\n        }\n\n        await source.save();\n    }\n});\n"],"names":["BuildParam","defineExtension","z","params","ctx","extensionsTsFilePath","buildParamsDir","paramName","value","valueStr","JSON","hash","crypto","className","fileName","filePath","path","fs","fileContent","project","Project","source","importPath","existingImportDeclaration","index","importDeclarations","last","pluginsArray","node","Node","contextPluginImportPath","existingContextPluginImport"],"mappings":"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"}

package/extensions/ApiExtension.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const ApiExtension: import("~/extensions/index.js").ExtensionComponent<z.ZodObject<{
+    src: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    exportName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;

package/extensions/ApiExtension.js

@@ -0,0 +1,81 @@
+import { defineExtension, zodSrcPath } from "./index.js";
+import { ExtensionSrcResolver } from "../index.js";
+import { z } from "zod";
+import path from "path";
+import { Node, Project } from "ts-morph";
+import crypto_0 from "crypto";
+const ApiExtension = defineExtension({
+    type: "Api/Extension",
+    tags: {
+        runtimeContext: "app-build",
+        appName: "api"
+    },
+    description: "Add any API extension.",
+    multiple: true,
+    paramsSchema: ({ project })=>z.object({
+            src: zodSrcPath({
+                project
+            }),
+            exportName: z.string().optional()
+        }),
+    async build (params, ctx) {
+        const extensionsTsFilePath = ctx.project.paths.workspaceFolder.join("apps", "api", "graphql", "src", "extensions.ts").toString();
+        const { src: extensionFilePath } = params;
+        const absoluteExtensionFilePath = ExtensionSrcResolver.resolvePath(extensionFilePath, ctx.project);
+        const extensionFileName = path.basename(absoluteExtensionFilePath);
+        const exportName = params.exportName ?? path.parse(extensionFileName).name;
+        const hash = crypto_0.createHash("sha256").update(extensionFilePath).digest("hex");
+        const exportNameAlias = `ApiExtension_${hash.slice(-10)}`;
+        const importPath = path.relative(path.dirname(extensionsTsFilePath), absoluteExtensionFilePath).replace(/\.tsx?$/, ".js");
+        const project = new Project();
+        project.addSourceFileAtPath(extensionsTsFilePath);
+        const source = project.getSourceFileOrThrow(extensionsTsFilePath);
+        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;
+        }
+        const extensionProject = new Project();
+        extensionProject.addSourceFileAtPath(absoluteExtensionFilePath);
+        const extensionSource = extensionProject.getSourceFileOrThrow(absoluteExtensionFilePath);
+        const hasDefaultExport = void 0 !== extensionSource.getDefaultExportSymbol();
+        if (hasDefaultExport) source.insertImportDeclaration(index, {
+            defaultImport: exportNameAlias,
+            moduleSpecifier: importPath
+        });
+        else source.insertImportDeclaration(index, {
+            namedImports: [
+                {
+                    name: exportName,
+                    alias: exportNameAlias
+                }
+            ],
+            moduleSpecifier: importPath
+        });
+        const pluginsArray = source.getFirstDescendant((node)=>Node.isArrayLiteralExpression(node));
+        pluginsArray.addElement(`\ncreateRegisterExtensionPlugin(ctx => {\n\tregisterExtension(ctx.container, ${exportNameAlias});\n})`);
+        {
+            let index = 1;
+            const importDeclarations = source.getImportDeclarations();
+            if (importDeclarations.length) {
+                const last = importDeclarations[importDeclarations.length - 1];
+                index = last.getChildIndex() + 1;
+            }
+            const registerExtensionPluginImportPath = "@webiny/handler/plugins/RegisterExtensionPlugin.js";
+            const existingContextPluginImport = source.getImportDeclaration(registerExtensionPluginImportPath);
+            if (!existingContextPluginImport) source.insertImportDeclaration(index, {
+                namedImports: [
+                    "createRegisterExtensionPlugin"
+                ],
+                moduleSpecifier: registerExtensionPluginImportPath
+            });
+        }
+        await source.save();
+    }
+});
+export { ApiExtension };
+
+//# sourceMappingURL=ApiExtension.js.map

package/extensions/ApiExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions/ApiExtension.js","sources":["../../src/extensions/ApiExtension.ts"],"sourcesContent":["import { defineExtension, zodSrcPath } from \"~/extensions/index.js\";\nimport { ExtensionSrcResolver } from \"~/index.js\";\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            `\\ncreateRegisterExtensionPlugin(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 registerExtensionPluginImportPath =\n                \"@webiny/handler/plugins/RegisterExtensionPlugin.js\";\n            const existingContextPluginImport = source.getImportDeclaration(\n                registerExtensionPluginImportPath\n            );\n            if (!existingContextPluginImport) {\n                source.insertImportDeclaration(index, {\n                    namedImports: [\"createRegisterExtensionPlugin\"],\n                    moduleSpecifier: registerExtensionPluginImportPath\n                });\n            }\n        }\n\n        await source.save();\n    }\n});\n"],"names":["ApiExtension","defineExtension","project","z","zodSrcPath","params","ctx","extensionsTsFilePath","extensionFilePath","absoluteExtensionFilePath","ExtensionSrcResolver","extensionFileName","path","exportName","hash","crypto","exportNameAlias","importPath","Project","source","existingImportDeclaration","index","importDeclarations","last","extensionProject","extensionSource","hasDefaultExport","undefined","pluginsArray","node","Node","registerExtensionPluginImportPath","existingContextPluginImport"],"mappings":";;;;;;AAOO,MAAMA,eAAeC,gBAAgB;IACxC,MAAM;IACN,MAAM;QAAE,gBAAgB;QAAa,SAAS;IAAM;IACpD,aAAa;IACb,UAAU;IACV,cAAc,CAAC,EAAEC,OAAO,EAAE,GACfC,EAAE,MAAM,CAAC;YACZ,KAAKC,WAAW;gBAAEF;YAAQ;YAC1B,YAAYC,EAAE,MAAM,GAAG,QAAQ;QACnC;IAEJ,MAAM,OAAME,MAAM,EAAEC,GAAG;QACnB,MAAMC,uBAAuBD,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CACzD,IAAI,CAAC,QAAQ,OAAO,WAAW,OAAO,iBACtC,QAAQ;QAEb,MAAM,EAAE,KAAKE,iBAAiB,EAAE,GAAGH;QAGnC,MAAMI,4BAA4BC,qBAAqB,WAAW,CAC9DF,mBACAF,IAAI,OAAO;QAGf,MAAMK,oBAAoBC,KAAK,QAAQ,CAACH;QAGxC,MAAMI,aAAaR,OAAO,UAAU,IAAIO,KAAK,KAAK,CAACD,mBAAmB,IAAI;QAI1E,MAAMG,OAAOC,SAAAA,UAAiB,CAAC,UAAU,MAAM,CAACP,mBAAmB,MAAM,CAAC;QAC1E,MAAMQ,kBAAkB,CAAC,aAAa,EAAEF,KAAK,KAAK,CAAC,MAAM;QAGzD,MAAMG,aAAaL,KAAAA,QACN,CAACA,KAAK,OAAO,CAACL,uBAAuBE,2BAC7C,OAAO,CAAC,WAAW;QAExB,MAAMP,UAAU,IAAIgB;QACpBhB,QAAQ,mBAAmB,CAACK;QAE5B,MAAMY,SAASjB,QAAQ,oBAAoB,CAACK;QAE5C,MAAMa,4BAA4BD,OAAO,oBAAoB,CAACF;QAC9D,IAAIG,2BACA;QAGJ,IAAIC,QAAQ;QAEZ,MAAMC,qBAAqBH,OAAO,qBAAqB;QACvD,IAAIG,mBAAmB,MAAM,EAAE;YAC3B,MAAMC,OAAOD,kBAAkB,CAACA,mBAAmB,MAAM,GAAG,EAAE;YAC9DD,QAAQE,KAAK,aAAa,KAAK;QACnC;QAGA,MAAMC,mBAAmB,IAAIN;QAC7BM,iBAAiB,mBAAmB,CAACf;QACrC,MAAMgB,kBAAkBD,iBAAiB,oBAAoB,CAACf;QAC9D,MAAMiB,mBAAmBD,AAA6CE,WAA7CF,gBAAgB,sBAAsB;QAG/D,IAAIC,kBACAP,OAAO,uBAAuB,CAACE,OAAO;YAClC,eAAeL;YACf,iBAAiBC;QACrB;aAEAE,OAAO,uBAAuB,CAACE,OAAO;YAClC,cAAc;gBAAC;oBAAE,MAAMR;oBAAY,OAAOG;gBAAgB;aAAE;YAC5D,iBAAiBC;QACrB;QAGJ,MAAMW,eAAeT,OAAO,kBAAkB,CAACU,CAAAA,OAC3CC,KAAK,wBAAwB,CAACD;QAGlCD,aAAa,UAAU,CACnB,CAAC,6EAA6E,EAAEZ,gBAAgB,MAAM,CAAC;QAG3G;YACI,IAAIK,QAAQ;YAEZ,MAAMC,qBAAqBH,OAAO,qBAAqB;YACvD,IAAIG,mBAAmB,MAAM,EAAE;gBAC3B,MAAMC,OAAOD,kBAAkB,CAACA,mBAAmB,MAAM,GAAG,EAAE;gBAC9DD,QAAQE,KAAK,aAAa,KAAK;YACnC;YAEA,MAAMQ,oCACF;YACJ,MAAMC,8BAA8Bb,OAAO,oBAAoB,CAC3DY;YAEJ,IAAI,CAACC,6BACDb,OAAO,uBAAuB,CAACE,OAAO;gBAClC,cAAc;oBAAC;iBAAgC;gBAC/C,iBAAiBU;YACrB;QAER;QAEA,MAAMZ,OAAO,IAAI;IACrB;AACJ"}

package/extensions/ApiMaxBundleSize.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare const ApiMaxBundleSize: import("~/defineExtension/index.js").ExtensionComponent<z.ZodObject<{
+    size: z.ZodNumber;
+}, z.core.$strip>>;

package/extensions/ApiMaxBundleSize.js

@@ -0,0 +1,23 @@
+import react from "react";
+import { z } from "zod";
+import { defineExtension } from "../defineExtension/index.js";
+import { EnvVar } from "./EnvVar.js";
+const ApiMaxBundleSize = defineExtension({
+    type: "Infra/Api/MaxBundleSize",
+    tags: {
+        runtimeContext: "project"
+    },
+    description: "Set the maximum bundle size for the API build.",
+    paramsSchema: z.object({
+        size: z.number().int().positive().describe("Maximum bundle size in bytes.")
+    }),
+    render ({ size }) {
+        return /*#__PURE__*/ react.createElement(EnvVar, {
+            varName: "WEBINY_INFRA_API_MAX_BUNDLE_SIZE",
+            value: String(size)
+        });
+    }
+});
+export { ApiMaxBundleSize };
+
+//# sourceMappingURL=ApiMaxBundleSize.js.map

package/extensions/ApiMaxBundleSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions/ApiMaxBundleSize.js","sources":["../../src/extensions/ApiMaxBundleSize.tsx"],"sourcesContent":["import React from \"react\";\nimport { z } from \"zod\";\nimport { defineExtension } from \"~/defineExtension/index.js\";\nimport { EnvVar } from \"~/extensions/EnvVar.js\";\n\nexport const ApiMaxBundleSize = defineExtension({\n    type: \"Infra/Api/MaxBundleSize\",\n    tags: { runtimeContext: \"project\" },\n    description: \"Set the maximum bundle size for the API build.\",\n    paramsSchema: z.object({\n        size: z.number().int().positive().describe(\"Maximum bundle size in bytes.\")\n    }),\n    render({ size }) {\n        return <EnvVar varName=\"WEBINY_INFRA_API_MAX_BUNDLE_SIZE\" value={String(size)} />;\n    }\n});\n"],"names":["ApiMaxBundleSize","defineExtension","z","size","EnvVar","String"],"mappings":";;;;AAKO,MAAMA,mBAAmBC,gBAAgB;IAC5C,MAAM;IACN,MAAM;QAAE,gBAAgB;IAAU;IAClC,aAAa;IACb,cAAcC,EAAE,MAAM,CAAC;QACnB,MAAMA,EAAE,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC/C;IACA,QAAO,EAAEC,IAAI,EAAE;QACX,OAAO,WAAP,GAAO,oBAACC,QAAMA;YAAC,SAAQ;YAAmC,OAAOC,OAAOF;;IAC5E;AACJ"}

package/extensions/DatabaseSetup.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
-export declare const DatabaseSetup: import("../defineExtension/defineExtension.js").ExtensionComponent<z.ZodObject<{
-    setupName: z.ZodEnum<["ddb", "ddb+es", "ddb+os"]>;
-}, "strip", z.ZodTypeAny, {
-    setupName: "ddb" | "ddb+es" | "ddb+os";
-}, {
-    setupName: "ddb" | "ddb+es" | "ddb+os";
-}>>;
+export declare const DatabaseSetup: import("./index.js").ExtensionComponent<z.ZodObject<{
+    setupName: z.ZodEnum<{
+        ddb: "ddb";
+        "ddb+es": "ddb+es";
+        "ddb+os": "ddb+os";
+    }>;
+}, z.core.$strip>>;

package/extensions/DatabaseSetup.js

@@ -1,14 +1,19 @@
 import { z } from "zod";
 import { defineExtension } from "../defineExtension/index.js";
-export const DatabaseSetup = defineExtension({
-  type: "Project/DatabaseSetup",
-  tags: {
-    runtimeContext: "project"
-  },
-  description: "Define the database setup configuration (ddb, ddb+es, or ddb+os).",
-  paramsSchema: z.object({
-    setupName: z.enum(["ddb", "ddb+es", "ddb+os"]).describe("The database setup type: ddb (DynamoDB only), ddb+es (DynamoDB + ElasticSearch), or ddb+os (DynamoDB + OpenSearch)")
-  })
+const DatabaseSetup = defineExtension({
+    type: "Project/DatabaseSetup",
+    tags: {
+        runtimeContext: "project"
+    },
+    description: "Define the database setup configuration (ddb, ddb+es, or ddb+os).",
+    paramsSchema: z.object({
+        setupName: z["enum"]([
+            "ddb",
+            "ddb+es",
+            "ddb+os"
+        ]).describe("The database setup type: ddb (DynamoDB only), ddb+es (DynamoDB + ElasticSearch), or ddb+os (DynamoDB + OpenSearch)")
+    })
 });
+export { DatabaseSetup };
 
 //# sourceMappingURL=DatabaseSetup.js.map

package/extensions/DatabaseSetup.js.map

@@ -1 +1 @@
-{"version":3,"names":["z","defineExtension","DatabaseSetup","type","tags","runtimeContext","description","paramsSchema","object","setupName","enum","describe"],"sources":["DatabaseSetup.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { defineExtension } from \"../defineExtension/index.js\";\n\nexport const DatabaseSetup = defineExtension({\n    type: \"Project/DatabaseSetup\",\n    tags: { runtimeContext: \"project\" },\n    description: \"Define the database setup configuration (ddb, ddb+es, or ddb+os).\",\n    paramsSchema: z.object({\n        setupName: z\n            .enum([\"ddb\", \"ddb+es\", \"ddb+os\"])\n            .describe(\n                \"The database setup type: ddb (DynamoDB only), ddb+es (DynamoDB + ElasticSearch), or ddb+os (DynamoDB + OpenSearch)\"\n            )\n    })\n});\n"],"mappings":"AAAA,SAASA,CAAC,QAAQ,KAAK;AACvB,SAASC,eAAe;AAExB,OAAO,MAAMC,aAAa,GAAGD,eAAe,CAAC;EACzCE,IAAI,EAAE,uBAAuB;EAC7BC,IAAI,EAAE;IAAEC,cAAc,EAAE;EAAU,CAAC;EACnCC,WAAW,EAAE,mEAAmE;EAChFC,YAAY,EAAEP,CAAC,CAACQ,MAAM,CAAC;IACnBC,SAAS,EAAET,CAAC,CACPU,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CACjCC,QAAQ,CACL,oHACJ;EACR,CAAC;AACL,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"extensions/DatabaseSetup.js","sources":["../../src/extensions/DatabaseSetup.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { defineExtension } from \"../defineExtension/index.js\";\n\nexport const DatabaseSetup = defineExtension({\n    type: \"Project/DatabaseSetup\",\n    tags: { runtimeContext: \"project\" },\n    description: \"Define the database setup configuration (ddb, ddb+es, or ddb+os).\",\n    paramsSchema: z.object({\n        setupName: z\n            .enum([\"ddb\", \"ddb+es\", \"ddb+os\"])\n            .describe(\n                \"The database setup type: ddb (DynamoDB only), ddb+es (DynamoDB + ElasticSearch), or ddb+os (DynamoDB + OpenSearch)\"\n            )\n    })\n});\n"],"names":["DatabaseSetup","defineExtension","z"],"mappings":";;AAGO,MAAMA,gBAAgBC,gBAAgB;IACzC,MAAM;IACN,MAAM;QAAE,gBAAgB;IAAU;IAClC,aAAa;IACb,cAAcC,EAAE,MAAM,CAAC;QACnB,WAAWA,CAAC,CAADA,OACF,CAAC;YAAC;YAAO;YAAU;SAAS,EAChC,QAAQ,CACL;IAEZ;AACJ"}

package/extensions/EnvVar.d.ts

@@ -1,11 +1,8 @@
 import { z } from "zod";
+/**
+ * Define an environment variable in the project context.
+ */
 export declare const EnvVar: import("~/defineExtension/index.js").ExtensionComponent<z.ZodObject<{
     varName: z.ZodString;
     value: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    value: string;
-    varName: string;
-}, {
-    value: string;
-    varName: string;
-}>>;
+}, z.core.$strip>>;