apexrest 0.4.0-beta.1

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/customer-crm/apex-overlay/pages/p00010-customers.apx

@@ -0,0 +1,164 @@
+page 10 (
+    name: Customers
+    alias: CUSTOMERS
+    title: Customers
+    appearance {
+        pageTemplate: @/standard
+        templateOptions: #DEFAULT#
+    }
+    security {
+        pageAccessProtection: argumentsMustHaveChecksum
+    }
+    region application-marker (
+        name: Customer workspace
+        type: staticContent
+        source {
+            htmlCode: <div data-testid="apexrest-crm">Customer workspace</div>
+        }
+        layout {
+            sequence: 5
+            slot: BODY
+        }
+        appearance {
+            template: @/blank-with-attributes
+            templateOptions: #DEFAULT#
+        }
+    )
+    region customers (
+        name: Customers
+        type: interactiveReport
+        source {
+            location: localDatabase
+            type: sqlQuery
+            sqlQuery:
+                ```sql
+                select id, name, email, status from apexrest_customers
+                ```
+        }
+        layout {
+            sequence: 10
+            slot: BODY
+        }
+        appearance {
+            template: @/interactive-report
+            templateOptions: #DEFAULT#
+        }
+        advanced {
+            htmlDomId: customers_report
+        }
+        link {
+            linkColumn: customTarget
+            target: {
+                page: 80
+                items: {
+                    P80_ID: #ID#
+                }
+                clearCache: 80
+            }
+            linkIcon: <span role="img" aria-label="Edit customer" class="fa fa-edit" title="Edit customer"></span>
+        }
+        column ID (
+            type: hidden
+            heading {
+                heading: ID
+            }
+            layout {
+                sequence: 10
+            }
+            source {
+                dataType: NUMBER
+            }
+        )
+        column NAME (
+            type: plainText
+            heading {
+                heading: Name
+            }
+            layout {
+                sequence: 20
+            }
+            source {
+                dataType: STRING
+            }
+        )
+        column EMAIL (
+            type: plainText
+            heading {
+                heading: Email
+            }
+            layout {
+                sequence: 30
+            }
+            source {
+                dataType: STRING
+            }
+        )
+        column STATUS (
+            type: plainText
+            heading {
+                heading: Status
+            }
+            layout {
+                sequence: 40
+            }
+            source {
+                dataType: STRING
+            }
+        )
+        savedReport 100010 (
+            visibility: primaryDefault
+            displayColumn NAME (
+                sequence: 1
+            )
+            displayColumn EMAIL (
+                sequence: 2
+            )
+            displayColumn STATUS (
+                sequence: 3
+            )
+        )
+    )
+    button create-customer (
+        buttonName: CREATE_CUSTOMER
+        label: Create Customer
+        layout {
+            sequence: 10
+            region: @customers
+            slot: RIGHT_OF_IR_SEARCH_BAR
+        }
+        appearance {
+            buttonTemplate: @/text
+            templateOptions: #DEFAULT#
+            hot: true
+        }
+        behavior {
+            action: redirectThisApp
+            target: {
+                page: 80
+                clearCache: 80
+            }
+        }
+    )
+    dynamicAction refresh-customers (
+        name: Refresh Customers
+        execution {
+            sequence: 10
+        }
+        when {
+            event: apexafterclosedialog
+            selectionType: region
+            region: @customers
+        }
+        action refresh-customers-report (
+            action: refresh
+            affectedElements {
+                selectionType: region
+                region: @customers
+            }
+            execution {
+                sequence: 10
+                fireOnInit: false
+            }
+        )
+    )
+)

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/customer-crm/apex-overlay/pages/p00020-dashboard.apx

@@ -0,0 +1,54 @@
+page 20 (
+    name: Dashboard
+    alias: DASHBOARD
+    title: Customer Dashboard
+    appearance {
+        pageTemplate: @/standard
+        templateOptions: #DEFAULT#
+    }
+    security {
+        pageAccessProtection: argumentsMustHaveChecksum
+    }
+    region customers-by-status (
+        name: Customers by Status
+        type: chart
+        layout {
+            sequence: 10
+            slot: BODY
+        }
+        appearance {
+            template: @/standard
+            templateOptions: #DEFAULT#
+        }
+        chart {
+            type: pie
+        }
+        title {
+            title: Customers by Status
+        }
+        legend {
+            show: true
+        }
+        series customer-count (
+            name: Customers
+            execution {
+                sequence: 10
+            }
+            source {
+                type: sqlQuery
+                sqlQuery:
+                    ```sql
+                    select status as label, count(*) as value
+                    from apexrest_customers group by status
+                    ```
+            }
+            columnMapping {
+                label: LABEL
+                value: VALUE
+            }
+            label {
+                show: true
+            }
+        )
+    )
+)

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/customer-crm/apex-overlay/pages/p00080-customer.apx

@@ -0,0 +1,332 @@
+page 80 (
+    name: Customer
+    alias: CUSTOMER
+    title: Customer
+    appearance {
+        pageMode: modalDialog
+        dialogTemplate: @/drawer
+        templateOptions: #DEFAULT#
+    }
+    dialog {
+        chained: false
+    }
+    security {
+        pageAccessProtection: argumentsMustHaveChecksum
+        formAutoComplete: false
+    }
+
+    region buttons (
+        name: Buttons
+        type: staticContent
+        layout {
+            sequence: 20
+            slot: REGION_POSITION_03
+        }
+        appearance {
+            template: @/buttons-container
+            templateOptions: #DEFAULT#
+        }
+    )
+
+    region form (
+        name: Form
+        type: form
+        source {
+            location: localDatabase
+            tableName: APEXREST_CUSTOMERS
+        }
+        layout {
+            sequence: 10
+            slot: contentBody
+        }
+        appearance {
+            template: @/blank-with-attributes
+            templateOptions: #DEFAULT#
+        }
+        edit {
+            enabled: true
+        }
+    )
+
+    pageItem P80_ID (
+        type: hidden
+        layout {
+            sequence: 10
+            region: @form
+            slot: regionBody
+        }
+        source {
+            formRegion: @form
+            column: ID
+            dataType: number
+            queryOnly: true
+            primaryKey: true
+        }
+        security {
+            sessionStateProtection: checksumRequiredSessionLevel
+        }
+    )
+
+    pageItem P80_SUCCESS_MESSAGE (
+        type: hidden
+        layout {
+            sequence: 11
+            region: @form
+            slot: regionBody
+        }
+    )
+
+    button cancel (
+        buttonName: CANCEL
+        label: Cancel
+        layout {
+            sequence: 10
+            region: @buttons
+            slot: CLOSE
+        }
+        appearance {
+            buttonTemplate: @/text
+            templateOptions: #DEFAULT#
+        }
+        behavior {
+            action: definedByDynamicAction
+        }
+    )
+
+    button create (
+        buttonName: CREATE
+        label: Create
+        layout {
+            sequence: 40
+            region: @buttons
+            slot: NEXT
+        }
+        appearance {
+            buttonTemplate: @/text
+            hot: true
+            templateOptions: #DEFAULT#
+        }
+        behavior {
+            warnOnUnsavedChanges: doNotCheck
+            databaseAction: insert
+        }
+        serverSideCondition {
+            type: itemIsNull
+            item: P80_ID
+        }
+    )
+
+    button delete (
+        buttonName: DELETE
+        label: Delete
+        layout {
+            sequence: 20
+            region: @buttons
+            slot: DELETE
+        }
+        appearance {
+            buttonTemplate: @/text
+            templateOptions: #DEFAULT#
+        }
+        behavior {
+            executeValidations: false
+            warnOnUnsavedChanges: doNotCheck
+            databaseAction: delete
+            requiresConfirmation: true
+        }
+        confirmation {
+            message: Delete this customer?
+            style: danger
+        }
+        serverSideCondition {
+            type: itemIsNotNull
+            item: P80_ID
+        }
+    )
+
+    button apply-changes (
+        buttonName: APPLY-CHANGES
+        label: Apply Changes
+        layout {
+            sequence: 30
+            region: @buttons
+            slot: NEXT
+        }
+        appearance {
+            buttonTemplate: @/text
+            hot: true
+            templateOptions: #DEFAULT#
+        }
+        behavior {
+            warnOnUnsavedChanges: doNotCheck
+            databaseAction: update
+        }
+        serverSideCondition {
+            type: itemIsNotNull
+            item: P80_ID
+        }
+    )
+
+    dynamicAction cancel-dialog (
+        name: Cancel Dialog
+        execution {
+            sequence: 10
+        }
+        when {
+            event: click
+            selectionType: button
+            button: @cancel
+        }
+
+        action native-dialog-cancel (
+            action: cancelDialog
+            execution {
+                sequence: 10
+                fireOnInit: false
+            }
+        )
+
+    )
+
+    process close-dialog (
+        name: Close Dialog
+        type: closeDialog
+        execution {
+            sequence: 50
+        }
+        serverSideCondition {
+            type: requestIsContainedInValue
+            value: CREATE,APPLY-CHANGES,DELETE
+        }
+    )
+
+    process initialize-form-form (
+        name: Initialize form Form
+        type: formInitialization
+        formRegion: @form
+        execution {
+            sequence: 10
+            point: beforeHeader
+        }
+    )
+
+    process set-success-message-form (
+        name: Set Success Message
+        type: executeCode
+        source {
+            plsqlCode: 
+                ```plsql
+                :P80_SUCCESS_MESSAGE :=
+                    case :REQUEST
+                        when 'CREATE' then 'Customer created.'
+                        when 'APPLY-CHANGES' then 'Customer updated.'
+                        when 'DELETE' then 'Customer deleted.'
+                        else null
+                    end;
+                ```
+        }
+        execution {
+            sequence: 5
+        }
+        serverSideCondition {
+            type: requestIsContainedInValue
+            value: CREATE,APPLY-CHANGES,DELETE
+        }
+    )
+
+    process process-form-form (
+        name: Process form Form
+        type: formAutoRowProcessing
+        formRegion: @form
+        execution {
+            sequence: 10
+        }
+        successMessage {
+            successMessage: &P80_SUCCESS_MESSAGE.
+        }
+    )
+
+    pageItem P80_NAME (
+        type: textField
+        label {
+            label: Name
+            alignment: left
+        }
+        layout {
+            sequence: 20
+            region: @form
+            slot: regionBody
+            alignment: left
+        }
+        appearance {
+            template: @/required-floating
+            templateOptions: #DEFAULT#
+            width: 32
+        }
+        validation {
+            maxLength: 200
+            valueRequired: true
+        }
+        source {
+            formRegion: @form
+            column: NAME
+            dataType: varchar2
+        }
+    )
+
+    pageItem P80_EMAIL (
+        type: textField
+        label {
+            label: Email
+            alignment: left
+        }
+        layout {
+            sequence: 30
+            region: @form
+            slot: regionBody
+            alignment: left
+        }
+        appearance {
+            template: @/required-floating
+            templateOptions: #DEFAULT#
+            width: 32
+        }
+        validation {
+            maxLength: 320
+            valueRequired: true
+        }
+        source {
+            formRegion: @form
+            column: EMAIL
+            dataType: varchar2
+        }
+    )
+
+    pageItem P80_STATUS (
+        type: selectList
+        label {
+            label: Status
+            alignment: left
+        }
+        lov {
+            type: staticValues
+            staticValues: STATIC:Active;ACTIVE,Inactive;INACTIVE
+        }
+        layout {
+            sequence: 70
+            region: @form
+            slot: regionBody
+            alignment: left
+        }
+        appearance {
+            template: @/optional-floating
+            templateOptions: #DEFAULT#
+            height: 1
+        }
+        source {
+            formRegion: @form
+            column: STATUS
+            dataType: varchar2
+        }
+    )
+)

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/customer-crm/project/src/database/migrations/0001__customers.sql

@@ -0,0 +1,10 @@
+create table apexrest_customers (
+    id number generated by default on null as identity primary key,
+    name varchar2(200) not null,
+    email varchar2(320) not null,
+    status varchar2(20) default 'ACTIVE' not null,
+    created_at timestamp default systimestamp not null,
+    updated_at timestamp default systimestamp not null,
+    constraint apexrest_customers_status_ck check (status in ('ACTIVE', 'INACTIVE')),
+    constraint apexrest_customers_email_uq unique (email)
+);

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/customer-crm/project/src/database/packages/0010__customer_api.sql

@@ -0,0 +1,28 @@
+create or replace package apexrest_customer_api authid definer as
+    procedure validate_customer(p_name varchar2, p_email varchar2, p_status varchar2);
+    function add_customer(p_name varchar2, p_email varchar2, p_status varchar2 default 'ACTIVE') return number;
+end apexrest_customer_api;
+/
+create or replace package body apexrest_customer_api as
+    procedure validate_customer(p_name varchar2, p_email varchar2, p_status varchar2) is
+    begin
+        if trim(p_name) is null then
+            raise_application_error(-20010, 'Customer name is required.');
+        end if;
+        if p_email is null or not regexp_like(p_email, '^[^@[:space:]]+@[^@[:space:]]+[.][^@[:space:]]+$') then
+            raise_application_error(-20011, 'Enter a valid email address.');
+        end if;
+        if p_status is null or p_status not in ('ACTIVE', 'INACTIVE') then
+            raise_application_error(-20012, 'Choose a valid customer status.');
+        end if;
+    end;
+    function add_customer(p_name varchar2, p_email varchar2, p_status varchar2 default 'ACTIVE') return number is
+        l_id number;
+    begin
+        validate_customer(p_name, p_email, p_status);
+        insert into apexrest_customers(name,email,status)
+        values(trim(p_name),lower(trim(p_email)),p_status) returning id into l_id;
+        return l_id;
+    end;
+end apexrest_customer_api;
+/

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/customer-crm/project/src/database/packages/0020__customer_validation_trigger.sql

@@ -0,0 +1,10 @@
+create or replace trigger apexrest_customers_biu
+before insert or update on apexrest_customers
+for each row
+begin
+    apexrest_customer_api.validate_customer(:new.name, :new.email, :new.status);
+    :new.email := lower(trim(:new.email));
+    :new.name := trim(:new.name);
+    :new.updated_at := systimestamp;
+end;
+/

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/customer-crm/project/tests/e2e/customer-crud.spec.mjs

@@ -0,0 +1,25 @@
+import {test,expect} from '../testkit/apex.mjs';
+// The runner supplies this fixture in its isolated run directory.
+// Runtime evidence is required before this fixture can be called verified.
+test('authenticated customer CRUD and invalid email',async({page})=>{
+ const suffix=crypto.randomUUID().replaceAll('-','');const name=`APEXREST ${suffix}`,updated=`Updated ${suffix}`,email=`${suffix}@example.test`;
+ await page.goto('./customers');await expect(page.getByTestId('apexrest-crm')).toBeVisible();
+ await page.getByRole('button',{name:'Create Customer',exact:true}).click();
+ let form=page.frameLocator('iframe[title="Customer"]');
+ await form.getByLabel('Name',{exact:true}).fill(name);await form.getByLabel('Email',{exact:true}).fill('invalid');await form.getByLabel('Status',{exact:true}).selectOption('ACTIVE');
+ await form.getByRole('button',{name:'Create',exact:true}).click();await expect(form.getByText('Enter a valid email address.',{exact:false})).toBeVisible();
+ await form.getByLabel('Email',{exact:true}).fill(email);await form.getByRole('button',{name:'Create',exact:true}).click();await expect(page.locator('iframe[title="Customer"]')).toHaveCount(0);
+ try {
+  await page.locator('#customers_report_search_field').fill(name);await page.locator('#customers_report_search_field').press('Enter');await expect(page.getByRole('cell',{name,exact:true})).toBeVisible();
+  await page.getByRole('row').filter({has:page.getByRole('cell',{name,exact:true})}).getByRole('link',{name:'Edit customer'}).click();
+  form=page.frameLocator('iframe[title="Customer"]');await expect(form.getByLabel('Email',{exact:true})).toHaveValue(email);await form.getByLabel('Name',{exact:true}).fill(updated);await form.getByRole('button',{name:'Apply Changes',exact:true}).click();await expect(page.locator('iframe[title="Customer"]')).toHaveCount(0);
+  await page.locator('#customers_report_search_field').fill(updated);await page.locator('#customers_report_search_field').press('Enter');await expect(page.getByRole('cell',{name:updated,exact:true})).toBeVisible();
+ } finally {
+  await page.locator('#customers_report_search_field').fill(suffix);await page.locator('#customers_report_search_field').press('Enter');
+  const row=page.getByRole('row').filter({has:page.getByRole('cell',{name:email,exact:true})});
+  if(await row.count()){
+   await row.getByRole('link',{name:'Edit customer'}).click();form=page.frameLocator('iframe[title="Customer"]');await form.getByRole('button',{name:'Delete',exact:true}).click();
+   await form.getByRole('dialog').getByRole('button',{name:'Delete',exact:true}).click();await expect(page.locator('iframe[title="Customer"]')).toHaveCount(0);await expect(page.getByRole('cell',{name:email,exact:true})).toHaveCount(0);
+  }
+ }
+});

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/customer-crm/project/tests/sql/test_customers.sql

@@ -0,0 +1,49 @@
+create or replace package test_apexrest_customers as
+    --%suite(Customer business rules)
+    --%test(Creates a customer with a generated identifier)
+    procedure creates_customer;
+    --%test(Rejects missing customer names)
+    --%throws(-20010)
+    procedure rejects_empty_name;
+    --%test(Rejects malformed email addresses)
+    --%throws(-20011)
+    procedure rejects_invalid_email;
+    --%test(Rejects unknown status)
+    --%throws(-20012)
+    procedure rejects_invalid_status;
+    --%test(Prevents duplicate emails)
+    --%throws(-1)
+    procedure rejects_duplicate_email;
+end;
+/
+create or replace package body test_apexrest_customers as
+    procedure creates_customer is
+        l_id number;
+        l_name varchar2(200);
+    begin
+        l_id := apexrest_customer_api.add_customer('Synthetic customer', lower(rawtohex(sys_guid())) || '@example.test');
+        select name into l_name from apexrest_customers where id=l_id;
+        ut.expect(l_id).to_be_greater_than(0);
+        ut.expect(l_name).to_equal('Synthetic customer');
+    end;
+    procedure rejects_empty_name is
+    begin
+        apexrest_customer_api.validate_customer(null,'name@example.test','ACTIVE');
+    end;
+    procedure rejects_invalid_email is
+    begin
+        apexrest_customer_api.validate_customer('Synthetic','invalid','ACTIVE');
+    end;
+    procedure rejects_invalid_status is
+    begin
+        apexrest_customer_api.validate_customer('Synthetic','name@example.test','UNKNOWN');
+    end;
+    procedure rejects_duplicate_email is
+        l_id number;
+        l_email varchar2(320) := lower(rawtohex(sys_guid())) || '@example.test';
+    begin
+        l_id := apexrest_customer_api.add_customer('First synthetic',l_email);
+        l_id := apexrest_customer_api.add_customer('Second synthetic',l_email);
+    end;
+end;
+/

package/dist/codex-compat/plugins/apexrest-apex/resources/templates/database-control/install.sql

@@ -0,0 +1,17 @@
+-- Optional deploymentControl=database mode only. Default local mode needs no service tables.
+-- Review and run explicitly in the dedicated parsing/control schema.
+-- Never executed automatically by setup, plan, doctor or test.
+create table apexrest_deploy_locks (
+  target_key varchar2(64) primary key,
+  owner_id varchar2(36) not null,
+  lease_until timestamp with time zone not null,
+  phase varchar2(20) default 'preparing' not null check (phase in ('preparing','writing'))
+);
+create table apexrest_migrations (
+  version varchar2(255) primary key,
+  checksum varchar2(64) not null,
+  status varchar2(20) check (status in ('started','succeeded','failed','outcome_unknown')),
+  run_id varchar2(36) not null,
+  started_at timestamp with time zone default systimestamp not null,
+  finished_at timestamp with time zone
+);