eai-cli 0.0.0-bootstrap.0

package/dist/lib/error-codes.js

@@ -0,0 +1,211 @@
+/**
+ * Structured error codes for consistent error handling across the CLI.
+ *
+ * Error code categories:
+ * - E001-E099: Project errors (not in EAI project, config missing)
+ * - E100-E199: Auth errors (not logged in, token expired)
+ * - E200-E299: Platform errors (API unreachable, resource not found)
+ * - E300-E399: Validation errors (invalid schema, missing field)
+ */
+import { findGuidanceByCode } from './error-guidance/catalog.js';
+import { guidanceToJSON, formatGuidanceText } from './error-guidance/render.js';
+export var ErrorCode;
+(function (ErrorCode) {
+    // E001-E099: Project errors
+    ErrorCode["E001"] = "E001";
+    ErrorCode["E002"] = "E002";
+    ErrorCode["E003"] = "E003";
+    ErrorCode["E004"] = "E004";
+    ErrorCode["E005"] = "E005";
+    ErrorCode["E006"] = "E006";
+    // E100-E199: Auth errors
+    ErrorCode["E101"] = "E101";
+    ErrorCode["E102"] = "E102";
+    ErrorCode["E103"] = "E103";
+    ErrorCode["E104"] = "E104";
+    // E200-E299: Platform errors
+    ErrorCode["E201"] = "E201";
+    ErrorCode["E202"] = "E202";
+    ErrorCode["E203"] = "E203";
+    ErrorCode["E204"] = "E204";
+    ErrorCode["E205"] = "E205";
+    ErrorCode["E242"] = "E242";
+    ErrorCode["E243"] = "E243";
+    ErrorCode["E250"] = "E250";
+    ErrorCode["E260"] = "E260";
+    ErrorCode["E270"] = "E270";
+    ErrorCode["E280"] = "E280";
+    // E300-E399: Validation errors
+    ErrorCode["E301"] = "E301";
+    ErrorCode["E302"] = "E302";
+    ErrorCode["E303"] = "E303";
+    ErrorCode["E304"] = "E304";
+    ErrorCode["E305"] = "E305";
+})(ErrorCode || (ErrorCode = {}));
+export const errorCatalog = {
+    // Project errors (E001-E099)
+    [ErrorCode.E001]: {
+        message: 'Not in an EAI project',
+        suggestion: 'Run `eai init` to create a new project or navigate to an existing EAI project directory',
+    },
+    [ErrorCode.E002]: {
+        message: '{var} environment variable not set',
+        suggestion: 'Set {var} in your environment or project config. Tenant selection comes from `eai login` and `eai tenant select`, not tenant IDs in .env.local',
+    },
+    [ErrorCode.E003]: {
+        message: 'Configuration file not found: {file}',
+        suggestion: 'Ensure {file} exists in your project. Run `eai init` if this is a new project',
+    },
+    [ErrorCode.E004]: {
+        message: 'Object Types file not found or invalid',
+        suggestion: 'Create src/eai.config/object-types.ts with your type definitions',
+    },
+    [ErrorCode.E005]: {
+        message: 'Invalid project structure',
+        suggestion: 'Run `eai verify` to check your project setup',
+    },
+    [ErrorCode.E006]: {
+        message: 'Failed to load configuration: {details}',
+        suggestion: 'Check your .env.local and eai.config.ts files for syntax errors',
+    },
+    // Auth errors (E100-E199)
+    [ErrorCode.E101]: {
+        message: 'Not logged in',
+        suggestion: 'Run `eai login` to authenticate with the platform',
+    },
+    [ErrorCode.E102]: {
+        message: 'Access token expired',
+        suggestion: 'Run `eai login` to refresh your authentication',
+    },
+    [ErrorCode.E103]: {
+        message: 'Invalid credentials',
+        suggestion: 'Verify your credentials and try `eai login` again',
+    },
+    [ErrorCode.E104]: {
+        message: 'Authentication failed: {details}',
+        suggestion: 'Contact your administrator or try `eai login` again',
+    },
+    // Platform errors (E200-E299)
+    [ErrorCode.E201]: {
+        message: 'Platform API unreachable: {url}',
+        suggestion: 'Check your network connection and verify BASE_URL_PUBLIC_API is correct',
+    },
+    [ErrorCode.E202]: {
+        message: '{resource} not found',
+        suggestion: 'Verify the {resource} ID or name and try again',
+    },
+    [ErrorCode.E203]: {
+        message: 'Platform API error: {details}',
+        suggestion: 'Check the error details above. If the issue persists, contact support',
+    },
+    [ErrorCode.E204]: {
+        message: 'Permission denied',
+        suggestion: 'You do not have permission to perform this action. Contact your administrator',
+    },
+    [ErrorCode.E205]: {
+        message: 'Resource conflict: {details}',
+        suggestion: 'The resource already exists or conflicts with existing data',
+    },
+    [ErrorCode.E242]: {
+        message: 'Tenant app authorization is incomplete',
+        suggestion: 'Run `eai whoami`, `eai tenant list --format json`, then `eai provision entra --force --debug`',
+    },
+    [ErrorCode.E243]: {
+        message: 'Tenant app authorization returned a platform server error',
+        suggestion: 'Retry `eai provision entra --force --debug` with bounded backoff, then escalate with the request ID if the 5xx repeats',
+    },
+    [ErrorCode.E250]: {
+        message: 'Tenant plan does not allow this builder operation',
+        suggestion: 'Run `eai workflow readiness --format json` and ask a tenant administrator to update the plan if required',
+    },
+    [ErrorCode.E260]: {
+        message: 'Object Type validation failed',
+        suggestion: 'Run `eai types validate`, fix the reported Object Type definitions, then run `eai types seed`',
+    },
+    [ErrorCode.E270]: {
+        message: 'Object Type is not published for the active tenant',
+        suggestion: 'Run `eai resources schema --format json`, then `eai types seed` if the type is missing',
+    },
+    [ErrorCode.E280]: {
+        message: 'Workflow runtime binding requires operator assistance',
+        suggestion: 'Run `eai workflow status <workflow-key> --format json`, then `eai workflow request <workflow-key> --reason "<reason>"` if status is operator_required',
+    },
+    // Validation errors (E300-E399)
+    [ErrorCode.E301]: {
+        message: 'Invalid schema: {details}',
+        suggestion: 'Fix the schema errors listed above',
+    },
+    [ErrorCode.E302]: {
+        message: 'Validation failed: {details}',
+        suggestion: 'Correct the validation errors and try again',
+    },
+    [ErrorCode.E303]: {
+        message: 'Required field missing: {field}',
+        suggestion: 'Provide a value for {field}',
+    },
+    [ErrorCode.E304]: {
+        message: 'Invalid format: {details}',
+        suggestion: 'Valid formats are: {validFormats}',
+    },
+    [ErrorCode.E305]: {
+        message: 'Invalid input: {details}',
+        suggestion: 'Check your input and try again',
+    },
+};
+/**
+ * Interpolate context variables into error message template
+ */
+function interpolate(template, context) {
+    if (!context)
+        return template;
+    return Object.entries(context).reduce((result, [key, value]) => {
+        return result.replace(new RegExp(`\\{${key}\\}`, 'g'), value);
+    }, template);
+}
+/**
+ * Format error for text output
+ */
+export function formatError(code, context) {
+    const guidance = findGuidanceByCode(code);
+    if (guidance) {
+        return formatGuidanceText(guidance, context);
+    }
+    const def = errorCatalog[code];
+    const message = interpolate(def.message, context);
+    const suggestion = interpolate(def.suggestion, context);
+    return `${message}\n\n${suggestion}\n\nError code: ${code}`;
+}
+/**
+ * Format error for JSON output
+ */
+export function formatErrorJSON(code, context) {
+    const def = errorCatalog[code];
+    const message = interpolate(def.message, context);
+    const suggestion = interpolate(def.suggestion, context);
+    const guidance = findGuidanceByCode(code);
+    return {
+        error: {
+            code,
+            message,
+            suggestion,
+            ...(guidance ? { guidance: guidanceToJSON(guidance, context) } : {}),
+            exitCode: 1,
+        },
+    };
+}
+/**
+ * Exit with error (text or JSON format)
+ */
+export function exitWithError(code, context, format) {
+    if (format === 'json') {
+        console.error(JSON.stringify(formatErrorJSON(code, context), null, 2));
+    }
+    else {
+        // Import error symbol only when needed (avoids circular dependency)
+        const errorSymbol = '✗';
+        const errorMessage = formatError(code, context);
+        console.error(`${errorSymbol} ${errorMessage}`);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=error-codes.js.map

package/dist/lib/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../src/lib/error-codes.ts"],"names":[],"mappings":"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"}