@empire-builder-kit/nx 1.0.0-beta.9 → 1.0.0-rc.2

package/src/generators/function/function.js

@@ -5,6 +5,9 @@ exports.functionGenerator = functionGenerator;
 const devkit_1 = require("@nx/devkit");
 const node_path_1 = require("node:path");
 const index_js_1 = require("../../ownership/index.js");
+const feature_registry_js_1 = require("../feature-registry.js");
+const logging_registry_js_1 = require("../logging-registry.js");
+const post_generation_install_js_1 = require("../post-generation-install.js");
 function requireName(value, label) {
     const normalized = value.trim();
     if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(normalized)) {
@@ -25,14 +28,20 @@ function replaceMarker(tree, path, marker, line) {
     }
     tree.write(path, source.replace(marker, `${line}\n${marker}`));
 }
-function createFunctionFilePlan(slice, name) {
+function requireCompositionMarker(tree, path, marker) {
+    const source = tree.read(path, 'utf8');
+    if (source === null || !source.includes(marker)) {
+        throw new Error(`Product Slice composition marker ${marker} is missing from ${path}.`);
+    }
+}
+function createFunctionFilePlan(workspace, slice, name, feature = name) {
     const symbol = `${pascal(slice)}${pascal(name)}Function`;
     const register = `register${symbol}`;
     return {
         files: {
-            [`api/${name}.ts`]: `import { createHttpJsonHandler } from '@empire-builder-kit/runtime';\n\nexport const handler = createHttpJsonHandler({\n  app: '${slice}',\n  operation: '${name}',\n  async handle({ context }) {\n    return { actor: context.actor?.id ?? null, function: '${name}', ok: true };\n  },\n});\n`,
+            [`api/${name}.ts`]: `import { createHttpJsonHandler } from '@empire-builder-kit/runtime';\n\nexport const handler = createHttpJsonHandler({\n  component: 'function-${name}',\n  feature: '${feature}',\n  operation: '${name}',\n  slice: '${slice}',\n  workspace: '${workspace}',\n  async handle({ context }) {\n    return { actor: context.actor?.id ?? null, function: '${name}', ok: true };\n  },\n});\n`,
             [`api/${name}.spec.ts`]: `import { describe, expect, it } from 'vitest';\nimport { handler } from './${name}.js';\n\ndescribe('${name} function', () => {\n  it('returns its generated identity', async () => {\n    const response = await handler({ requestContext: { requestId: 'test-request' } });\n    expect(response.statusCode).toBe(200);\n    expect(JSON.parse(response.body).data).toMatchObject({ function: '${name}', ok: true });\n  });\n});\n`,
-            [`infra/functions/${name}.ts`]: `export function ${register}(api: any) {\n  api.route('ANY /functions/${name}', {\n    environment: { EBK_STAGE: $app.stage },\n    handler: 'api/${name}.handler',\n    logging: { format: 'json', retention: '1 month' },\n  });\n}\n`,
+            [`infra/functions/${name}.ts`]: `import { createManagedLogGroupContract } from '@empire-builder-kit/nx/foundation';\n\nexport function ${register}(\n  api: any,\n  alertTopicArn: any,\n  role?: { role: string },\n  links: any[] = [],\n) {\n  const contract = createManagedLogGroupContract({\n    component: 'function-${name}',\n    slice: '${slice}',\n    stage: $app.stage,\n    workspace: '${workspace}',\n  });\n  const logGroup = new aws.cloudwatch.LogGroup('${pascal(slice)}${pascal(name)}Logs', {\n    logGroupClass: contract.logGroupClass,\n    name: contract.name,\n    retentionInDays: contract.retentionInDays,\n    tags: contract.tags,\n  });\n  const dataProtection = new aws.cloudwatch.LogDataProtectionPolicy(\n    '${pascal(slice)}${pascal(name)}LogDataProtection',\n    {\n      logGroupName: logGroup.name,\n      policyDocument: JSON.stringify(contract.dataProtectionPolicy),\n    },\n    { dependsOn: [logGroup] },\n  );\n  const dataProtectionAlarm = new aws.cloudwatch.MetricAlarm(\n    '${pascal(slice)}${pascal(name)}LogDataProtectionFindings',\n    {\n      alarmActions: [alertTopicArn],\n      comparisonOperator: 'GreaterThanOrEqualToThreshold',\n      dimensions: { LogGroupName: logGroup.name },\n      evaluationPeriods: 1,\n      metricName: 'LogEventsWithFindings',\n      namespace: 'AWS/Logs',\n      period: 300,\n      statistic: 'Sum',\n      threshold: 1,\n      treatMissingData: 'notBreaching',\n    },\n    { dependsOn: [dataProtection] },\n  );\n  api.route('ANY /functions/${name}', {\n    ...(role ?? {}),\n    environment: { EBK_STAGE: $app.stage },\n    handler: 'api/${name}.handler',\n    link: links,\n    logging: { format: 'json', logGroup: logGroup.name },\n    transform: {\n      function: {\n        loggingConfig: {\n          applicationLogLevel: 'TRACE',\n          logFormat: 'JSON',\n          logGroup: logGroup.name,\n          systemLogLevel: 'INFO',\n        },\n      },\n    },\n  });\n  return { dataProtection, dataProtectionAlarm, logGroup };\n}\n`,
         },
         paths: [
             { mode: 'seeded', path: `api/${name}.ts` },
@@ -43,27 +52,63 @@ function createFunctionFilePlan(slice, name) {
     };
 }
 async function functionGenerator(tree, options) {
+    const packageSource = tree.read('package.json', 'utf8');
+    if (packageSource === null) {
+        throw new Error('Workspace package.json is required.');
+    }
+    let packageName;
+    try {
+        packageName = JSON.parse(packageSource).name;
+    }
+    catch {
+        throw new Error('Workspace package.json must be valid JSON.');
+    }
+    const workspace = requireName(typeof packageName === 'string' ? packageName : '', 'Workspace name');
     const slice = requireName(options.slice, 'Product Slice name');
     const name = requireName(options.name, 'Function name');
+    (0, post_generation_install_js_1.assertPostGenerationInstallWorkspaceAvailable)(tree, `generator:function:${slice}:${name}`);
     const sliceRoot = node_path_1.posix.join('packages', slice);
     const handlerPath = node_path_1.posix.join(sliceRoot, 'api', `${name}.ts`);
     const infraPath = node_path_1.posix.join(sliceRoot, 'infra/functions', `${name}.ts`);
     const productPath = node_path_1.posix.join(sliceRoot, 'infra/product.ts');
+    const candidatePath = node_path_1.posix.join(sliceRoot, 'infra/workload-roles/candidate.ts');
+    const intentPath = node_path_1.posix.join(sliceRoot, 'infra/workload-roles/effective-intent.ts');
     if (!tree.exists(productPath))
         throw new Error(`${slice} is not an EBK v1 Product Slice.`);
     if (tree.exists(handlerPath) || tree.exists(infraPath)) {
         throw new Error(`Function ${name} already exists in Product Slice ${slice}.`);
     }
-    const plan = createFunctionFilePlan(slice, name);
+    const feature = (0, feature_registry_js_1.requireRegisteredSliceFeature)(tree, sliceRoot, options.feature);
+    requireCompositionMarker(tree, candidatePath, '// <ebk:workload-role-extensions:end>');
+    requireCompositionMarker(tree, intentPath, '// <ebk:workload-role-intent-contributions:end>');
+    requireCompositionMarker(tree, productPath, '// <ebk:composition-imports:end>');
+    requireCompositionMarker(tree, productPath, '// <ebk:function-registrations:end>');
+    const loggingRegistration = (0, logging_registry_js_1.planSliceLoggingComponentRegistration)(tree, sliceRoot, `function-${name}`);
+    const plan = createFunctionFilePlan(workspace, slice, name, feature);
     for (const [path, contents] of Object.entries(plan.files)) {
         tree.write(node_path_1.posix.join(sliceRoot, path), contents);
     }
+    tree.write(loggingRegistration.path, loggingRegistration.contents);
     replaceMarker(tree, productPath, '// <ebk:composition-imports:end>', `import { ${plan.register} } from './functions/${name}.js';`);
-    replaceMarker(tree, productPath, '// <ebk:function-registrations:end>', `  ${plan.register}(api);`);
+    replaceMarker(tree, productPath, '// <ebk:function-registrations:end>', `  ${plan.register}(
+    api,
+    foundation.discovery.alertTopicArn,
+    workloadRoleBindings?.extension.function('${name}'),
+    secretLinksFor('${name}-function'),
+  );`);
+    replaceMarker(tree, candidatePath, '// <ebk:workload-role-extensions:end>', `  { id: '${name}', kind: 'function' },`);
+    replaceMarker(tree, intentPath, '// <ebk:workload-role-intent-contributions:end>', `    ...extensionWorkloadRoleIntentContributions(context, topology, '${name}', 'function'),`);
     if (!options.skipFormat)
         await (0, devkit_1.formatFiles)(tree);
     (0, index_js_1.recordCompositionOwnership)(tree, {
-        paths: [...plan.paths, { path: 'infra/product.ts' }],
+        compositions: [{ feature, kind: 'function', name }],
+        paths: [
+            ...plan.paths,
+            { path: 'infra/product.ts' },
+            { path: 'infra/workload-roles/candidate.ts' },
+            { path: 'infra/workload-roles/effective-intent.ts' },
+            { path: logging_registry_js_1.SLICE_LOGGING_REGISTRY_PATH },
+        ],
         slice,
     });
 }

package/src/generators/function/function.js.map

@@ -1 +1 @@
-{"version":3,"file":"function.js","sourceRoot":"","sources":["../../../../../../packages/nx/src/generators/function/function.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../../../../../packages/nx/src/generators/function/function.ts"],"names":[],"mappings":"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"}

package/src/generators/function/schema.d.ts

@@ -1,4 +1,5 @@
 export interface FunctionGeneratorSchema {
+  feature: string;
   name: string;
   skipFormat?: boolean;
   slice: string;

package/src/generators/function/schema.json

@@ -5,6 +5,11 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
+    "feature": {
+      "type": "string",
+      "description": "Existing Slice feature id",
+      "x-prompt": "Which registered feature owns this function?"
+    },
     "name": {
       "type": "string",
       "$default": { "$source": "argv", "index": 0 }
@@ -16,5 +21,5 @@
     },
     "skipFormat": { "type": "boolean", "default": false }
   },
-  "required": ["name", "slice"]
+  "required": ["feature", "name", "slice"]
 }

package/src/generators/logging-registry.d.ts

@@ -0,0 +1,13 @@
+import type { Tree } from '@nx/devkit';
+export declare const SLICE_LOGGING_REGISTRY_PATH = "operations/logging-components.json";
+export declare const SLICE_LOGGING_REGISTRY_SCHEMA_VERSION: 1;
+export interface SliceLoggingRegistry {
+    components: string[];
+    databaseComponents: string[];
+    schemaVersion: typeof SLICE_LOGGING_REGISTRY_SCHEMA_VERSION;
+}
+export declare function parseSliceLoggingRegistry(value: unknown): SliceLoggingRegistry;
+export declare function planSliceLoggingComponentRegistration(tree: Tree, sliceRoot: string, component: string): {
+    contents: string;
+    path: string;
+};

package/src/generators/logging-registry.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SLICE_LOGGING_REGISTRY_SCHEMA_VERSION = exports.SLICE_LOGGING_REGISTRY_PATH = void 0;
+exports.parseSliceLoggingRegistry = parseSliceLoggingRegistry;
+exports.planSliceLoggingComponentRegistration = planSliceLoggingComponentRegistration;
+const node_path_1 = require("node:path");
+exports.SLICE_LOGGING_REGISTRY_PATH = 'operations/logging-components.json';
+exports.SLICE_LOGGING_REGISTRY_SCHEMA_VERSION = 1;
+const componentPattern = /^[a-z0-9][a-z0-9-]{0,127}$/;
+function requireComponents(value, field) {
+    if (!Array.isArray(value) ||
+        value.some((component) => typeof component !== 'string' || !componentPattern.test(component)) ||
+        new Set(value).size !== value.length) {
+        throw new Error(`Slice logging registry ${field} must contain unique normalized components.`);
+    }
+    return [...value].sort();
+}
+function parseSliceLoggingRegistry(value) {
+    if (typeof value !== 'object' ||
+        value === null ||
+        Array.isArray(value) ||
+        Object.keys(value).some((key) => key !== 'components' &&
+            key !== 'databaseComponents' &&
+            key !== 'schemaVersion')) {
+        throw new Error('Slice logging registry must be an exact object.');
+    }
+    const record = value;
+    if (record.schemaVersion !== exports.SLICE_LOGGING_REGISTRY_SCHEMA_VERSION) {
+        throw new Error(`Slice logging registry must use schemaVersion ${exports.SLICE_LOGGING_REGISTRY_SCHEMA_VERSION}.`);
+    }
+    return {
+        components: requireComponents(record.components, 'components'),
+        databaseComponents: requireComponents(record.databaseComponents, 'databaseComponents'),
+        schemaVersion: exports.SLICE_LOGGING_REGISTRY_SCHEMA_VERSION,
+    };
+}
+function planSliceLoggingComponentRegistration(tree, sliceRoot, component) {
+    if (!componentPattern.test(component)) {
+        throw new Error('Generated logging component must be a normalized slug.');
+    }
+    const path = node_path_1.posix.join(sliceRoot, exports.SLICE_LOGGING_REGISTRY_PATH);
+    const source = tree.read(path, 'utf8');
+    if (source === null) {
+        throw new Error(`Slice logging registry is missing at ${path}.`);
+    }
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch {
+        throw new Error(`Slice logging registry at ${path} must be valid JSON.`);
+    }
+    const registry = parseSliceLoggingRegistry(value);
+    return {
+        contents: `${JSON.stringify({
+            ...registry,
+            components: [...new Set([...registry.components, component])].sort(),
+        }, null, 2)}\n`,
+        path,
+    };
+}
+//# sourceMappingURL=logging-registry.js.map

package/src/generators/logging-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-registry.js","sourceRoot":"","sources":["../../../../../packages/nx/src/generators/logging-registry.ts"],"names":[],"mappings":"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"}

package/src/generators/post-generation-install.d.ts

@@ -0,0 +1,67 @@
+import type { GeneratorCallback, Tree } from '@nx/devkit';
+import { type PnpmPackageManagerDescriptor, type PnpmToolchainAuthority } from '../supply-chain/pnpm-toolchain-authority.js';
+declare const INSTALL_RESERVATION_KIND: "ebk-post-generation-install-reservation";
+declare const INSTALL_RESERVATION_SCHEMA_VERSION: 1;
+interface PnpmPackageManagerAuthority extends PnpmPackageManagerDescriptor {
+    toolchain: PnpmToolchainAuthority;
+}
+export interface PostGenerationInstallFeaturePrerequisite {
+    kind: 'registered-slice-feature';
+    path: string;
+    selectedFeature: string;
+}
+interface InstallPlanningReservation {
+    generation: string;
+    kind: typeof INSTALL_RESERVATION_KIND;
+    operationFingerprint: string;
+    operationId: string;
+    schemaVersion: typeof INSTALL_RESERVATION_SCHEMA_VERSION;
+}
+interface ChangeSnapshot {
+    contents: Map<string, Buffer>;
+    changes: Map<string, string>;
+    lockfileDigest: string;
+    packageManager: PnpmPackageManagerAuthority;
+    reservation: InstallPlanningReservation;
+}
+export interface PostGenerationInstallScope {
+    exactPaths?: string[];
+    requiredPaths: string[];
+    roots: string[];
+}
+export interface PostGenerationInstallOperation {
+    generator: 'slice' | 'workload';
+    id: string;
+    key: string;
+    request: Record<string, unknown>;
+    resumeArguments: string[];
+    semanticPrerequisites?: PostGenerationInstallFeaturePrerequisite[];
+    sourceRoot: string;
+}
+export interface PostGenerationInstallDependencies {
+    frozenInstall?: (workspaceRoot: string) => void;
+    initialInstall?: () => void;
+    protocolCheckpoint?: (checkpoint: 'after-complete-checkpoint' | 'after-initial-lease-create' | 'after-marker-clear-before-lease-release' | 'after-replacement-lease-create' | 'after-stale-lease-rename') => 'simulate-crash' | void;
+    resumedInitialInstall?: (workspaceRoot: string) => void;
+}
+export declare function postGenerationInstallFeaturePrerequisite(path: string, selectedFeature: string): PostGenerationInstallFeaturePrerequisite;
+export declare function postGenerationInstallMarkerPath(key: string): string;
+export declare function capturePostGenerationInstallState(tree: Tree, scope: PostGenerationInstallScope, operation: PostGenerationInstallOperation): ChangeSnapshot;
+export interface PostGenerationInstallPnpmInvocation {
+    args: string[];
+    command: string;
+    env: NodeJS.ProcessEnv;
+}
+export declare function postGenerationInstallPnpmInvocation(args: string[], options: {
+    environment?: NodeJS.ProcessEnv;
+    isolatedHome: string;
+    toolchain: PnpmToolchainAuthority;
+}): PostGenerationInstallPnpmInvocation;
+/**
+ * Prevents a non-installing generator from changing workspace bytes while a
+ * Slice or workload install still owns an exact recovery surface.
+ */
+export declare function assertPostGenerationInstallWorkspaceAvailable(tree: Tree, operationId: string): void;
+export declare function resumePendingPostGenerationInstall(tree: Tree, operation: PostGenerationInstallOperation, skipInstall: boolean | undefined, dependencies?: PostGenerationInstallDependencies): GeneratorCallback | undefined;
+export declare function createPostGenerationInstallCallback(tree: Tree, before: ChangeSnapshot, scope: PostGenerationInstallScope, operation: PostGenerationInstallOperation, dependencies?: PostGenerationInstallDependencies): GeneratorCallback;
+export {};