@inizioevoke/veeva-astroclm-core 1.0.2 → 1.0.4

package/agents/claude/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: inizioevoke-veeva-astroclm
+description: >
+  Skills and tools for working in this Veeva CLM Astro project (inizioevoke-veeva-astroclm).
+  Use this skill for any project-specific tasks such as creating pages, managing content, or
+  running project utilities. Triggers on any request that involves scaffolding, generating,
+  or managing project files in this Veeva CLM project.
+---
+
+# inizioevoke-veeva-astroclm Skills
+
+## Available skills
+
+- **Page Manager** — Create a new page in the project → read `page-manager/SKILL.md`
+- **Veeva Config Manager** — Manage Veeva CLM configuration → read `veeva-config-manager/SKILL.md`

package/agents/claude/page-manager/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: inizioevoke-veeva-astroclm-pagemanager
+description: >
+  Scaffolds a new page in this Veeva CLM Astro project. Use this skill whenever the user asks to
+  create a new page, add a page, scaffold a slide, generate a new route, or set up a new CLM slide —
+  even if they don't say "page manager" explicitly. If the user is working in this project and wants
+  a new page, this skill should always trigger.
+---
+
+# Page Manager
+
+## Step 1 — Ask for the page path
+
+Ask: "What should the page path be? (relative to `src/contents/`, e.g. `home` or `module-1/slide-2`)"
+
+## Step 2 — Ask for the layout
+
+Read `src/layouts/` to discover available layouts (each subdirectory containing a `.astro` file is a layout). Present them as a numbered list, for example:
+
+```
+Which layout would you like to use?
+  1. GlobalLayout
+  2. LeftNavLayout
+  3. TopNavLayout
+```
+
+The user can respond with just a number. Resolve it to the layout name (e.g. `TopNavLayout`) before proceeding.
+
+## Step 3 — Check for veeva-config.ts
+
+Check if `veeva-config.ts` exists in the project root. If it does, ask the user: "Would you like to add a slide entry for this page in `veeva-config.ts`?"
+
+## Step 4 — Create files
+
+Given the page path (e.g. `this/one`):
+- `contentName` = last segment of the path (e.g. `one`)
+- `pageName` = full path with `/` replaced by `-` (e.g. `this-one`)
+
+Check that neither `src/pages/<pageName>.astro` nor `src/contents/<path>/` already exist — if either does, stop and tell the user.
+
+**Write `src/pages/<pageName>.astro`:**
+```astro
+---
+import Page from '@/contents/<path>/<contentName>.astro';
+---
+<Page />
+```
+
+**Create `src/contents/<path>/` and write `<contentName>.astro`:**
+```astro
+---
+import <layoutName> from '@/layouts/<layoutName>/<layoutName>.astro';
+
+import './<contentName>.scss';
+---
+<<layoutName>>
+  <!-- Insert page content here -->
+  
+  <script>
+    import './<contentName>';
+  </script>
+</<layoutName>>
+```
+
+**Write `src/contents/<path>/<contentName>.scss`:** empty file
+
+**Write `src/contents/<path>/<contentName>.ts`:** empty file
+
+## Step 5 — Add slide to veeva-config.ts
+
+If the user said yes in Step 3, add a new slide entry to `presentation.slides` following the pattern in `../veeva-config-manager/manage.md` (Step 3 — Resolve missing slides).
+
+## Step 6 — Report
+
+Tell the user which files were created.

package/agents/claude/veeva-config-manager/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: inizioevoke-veeva-astroclm-veeva-config-manager
+description: >
+  Manages Veeva CLM configuration for this project. Use this skill whenever the user asks to
+  create, generate, or set up a Veeva config, initialize a veeva-config.ts, scaffold a new
+  presentation, or run the veeva-config-manager. Also trigger when the user says things like
+  "set up the config", "create the config file", "initialize the presentation config",
+  "sync the config", "check the config", or "update the slides in the config".
+---
+
+# Veeva Config Manager
+
+## Available skills
+
+- **Create config** — Generate a `veeva-config.ts` file for the project → read `create.md`
+- **Manage config** — Sync `veeva-config.ts` slides with `src/pages/` → read `manage.md`

package/agents/claude/veeva-config-manager/create.md

@@ -0,0 +1,154 @@
+# veeva-create-config
+
+Interactively collect presentation metadata from the user and write a
+`veeva-config.ts` file to the project root, replicating the flow in
+`src/apps/veeva-config-manager/create.ts`.
+
+## What you need from the user
+
+Gather **all** of the following before writing any files. Ask for them
+conversationally, batching related questions into a single message to minimize
+round-trips:
+
+| Field | Options / constraints |
+|---|---|
+| **Product name** | Free text, required |
+| **Presentation name** | Free text, required |
+| **Presentation ID** | Free text; default = presentation name lowercased, non-alphanumeric → `_` |
+| **IVA dimensions** | `1024 × 768`, `1366 × 1024` *(default)*, `1376 × 1032` |
+| **iOS resolution** | `Default For Device` *(default)*, `Scale To Fit`, `Scale To 1024x768` |
+| **Disabled actions** | Multi-select, none required: History Buttons, Navigation Bar, Pinch to Exit, Reactions, Rotation Lock, Swipe, Zoom |
+| **CRM target** | `Salesforce` *(default)*, `Vault` |
+
+## Generating IDs
+
+You will need two kinds of random IDs. Implement them inline with JavaScript/TypeScript logic or generate them yourself:
+
+- **External ID prefix**: First 3 chars of `product` (uppercased) + `_` + an 8-char alphanumeric random string (uppercase A–Z, 0–9).
+  Example: product `Velorixin` → `VEL_3K9BW12X`
+- **Per-slide ID**: An independent 8-char alphanumeric random string for each slide, unique within the set.
+
+To generate an 8-char random-ish ID in a bash snippet you can run:
+```bash
+node -e "const a='0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';let r='';for(let i=0;i<8;i++)r+=a[Math.floor(Math.random()*36)];console.log(r)"
+```
+Or generate them yourself — just make them look like `3K9BW12X` (8 uppercase alphanumeric chars).
+
+## Discovering slides
+
+Read all `.astro` files in `src/pages/`:
+
+```bash
+ls src/pages/*.astro 2>/dev/null
+```
+
+For each file `some-page-name.astro`:
+- `path` = filename without `.astro` extension (e.g. `some-page-name`)
+- `title` = title-case the path by splitting on `-`, capitalising each part, joining with space (e.g. `Some Page Name`)
+- `externalId` = `formatExtId('<SLIDE_ID>')` — keep as a function call literal in the output. Ensure that `<SLIDE_ID>` is unique
+
+## Output format
+
+Write `veeva-config.ts` to the **project root** using exactly this template
+(replace all `##...##` tokens with the collected/generated values):
+
+```ts
+import type { IVeevaClmBinderFields, IVeevaConfig, VeevaEnv } from "@inizioevoke/veeva-astroclm-core/types";
+import { formatExtId as __formatExtId } from '@inizioevoke/veeva-astroclm-core/lib';
+
+interface IVeevaConfigArgs {
+  veevaEnv?: VeevaEnv;
+  isTraining?: boolean;
+}
+export default function ({ veevaEnv = 'client', isTraining = false }: IVeevaConfigArgs = {}): IVeevaConfig {
+  const isEvokeBuild = veevaEnv === 'evoke';
+  const EXT_ID = `##EXTERNAL_ID##${isTraining ? '_TRN' : ''}`;
+  const PRESENTATION_NAME = '##PRESENTATION_NAME##';
+
+  const formatExtId = (id: string) => {
+    return __formatExtId(EXT_ID, id);
+  };
+
+  const binderFields: IVeevaClmBinderFields = {
+    // language: isEvokeBuild ? undefined : 'English',
+    // crmOrg: isEvokeBuild ? undefined : { crmId: ['CRM_ORD_ID'] },
+    // crmProduct: isEvokeBuild ? undefined : { id: 'VEEVA_ID_FROM_URL' },
+    // crmDetailGroup: isEvokeBuild ? undefined : { id: 'VEEVA_ID_FROM_URL' },
+    // detailGroup: undefined
+  };
+
+  return {
+    dimensions: { width: ##DIMENSIONS_WIDTH##, height: ##DIMENSIONS_HEIGHT## },
+    thumbnails: {
+      default: {
+        queryStringParams: {
+          screenshots: true
+        }
+      }
+    },
+    presentation: {
+      externalId: EXT_ID,
+      presentationId: `##PRESENTATION_ID##${isTraining ? '_trn' : ''}`,
+      product: '##PRODUCT##',
+      name: `${PRESENTATION_NAME}${isTraining ? ' [Training]' : ''}`,
+      country: 'United States',
+      isTraining,
+      crmTarget: '##CRM_TARGET##',
+      ...binderFields,
+
+      shared: {
+        externalId: formatExtId('SHARED'),
+        ...binderFields
+      },
+
+      slideSettings: {
+        mediaType: 'HTML',
+        disableActions: ##DISABLE_ACTIONS##,
+        iosResolution: '##IOS_RESOLUTION##',
+        ...binderFields
+      },
+      slides: ##SLIDES##
+    }
+  };
+}
+
+```
+
+### Token substitution reference
+
+| Token | Value |
+|---|---|
+| `##EXTERNAL_ID##` | e.g. `OZE_3K9BW12X` |
+| `##PRESENTATION_NAME##` | cleaned presentation name (trim, collapse double spaces) |
+| `##PRESENTATION_ID##` | cleaned presentation ID |
+| `##PRODUCT##` | cleaned product name |
+| `##DIMENSIONS_WIDTH##` | numeric width, no quotes (e.g. `1366`) |
+| `##DIMENSIONS_HEIGHT##` | numeric height, no quotes (e.g. `1024`) |
+| `##IOS_RESOLUTION##` | string value as-is (e.g. `Default For Device`) |
+| `##DISABLE_ACTIONS##` | TS array literal e.g. `['Swipe', 'Zoom']` or `[]` |
+| `##CRM_TARGET##` | `Salesforce` or `Vault` |
+| `##SLIDES##` | Array of slide objects (see below) |
+
+### Slides array format
+
+```ts
+[{
+  path: 'some-page-name',
+  title: 'Some Page Name',
+  externalId: formatExtId('3K9BW12X')
+}, {
+  path: 'another-page',
+  title: 'Another Page',
+  externalId: formatExtId('7XZ2M4QR')
+}]
+```
+
+## "Clean input" rule
+
+Before using any free-text value in the output: `.trim()` and replace runs of
+two or more spaces with a single space. Do not otherwise transform user input.
+
+## After writing the file
+
+Tell the user where the file was written (`veeva-config.ts` in the project
+root) and list the slides that were detected.

package/agents/claude/veeva-config-manager/manage.md

@@ -0,0 +1,48 @@
+# veeva-manage-config
+
+Audit `veeva-config.ts` against `src/pages/` to keep slides in sync with the actual pages in the project.
+
+## Step 1 — Discover pages and slides
+
+Run in parallel:
+
+1. List all `.astro` files in `src/pages/`:
+   ```bash
+   ls src/pages/*.astro 2>/dev/null
+   ```
+   Extract the `path` for each: filename without the `.astro` extension (e.g. `some-page-name`).
+
+2. Read `veeva-config.ts` from the project root and extract the `path` property from each entry in `presentation.slides`.
+
+## Step 2 — Compare
+
+Identify:
+- **Missing slides** — pages in `src/pages/` that have no matching entry in `slides`
+- **Extraneous slides** — entries in `slides` whose `path` has no matching file in `src/pages/`
+
+If everything is in sync, tell the user and stop.
+
+## Step 3 — Resolve missing slides
+
+For each missing slide, ask the user: "No slide entry found for `<path>`. Add it to `veeva-config.ts`?"
+
+If yes, add a new slide object to the `slides` array following the same pattern from `create.md`:
+- `path` = the page filename without `.astro`
+- `title` = title-case by splitting on `-`, capitalising each part, joining with a space
+- `externalId` = `formatExtId('<SLIDE_ID>')` where `<SLIDE_ID>` is a new unique 8-char uppercase alphanumeric string, different from all existing slide IDs in the file
+
+Generate the ID with:
+```bash
+node -e "const a='0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';let r='';for(let i=0;i<8;i++)r+=a[Math.floor(Math.random()*36)];console.log(r)"
+```
+
+## Step 4 — Resolve extraneous slides
+
+For each extraneous slide, ask the user: "Slide entry `<path>` has no matching page. Remove it or comment it out?"
+
+- **Remove** — delete the slide object from the array entirely
+- **Comment out** — wrap the slide object in a block comment: `/* { path: '...', ... } */`
+
+## Step 5 — Write the file
+
+If any changes were made, write the updated `veeva-config.ts` and tell the user what was added, removed, or commented out.

package/dist/lib/index.d.ts

@@ -1,5 +1 @@
-export * from './const.js';
-export { default as loadEnv } from './env.js';
-export { default as parseArgv } from './parse-argv.js';
-export { default as parseEnv } from './parse-env.js';
 export * from './utils.js';

package/dist/lib/index.js

@@ -1,5 +1,2 @@
-export * from './const.js';
-export { default as loadEnv } from './env.js';
-export { default as parseArgv } from './parse-argv.js';
-export { default as parseEnv } from './parse-env.js';
+// only export client-side compatible scripts
 export * from './utils.js';

package/dist/lib/server.d.ts

@@ -0,0 +1,5 @@
+export * from './const.js';
+export { default as loadEnv } from './env.js';
+export { default as parseArgv } from './parse-argv.js';
+export { default as parseEnv } from './parse-env.js';
+export * from './utils.js';

package/dist/lib/server.js

@@ -0,0 +1,5 @@
+export * from './const.js';
+export { default as loadEnv } from './env.js';
+export { default as parseArgv } from './parse-argv.js';
+export { default as parseEnv } from './parse-env.js';
+export * from './utils.js';

package/dist/tasks/create-csv.d.ts

@@ -1,14 +1,18 @@
 import type { IVeevaConfig } from '../types';
+export interface AdditionalField {
+    header: string;
+    value?: string;
+    property?: string;
+}
 interface Params {
     config: IVeevaConfig;
     deployDir: string;
     buildName: string;
     fieldsOnly?: boolean;
     additional?: {
-        headers: string[];
-        presentation: string[];
-        slides: string[][];
-        shared: string[];
+        presentation: AdditionalField[];
+        slides: AdditionalField[];
+        shared: AdditionalField[];
     };
 }
 export default function ({ config, deployDir, buildName, fieldsOnly, additional }: Params): Promise<void>;

package/dist/tasks/create-csv.js

@@ -4,7 +4,30 @@ import logger from '../lib/logger.js';
 import { pathToSlideZip } from '../lib/utils.js';
 export default async function ({ config, deployDir, buildName, fieldsOnly = false, additional }) {
     logger.info('Creating multichannel loader CSV');
-    const headers = (fieldsOnly ? CSV_HEADERS_FIELDS_ONLY : CSV_HEADERS).concat(additional?.headers ?? []);
+    const headers = fieldsOnly ? CSV_HEADERS_FIELDS_ONLY : CSV_HEADERS;
+    additional?.presentation?.forEach((a) => {
+        if (a.value || (a.property && config.presentation[a.property])) {
+            headers.push(a.header);
+        }
+    });
+    additional?.slides?.forEach((a) => {
+        if (a.value) {
+            headers.push(a.header);
+        }
+        else if (a.property && config.presentation.slides) {
+            const slide = config.presentation.slides.find((s) => {
+                return s[a.property];
+            });
+            if (slide) {
+                headers.push(a.header);
+            }
+        }
+    });
+    additional?.shared?.forEach((a) => {
+        if (a.value || (a.property && config.presentation.shared && config.presentation.shared[a.property])) {
+            headers.push(a.header);
+        }
+    });
     const presentation = config.presentation;
     for (const [key, header] of Object.entries(BINDER_PRES_HEADERS)) {
         if (presentation[key]) {
@@ -17,12 +40,12 @@ export default async function ({ config, deployDir, buildName, fieldsOnly = fals
         }
     }
     const rows = [headers];
-    rows.push(createPresentationRow(headers, config).concat(additional?.presentation ?? []));
+    rows.push(createPresentationRow(headers, config, additional?.presentation));
     for (let i = 0; i < config.presentation.slides.length; i++) {
-        rows.push(createSlideRow(headers, config, config.presentation.slides[i]).concat(additional?.slides?.[i] ?? []));
+        rows.push(createSlideRow(headers, config, config.presentation.slides[i], additional?.slides));
     }
-    const shared = createSharedRow(headers, config);
-    shared && rows.push(shared.concat(additional?.shared ?? []));
+    const shared = createSharedRow(headers, config, additional?.shared);
+    shared && rows.push(shared);
     await writeFile(join(deployDir, `_${config.presentation.presentationId}_${buildName}.csv`), rows.map((r) => { return r.join(','); }).join('\n'), { encoding: 'utf8' });
 }
 const VEEVA_YES = 'YES', VEEVA_NO = 'NO', VEEVA_TYPE_PRESENTATION = 'Presentation', VEEVA_TYPE_SLIDE = 'Slide', VEEVA_TYPE_SHARED = 'Shared', VEEVA_LIFECYCLE_BINDER = 'Binder Lifecycle', VEEVA_LIFECYCLE_CRM_CONTENT = 'CRM Content Lifecycle', VEEVA_IOS_RESOLUTION_DEFAULT = 'Default For Device', VEEVA_MEDIATYPE_HTML = 'HTML', 
@@ -30,10 +53,10 @@ const VEEVA_YES = 'YES', VEEVA_NO = 'NO', VEEVA_TYPE_PRESENTATION = 'Presentatio
 HEADER_FIELDS_ONLY = 'Fields Only', HEADER_EXTERNAL_ID = 'external_id__v', HEADER_NAME = 'name__v', HEADER_TYPE = 'Type', HEADER_LIFECYCLE = 'lifecycle__v', HEADER_PRES_ID = 'pres.crm_presentation_id__v', HEADER_PRES_TITLE = 'pres.title__v', HEADER_PRES_PRODUCT = 'pres.product__v.name__v', HEADER_PRES_COUNTRY = 'pres.country__v.name__v', HEADER_PRES_LANGUAGE = 'pres.language__v', HEADER_PRES_CLM_CONTENT = 'pres.clm_content__v', HEADER_PRES_CLM_HIDDEN = 'pres.crm_hidden__v', HEADER_PRES_TRAINING = 'pres.crm_training__v', HEADER_PRES_CRM_TARGET = 'pres.crm_target_platform__v', HEADER_PRES_CRM_ORG = 'pres.crm_org__v.crm_org_id__v', HEADER_PRES_CRM_PRODUCT = 'pres.crm_product__v.id', // Get the Veeva ID from the URL
 HEADER_PRES_CRM_CONTENT_GROUP = 'pres.crm_content_group__v.id', // Get the Veeva ID from the URL
 HEADER_PRES_CRM_DETAIL_GROUP = 'pres.crm_detail_group__v.id', // Get the Veeva ID from the URL
-HEADER_PRES_DETAIL_GROUP = 'pres.detail_group__v', HEADER_PRESENTATION = 'Presentation Link', HEADER_SLIDE_TITLE = 'slide.title__v', HEADER_SLIDE_PRODUCT = 'slide.product__v.name__v', HEADER_SLIDE_COUNTRY = 'slide.country__v.name__v', HEADER_SLIDE_LANGUAGE = 'slide.language__v', HEADER_SLIDE_MEDIA_TYPE = 'slide.crm_media_type__v', HEADER_SLIDE_IOS_RESOLUTION = 'slide.ios_resolution__v', HEADER_SLIDE_RELATED_SHARED = 'slide.related_shared_resource__v', HEADER_SLIDE_CLM_CONTENT = 'slide.clm_content__v', HEADER_SLIDE_FILE_NAME = 'slide.filename', HEADER_SLIDE_REACTIONS = 'slide.crm_custom_reaction__v', HEADER_SLIDE_DISABLE_ACTIONS = 'slide.crm_disable_actions__v', HEADER_SLIDE_CRM_TARGET = 'slide.crm_target_platform__v', HEADER_SLIDE_CRM_ORG = 'slide.crm_org__v.crm_org_id__v', HEADER_SLIDE_CRM_PRODUCT = 'slide.crm_product__v.id', // Get the Veeva ID from the URL
+HEADER_PRES_DETAIL_GROUP = 'pres.detail_group__v', HEADER_PRES_EXP_DATE = 'pres.expiration_date__v', HEADER_PRESENTATION = 'Presentation Link', HEADER_SLIDE_TITLE = 'slide.title__v', HEADER_SLIDE_PRODUCT = 'slide.product__v.name__v', HEADER_SLIDE_COUNTRY = 'slide.country__v.name__v', HEADER_SLIDE_LANGUAGE = 'slide.language__v', HEADER_SLIDE_MEDIA_TYPE = 'slide.crm_media_type__v', HEADER_SLIDE_IOS_RESOLUTION = 'slide.ios_resolution__v', HEADER_SLIDE_RELATED_SHARED = 'slide.related_shared_resource__v', HEADER_SLIDE_CLM_CONTENT = 'slide.clm_content__v', HEADER_SLIDE_FILE_NAME = 'slide.filename', HEADER_SLIDE_REACTIONS = 'slide.crm_custom_reaction__v', HEADER_SLIDE_DISABLE_ACTIONS = 'slide.crm_disable_actions__v', HEADER_SLIDE_CRM_TARGET = 'slide.crm_target_platform__v', HEADER_SLIDE_CRM_ORG = 'slide.crm_org__v.crm_org_id__v', HEADER_SLIDE_CRM_PRODUCT = 'slide.crm_product__v.id', // Get the Veeva ID from the URL
 HEADER_SLIDE_CRM_CONTENT_GROUP = 'slide.crm_content_group__v.id', // Get the Veeva ID from the URL
 HEADER_SLIDE_CRM_DETAIL_GROUP = 'slide.crm_detail_group__v.id', // Get the Veeva ID from the URL
-HEADER_SLIDE_CRM_SHARED = 'slide.crm_shared_resource__v', HEADER_SLIDE_DETAIL_GROUP = 'slide.detail_group__v';
+HEADER_SLIDE_CRM_SHARED = 'slide.crm_shared_resource__v', HEADER_SLIDE_DETAIL_GROUP = 'slide.detail_group__v', HEADER_SLIDE_EXP_DATE = 'slide.expiration_date__v';
 const CSV_HEADERS = [
     HEADER_EXTERNAL_ID,
     HEADER_TYPE,
@@ -71,7 +94,8 @@ const BINDER_PRES_HEADERS = {
     crmProduct: HEADER_PRES_CRM_PRODUCT,
     crmContentGroup: HEADER_PRES_CRM_CONTENT_GROUP,
     crmDetailGroup: HEADER_PRES_CRM_DETAIL_GROUP,
-    detailGroup: HEADER_PRES_DETAIL_GROUP
+    detailGroup: HEADER_PRES_DETAIL_GROUP,
+    expirationDate: HEADER_PRES_EXP_DATE
 };
 const BINDER_SLIDE_HEADERS = {
     language: HEADER_SLIDE_LANGUAGE,
@@ -80,9 +104,10 @@ const BINDER_SLIDE_HEADERS = {
     crmProduct: HEADER_SLIDE_CRM_PRODUCT,
     crmContentGroup: HEADER_SLIDE_CRM_CONTENT_GROUP,
     crmDetailGroup: HEADER_SLIDE_CRM_DETAIL_GROUP,
-    detailGroup: HEADER_SLIDE_DETAIL_GROUP
+    detailGroup: HEADER_SLIDE_DETAIL_GROUP,
+    expirationDate: HEADER_SLIDE_EXP_DATE
 };
-function createPresentationRow(headers, config) {
+function createPresentationRow(headers, config, additional) {
     const row = new Array(headers.length).fill('');
     const presentation = config.presentation;
     addColumn(headers, row, HEADER_FIELDS_ONLY, VEEVA_YES);
@@ -101,9 +126,12 @@ function createPresentationRow(headers, config) {
     for (const [key, header] of Object.entries(BINDER_PRES_HEADERS)) {
         addColumn(headers, row, header, presentation[key]);
     }
+    additional?.forEach((a) => {
+        addColumn(headers, row, a.header, a.property ? presentation[a.property] : a.value);
+    });
     return row;
 }
-function createSlideRow(headers, config, slide) {
+function createSlideRow(headers, config, slide, additional) {
     const row = new Array(headers.length).fill('');
     addColumn(headers, row, HEADER_FIELDS_ONLY, VEEVA_YES);
     addColumn(headers, row, HEADER_EXTERNAL_ID, slide.externalId);
@@ -133,9 +161,12 @@ function createSlideRow(headers, config, slide) {
     for (const [key, header] of Object.entries(BINDER_SLIDE_HEADERS)) {
         addColumn(headers, row, header, slide[key] ?? config.presentation.slideSettings?.[key] ?? config.slideSettings?.[key]);
     }
+    additional?.forEach((a) => {
+        addColumn(headers, row, a.header, a.property ? slide[a.property] : a.value);
+    });
     return row;
 }
-function createSharedRow(headers, config) {
+function createSharedRow(headers, config, additional) {
     const shared = config.presentation.shared;
     if (!shared) {
         return null;
@@ -157,6 +188,9 @@ function createSharedRow(headers, config) {
     for (const [key, header] of Object.entries(BINDER_SLIDE_HEADERS)) {
         addColumn(headers, row, header, shared[key] ?? config.presentation.slideSettings?.[key] ?? config.slideSettings?.[key]);
     }
+    additional?.forEach((a) => {
+        addColumn(headers, row, a.header, a.property ? shared[a.property] : a.value);
+    });
     return row;
 }
 function addColumn(headers, row, header, value) {

package/dist/types/veeva.d.ts

@@ -21,6 +21,7 @@ export interface IVeevaClmBinderFields {
   crmContentGroup?: VeevaIdField | VeevaIdField[];
   crmDetailGroup?: VeevaIdField;
   detailGroup?: string;
+  expirationDate?: `${string}/${string}/${string}`;
 }
 
 

package/package.json

@@ -1,19 +1,27 @@
 {
   "name": "@inizioevoke/veeva-astroclm-core",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "",
   "license": "ISC",
   "author": "",
   "type": "module",
   "scripts": {
     "prepublishOnly": "npm run build",
-    "build": "npx tsx build.ts --cmd pre && tsc && npx tsx build.ts --cmd post"
+    "build": "npx tsx build.ts --cmd pre && tsc && npx tsx build.ts --cmd post",
+    "postinstall": "node postinstall.mjs"
   },
   "exports": {
     "./apps": "./dist/apps/index.js",
     "./env": "./dist/env/index.js",
     "./integrations": "./dist/integrations/index.js",
-    "./lib": "./dist/lib/index.js",
+    "./lib": {
+      "types": "./dist/lib/index.d.ts",
+      "default": "./dist/lib/index.js"
+    },
+    "./lib/server": {
+      "types": "./dist/lib/server.d.ts",
+      "default": "./dist/lib/server.js"
+    },
     "./tasks": "./dist/tasks/index.js",
     "./types": "./dist/types/index.d.ts"
   },

package/postinstall.mjs

@@ -0,0 +1,17 @@
+import { copyFileSync, mkdirSync, rmSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Resolve the consuming project's root (three levels up from node_modules/@inizioevoke/astro-core)
+const projectRoot = join(__dirname, '..', '..', '..');
+const destDir = join(projectRoot, '.claude', 'skills', 'inizioevoke-veeva-astroclm-core');
+const src = join(__dirname, 'agents', 'claude', 'SKILL.md');
+const dest = join(destDir, 'SKILL.md');
+
+rmSync(destDir, { recursive: true, force: true });
+mkdirSync(destDir, { recursive: true });
+
+copyFileSync(src, dest);
+console.log(`[@inizioevoke/veeva-astroclm-core] Copied skill to ${dest}`);

package/src/lib/index.ts

@@ -1,5 +1,2 @@
-export * from './const.js';
-export { default as loadEnv } from './env.js';
-export { default as parseArgv } from './parse-argv.js';
-export { default as parseEnv } from './parse-env.js';
+// only export client-side compatible scripts
 export * from './utils.js';

package/src/lib/server.ts

@@ -0,0 +1,5 @@
+export * from './const.js';
+export { default as loadEnv } from './env.js';
+export { default as parseArgv } from './parse-argv.js';
+export { default as parseEnv } from './parse-env.js';
+export * from './utils.js';

package/src/tasks/create-csv.ts

@@ -4,21 +4,48 @@ import type { IVeevaConfig, IVeevaConfigSlide, Actions, IVeevaClmBinderFields }
 import logger from '../lib/logger.js';
 import { pathToSlideZip } from '../lib/utils.js';
 
+export interface AdditionalField {
+  header: string;
+  value?: string;
+  property?: string;
+}
+
 interface Params {
   config: IVeevaConfig
   deployDir: string;
   buildName: string;
   fieldsOnly?: boolean;
   additional?: {
-    headers: string[];
-    presentation: string[];
-    slides: string[][];
-    shared: string[];
+    presentation: AdditionalField[];
+    slides: AdditionalField[];
+    shared: AdditionalField[];
   }
 }
 export default async function({ config, deployDir, buildName, fieldsOnly = false, additional }: Params) {
   logger.info('Creating multichannel loader CSV');
-  const headers: string[] = (fieldsOnly ? CSV_HEADERS_FIELDS_ONLY : CSV_HEADERS).concat(additional?.headers ?? []);
+  const headers: string[] = fieldsOnly ? CSV_HEADERS_FIELDS_ONLY : CSV_HEADERS;
+  additional?.presentation?.forEach((a) => {
+    if (a.value || (a.property && config.presentation[a.property as keyof typeof config.presentation])) {
+      headers.push(a.header);
+    }
+  });
+  additional?.slides?.forEach((a) => {
+    if (a.value) {
+      headers.push(a.header);
+    } else if (a.property && config.presentation.slides) {
+      const slide = config.presentation.slides.find((s) => {  
+        return s[a.property as keyof typeof s]
+      });
+      if (slide) {
+        headers.push(a.header);
+      }
+    }
+  });
+  additional?.shared?.forEach((a) => {
+    if (a.value || (a.property && config.presentation.shared && config.presentation.shared[a.property as keyof typeof config.presentation.shared])) {
+      headers.push(a.header);
+    }
+  });
   const presentation = config.presentation;
 
   for (const [key, header] of Object.entries(BINDER_PRES_HEADERS)) {
@@ -33,12 +60,12 @@ export default async function({ config, deployDir, buildName, fieldsOnly = false
   }
 
   const rows: string[][] = [headers];
-  rows.push(createPresentationRow(headers, config).concat(additional?.presentation ?? []));
+  rows.push(createPresentationRow(headers, config, additional?.presentation));
   for (let i=0; i<config.presentation.slides.length; i++) {
-    rows.push(createSlideRow(headers, config, config.presentation.slides[i]).concat(additional?.slides?.[i] ?? []));
+    rows.push(createSlideRow(headers, config, config.presentation.slides[i], additional?.slides));
   }
-  const shared = createSharedRow(headers, config);
-  shared && rows.push(shared.concat(additional?.shared ?? []));
+  const shared = createSharedRow(headers, config, additional?.shared);
+  shared && rows.push(shared);
 
   await writeFile(join(deployDir, `_${config.presentation.presentationId}_${buildName}.csv`), rows.map((r)=>{return r.join(',');}).join('\n'), { encoding: 'utf8' });
 }
@@ -76,6 +103,7 @@ const
   HEADER_PRES_CRM_CONTENT_GROUP = 'pres.crm_content_group__v.id', // Get the Veeva ID from the URL
   HEADER_PRES_CRM_DETAIL_GROUP = 'pres.crm_detail_group__v.id', // Get the Veeva ID from the URL
   HEADER_PRES_DETAIL_GROUP = 'pres.detail_group__v',
+  HEADER_PRES_EXP_DATE = 'pres.expiration_date__v',
 
   HEADER_PRESENTATION = 'Presentation Link',
   HEADER_SLIDE_TITLE = 'slide.title__v',
@@ -95,7 +123,8 @@ const
   HEADER_SLIDE_CRM_CONTENT_GROUP = 'slide.crm_content_group__v.id', // Get the Veeva ID from the URL
   HEADER_SLIDE_CRM_DETAIL_GROUP = 'slide.crm_detail_group__v.id', // Get the Veeva ID from the URL
   HEADER_SLIDE_CRM_SHARED = 'slide.crm_shared_resource__v',
-  HEADER_SLIDE_DETAIL_GROUP = 'slide.detail_group__v';
+  HEADER_SLIDE_DETAIL_GROUP = 'slide.detail_group__v',
+  HEADER_SLIDE_EXP_DATE = 'slide.expiration_date__v';
 
 const CSV_HEADERS = [
   HEADER_EXTERNAL_ID,
@@ -136,7 +165,8 @@ const BINDER_PRES_HEADERS: Record<keyof IVeevaClmBinderFields, string> = {
   crmProduct: HEADER_PRES_CRM_PRODUCT,
   crmContentGroup: HEADER_PRES_CRM_CONTENT_GROUP,
   crmDetailGroup: HEADER_PRES_CRM_DETAIL_GROUP,
-  detailGroup: HEADER_PRES_DETAIL_GROUP
+  detailGroup: HEADER_PRES_DETAIL_GROUP,
+  expirationDate: HEADER_PRES_EXP_DATE
 };
 const BINDER_SLIDE_HEADERS: Record<keyof IVeevaClmBinderFields, string> = {
   language: HEADER_SLIDE_LANGUAGE,
@@ -145,11 +175,12 @@ const BINDER_SLIDE_HEADERS: Record<keyof IVeevaClmBinderFields, string> = {
   crmProduct: HEADER_SLIDE_CRM_PRODUCT,
   crmContentGroup: HEADER_SLIDE_CRM_CONTENT_GROUP,
   crmDetailGroup: HEADER_SLIDE_CRM_DETAIL_GROUP,
-  detailGroup: HEADER_SLIDE_DETAIL_GROUP
+  detailGroup: HEADER_SLIDE_DETAIL_GROUP,
+  expirationDate: HEADER_SLIDE_EXP_DATE
 };
 
 
-function createPresentationRow(headers: string[], config: IVeevaConfig): string[] {
+function createPresentationRow(headers: string[], config: IVeevaConfig, additional?: AdditionalField[]): string[] {
   const row: string[] = new Array(headers.length).fill('');
   const presentation = config.presentation;
   addColumn(headers, row, HEADER_FIELDS_ONLY, VEEVA_YES);
@@ -168,10 +199,13 @@ function createPresentationRow(headers: string[], config: IVeevaConfig): string[
   for (const [key, header] of Object.entries(BINDER_PRES_HEADERS)) {
     addColumn(headers, row, header, presentation[key as keyof IVeevaClmBinderFields]);
   }
+  additional?.forEach((a) => {
+    addColumn(headers, row, a.header, a.property ? presentation[a.property as keyof typeof presentation] : a.value)
+  });
   return row;
 }
 
-function createSlideRow(headers: string[], config: IVeevaConfig, slide: IVeevaConfigSlide): string[] {
+function createSlideRow(headers: string[], config: IVeevaConfig, slide: IVeevaConfigSlide, additional?: AdditionalField[]): string[] {
   const row: string[] = new Array(headers.length).fill('');
   addColumn(headers, row, HEADER_FIELDS_ONLY, VEEVA_YES);
   addColumn(headers, row, HEADER_EXTERNAL_ID, slide.externalId);
@@ -206,10 +240,13 @@ function createSlideRow(headers: string[], config: IVeevaConfig, slide: IVeevaCo
   for (const [key, header] of Object.entries(BINDER_SLIDE_HEADERS)) {
     addColumn(headers, row, header, slide[key as keyof IVeevaClmBinderFields] ?? config.presentation.slideSettings?.[key as keyof IVeevaClmBinderFields] ?? config.slideSettings?.[key as keyof IVeevaClmBinderFields]);
   }
+  additional?.forEach((a) => {
+    addColumn(headers, row, a.header, a.property ? slide[a.property as keyof typeof slide] : a.value)
+  });
   return row; 
 }
 
-function createSharedRow(headers: string[], config: IVeevaConfig): string[] | null {
+function createSharedRow(headers: string[], config: IVeevaConfig, additional?: AdditionalField[]): string[] | null {
   const shared = config.presentation.shared;
   if (!shared) {
     return null;
@@ -231,6 +268,9 @@ function createSharedRow(headers: string[], config: IVeevaConfig): string[] | nu
   for (const [key, header] of Object.entries(BINDER_SLIDE_HEADERS)) {
     addColumn(headers, row, header, shared[key as keyof IVeevaClmBinderFields] ?? config.presentation.slideSettings?.[key as keyof IVeevaClmBinderFields] ?? config.slideSettings?.[key as keyof IVeevaClmBinderFields]);
   }
+  additional?.forEach((a) => {
+    addColumn(headers, row, a.header, a.property ? shared[a.property as keyof typeof shared] : a.value)
+  });
   return row; 
 }
 

package/src/types/veeva.d.ts

@@ -21,6 +21,7 @@ export interface IVeevaClmBinderFields {
   crmContentGroup?: VeevaIdField | VeevaIdField[];
   crmDetailGroup?: VeevaIdField;
   detailGroup?: string;
+  expirationDate?: `${string}/${string}/${string}`;
 }