@izara_project/izara-core-generate-service-code 1.0.96 → 1.0.97

package/test/helpers/testProject.js

@@ -0,0 +1,127 @@
+import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+
+const trackedRoots = new Set();
+
+/**
+ * Creates a temporary project directory with standard Izara service structure.
+ *
+ * @param {Object} [options]
+ * @param {string} [options.rootPath] - Existing root path to re-use
+ * @param {string} [options.prefix] - Temp folder prefix (default: 'izara-test-')
+ * @param {string} [options.serviceName] - Service name in config
+ * @param {string} [options.serviceTag] - Custom serviceTag in config
+ * @param {string} [options.serverlessConfig] - Custom serverless.config.yml content
+ * @param {Object} [options.schemas] - Schemas map e.g. { ObjectSchemas: { 'Order.js': '...' } }
+ * @returns {Promise<string>} The project root path
+ */
+export async function createTestProject({
+  rootPath: existingRoot,
+  prefix = 'izara-test-',
+  serviceName = 'TestService',
+  serviceTag = 'TestService',
+  serverlessConfig,
+  schemas = {}
+} = {}) {
+  let rootPath = existingRoot;
+  if (!rootPath) {
+    rootPath = await mkdtemp(join(tmpdir(), prefix));
+  }
+  trackedRoots.add(rootPath);
+
+  const schemaRoot = join(rootPath, 'app/src/schemas');
+  await mkdir(join(schemaRoot, 'ObjectSchemas'), { recursive: true });
+  await mkdir(join(schemaRoot, 'RelationshipSchemas'), { recursive: true });
+  await mkdir(join(schemaRoot, 'FlowSchemas'), { recursive: true });
+  await mkdir(join(schemaRoot, 'ErrorSchemas'), { recursive: true });
+  await mkdir(join(rootPath, 'config'), { recursive: true });
+
+  let configContent = serverlessConfig;
+  if (!configContent) {
+    configContent =
+      `service: ${serviceName}\n` +
+      `custom:\n` +
+      `  serviceTag: ${serviceTag}\n`;
+  }
+  await writeFile(
+    join(rootPath, 'config/serverless.config.yml'),
+    configContent,
+    'utf8'
+  );
+
+  const schemaCategories = [
+    'ObjectSchemas',
+    'RelationshipSchemas',
+    'FlowSchemas',
+    'ErrorSchemas'
+  ];
+
+  for (const category of schemaCategories) {
+    const files = schemas[category];
+    if (files && typeof files === 'object') {
+      for (const [filename, content] of Object.entries(files)) {
+        await writeProjectFile(
+          rootPath,
+          join('app/src/schemas', category, filename),
+          content
+        );
+      }
+    }
+  }
+
+  for (const [key, content] of Object.entries(schemas)) {
+    if (!schemaCategories.includes(key) && typeof content === 'string') {
+      await writeProjectFile(
+        rootPath,
+        join('app/src/schemas', key),
+        content
+      );
+    }
+  }
+
+  return rootPath;
+}
+
+/**
+ * Tracks an external directory path for cleanupTestProjects.
+ *
+ * @param {string} rootPath - Directory path to track
+ * @returns {string} The tracked path
+ */
+export function trackTestProject(rootPath) {
+  trackedRoots.add(rootPath);
+  return rootPath;
+}
+
+/**
+ * Writes a file relative to the project root.
+ */
+export async function writeProjectFile(rootPath, relativePath, content) {
+  const targetPath = join(rootPath, relativePath);
+  await mkdir(dirname(targetPath), { recursive: true });
+  await writeFile(targetPath, content, 'utf8');
+  return targetPath;
+}
+
+/**
+ * Reads a file relative to the project root.
+ */
+export async function readProjectFile(rootPath, relativePath) {
+  return await readFile(join(rootPath, relativePath), 'utf8');
+}
+
+/**
+ * Cleans up all tracked temporary project directories.
+ */
+export async function cleanupTestProjects() {
+  const roots = Array.from(trackedRoots);
+  trackedRoots.clear();
+  for (const root of roots) {
+    try {
+      await rm(root, { recursive: true, force: true });
+    } catch (err) {
+      // Ignore cleanup errors
+    }
+  }
+}

package/test/helpers/testProject.test.js

@@ -0,0 +1,57 @@
+import assert from 'node:assert/strict';
+import { stat } from 'node:fs/promises';
+import test, { after } from 'node:test';
+
+import {
+  createTestProject,
+  writeProjectFile,
+  readProjectFile,
+  cleanupTestProjects
+} from './testProject.js';
+
+after(async () => {
+  await cleanupTestProjects();
+});
+
+test('createTestProject creates directories and serverless config', async () => {
+  const rootPath = await createTestProject({
+    serviceName: 'DemoService',
+    serviceTag: 'DemoTag'
+  });
+
+  const config = await readProjectFile(
+    rootPath,
+    'config/serverless.config.yml'
+  );
+  assert.match(config, /service: DemoService/);
+  assert.match(config, /serviceTag: DemoTag/);
+
+  const customFile = 'app/src/schemas/ObjectSchemas/Demo.js';
+  await writeProjectFile(
+    rootPath,
+    customFile,
+    'export default [{ objectType: "demo" }];'
+  );
+
+  const readBack = await readProjectFile(rootPath, customFile);
+  assert.match(readBack, /objectType: "demo"/);
+
+  const stats = await stat(rootPath);
+  assert.equal(stats.isDirectory(), true);
+});
+
+test('createTestProject populates initial schemas map', async () => {
+  const rootPath = await createTestProject({
+    schemas: {
+      ObjectSchemas: {
+        'Item.js': 'export default [{ objectType: "item" }];'
+      }
+    }
+  });
+
+  const content = await readProjectFile(
+    rootPath,
+    'app/src/schemas/ObjectSchemas/Item.js'
+  );
+  assert.match(content, /objectType: "item"/);
+});

package/test/{core.test.js → integration/core.test.js}

@@ -11,9 +11,9 @@ import { tmpdir } from 'node:os';
 import { dirname, join } from 'node:path';
 import test from 'node:test';
 
-import { buildGenerationPlan } from '../src/plan/buildGenerationPlan.js';
-import { commitArtifacts } from '../src/output/commitArtifacts.js';
-import { compileProject } from '../src/compile/compileProject.js';
+import { buildGenerationPlan } from '../../src/plan/buildGenerationPlan.js';
+import { commitArtifacts } from '../../src/output/commitArtifacts.js';
+import { compileProject } from '../../src/compile/compileProject.js';
 
 test('compiles a request and commits only declared relative artifacts', async () => {
   const outputPath = await mkdtemp(join(tmpdir(), 'generate-service-code-v2-'));

package/test/{graphDrivenFlowSchema.test.js → integration/graphDrivenFlowSchema.test.js}

@@ -1,6 +1,6 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
-import { validateFlowSchema } from '../src/compile/flowValidator.js';
+import { validateFlowSchema } from '../../src/compile/flowValidator.js';
 
 test('validateFlowSchema passes for valid Graph-Driven FlowSchema', () => {
   const validSchema = {

package/test/{intTestApi.test.js → integration/intTestApi.test.js}

@@ -4,7 +4,7 @@ import os from 'node:os';
 import path from 'node:path';
 import test from 'node:test';
 
-import { generateIntTest, generateResourceIntTest } from '../index.js';
+import { generateIntTest, generateResourceIntTest } from '../../index.js';
 
 test('exports IntTest generators and requires a service tag', async () => {
   const rootPath = await mkdtemp(

package/test/{publicApi.test.js → integration/publicApi.test.js}

@@ -7,7 +7,7 @@ import test from 'node:test';
 
 process.env.NODE_ENV = 'test';
 
-import * as publicApi from '../index.js';
+import * as publicApi from '../../index.js';
 
 const { generate } = publicApi;
 

package/test/{createTargetRoleHandler.test.js → unit/application/createTargetRoleHandler.test.js}

@@ -4,7 +4,7 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import test, { after } from 'node:test';
 
-import { generateCreateTargetRoleHandler } from '../src/emit/rbac/generateCreateTargetRoleHandler.js';
+import { generateCreateTargetRoleHandler } from '../../../src/emit/application/rbac/generateCreateTargetRoleHandler.js';
 
 const roots = new Set();
 const OWN_TOPIC_FLOWS = [

package/test/{crudApplicationArtifacts.test.js → unit/application/crudApplicationArtifacts.test.js}

@@ -7,7 +7,7 @@ import test, { after } from 'node:test';
 
 process.env.NODE_ENV = 'test';
 
-import { generateCrudApplicationArtifacts } from '../src/emit/crud/generateCrudApplicationArtifacts.js';
+import { generateCrudApplicationArtifacts } from '../../../src/emit/application/crud/generateCrudApplicationArtifacts.js';
 
 const roots = new Set();
 after(() =>

package/test/{customFlowApplicationArtifacts.test.js → unit/application/customFlowApplicationArtifacts.test.js}

@@ -13,10 +13,10 @@ import { dirname, join, resolve } from 'node:path';
 import { promisify } from 'node:util';
 import test, { after } from 'node:test';
 
-import { generate } from '../src/generate.js';
-import { generateCustomFlowApplicationArtifacts } from '../src/emit/custom/generateCustomFlowApplicationArtifacts.js';
-import { generateResourceArtifacts } from '../src/emit/resource/generateResourceArtifacts.js';
-import { renderEventBridgeFunctionYaml } from '../src/emit/function/functionYamlArtifact.js';
+import { generate } from '../../../src/generate.js';
+import { generateCustomFlowApplicationArtifacts } from '../../../src/emit/application/custom/generateCustomFlowApplicationArtifacts.js';
+import { generateResourceArtifacts } from '../../../src/emit/infrastructure/resources/generateResourceArtifacts.js';
+import { renderEventBridgeFunctionYaml } from '../../../src/emit/infrastructure/functions/functionYamlArtifact.js';
 
 const roots = new Set();
 const execFileAsync = promisify(execFile);
@@ -865,7 +865,7 @@ test(
 );
 
 test('renders nextSteps IAM permissions in InitialSetupConfig', async () => {
-  const { generate } = await import('../src/generate.js');
+  const { generate } = await import('../../../src/generate.js');
   const rootPath = await mkdtemp(
     join(tmpdir(), 'generate-service-code-v2-nextsteps-')
   );
@@ -935,7 +935,7 @@ test('renders nextSteps IAM permissions in InitialSetupConfig', async () => {
 });
 
 test('registers SQS queue, SNS subscription, and SNS out topic for custom flowSchema with outputTopic set to true', async () => {
-  const { generate } = await import('../src/generate.js');
+  const { generate } = await import('../../../src/generate.js');
   const rootPath = await mkdtemp(
     join(tmpdir(), 'generate-service-code-v2-outputtopic-')
   );
@@ -1030,7 +1030,7 @@ test('uses synchronous RBAC without obsolete callback SQS subscriptions in Initi
 });
 
 test('deduplicates duplicate nextSteps topics across flowSteps in InitialSetupConfig', async () => {
-  const { generate } = await import('../src/generate.js');
+  const { generate } = await import('../../../src/generate.js');
   const rootPath = await mkdtemp(
     join(tmpdir(), 'generate-service-code-v2-dedupe-nextsteps-')
   );
@@ -1466,7 +1466,7 @@ test('emits canonical checkStatusField and hooks in FlowEndpoint_Main for status
 });
 
 test('does not emit RbacCallback artifacts or duplicate artifact paths for custom flow with RBAC', async () => {
-  const { generate } = await import('../src/generate.js');
+  const { generate } = await import('../../../src/generate.js');
   const rootPath = await createProject();
   await writeFile(
     join(rootPath, 'app/src/schemas/ObjectSchemas/ComAcc.js'),
@@ -1539,7 +1539,7 @@ test('does not emit RbacCallback artifacts or duplicate artifact paths for custo
 });
 
 test('skips checkRbacPermission in FlowEndpoint_Main when initiateBy is systemNoUser', async () => {
-  const { generate } = await import('../src/generate.js');
+  const { generate } = await import('../../../src/generate.js');
   const rootPath = await createProject();
   await writeFile(
     join(rootPath, 'app/src/schemas/ObjectSchemas/ComAcc.js'),

package/test/{relationshipApplicationArtifacts.test.js → unit/application/relationshipApplicationArtifacts.test.js}

@@ -4,7 +4,7 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import test, { after } from 'node:test';
 
-import { generateRelationshipApplicationArtifacts } from '../src/emit/relationship/generateRelationshipApplicationArtifacts.js';
+import { generateRelationshipApplicationArtifacts } from '../../../src/emit/application/relationship/generateRelationshipApplicationArtifacts.js';
 
 const roots = new Set();
 after(() =>

package/test/{systemFindDataArtifacts.test.js → unit/application/systemFindDataArtifacts.test.js}

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
 
-import { emitSystemFindDataArtifacts } from '../src/emit/system/emitSystemFindDataArtifacts.js';
+import { emitSystemFindDataArtifacts } from '../../../src/emit/application/system/emitSystemFindDataArtifacts.js';
 
 test('emitSystemFindDataArtifacts returns empty when no objects have storage resources', async () => {
   const result = await emitSystemFindDataArtifacts([

package/test/{functionYamlArtifact.test.js → unit/infrastructure/functionYamlArtifact.test.js}

@@ -7,7 +7,7 @@ import {
   renderInvFunctionYaml,
   renderSqsFunctionYaml,
   renderWbsFunctionYaml
-} from '../src/emit/function/functionYamlArtifact.js';
+} from '../../../src/emit/infrastructure/functions/functionYamlArtifact.js';
 
 test('renders function-setting hooks for every function transport', () => {
   const functions = [

package/test/{resourceArtifacts.test.js → unit/infrastructure/resourceArtifacts.test.js}

@@ -6,7 +6,7 @@ import test, { after } from 'node:test';
 
 process.env.NODE_ENV = 'test';
 
-import { generateResourceArtifacts } from '../src/emit/resource/generateResourceArtifacts.js';
+import { generateResourceArtifacts } from '../../../src/emit/infrastructure/resources/generateResourceArtifacts.js';
 
 const roots = new Set();
 after(() =>

package/test/{attributeTreeSchemas.test.js → unit/schemas/attributeTreeSchemas.test.js}

@@ -1,5 +1,5 @@
 import assert from 'node:assert/strict';
-import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { mkdir, mkdtemp } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import test, { after } from 'node:test';
@@ -11,17 +11,18 @@ import {
   attributeTreeRelationshipSchemaManagedPaths,
   resolveTargetServicePath,
   emitAttributeTreeTargetSchemas
-} from '../src/emit/attributeTree/emitAttributeTreeSchemas.js';
-import { generate } from '../src/generate.js';
-
-const projectRoots = new Set();
+} from '../../../src/emit/schemas/attributeTree/emitAttributeTreeSchemas.js';
+import { generate } from '../../../src/generate.js';
+import {
+  createTestProject,
+  readProjectFile,
+  writeProjectFile,
+  cleanupTestProjects,
+  trackTestProject
+} from '../../helpers/testProject.js';
 
 after(async () => {
-  await Promise.all(
-    [...projectRoots].map((rootPath) =>
-      rm(rootPath, { recursive: true, force: true })
-    )
-  );
+  await cleanupTestProjects();
 });
 
 test('emitAttributeTreeObjectSchemas returns 3 object schemas per attributeTree tag', () => {
@@ -149,23 +150,19 @@ test('managed paths return empty array when no attributeTree is present', () =>
 
 test('generate commits and cleans up attributeTree dynamic schemas', async () => {
   const rootPath = await createProjectWithAttributeTree({ hasAddOn: true });
-  const result = await generate(rootPath);
+  await generate(rootPath);
 
-  const expectedObjectPath = join(
-    rootPath,
-    'app/src/schemas/ObjectSchemas/generatedAttributeTree/sellOfferTermLink.js'
-  );
-  const expectedRelPath = join(
-    rootPath,
-    'app/src/schemas/RelationshipSchemas/generatedAttributeTree/hasSellOfferTermLink.js'
-  );
+  const objectRelPath =
+    'app/src/schemas/ObjectSchemas/generatedAttributeTree/sellOfferTermLink.js';
+  const relRelPath =
+    'app/src/schemas/RelationshipSchemas/generatedAttributeTree/hasSellOfferTermLink.js';
 
-  const objectContent = await readFile(expectedObjectPath, 'utf8');
+  const objectContent = await readProjectFile(rootPath, objectRelPath);
   assert.match(objectContent, /sellOfferTermLink/);
   assert.match(objectContent, /GraphHandler/);
   assert.doesNotMatch(objectContent, /dynamoDB/);
 
-  const relContent = await readFile(expectedRelPath, 'utf8');
+  const relContent = await readProjectFile(rootPath, relRelPath);
   assert.match(relContent, /hasSellOfferTermLink/);
   assert.match(relContent, /sellOfferTermLink/);
 
@@ -173,10 +170,10 @@ test('generate commits and cleans up attributeTree dynamic schemas', async () =>
   await createProjectWithAttributeTree({ rootPath, hasAddOn: false });
   await generate(rootPath);
 
-  await assert.rejects(readFile(expectedObjectPath, 'utf8'), {
+  await assert.rejects(readProjectFile(rootPath, objectRelPath), {
     code: 'ENOENT'
   });
-  await assert.rejects(readFile(expectedRelPath, 'utf8'), {
+  await assert.rejects(readProjectFile(rootPath, relRelPath), {
     code: 'ENOENT'
   });
 });
@@ -185,21 +182,6 @@ async function createProjectWithAttributeTree({
   rootPath: existingRoot,
   hasAddOn = true
 } = {}) {
-  const rootPath =
-    existingRoot || (await mkdtemp(join(tmpdir(), 'izara-attr-tree-test-')));
-  projectRoots.add(rootPath);
-
-  const schemaRoot = join(rootPath, 'app/src/schemas');
-  await mkdir(join(schemaRoot, 'ObjectSchemas'), { recursive: true });
-  await mkdir(join(schemaRoot, 'RelationshipSchemas'), { recursive: true });
-  await mkdir(join(schemaRoot, 'FlowSchemas'), { recursive: true });
-  await mkdir(join(rootPath, 'config'), { recursive: true });
-
-  await writeFile(
-    join(rootPath, 'config/serverless.config.yml'),
-    'service: SellOfferManager\ncustom:\n  serviceTag: SellOfferManager\n'
-  );
-
   const addOnContent = hasAddOn
     ? `
     addOnDataStructure: [
@@ -210,9 +192,7 @@ async function createProjectWithAttributeTree({
     ],`
     : '    addOnDataStructure: [],';
 
-  await writeFile(
-    join(schemaRoot, 'ObjectSchemas/SellOffer.js'),
-    `export default [
+  const schemaContent = `export default [
   {
     objectType: 'sellOffer',
     canDelete: false,
@@ -244,15 +224,30 @@ async function createProjectWithAttributeTree({
     ]
   }
 ];
-`
-  );
+`;
+
+  if (existingRoot) {
+    await writeProjectFile(
+      existingRoot,
+      'app/src/schemas/ObjectSchemas/SellOffer.js',
+      schemaContent
+    );
+    return existingRoot;
+  }
 
-  return rootPath;
+  return await createTestProject({
+    prefix: 'izara-attr-tree-test-',
+    serviceTag: 'SellOfferManager',
+    schemas: {
+      'ObjectSchemas/SellOffer.js': schemaContent
+    }
+  });
 }
 
 test('resolveTargetServicePath prioritizes dev suffix and matches attributeTag', async () => {
-  const tmpRoot = await mkdtemp(join(tmpdir(), 'izara-services-test-'));
-  projectRoots.add(tmpRoot);
+  const tmpRoot = trackTestProject(
+    await mkdtemp(join(tmpdir(), 'izara-services-test-'))
+  );
 
   const currentServiceDir = join(
     tmpRoot,

package/test/{dynamicCrudFlowSchemas.test.js → unit/schemas/dynamicCrudFlowSchemas.test.js}

@@ -5,8 +5,8 @@ import { join } from 'node:path';
 import test from 'node:test';
 import { pathToFileURL } from 'node:url';
 
-import { generateDynamicCrudFlowSchemas } from '../src/emit/crud/generateDynamicCrudFlowSchemas.js';
-import { createCrudActionPlans } from '../src/emit/crud/crudActionPlan.js';
+import { generateDynamicCrudFlowSchemas } from '../../../src/emit/application/crud/generateDynamicCrudFlowSchemas.js';
+import { createCrudActionPlans } from '../../../src/emit/application/crud/crudActionPlan.js';
 
 test('generates dynamic CRUD schemas from local schema modules', async () => {
   const rootPath = await createProject({

package/test/{dynamicRbacFlowSchemas.test.js → unit/schemas/dynamicRbacFlowSchemas.test.js}

@@ -5,7 +5,7 @@ import { join } from 'node:path';
 import test, { after } from 'node:test';
 import { pathToFileURL } from 'node:url';
 
-import { generateDynamicRbacFlowSchemas } from '../src/emit/rbac/generateDynamicRbacFlowSchemas.js';
+import { generateDynamicRbacFlowSchemas } from '../../../src/emit/application/rbac/generateDynamicRbacFlowSchemas.js';
 
 const projectRoots = new Set();
 const STATIC_RBAC_ACTIONS = [

package/test/{dynamicRelationshipFlowSchemas.test.js → unit/schemas/dynamicRelationshipFlowSchemas.test.js}

@@ -5,7 +5,7 @@ import { join } from 'node:path';
 import test, { after } from 'node:test';
 import { pathToFileURL } from 'node:url';
 
-import { generateDynamicRelationshipFlowSchemas } from '../src/emit/relationship/generateDynamicRelationshipFlowSchemas.js';
+import { generateDynamicRelationshipFlowSchemas } from '../../../src/emit/application/relationship/generateDynamicRelationshipFlowSchemas.js';
 
 const RELATIONSHIP_ACTIONS = [
   'CreateRelationship',
@@ -60,6 +60,16 @@ test('generates dynamic relationship schemas when declared relationships exist',
     'userId',
     'correlationId'
   ]);
+  const completeStep = create.flowSteps.find(
+    (step) => step.stepName === 'Complete'
+  );
+  assert.deepEqual(completeStep.properties, [
+    'returnValue',
+    'parentFlowId',
+    'status',
+    'foundErrors',
+    'graphServiceTag'
+  ]);
   assert.deepEqual(get.event, [
     'lambdaSyncInv',
     'lambdaSyncApi',

package/test/{errorSchemas.test.js → unit/schemas/errorSchemas.test.js}

@@ -8,8 +8,8 @@ import {
   emitErrorSchemas,
   errorSchemaManagedPaths,
   ERROR_SCHEMA_PATH
-} from '../src/emit/error/emitErrorSchemas.js';
-import { generate } from '../src/generate.js';
+} from '../../../src/emit/schemas/error/emitErrorSchemas.js';
+import { generate } from '../../../src/generate.js';
 
 const roots = new Set();
 after(() =>