pi-apexlang 0.1.0

package/skills/apexlang/templates/shared-components/rest-data-sources/example_rest_data_source.example.md

@@ -0,0 +1,386 @@
+---
+templateId: shared-components.rest-data-sources.example-rest-data-source.example
+componentType: markdown-apexlang-example
+version: 1.0
+migrationNote: preserved from previous standalone template example
+---
+
+# Example Rest Data Source Example
+
+## Purpose
+
+Snippet class: `metavariable_template`.
+
+Markdown-preserved APEXlang example. Use this file for syntax and structure only after loading the family `_index.md` and `_common.md` contract. Bind every `{{...}}` variable from discovered REST data-profile metadata, schema evidence, user input, or compiler-backed truth before emitting APEXlang.
+
+## Example
+
+```apexlang
+/*Acceptance and usage notes 
+    - the below mentioned dataprofile is only for reference and a REST Data source can have more columns in the data profile. Hence sure to discover the entire data profile with child level hierarchy by making a call to the REST API configured under rest-data-sources */
+/*Use the below for GET operation*/
+    restDataSource http_paginated_records_example (
+    name: Objects
+    source {
+        type: http
+        remoteServer: @sample-rest-api
+        urlPathPrefix: /data/Pagination
+    }
+    /*STRICTLY - Use this ONLY when asked to do Synchronization to local table with Synchronization type as 'append' */    
+    restSynchronization {
+        jobIsActive: true
+        localTableOwner: SAN
+        localTableName: {{source.table}}
+        schedule: FREQ=DAILY;INTERVAL=1;BYHOUR=1;BYMINUTE=5;BYSECOND=10
+        httpRequestLimit: 1000
+    }
+    /*STRICTLY - Use this ONLY when asked to do Synchronization to local table with Synchronization type as 'merge' */    
+      restSynchronization {
+        jobIsActive: true
+        localTableOwner: SAN
+        localTableName: {{source.table}}
+        type: merge
+        schedule: FREQ=HOURLY;INTERVAL=3;BYMINUTE=20;BYSECOND=10
+        httpRequestLimit: 1000
+    }
+     /*STRICTLY - Use this ONLY when asked to do Synchronization to local table with Synchronization type as 'replace' or 'fullRefreshDelete' */    
+     restSynchronization {
+        jobIsActive: true
+        localTableOwner: SAN
+        localTableName: {{source.table}}
+        type: fullRefreshDelete
+        schedule: FREQ=DAILY;INTERVAL=2;BYHOUR=10;BYMINUTE=05;BYSECOND=20
+        httpRequestLimit: 1000
+    }
+    /*STRICTLY - Use this ONLY when Synchronization RateLimit is required */    
+    synchronizationRateLimit {
+        timeframe: 50   
+        httpRequests: 100
+    }
+    authentication {
+        credentials: @moviedb_api_key
+    }
+    settings {
+        paginationType: pageSizeAndFetchOffset
+        pageSizeUrlParam: limit
+        rowOffsetUrlParam: offset
+        hasMoreRowsSelector: hasMore
+    }
+
+    parameter search_query (
+        name: query
+        parameter {
+            type: urlQueryString
+        }
+        advanced {
+            useForRowSearch: true
+        }
+    )
+
+    parameter name (
+        name: name
+    )
+    
+    dataProfile {
+        name: HTTP_PAGINATED_RECORDS_EXAMPLE
+        rowSelector: items
+    }
+
+    dataProfileCol data (
+        colName: DATA
+        source {
+            sequence: 1
+            dataType: varchar2
+        }
+        parsing {
+            pathExpression: data
+        }
+        advanced {
+            sourceDataType: null
+        }
+    )
+
+    dataProfileCol data-capacity (
+        colName: DATA_CAPACITY
+        source {
+            sequence: 2
+            dataType: varchar2
+        }
+        parsing {
+            pathExpression: data.Capacity
+        }
+        advanced {
+            sourceDataType: string
+        }
+    )
+
+    dataProfileCol data-hard-disk-size (
+        colName: DATA_HARD_DISK_SIZE
+        source {
+            sequence: 3
+            dataType: varchar2
+        }
+        parsing {
+            pathExpression: "data."Hard disk size""
+        }
+        advanced {
+            sourceDataType: string
+        }
+    )
+    
+    dataProfileCol data-capacity-gb (
+        colName: DATA_CAPACITY_GB
+        source {
+            sequence: 4
+            dataType: number
+        }
+        parsing {
+            pathExpression: "data."capacity GB""
+        }
+        advanced {
+            sourceDataType: number
+        }
+    )
+
+    dataProfileCol ID (
+        colName: ID
+        source {
+            sequence: 5
+            dataType: number
+            primaryKey: true
+        }
+        parsing {
+            pathExpression: id
+        }
+        
+        advanced {
+            sourceDataType: number
+        }
+    )
+
+    dataProfileCol NAME (
+        colName: NAME
+        source {
+            sequence: 6
+            dataType: varchar2
+        }
+        parsing {
+            pathExpression: name
+        }
+        
+        advanced {
+            sourceDataType: string
+        }
+    )
+
+    dataProfileCol {{source.dateColumn}} (
+        colName: {{source.dateColumn}}
+        source {
+            sequence: 7
+            dataType: timestampWithTimeZone
+        }
+        parsing {
+            pathExpression: {{source.dateJsonPath}}
+            formatMask: YYYY"-"MM"-"DD"T"HH24":"MI:SS.FF9TZR
+        }
+        
+        advanced {
+            sourceDataType: string
+        }
+    )
+
+    dataProfileCol {{source.amountColumn}} (
+        colName: {{source.amountColumn}}
+        source {
+            sequence: 8
+            dataType: number
+        }
+        parsing {
+            pathExpression: {{source.amountJsonPath}}
+        }
+       
+        advanced {
+            sourceDataType: number
+        }
+    )
+
+    operation get_rows (
+        label {
+            label: GET
+        }
+        operation {
+            urlPattern: .
+            httpMethod: get
+            databaseOperation: fetchRows
+        }
+        advanced {
+            fixedPageSize: 20
+        }
+    )
+
+)
+
+/*Use the below for POST operation*/
+
+restDataSource icm-claims-data (
+    name: ICM Claims Data
+    source {
+        type: ords
+        remoteServer: @ph-apex
+        urlPathPrefix: /icm_claims/
+    }
+
+    parameter claim-id (
+        name: CLAIM_ID
+        operation: @post
+        parameter {
+            type: requestOrResponseBody
+        }
+    )
+
+    parameter claim-number (
+        name: CLAIM_NUMBER
+        operation: @post
+        parameter {
+            type: requestOrResponseBody
+        }
+    )
+
+    parameter currency-code (
+        name: CURRENCY_CODE
+        operation: @post
+        parameter {
+            type: requestOrResponseBody
+        }
+    )
+
+    parameter policy-id (
+        name: POLICY_ID
+        operation: @post
+        parameter {
+            type: requestOrResponseBody
+        }
+    )
+
+    parameter reported-date (
+        name: REPORTED_DATE
+        operation: @post
+        parameter {
+            type: requestOrResponseBody
+        }
+    )
+
+    parameter total-claimed-amount (
+        name: TOTAL_CLAIMED_AMOUNT
+        operation: @post
+        parameter {
+            type: requestOrResponseBody
+        }
+    )
+
+    dataProfile {
+        name: ICM Claims Data
+        rowSelector: items
+    }
+
+    dataProfileCol claim-id (
+        colName: CLAIM_ID
+        source {
+            sequence: 1
+            dataType: number
+        }
+        parsing {
+            pathExpression: claim_id
+        }
+    )
+
+    dataProfileCol claim-number (
+        colName: CLAIM_NUMBER
+        source {
+            sequence: 3
+            dataType: varchar2
+        }
+        parsing {
+            pathExpression: claim_number
+        }
+    )
+
+    dataProfileCol currency-code (
+        colName: CURRENCY_CODE
+        source {
+            sequence: 6
+            dataType: varchar2
+        }
+        parsing {
+            pathExpression: currency_code
+        }
+    )
+
+    dataProfileCol policy-id (
+        colName: POLICY_ID
+        source {
+            sequence: 2
+            dataType: number
+        }
+        parsing {
+            pathExpression: policy_id
+        }
+    )
+
+    dataProfileCol reported-date (
+        colName: REPORTED_DATE
+        source {
+            sequence: 4
+            dataType: date
+        }
+        parsing {
+            pathExpression: reported_date
+        }
+    )
+
+    dataProfileCol total-claimed-amount (
+        colName: TOTAL_CLAIMED_AMOUNT
+        source {
+            sequence: 5
+            dataType: number
+        }
+        parsing {
+            pathExpression: total_claimed_amount
+        }
+    )
+
+    operation get (
+        label {
+            label: GET
+        }
+        operation {
+            urlPattern: .
+            httpMethod: get
+            databaseOperation: fetchRows
+        }
+    )
+
+    operation post (
+        label {
+            label: POST
+        }
+        operation {
+            urlPattern: .
+            httpMethod: post
+            databaseOperation: insert
+            requestBodyTemplate: 
+                ```
+                {
+                    "claim_id":"#CLAIM_ID#"
+                   ,"policy_id":"#POLICY_ID#"
+                   ,"claim_number":"#CLAIM_NUMBER#"
+                   ,"reported_date":"#REPORTED_DATE#"
+                   ,"total_claimed_amount":"#TOTAL_CLAIMED_AMOUNT#"
+                   ,"currency_code":"#CURRENCY_CODE#"
+                }
+                ```
+        }
+    )
+
+)
+```

package/skills/apexlang/templates/shared-components/rest-data-sources/rest-data-sources._common.md

@@ -0,0 +1,20 @@
+---
+templateId: shared-components.rest-data-sources.common
+componentType: shared-component
+version: 1.0
+description: Canonical contract for REST Data Source discovery, profile, operations, and synchronization settings.
+---
+
+# Purpose
+Define REST Data Source configuration using discovery-first rules and validated data profiles.
+
+# Required Inputs
+- remote server alias
+- endpoint base/path and operations
+- discovered profile fields (including nested structures)
+- explicit synchronization requirements when requested
+
+# Guardrails
+- Never guess profile shape.
+- Use `restSource` references for page/process integration.
+- Treat synchronization schedule values as explicit inputs, never defaults.

package/skills/apexlang/templates/shared-components/rest-data-sources/rest-data-sources._index.md

@@ -0,0 +1,18 @@
+---
+templateId: rest-data-sources.index
+componentType: template
+version: 1.0
+imports:
+  - rest-data-sources._common.md
+description: Routing entrypoint for rest-data-sources templates.
+---
+
+# Purpose
+
+Primary routing entrypoint for `rest-data-sources` templates.
+
+# Load Order
+
+1. Load this file.
+2. Load `rest-data-sources._common.md`.
+3. Load one scenario template in this folder.

package/skills/apexlang/templates/shared-components/rest-data-sources/rest-data-sources.http-paginated-example.md

@@ -0,0 +1,9 @@
+---
+templateId: shared-components.rest-data-sources.http-paginated-example
+componentType: shared-component
+version: 1.0
+imports:
+  - rest-data-sources._common.md
+---
+
+HTTP pagination example variant (limit/offset + has-more selector) for deterministic REST profile scaffolding.

package/skills/apexlang/templates/shared-components/shared-components.registry.json

@@ -0,0 +1,110 @@
+{
+  "version": 1,
+  "entries": [
+    {
+      "slug": "acl-roles",
+      "path": "acl-roles/",
+      "index": "acl-roles/acl-roles._index.md",
+      "common": "acl-roles/acl-roles._common.md"
+    },
+    {
+      "slug": "ai-agents",
+      "path": "ai-agents/",
+      "index": "ai-agents/ai-agents._index.md",
+      "common": "ai-agents/ai-agents._common.md"
+    },
+    {
+      "slug": "app-computations-doc",
+      "file": "app-computations.md"
+    },
+    {
+      "slug": "app-items-doc",
+      "file": "app-items.md"
+    },
+    {
+      "slug": "app-processes",
+      "path": "app-processes/",
+      "index": "app-processes/app-processes._index.md",
+      "common": "app-processes/app-processes._common.md"
+    },
+    {
+      "slug": "authentications",
+      "path": "authentications/",
+      "index": "authentications/authentications._index.md",
+      "common": "authentications/authentications._common.md"
+    },
+    {
+      "slug": "authorizations",
+      "path": "authorizations/",
+      "index": "authorizations/authorizations._index.md",
+      "common": "authorizations/authorizations._common.md"
+    },
+    {
+      "slug": "breadcrumbs",
+      "path": "breadcrumbs/",
+      "examples": [
+        "breadcrumbs/breadcrumbs.md",
+        "breadcrumbs/breadcrumb-entries.md"
+      ]
+    },
+    {
+      "slug": "build-options-doc",
+      "file": "build-options.md"
+    },
+    {
+      "slug": "component-settings-family",
+      "path": "component-settings/",
+      "index": "component-settings/component-settings._index.md",
+      "common": "component-settings/component-settings._common.md"
+    },
+    {
+      "slug": "component-settings-example",
+      "file": "component-settings.example.md"
+    },
+    {
+      "slug": "email-templates-family",
+      "path": "email-templates/",
+      "index": "email-templates/email-templates._index.md",
+      "common": "email-templates/email-templates._common.md"
+    },
+    {
+      "slug": "email-templates-example",
+      "file": "email-templates.example.md"
+    },
+    {
+      "slug": "lists",
+      "path": "lists/",
+      "examples": [
+        "lists/lists.md",
+        "lists/list-entries.md"
+      ]
+    },
+    {
+      "slug": "lovs",
+      "path": "lovs/",
+      "examples": [
+        "lovs/lovs.static.md",
+        "lovs/lovs.dynamic.query.md",
+        "lovs/lovs.dynamic.table.md"
+      ]
+    },
+    {
+      "slug": "rest-data-sources",
+      "path": "rest-data-sources/",
+      "index": "rest-data-sources/rest-data-sources._index.md",
+      "common": "rest-data-sources/rest-data-sources._common.md"
+    },
+    {
+      "slug": "task-definitions",
+      "path": "task-definitions/",
+      "index": "task-definitions/task-definitions._index.md",
+      "common": "task-definitions/task-definitions._common.md"
+    },
+    {
+      "slug": "translations",
+      "path": "translations/",
+      "index": "translations/translations._index.md",
+      "common": "translations/translations._common.md"
+    }
+  ]
+}

package/skills/apexlang/templates/shared-components/task-definitions/action-task.example.md

@@ -0,0 +1,164 @@
+---
+templateId: shared-components.task-definitions.action-task.example
+componentType: markdown-apexlang-example
+version: 1.0
+migrationNote: preserved from previous standalone template example
+---
+
+# Action Task Example
+
+## Purpose
+
+Markdown-preserved APEXlang example. Use this file for syntax and structure only after loading the family `_index.md` and `_common.md` contract.
+
+## Example
+
+```apexlang
+/* create this component under shared-components/task-definitions/taskDefinitionName.apx
+   - taskDefinitionName could be a valid suitable name   
+   - Completion-driven (task done).
+   - Used for manual operational steps.
+   - Outcome may simply be "Completed".
+   - All the substitutition strings should follow the format &LOAN_ACCOUNT_NO. , don't enclose it within #
+   - Strictly use action component group to perform any post approval or completion action once the task has been completed.
+   Common Use Cases
+   ----------------
+   - Verify documents
+   - Upload missing files
+   - Perform physical inspection
+   - Enter additional data
+
+   Outcomes (Optional)
+   ------------------
+   - COMPLETED
+
+   Parameter rules
+   ------------------
+   - Do not use advanced.required; it is not a valid property for task parameters.
+
+   Completion handling rules
+   ------------------
+   - Do not create page-level sendEmail processes for task completion.
+   - Implement completion logic in the task definition action with execution.onEvent: complete.
+   - If email is required, send it from this action using APEX_MAIL or sendEMail under action onEvent: complete.
+   - When using APEX_MAIL.SEND with p_template_static_id, the value MUST match the email template Static ID exactly (case-sensitive, includes hyphens). Do not guess or transform names.
+   - Preferred: use native sendEMail action with emailTemplate: @<static-id> to avoid mismatches.
+   - Do not call undocumented APEX/DB APIs. Verify package/procedure existence in the target schema
+     (ALL_OBJECTS/ALL_PROCEDURES) before use; prefer native actions when available.
+   
+   When determining participants for an Human Task:
+
+   1. DO NOT hardcode usernames.
+   2. DO NOT assume :APP_USER is the approver.
+   3. ALWAYS resolve approvers from configured user tables.
+   4. Find the appropriate approver/supervisor based on the user tables and roles.
+   5. Fail safely if no approver is found.
+   6. Validate the SQL or PL/SQL code blocks. 
+
+Note: Prefer the structured `advanced { detailsPage: { ... } }` object form shown in this task-definition family. Do not default to a string `f?p=...` value when creating new task definitions. Keep the details page aligned with the task-details page family and pass the task id through the mapped page item.
+
+*/
+
+taskDefinition LOAN_ACTION (
+    name: Loan Action
+    type: action
+    task {
+        subject: Loan Action Required – &LOAN_ACCOUNT_NO.
+    }
+    advanced {
+        detailsPage: {
+            page: 10
+            items: {
+                P10_TASK_ID: &TASK_ID.
+            }
+            clearCache: 10
+            action: resetPagination
+        }
+    }
+    source {
+        type: sqlQuery
+        sqlQuery: select * from loan_master where loan_id = :APEX$TASK_PK
+    }
+
+    
+
+    parameter DISBURSED_AMOUNT (
+        label {
+            label: Disbursed Amount
+        }
+        advanced {
+            updatable: true
+        }
+    )
+
+
+    action loan-action-completed (
+        name: Loan action - completed
+        type: executeCode
+        source {
+            plsqlCode: 
+                ```plsql
+                begin
+                    update LOAN_MASTER set DISBURSED_AMOUNT = :DISBURSED_AMOUNT ,DISBURSED_DATE = trunc(sysdate) where loan_id = :LOAN_ID;
+                    -- add plsql logic here
+                end;
+                ```
+        }
+        execution {
+            onEvent: complete
+            sequence: 10
+        }
+        successMessage {
+            successMessage: Disbursed amount has been updated successfully.
+        }
+    )
+    
+    action send-email (
+        name: Send Email
+        type: sendEMail
+        emailHeader {
+            to: &P12_CUSTOMER_EMAIL.
+        }
+        emailTemplate {
+            emailTemplate: @order-confirmation
+            placeholderValues: 
+                ```
+                {
+                    "ORDER_NUMBER":"&P12_ORDER_ID.",
+                    "CUSTOMER_NAME":"&P12_CUSTOMER_NAME.",
+                    "ORDER_DATE":"&P12_ORDER_DATE.",
+                    "SHIP_TO":"",
+                    "SHIPPING_ADDRESS_LINE_1":"",
+                    "SHIPPING_ADDRESS_LINE_2":"",
+                    "ITEMS_ORDERED":"",
+                    "ORDER_TOTAL":"&P12_TOTAL_AMT.",
+                    "ORDER_URL":"","MY_APPLICATION_LINK":""
+                }
+                ```
+        }
+        emailAttachments {
+            attachmentSql: 
+                ```sql
+                select file_blob blob_column,
+                       file_name,
+                       mime_type,
+                       null content_id
+                  from order_files
+                 where order_id = :APEX$TASK_PK
+                ```
+        }
+        execution {
+            onEvent: complete
+            sequence: 20
+        }
+    )
+
+    participant (
+        value {
+            type: expression
+            plsqlExpression: loan_workflow_api.get_action_owner(:APEX$TASK_PK)
+        }
+    )
+
+)
+```