@auto-engineer/narrative 0.12.0 → 0.13.0

package/dist/src/model-to-narrative.specs.js

@@ -7,13 +7,14 @@ describe('modelToNarrative', () => {
         expect(code).toEqual(`import {
   command,
   data,
+  describe,
   example,
   gql,
+  it,
   narrative,
   query,
   react,
   rule,
-  should,
   sink,
   source,
   specs,
@@ -89,13 +90,13 @@ type ItemsAddedToCart = Event<
 narrative('Seasonal Assistant', () => {
   command('enters shopping criteria into assistant')
     .client(() => {
-      specs('Assistant Chat Interface', () => {
-        should('allow shopper to describe their shopping needs in natural language');
-        should('provide a text input for entering criteria');
-        should('show examples of what to include (age, interests, budget)');
-        should('show a button to submit the criteria');
-        should('generate a persisted session id for a visit');
-        should('show the header on top of the page');
+      describe('Assistant Chat Interface', () => {
+        it('allow shopper to describe their shopping needs in natural language');
+        it('provide a text input for entering criteria');
+        it('show examples of what to include (age, interests, budget)');
+        it('show a button to submit the criteria');
+        it('generate a persisted session id for a visit');
+        it('show the header on top of the page');
       });
     })
     .request(
@@ -233,11 +234,11 @@ narrative('Seasonal Assistant', () => {
   });
   query('views suggested items')
     .client(() => {
-      specs('Suggested Items Screen', () => {
-        should('display all suggested items with names and reasons');
-        should('show quantity selectors for each item');
-        should('have an "Add to Cart" button for selected items');
-        should('allow removing items from the suggestions');
+      describe('Suggested Items Screen', () => {
+        it('display all suggested items with names and reasons');
+        it('show quantity selectors for each item');
+        it('have an "Add to Cart" button for selected items');
+        it('allow removing items from the suggestions');
       });
     })
     .request(
@@ -320,10 +321,10 @@ narrative('Seasonal Assistant', () => {
     });
   command('accepts items and adds to their cart')
     .client(() => {
-      specs('Suggested Items Screen', () => {
-        should('allow selecting specific items to add');
-        should('update quantities before adding to cart');
-        should('provide feedback when items are added');
+      describe('Suggested Items Screen', () => {
+        it('allow selecting specific items to add');
+        it('update quantities before adding to cart');
+        it('provide feedback when items are added');
       });
     })
     .server(() => {
@@ -368,10 +369,10 @@ narrative('Seasonal Assistant', () => {
                             id: 'EXP-001',
                             type: 'experience',
                             client: {
-                                specs: {
-                                    name: '',
-                                    rules: ['show a hero section with a welcome message', 'allow user to start the questionnaire'],
-                                },
+                                specs: [
+                                    { type: 'it', title: 'show a hero section with a welcome message' },
+                                    { type: 'it', title: 'allow user to start the questionnaire' },
+                                ],
                             },
                         },
                     ],
@@ -381,13 +382,11 @@ narrative('Seasonal Assistant', () => {
             integrations: [],
         };
         const code = await modelToNarrative(experienceModel);
-        expect(code).toEqual(`import { experience, narrative, should, specs } from '@auto-engineer/narrative';
+        expect(code).toEqual(`import { experience, it, narrative } from '@auto-engineer/narrative';
 narrative('Test Experience Flow', 'TEST-001', () => {
   experience('Homepage', 'EXP-001').client(() => {
-    specs(() => {
-      should('show a hero section with a welcome message');
-      should('allow user to start the questionnaire');
-    });
+    it('show a hero section with a welcome message');
+    it('allow user to start the questionnaire');
   });
 });
 `);
@@ -405,10 +404,16 @@ narrative('Test Experience Flow', 'TEST-001', () => {
                             // id: undefined - no ID
                             type: 'experience',
                             client: {
-                                specs: {
-                                    name: 'Homepage specs',
-                                    rules: ['show welcome message', 'display navigation'],
-                                },
+                                specs: [
+                                    {
+                                        type: 'describe',
+                                        title: 'Homepage specs',
+                                        children: [
+                                            { type: 'it', title: 'show welcome message' },
+                                            { type: 'it', title: 'display navigation' },
+                                        ],
+                                    },
+                                ],
                             },
                         },
                     ],
@@ -418,12 +423,12 @@ narrative('Test Experience Flow', 'TEST-001', () => {
             integrations: [],
         };
         const code = await modelToNarrative(modelWithoutIds);
-        expect(code).toEqual(`import { experience, narrative, should, specs } from '@auto-engineer/narrative';
+        expect(code).toEqual(`import { describe, experience, it, narrative } from '@auto-engineer/narrative';
 narrative('Test Flow without IDs', () => {
   experience('Homepage').client(() => {
-    specs('Homepage specs', () => {
-      should('show welcome message');
-      should('display navigation');
+    describe('Homepage specs', () => {
+      it('show welcome message');
+      it('display navigation');
     });
   });
 });
@@ -442,10 +447,16 @@ narrative('Test Flow without IDs', () => {
                             id: 'SLICE-ABC',
                             type: 'experience',
                             client: {
-                                specs: {
-                                    name: 'Homepage specs',
-                                    rules: ['show welcome message', 'display navigation'],
-                                },
+                                specs: [
+                                    {
+                                        type: 'describe',
+                                        title: 'Homepage specs',
+                                        children: [
+                                            { type: 'it', title: 'show welcome message' },
+                                            { type: 'it', title: 'display navigation' },
+                                        ],
+                                    },
+                                ],
                             },
                         },
                         {
@@ -453,11 +464,16 @@ narrative('Test Flow without IDs', () => {
                             id: 'SLICE-XYZ',
                             type: 'query',
                             client: {
-                                description: 'Product query client',
-                                specs: {
-                                    name: 'Product list specs',
-                                    rules: ['display all products', 'allow filtering'],
-                                },
+                                specs: [
+                                    {
+                                        type: 'describe',
+                                        title: 'Product list specs',
+                                        children: [
+                                            { type: 'it', title: 'display all products' },
+                                            { type: 'it', title: 'allow filtering' },
+                                        ],
+                                    },
+                                ],
                             },
                             server: {
                                 description: 'Product query server',
@@ -474,19 +490,19 @@ narrative('Test Flow without IDs', () => {
             integrations: [],
         };
         const code = await modelToNarrative(modelWithIds);
-        expect(code).toEqual(`import { experience, narrative, query, should, specs } from '@auto-engineer/narrative';
+        expect(code).toEqual(`import { describe, experience, it, narrative, query, specs } from '@auto-engineer/narrative';
 narrative('Test Flow with IDs', 'FLOW-123', () => {
   experience('Homepage', 'SLICE-ABC').client(() => {
-    specs('Homepage specs', () => {
-      should('show welcome message');
-      should('display navigation');
+    describe('Homepage specs', () => {
+      it('show welcome message');
+      it('display navigation');
     });
   });
   query('view products', 'SLICE-XYZ')
     .client(() => {
-      specs('Product list specs', () => {
-        should('display all products');
-        should('allow filtering');
+      describe('Product list specs', () => {
+        it('display all products');
+        it('allow filtering');
       });
     })
     .server(() => {
@@ -508,7 +524,7 @@ narrative('Test Flow with IDs', 'FLOW-123', () => {
                             id: 'SLICE-789',
                             type: 'command',
                             client: {
-                                description: 'Command processing client',
+                                specs: [],
                             },
                             server: {
                                 description: 'Command processing server',
@@ -664,34 +680,36 @@ narrative('Questionnaire Flow', 'QUEST-001', () => {});
             narratives: [
                 {
                     name: 'Questionnaires',
-                    id: 'AUTO-Q9m2Kp4Lx',
+                    id: 'Q9m2Kp4Lx',
                     slices: [
                         {
                             name: 'Homepage',
-                            id: 'AUTO-H1a4Bn6Cy',
+                            id: 'H1a4Bn6Cy',
                             type: 'experience',
                             client: {
-                                specs: {
-                                    name: '',
-                                    rules: ['show a hero section with a welcome message', 'allow user to start the questionnaire'],
-                                },
+                                specs: [
+                                    { type: 'it', title: 'show a hero section with a welcome message' },
+                                    { type: 'it', title: 'allow user to start the questionnaire' },
+                                ],
                             },
                         },
                         {
                             name: 'views the questionnaire',
-                            id: 'AUTO-V7n8Rq5M',
+                            id: 'V7n8Rq5M',
                             type: 'query',
                             client: {
-                                description: '',
-                                specs: {
-                                    name: 'Questionnaire Progress',
-                                    rules: [
-                                        'focus on the current question based on the progress state',
-                                        'display the list of answered questions',
-                                        'display the list of remaining questions',
-                                        'show a progress indicator that is always visible as the user scrolls',
-                                    ],
-                                },
+                                specs: [
+                                    {
+                                        type: 'describe',
+                                        title: 'Questionnaire Progress',
+                                        children: [
+                                            { type: 'it', title: 'focus on the current question based on the progress state' },
+                                            { type: 'it', title: 'display the list of answered questions' },
+                                            { type: 'it', title: 'display the list of remaining questions' },
+                                            { type: 'it', title: 'show a progress indicator that is always visible as the user scrolls' },
+                                        ],
+                                    },
+                                ],
                             },
                             request: 'query QuestionnaireProgress($participantId: ID!) {\n  questionnaireProgress(participantId: $participantId) {\n    questionnaireId\n    participantId\n    currentQuestionId\n    remainingQuestions\n    status\n    answers {\n      questionId\n      value\n    }\n  }\n}',
                             server: {
@@ -713,7 +731,7 @@ narrative('Questionnaire Flow', 'QUEST-001', () => {});
                                     name: '',
                                     rules: [
                                         {
-                                            id: 'AUTO-r1A3Bp9W',
+                                            id: 'r1A3Bp9W',
                                             description: 'questionnaires show current progress',
                                             examples: [
                                                 {
@@ -878,13 +896,14 @@ narrative('Questionnaire Flow', 'QUEST-001', () => {});
         const code = await modelToNarrative(questionnairesModel);
         expect(code).toEqual(`import {
   data,
+  describe,
   example,
   experience,
   gql,
+  it,
   narrative,
   query,
   rule,
-  should,
   source,
   specs,
 } from '@auto-engineer/narrative';
@@ -922,20 +941,18 @@ type QuestionnaireProgress = State<
     }[];
   }
 >;
-narrative('Questionnaires', 'AUTO-Q9m2Kp4Lx', () => {
-  experience('Homepage', 'AUTO-H1a4Bn6Cy').client(() => {
-    specs(() => {
-      should('show a hero section with a welcome message');
-      should('allow user to start the questionnaire');
-    });
+narrative('Questionnaires', 'Q9m2Kp4Lx', () => {
+  experience('Homepage', 'H1a4Bn6Cy').client(() => {
+    it('show a hero section with a welcome message');
+    it('allow user to start the questionnaire');
   });
-  query('views the questionnaire', 'AUTO-V7n8Rq5M')
+  query('views the questionnaire', 'V7n8Rq5M')
     .client(() => {
-      specs('Questionnaire Progress', () => {
-        should('focus on the current question based on the progress state');
-        should('display the list of answered questions');
-        should('display the list of remaining questions');
-        should('show a progress indicator that is always visible as the user scrolls');
+      describe('Questionnaire Progress', () => {
+        it('focus on the current question based on the progress state');
+        it('display the list of answered questions');
+        it('display the list of remaining questions');
+        it('show a progress indicator that is always visible as the user scrolls');
       });
     })
     .request(
@@ -956,7 +973,7 @@ narrative('Questionnaires', 'AUTO-Q9m2Kp4Lx', () => {
     .server(() => {
       data([source().state('QuestionnaireProgress').fromProjection('Questionnaires', 'questionnaire-participantId')]);
       specs(() => {
-        rule('questionnaires show current progress', 'AUTO-r1A3Bp9W', () => {
+        rule('questionnaires show current progress', 'r1A3Bp9W', () => {
           example('a question has already been answered')
             .given<QuestionnaireLinkSent>({
               questionnaireId: 'q-001',
@@ -998,7 +1015,7 @@ narrative('Questionnaires', 'AUTO-Q9m2Kp4Lx', () => {
                             id: 'TEST-SLICE',
                             type: 'query',
                             client: {
-                                description: 'Test client for duplicate rules',
+                                specs: [],
                             },
                             server: {
                                 description: 'Test server for duplicate rules',
@@ -1006,7 +1023,7 @@ narrative('Questionnaires', 'AUTO-Q9m2Kp4Lx', () => {
                                     name: 'Test Rules',
                                     rules: [
                                         {
-                                            id: 'AUTO-r1A3Bp9W',
+                                            id: 'r1A3Bp9W',
                                             description: 'questionnaires show current progress',
                                             examples: [
                                                 {
@@ -1134,7 +1151,7 @@ type QuestionnaireProgress = State<
 narrative('Test Flow', 'TEST-FLOW', () => {
   query('test slice', 'TEST-SLICE').server(() => {
     specs('Test Rules', () => {
-      rule('questionnaires show current progress', 'AUTO-r1A3Bp9W', () => {
+      rule('questionnaires show current progress', 'r1A3Bp9W', () => {
         example('a question has already been answered')
           .given<QuestionnaireLinkSent>({ questionnaireId: 'q-001', participantId: 'participant-abc' })
           .when<QuestionAnswered>({ questionnaireId: 'q-001', questionId: 'q1', answer: 'Yes' })
@@ -1162,7 +1179,7 @@ narrative('Test Flow', 'TEST-FLOW', () => {
                             id: 'MULTI-SLICE',
                             type: 'query',
                             client: {
-                                description: 'Multi given client',
+                                specs: [],
                             },
                             server: {
                                 description: 'Multi given server rules',
@@ -1170,7 +1187,7 @@ narrative('Test Flow', 'TEST-FLOW', () => {
                                     name: 'Multi Given Rules',
                                     rules: [
                                         {
-                                            id: 'AUTO-MultiGiven',
+                                            id: 'MultiGiven',
                                             description: 'all questions have been answered',
                                             examples: [
                                                 {
@@ -1346,7 +1363,7 @@ type QuestionnaireProgress = State<
 narrative('Multi Given Flow', 'MULTI-GIVEN', () => {
   query('multi given slice', 'MULTI-SLICE').server(() => {
     specs('Multi Given Rules', () => {
-      rule('all questions have been answered', 'AUTO-MultiGiven', () => {
+      rule('all questions have been answered', 'MultiGiven', () => {
         example('questionnaire with multiple events')
           .given<QuestionnaireConfig>({ questionnaireId: 'q-001', numberOfQuestions: 3 })
           .and<QuestionnaireLinkSent>({
@@ -1406,7 +1423,7 @@ narrative('Multi Given Flow', 'MULTI-GIVEN', () => {
                             id: 'REF-SLICE',
                             type: 'query',
                             client: {
-                                description: 'Client for referenced states',
+                                specs: [],
                             },
                             server: {
                                 description: 'Server for referenced states',
@@ -1438,7 +1455,7 @@ narrative('Multi Given Flow', 'MULTI-GIVEN', () => {
                                     name: 'Database State Rules',
                                     rules: [
                                         {
-                                            id: 'AUTO-RefState',
+                                            id: 'RefState',
                                             description: 'questionnaire config is available when referenced',
                                             examples: [
                                                 {
@@ -1531,7 +1548,7 @@ narrative('Referenced States Flow', 'REF-STATES', () => {
       source().state('QuestionnaireConfig').fromDatabase('ConfigStore', { questionnaireId: '$questionnaireId' }),
     ]);
     specs('Database State Rules', () => {
-      rule('questionnaire config is available when referenced', 'AUTO-RefState', () => {
+      rule('questionnaire config is available when referenced', 'RefState', () => {
         example('config from database is accessible')
           .given<QuestionnaireConfig>({
             questionnaireId: 'q-001',
@@ -1564,7 +1581,7 @@ narrative('Referenced States Flow', 'REF-STATES', () => {
                             id: 'DATE-SLICE',
                             type: 'query',
                             client: {
-                                description: 'Date client',
+                                specs: [],
                             },
                             server: {
                                 description: 'Date server with Date fields',
@@ -1572,7 +1589,7 @@ narrative('Referenced States Flow', 'REF-STATES', () => {
                                     name: 'Date Field Rules',
                                     rules: [
                                         {
-                                            id: 'AUTO-DateRule',
+                                            id: 'DateRule',
                                             description: 'handles Date fields correctly',
                                             examples: [
                                                 {
@@ -1679,7 +1696,7 @@ type ProcessState = State<
 narrative('Date Handling Flow', 'DATE-FLOW', () => {
   query('date handling slice', 'DATE-SLICE').server(() => {
     specs('Date Field Rules', () => {
-      rule('handles Date fields correctly', 'AUTO-DateRule', () => {
+      rule('handles Date fields correctly', 'DateRule', () => {
         example('event with Date fields')
           .given<TimestampedEvent>({
             id: 'event-123',
@@ -1710,13 +1727,10 @@ narrative('Date Handling Flow', 'DATE-FLOW', () => {
                     slices: [
                         {
                             name: 'Active Surveys Summary',
-                            id: 'AUTO-aifPcU3hw',
+                            id: 'aifPcU3hw',
                             type: 'experience',
                             client: {
-                                specs: {
-                                    name: '',
-                                    rules: ['show active surveys summary'],
-                                },
+                                specs: [{ type: 'it', title: 'show active surveys summary' }],
                             },
                         },
                     ],
@@ -1727,13 +1741,10 @@ narrative('Date Handling Flow', 'DATE-FLOW', () => {
                     slices: [
                         {
                             name: 'Create Survey Form',
-                            id: 'AUTO-MPviTMrQC',
+                            id: 'MPviTMrQC',
                             type: 'experience',
                             client: {
-                                specs: {
-                                    name: '',
-                                    rules: ['allow entering survey title'],
-                                },
+                                specs: [{ type: 'it', title: 'allow entering survey title' }],
                             },
                         },
                     ],
@@ -1744,13 +1755,10 @@ narrative('Date Handling Flow', 'DATE-FLOW', () => {
                     slices: [
                         {
                             name: 'Response Rate Charts',
-                            id: 'AUTO-eME978Euk',
+                            id: 'eME978Euk',
                             type: 'experience',
                             client: {
-                                specs: {
-                                    name: '',
-                                    rules: ['show daily response rate charts'],
-                                },
+                                specs: [{ type: 'it', title: 'show daily response rate charts' }],
                             },
                         },
                     ],
@@ -1760,26 +1768,20 @@ narrative('Date Handling Flow', 'DATE-FLOW', () => {
             integrations: [],
         };
         const code = await modelToNarrative(modelWithMultipleFlowsSameSource);
-        expect(code).toEqual(`import { experience, narrative, should, specs } from '@auto-engineer/narrative';
+        expect(code).toEqual(`import { experience, it, narrative } from '@auto-engineer/narrative';
 narrative('Home Screen', () => {
-  experience('Active Surveys Summary', 'AUTO-aifPcU3hw').client(() => {
-    specs(() => {
-      should('show active surveys summary');
-    });
+  experience('Active Surveys Summary', 'aifPcU3hw').client(() => {
+    it('show active surveys summary');
   });
 });
 narrative('Create Survey', () => {
-  experience('Create Survey Form', 'AUTO-MPviTMrQC').client(() => {
-    specs(() => {
-      should('allow entering survey title');
-    });
+  experience('Create Survey Form', 'MPviTMrQC').client(() => {
+    it('allow entering survey title');
   });
 });
 narrative('Response Analytics', () => {
-  experience('Response Rate Charts', 'AUTO-eME978Euk').client(() => {
-    specs(() => {
-      should('show daily response rate charts');
-    });
+  experience('Response Rate Charts', 'eME978Euk').client(() => {
+    it('show daily response rate charts');
   });
 });
 `);
@@ -1797,7 +1799,7 @@ narrative('Response Analytics', () => {
                             id: 'SUMMARY-001',
                             type: 'query',
                             client: {
-                                description: 'Summary view client',
+                                specs: [],
                             },
                             server: {
                                 description: 'Summary calculation server',
@@ -2006,7 +2008,7 @@ narrative('Todo List Summary', 'TODO-001', () => {
                                 id: 'SUMMARY-SLICE',
                                 type: 'query',
                                 client: {
-                                    description: 'Summary client',
+                                    specs: [],
                                 },
                                 server: {
                                     description: 'Summary server',
@@ -2076,7 +2078,7 @@ narrative('Todo Summary Flow', 'TODO-SUMMARY', () => {
                                 id: 'TODO-SLICE',
                                 type: 'query',
                                 client: {
-                                    description: 'Todo client',
+                                    specs: [],
                                 },
                                 server: {
                                     description: 'Todo server',
@@ -2146,7 +2148,7 @@ narrative('Todo Flow', 'TODO-FLOW', () => {
                                 id: 'USER-PROJECT-SLICE',
                                 type: 'query',
                                 client: {
-                                    description: 'User project client',
+                                    specs: [],
                                 },
                                 server: {
                                     description: 'User project server',
@@ -2218,7 +2220,7 @@ narrative('User Project Flow', 'USER-PROJECT-FLOW', () => {
                                 id: 'SUMMARY-SLICE',
                                 type: 'query',
                                 client: {
-                                    description: 'Summary client',
+                                    specs: [],
                                 },
                                 server: {
                                     description: 'Summary server',
@@ -2246,7 +2248,7 @@ narrative('User Project Flow', 'USER-PROJECT-FLOW', () => {
                                 id: 'TODO-SLICE',
                                 type: 'query',
                                 client: {
-                                    description: 'Todo client',
+                                    specs: [],
                                 },
                                 server: {
                                     description: 'Todo server',
@@ -2274,7 +2276,7 @@ narrative('User Project Flow', 'USER-PROJECT-FLOW', () => {
                                 id: 'USER-PROJECT-SLICE',
                                 type: 'query',
                                 client: {
-                                    description: 'User project client',
+                                    specs: [],
                                 },
                                 server: {
                                     description: 'User project server',