@eide/foir-cli 0.1.25 → 0.1.26

package/dist/commands/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/commands/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AActD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,aAAa,GAC9B,IAAI,CAyJN"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/commands/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AActD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,aAAa,GAC9B,IAAI,CAkKN"}

package/dist/commands/extensions.js

@@ -78,8 +78,14 @@ export function registerExtensionsCommands(program, globalOpts) {
         .command('install')
         .description('Install (or update) an extension with full provisioning')
         .option('-d, --data <json>', 'Extension manifest as JSON')
-        .option('-f, --file <path>', 'Read manifest from JSON file')
+        .option('-f, --file <path>', 'Read manifest from file (.ts, .js, or .json)')
         .option('-k, --key <key>', 'Extension key (overrides manifest)')
+        .addHelpText('after', `
+Examples:
+  $ foir extensions install -f install.config.ts
+  $ foir extensions install -f install.json
+  $ foir extensions install -d '{"key":"my-ext","name":"My Extension",...}'
+    `)
         .action(withErrorHandler(globalOpts, async (cmdOpts) => {
         const opts = globalOpts();
         const client = await createClient(opts);

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eide/foir-cli",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "Universal platform CLI for EIDE — scriptable, composable resource management",
   "type": "module",
   "publishConfig": {
@@ -17,29 +17,16 @@
     "./config": {
       "types": "./dist/config/types.js",
       "import": "./dist/config/types.js"
+    },
+    "./extensions": {
+      "types": "./dist/lib/extension-helpers.js",
+      "import": "./dist/lib/extension-helpers.js"
     }
   },
   "files": [
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc",
-    "dev:cli": "tsx src/cli.ts",
-    "check-types": "tsc --noEmit",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "test": "vitest run",
-    "test:watch": "vitest watch",
-    "codegen": "graphql-codegen --config codegen.ts",
-    "codegen:watch": "graphql-codegen --config codegen.ts --watch",
-    "prepublishOnly": "npm run build",
-    "patch": "npm run build && npm version patch",
-    "minor": "npm run build && npm version minor",
-    "major": "npm run build && npm version major",
-    "publish": "npm run build && npm publish",
-    "release": "npm run build && npm version patch && npm publish"
-  },
   "keywords": [
     "foir",
     "eide",
@@ -83,5 +70,20 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/eidebuild/foir-cli.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev:cli": "tsx src/cli.ts",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "codegen": "graphql-codegen --config codegen.ts",
+    "codegen:watch": "graphql-codegen --config codegen.ts --watch",
+    "patch": "npm run build && npm version patch",
+    "minor": "npm run build && npm version minor",
+    "major": "npm run build && npm version major",
+    "release": "npm run build && npm version patch && npm publish"
   }
-}
+}