@eide/foir-cli 0.1.25 → 0.1.27

package/dist/lib/config-loader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Configuration file loader.
+ *
+ * Supports loading TypeScript (.ts), JavaScript (.js, .mjs), and JSON (.json) config files.
+ * Uses dynamic imports for TypeScript/JavaScript and JSON.parse for JSON files.
+ */
+/**
+ * Load a configuration file from disk.
+ *
+ * Supports:
+ * - TypeScript (.ts) - via dynamic import
+ * - JavaScript (.js, .mjs) - via dynamic import
+ * - JSON (.json) - via JSON.parse
+ *
+ * @param filePath - Path to the config file
+ * @returns The default export from the config file
+ *
+ * @example
+ * ```typescript
+ * // Load TypeScript config
+ * const config = await loadConfig('./install.config.ts');
+ *
+ * // Load JSON config (backward compatible)
+ * const config = await loadConfig('./install.json');
+ * ```
+ */
+export declare function loadConfig<T = unknown>(filePath: string): Promise<T>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/lib/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/lib/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAyB1E"}

package/dist/lib/config-loader.js

@@ -0,0 +1,49 @@
+/**
+ * Configuration file loader.
+ *
+ * Supports loading TypeScript (.ts), JavaScript (.js, .mjs), and JSON (.json) config files.
+ * Uses dynamic imports for TypeScript/JavaScript and JSON.parse for JSON files.
+ */
+import { readFile } from 'fs/promises';
+import { pathToFileURL } from 'url';
+import { resolve } from 'path';
+/**
+ * Load a configuration file from disk.
+ *
+ * Supports:
+ * - TypeScript (.ts) - via dynamic import
+ * - JavaScript (.js, .mjs) - via dynamic import
+ * - JSON (.json) - via JSON.parse
+ *
+ * @param filePath - Path to the config file
+ * @returns The default export from the config file
+ *
+ * @example
+ * ```typescript
+ * // Load TypeScript config
+ * const config = await loadConfig('./install.config.ts');
+ *
+ * // Load JSON config (backward compatible)
+ * const config = await loadConfig('./install.json');
+ * ```
+ */
+export async function loadConfig(filePath) {
+    const absPath = resolve(filePath);
+    // TypeScript files (requires tsx or ts-node in user's environment)
+    if (filePath.endsWith('.ts')) {
+        const configModule = await import(pathToFileURL(absPath).href);
+        return configModule.default;
+    }
+    // JavaScript files
+    if (filePath.endsWith('.js') || filePath.endsWith('.mjs')) {
+        const configModule = await import(pathToFileURL(absPath).href);
+        return configModule.default;
+    }
+    // JSON files (backward compatible)
+    if (filePath.endsWith('.json')) {
+        const content = await readFile(absPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    throw new Error(`Unsupported file extension for "${filePath}". ` +
+        `Supported: .ts, .js, .mjs, .json`);
+}

package/dist/lib/extension-helpers.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Extension configuration helpers.
+ *
+ * These helpers provide type-safe configuration for extension installation
+ * using types generated from the platform's GraphQL schema.
+ *
+ * @example
+ * ```typescript
+ * import { defineExtension } from '@eide/foir-cli/extensions';
+ *
+ * export default defineExtension({
+ *   key: 'my-extension',
+ *   name: 'My Extension',
+ *   models: [...]
+ * });
+ * ```
+ */
+import type { InstallExtensionInput, InstallExtensionModelInput, FieldDefinitionInput, InstallExtensionOperationInput } from '../graphql/generated.js';
+/**
+ * Define an extension manifest with full type safety.
+ *
+ * This is a pass-through function that provides IntelliSense and
+ * compile-time validation for extension configurations.
+ *
+ * @example
+ * ```typescript
+ * export default defineExtension({
+ *   key: 'my-extension',
+ *   name: 'My Extension',
+ *   models: [{
+ *     key: 'my_model',
+ *     name: 'My Model',
+ *     fields: [
+ *       { key: 'title', type: 'text', label: 'Title', required: true }
+ *     ]
+ *   }]
+ * });
+ * ```
+ */
+export declare function defineExtension(config: InstallExtensionInput): InstallExtensionInput;
+/**
+ * Define a model with type-safe field definitions.
+ *
+ * @example
+ * ```typescript
+ * const myModel = defineModel({
+ *   key: 'my_model',
+ *   name: 'My Model',
+ *   fields: [
+ *     { key: 'title', type: 'text', label: 'Title', required: true }
+ *   ]
+ * });
+ * ```
+ */
+export declare function defineModel(model: InstallExtensionModelInput): InstallExtensionModelInput;
+/**
+ * Define a field with type safety.
+ *
+ * @example
+ * ```typescript
+ * const titleField = defineField({
+ *   key: 'title',
+ *   type: 'text',
+ *   label: 'Title',
+ *   required: true
+ * });
+ * ```
+ */
+export declare function defineField(field: FieldDefinitionInput): FieldDefinitionInput;
+/**
+ * Define an operation with type safety.
+ *
+ * @example
+ * ```typescript
+ * const myOperation = defineOperation({
+ *   key: 'my-operation',
+ *   name: 'My Operation',
+ *   endpoint: '/operations/my-operation'
+ * });
+ * ```
+ */
+export declare function defineOperation(operation: InstallExtensionOperationInput): InstallExtensionOperationInput;
+export type { InstallExtensionInput, InstallExtensionModelInput, FieldDefinitionInput, InstallExtensionOperationInput, InstallExtensionAuthProviderInput, InstallExtensionPlacementInput, InstallExtensionCustomerProfileSchemaInput, } from '../graphql/generated.js';
+//# sourceMappingURL=extension-helpers.d.ts.map

package/dist/lib/extension-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/extension-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,GAC5B,qBAAqB,CAEvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,0BAA0B,GAChC,0BAA0B,CAE5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,oBAAoB,GAC1B,oBAAoB,CAEtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,8BAA8B,GACxC,8BAA8B,CAEhC;AAGD,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,8BAA8B,EAC9B,iCAAiC,EACjC,8BAA8B,EAC9B,0CAA0C,GAC3C,MAAM,yBAAyB,CAAC"}

package/dist/lib/extension-helpers.js

@@ -0,0 +1,89 @@
+/**
+ * Extension configuration helpers.
+ *
+ * These helpers provide type-safe configuration for extension installation
+ * using types generated from the platform's GraphQL schema.
+ *
+ * @example
+ * ```typescript
+ * import { defineExtension } from '@eide/foir-cli/extensions';
+ *
+ * export default defineExtension({
+ *   key: 'my-extension',
+ *   name: 'My Extension',
+ *   models: [...]
+ * });
+ * ```
+ */
+/**
+ * Define an extension manifest with full type safety.
+ *
+ * This is a pass-through function that provides IntelliSense and
+ * compile-time validation for extension configurations.
+ *
+ * @example
+ * ```typescript
+ * export default defineExtension({
+ *   key: 'my-extension',
+ *   name: 'My Extension',
+ *   models: [{
+ *     key: 'my_model',
+ *     name: 'My Model',
+ *     fields: [
+ *       { key: 'title', type: 'text', label: 'Title', required: true }
+ *     ]
+ *   }]
+ * });
+ * ```
+ */
+export function defineExtension(config) {
+    return config;
+}
+/**
+ * Define a model with type-safe field definitions.
+ *
+ * @example
+ * ```typescript
+ * const myModel = defineModel({
+ *   key: 'my_model',
+ *   name: 'My Model',
+ *   fields: [
+ *     { key: 'title', type: 'text', label: 'Title', required: true }
+ *   ]
+ * });
+ * ```
+ */
+export function defineModel(model) {
+    return model;
+}
+/**
+ * Define a field with type safety.
+ *
+ * @example
+ * ```typescript
+ * const titleField = defineField({
+ *   key: 'title',
+ *   type: 'text',
+ *   label: 'Title',
+ *   required: true
+ * });
+ * ```
+ */
+export function defineField(field) {
+    return field;
+}
+/**
+ * Define an operation with type safety.
+ *
+ * @example
+ * ```typescript
+ * const myOperation = defineOperation({
+ *   key: 'my-operation',
+ *   name: 'My Operation',
+ *   endpoint: '/operations/my-operation'
+ * });
+ * ```
+ */
+export function defineOperation(operation) {
+    return operation;
+}

package/dist/lib/input.d.ts

@@ -1,5 +1,7 @@
 /**
  * Parse input data from --data, --file, or stdin.
+ *
+ * Supports TypeScript (.ts), JavaScript (.js, .mjs), and JSON (.json) files.
  */
 export declare function parseInputData(opts: {
     data?: string;

package/dist/lib/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/lib/input.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBnC;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM7C;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CA8B9D;AAWD,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAQjE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,OAAO,CAAC,CAalB"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/lib/input.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBnC;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM7C;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CA8B9D;AAWD,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAQjE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/lib/input.js

@@ -1,15 +1,17 @@
-import { promises as fs } from 'fs';
 import inquirer from 'inquirer';
+import { loadConfig } from './config-loader.js';
 /**
  * Parse input data from --data, --file, or stdin.
+ *
+ * Supports TypeScript (.ts), JavaScript (.js, .mjs), and JSON (.json) files.
  */
 export async function parseInputData(opts) {
     if (opts.data) {
         return JSON.parse(opts.data);
     }
     if (opts.file) {
-        const content = await fs.readFile(opts.file, 'utf-8');
-        return JSON.parse(content);
+        // Use config loader for TypeScript/JavaScript/JSON files
+        return await loadConfig(opts.file);
     }
     // Check for stdin pipe
     if (!process.stdin.isTTY) {

package/dist/lib/seed-helpers.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Model and record seed configuration helpers.
+ *
+ * These helpers provide type-safe configuration for seeding models and records
+ * using types generated from the platform's GraphQL schema.
+ *
+ * @example
+ * ```typescript
+ * import { defineModels, defineRecords } from '@eide/foir-cli/seed';
+ *
+ * // Define models
+ * export const models = defineModels([
+ *   {
+ *     key: 'my_model',
+ *     name: 'My Model',
+ *     fields: [...]
+ *   }
+ * ]);
+ *
+ * // Define records
+ * export const records = defineRecords([
+ *   {
+ *     modelKey: 'my_model',
+ *     naturalKey: 'my-record',
+ *     data: { ... }
+ *   }
+ * ]);
+ * ```
+ */
+import type { CreateModelInput, CreateRecordInput, FieldDefinitionInput } from '../graphql/generated.js';
+/**
+ * Define a single model with type safety.
+ *
+ * @example
+ * ```typescript
+ * export default defineModel({
+ *   key: 'tilly_page',
+ *   name: 'Tilly Page',
+ *   fields: [
+ *     { key: 'title', type: 'text', label: 'Title', required: true }
+ *   ],
+ *   config: {
+ *     versioning: true,
+ *     publishing: true
+ *   }
+ * });
+ * ```
+ */
+export declare function defineModel(model: CreateModelInput): CreateModelInput;
+/**
+ * Define multiple models with type safety.
+ *
+ * @example
+ * ```typescript
+ * export default defineModels([
+ *   {
+ *     key: 'model_a',
+ *     name: 'Model A',
+ *     fields: [...]
+ *   },
+ *   {
+ *     key: 'model_b',
+ *     name: 'Model B',
+ *     fields: [...]
+ *   }
+ * ]);
+ * ```
+ */
+export declare function defineModels(models: CreateModelInput[]): CreateModelInput[];
+/**
+ * Define a single record with type safety.
+ *
+ * @example
+ * ```typescript
+ * export default defineRecord({
+ *   modelKey: 'tilly_page',
+ *   naturalKey: 'home',
+ *   data: {
+ *     title: 'Home Page',
+ *     blocks: [...]
+ *   }
+ * });
+ * ```
+ */
+export declare function defineRecord(record: CreateRecordInput): CreateRecordInput;
+/**
+ * Define multiple records with type safety.
+ *
+ * @example
+ * ```typescript
+ * export default defineRecords([
+ *   {
+ *     modelKey: 'tilly_page',
+ *     naturalKey: 'home',
+ *     data: { title: 'Home' }
+ *   },
+ *   {
+ *     modelKey: 'tilly_page',
+ *     naturalKey: 'about',
+ *     data: { title: 'About' }
+ *   }
+ * ]);
+ * ```
+ */
+export declare function defineRecords(records: CreateRecordInput[]): CreateRecordInput[];
+/**
+ * Define a field with type safety.
+ * Alias of the extension helper for convenience.
+ *
+ * @example
+ * ```typescript
+ * const titleField = defineField({
+ *   key: 'title',
+ *   type: 'text',
+ *   label: 'Title',
+ *   required: true
+ * });
+ * ```
+ */
+export declare function defineField(field: FieldDefinitionInput): FieldDefinitionInput;
+export type { CreateModelInput, CreateRecordInput, FieldDefinitionInput, } from '../graphql/generated.js';
+//# sourceMappingURL=seed-helpers.d.ts.map

package/dist/lib/seed-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/seed-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAE3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAEzE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAAE,GAC3B,iBAAiB,EAAE,CAErB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,oBAAoB,GAC1B,oBAAoB,CAEtB;AAGD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/lib/seed-helpers.js

@@ -0,0 +1,129 @@
+/**
+ * Model and record seed configuration helpers.
+ *
+ * These helpers provide type-safe configuration for seeding models and records
+ * using types generated from the platform's GraphQL schema.
+ *
+ * @example
+ * ```typescript
+ * import { defineModels, defineRecords } from '@eide/foir-cli/seed';
+ *
+ * // Define models
+ * export const models = defineModels([
+ *   {
+ *     key: 'my_model',
+ *     name: 'My Model',
+ *     fields: [...]
+ *   }
+ * ]);
+ *
+ * // Define records
+ * export const records = defineRecords([
+ *   {
+ *     modelKey: 'my_model',
+ *     naturalKey: 'my-record',
+ *     data: { ... }
+ *   }
+ * ]);
+ * ```
+ */
+/**
+ * Define a single model with type safety.
+ *
+ * @example
+ * ```typescript
+ * export default defineModel({
+ *   key: 'tilly_page',
+ *   name: 'Tilly Page',
+ *   fields: [
+ *     { key: 'title', type: 'text', label: 'Title', required: true }
+ *   ],
+ *   config: {
+ *     versioning: true,
+ *     publishing: true
+ *   }
+ * });
+ * ```
+ */
+export function defineModel(model) {
+    return model;
+}
+/**
+ * Define multiple models with type safety.
+ *
+ * @example
+ * ```typescript
+ * export default defineModels([
+ *   {
+ *     key: 'model_a',
+ *     name: 'Model A',
+ *     fields: [...]
+ *   },
+ *   {
+ *     key: 'model_b',
+ *     name: 'Model B',
+ *     fields: [...]
+ *   }
+ * ]);
+ * ```
+ */
+export function defineModels(models) {
+    return models;
+}
+/**
+ * Define a single record with type safety.
+ *
+ * @example
+ * ```typescript
+ * export default defineRecord({
+ *   modelKey: 'tilly_page',
+ *   naturalKey: 'home',
+ *   data: {
+ *     title: 'Home Page',
+ *     blocks: [...]
+ *   }
+ * });
+ * ```
+ */
+export function defineRecord(record) {
+    return record;
+}
+/**
+ * Define multiple records with type safety.
+ *
+ * @example
+ * ```typescript
+ * export default defineRecords([
+ *   {
+ *     modelKey: 'tilly_page',
+ *     naturalKey: 'home',
+ *     data: { title: 'Home' }
+ *   },
+ *   {
+ *     modelKey: 'tilly_page',
+ *     naturalKey: 'about',
+ *     data: { title: 'About' }
+ *   }
+ * ]);
+ * ```
+ */
+export function defineRecords(records) {
+    return records;
+}
+/**
+ * Define a field with type safety.
+ * Alias of the extension helper for convenience.
+ *
+ * @example
+ * ```typescript
+ * const titleField = defineField({
+ *   key: 'title',
+ *   type: 'text',
+ *   label: 'Title',
+ *   required: true
+ * });
+ * ```
+ */
+export function defineField(field) {
+    return field;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eide/foir-cli",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "Universal platform CLI for EIDE — scriptable, composable resource management",
   "type": "module",
   "publishConfig": {
@@ -17,6 +17,14 @@
     "./config": {
       "types": "./dist/config/types.js",
       "import": "./dist/config/types.js"
+    },
+    "./extensions": {
+      "types": "./dist/lib/extension-helpers.js",
+      "import": "./dist/lib/extension-helpers.js"
+    },
+    "./seed": {
+      "types": "./dist/lib/seed-helpers.js",
+      "import": "./dist/lib/seed-helpers.js"
     }
   },
   "files": [