glost-core 0.5.0

package/dist/errors.js

@@ -0,0 +1,300 @@
+/**
+ * GLOST Error Classes
+ *
+ * Comprehensive error handling with context, suggestions, and helpful messages
+ *
+ * @packageDocumentation
+ */
+/**
+ * Base class for all GLOST errors
+ */
+export class GLOSTError extends Error {
+    context;
+    constructor(message, context = {}) {
+        super(message);
+        this.name = 'GLOSTError';
+        this.context = context;
+        // Maintain proper stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Format error message with context
+     */
+    toString() {
+        const parts = [];
+        // Header
+        parts.push(`${this.name}: ${this.message}`);
+        parts.push('');
+        // Location information
+        if (this.context.path) {
+            parts.push(`  Location: ${this.context.path.join('.')}`);
+        }
+        if (this.context.file) {
+            parts.push(`  File: ${this.context.file}`);
+        }
+        if (this.context.node) {
+            parts.push(`  Node type: ${this.context.node.type || 'unknown'}`);
+        }
+        // Suggestion
+        if (this.context.suggestion) {
+            parts.push('');
+            parts.push(`  Suggestion: ${this.context.suggestion}`);
+        }
+        // Documentation link
+        if (this.context.docsUrl) {
+            parts.push('');
+            parts.push(`  Documentation: ${this.context.docsUrl}`);
+        }
+        // Stack trace
+        if (this.stack) {
+            parts.push('');
+            parts.push('  Stack trace:');
+            const stackLines = this.stack.split('\n').slice(1); // Skip first line (message)
+            parts.push(...stackLines.map(line => `  ${line}`));
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Get a concise error summary
+     */
+    toSummary() {
+        let summary = `${this.name}: ${this.message}`;
+        if (this.context.path) {
+            summary += ` (at ${this.context.path.join('.')})`;
+        }
+        return summary;
+    }
+}
+/**
+ * Validation error for schema violations
+ */
+export class GLOSTValidationError extends GLOSTError {
+    constructor(message, context = {}) {
+        super(message, context);
+        this.name = 'GLOSTValidationError';
+    }
+    toString() {
+        const parts = [];
+        parts.push(`${this.name}: ${this.message}`);
+        parts.push('');
+        // Location
+        if (this.context.path) {
+            const location = this.context.path.length > 0
+                ? this.context.path.join('.')
+                : 'root';
+            parts.push(`  Location: ${location}`);
+        }
+        if (this.context.node) {
+            const node = this.context.node;
+            parts.push(`  Node type: ${node.type || 'unknown'}`);
+        }
+        if (this.context.file) {
+            parts.push(`  File: ${this.context.file}`);
+        }
+        // Expected vs Received
+        if (this.context.expected) {
+            parts.push('');
+            parts.push(`  Expected: ${JSON.stringify(this.context.expected, null, 2)}`);
+        }
+        if (this.context.received) {
+            parts.push(`  Received: ${JSON.stringify(this.context.received, null, 2)}`);
+        }
+        // Problem explanation
+        if (this.context.problem) {
+            parts.push('');
+            parts.push(`  Problem: ${this.context.problem}`);
+        }
+        // Suggestion
+        if (this.context.suggestion) {
+            parts.push('');
+            parts.push(`  Suggestion: ${this.context.suggestion}`);
+        }
+        // Documentation
+        if (this.context.docsUrl) {
+            parts.push('');
+            parts.push(`  Documentation: ${this.context.docsUrl}`);
+        }
+        return parts.join('\n');
+    }
+}
+/**
+ * Error for missing required fields
+ */
+export class GLOSTMissingFieldError extends GLOSTValidationError {
+    constructor(fieldName, nodeType, context = {}) {
+        const message = `Missing required field '${fieldName}' on ${nodeType}`;
+        super(message, {
+            ...context,
+            problem: `${nodeType} must have a '${fieldName}' field.`,
+            docsUrl: context.docsUrl || `https://glost.dev/docs/node-types#${nodeType.toLowerCase()}`,
+        });
+        this.name = 'GLOSTMissingFieldError';
+    }
+}
+/**
+ * Error for invalid field types
+ */
+export class GLOSTInvalidTypeError extends GLOSTValidationError {
+    constructor(fieldName, expectedType, receivedType, context = {}) {
+        const message = `Invalid type for field '${fieldName}': expected ${expectedType}, got ${receivedType}`;
+        super(message, {
+            ...context,
+            problem: `Field '${fieldName}' must be of type ${expectedType}.`,
+            suggestion: `Convert the value to ${expectedType} or check your data source.`,
+        });
+        this.name = 'GLOSTInvalidTypeError';
+    }
+}
+/**
+ * Error for invalid language codes
+ */
+export class GLOSTInvalidLanguageCodeError extends GLOSTValidationError {
+    constructor(code, context = {}) {
+        const message = `Invalid language code: "${code}"`;
+        super(message, {
+            ...context,
+            problem: `Language codes must follow BCP-47 format (e.g., "en-US", "th-TH").`,
+            suggestion: `Use normalizeLanguageCode() from glost-common to convert "${code}" to a valid format.`,
+            docsUrl: context.docsUrl || 'https://glost.dev/docs/languages#bcp-47',
+        });
+        this.name = 'GLOSTInvalidLanguageCodeError';
+    }
+}
+/**
+ * Error for extension processing
+ */
+export class GLOSTExtensionError extends GLOSTError {
+    constructor(extensionName, message, context = {}) {
+        super(`[${extensionName}] ${message}`, context);
+        this.name = 'GLOSTExtensionError';
+    }
+}
+/**
+ * Error for provider issues
+ */
+export class GLOSTProviderError extends GLOSTError {
+    constructor(providerName, message, context = {}) {
+        super(`[${providerName} Provider] ${message}`, context);
+        this.name = 'GLOSTProviderError';
+    }
+}
+/**
+ * Error for document parsing
+ */
+export class GLOSTParseError extends GLOSTError {
+    constructor(message, context = {}) {
+        super(message, context);
+        this.name = 'GLOSTParseError';
+    }
+}
+/**
+ * Error for serialization issues
+ */
+export class GLOSTSerializationError extends GLOSTError {
+    constructor(message, context = {}) {
+        super(message, context);
+        this.name = 'GLOSTSerializationError';
+    }
+}
+/**
+ * Create a validation error with helpful context
+ *
+ * @param message - Error message
+ * @param options - Error options
+ * @returns GLOSTValidationError instance
+ *
+ * @example
+ * ```typescript
+ * throw createValidationError('Invalid word node', {
+ *   node: wordNode,
+ *   path: ['document', 'children', '0'],
+ *   suggestion: 'Add a "text" field to the word node',
+ *   docsUrl: 'https://glost.dev/docs/node-types#word'
+ * });
+ * ```
+ */
+export function createValidationError(message, options = {}) {
+    return new GLOSTValidationError(message, options);
+}
+/**
+ * Format a path array as a readable string
+ *
+ * @param path - Path array
+ * @returns Formatted path string
+ *
+ * @example
+ * ```typescript
+ * formatPath(['document', 'children', '0', 'text'])
+ * // Returns: "document.children[0].text"
+ * ```
+ */
+export function formatPath(path) {
+    if (path.length === 0)
+        return 'root';
+    return path.reduce((acc, segment, index) => {
+        if (index === 0)
+            return String(segment);
+        if (typeof segment === 'number' || !isNaN(Number(segment))) {
+            return `${acc}[${segment}]`;
+        }
+        return `${acc}.${segment}`;
+    }, '');
+}
+/**
+ * Assert that a condition is true, throw validation error if not
+ *
+ * @param condition - Condition to check
+ * @param message - Error message if condition is false
+ * @param context - Error context
+ *
+ * @example
+ * ```typescript
+ * glostAssert(
+ *   node.type === 'word',
+ *   'Node must be a word node',
+ *   { node, path: ['document', 'children', '0'] }
+ * );
+ * ```
+ */
+export function glostAssert(condition, message, context) {
+    if (!condition) {
+        throw new GLOSTValidationError(message, context);
+    }
+}
+/**
+ * Wrap an error with additional GLOST context
+ *
+ * @param error - Original error
+ * @param context - Additional context
+ * @returns GLOST error
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await processNode(node);
+ * } catch (error) {
+ *   throw wrapError(error, {
+ *     node,
+ *     path: ['document', 'children', '0'],
+ *     suggestion: 'Check that the node has all required fields'
+ *   });
+ * }
+ * ```
+ */
+export function wrapError(error, context) {
+    if (error instanceof GLOSTError) {
+        // Merge contexts - create new error with merged context
+        return new GLOSTError(error.message, {
+            ...error.context,
+            ...context,
+        });
+    }
+    // Create new GLOST error
+    return new GLOSTError(error.message, {
+        ...context,
+        originalError: error,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/guards.d.ts

@@ -0,0 +1,103 @@
+import type { GLOSTParagraph, GLOSTPunctuation, GLOSTRoot, GLOSTSentence, GLOSTSource, GLOSTSymbol, GLOSTText, GLOSTWhiteSpace, GLOSTWord, GLOSTNode } from "./types.js";
+/**
+ * Type guard to check if a node is an GLOSTWord
+ */
+export declare function isGLOSTWord(node: unknown): node is GLOSTWord;
+/**
+ * Type guard to check if a node is an GLOSTSentence
+ */
+export declare function isGLOSTSentence(node: unknown): node is GLOSTSentence;
+/**
+ * Type guard to check if a node is an GLOSTParagraph
+ */
+export declare function isGLOSTParagraph(node: unknown): node is GLOSTParagraph;
+/**
+ * Type guard to check if a node is an GLOSTRoot
+ */
+export declare function isGLOSTRoot(node: unknown): node is GLOSTRoot;
+/**
+ * Type guard to check if a node is an GLOSTText
+ */
+export declare function isGLOSTText(node: unknown): node is GLOSTText;
+/**
+ * Type guard to check if a node is an GLOSTPunctuation
+ */
+export declare function isGLOSTPunctuation(node: unknown): node is GLOSTPunctuation;
+/**
+ * Type guard to check if a node is an GLOSTSymbol
+ */
+export declare function isGLOSTSymbol(node: unknown): node is GLOSTSymbol;
+/**
+ * Type guard to check if a node is an GLOSTWhiteSpace
+ */
+export declare function isGLOSTWhiteSpace(node: unknown): node is GLOSTWhiteSpace;
+/**
+ * Type guard to check if a node is an GLOSTSource
+ */
+export declare function isGLOSTSource(node: unknown): node is GLOSTSource;
+/**
+ * Type guard to check if a node is GLOSTNode (any GLOST node)
+ */
+export declare function isGLOSTNode(node: unknown): node is GLOSTNode;
+/**
+ * Type guard to check if a node is an GLOSTDocument (Root or Content)
+ */
+export declare function isGLOSTDocument(node: unknown): node is GLOSTRoot;
+/**
+ * Type guard to check if an array contains only GLOSTWord nodes
+ */
+export declare function isGLOSTWordArray(nodes: unknown[]): nodes is GLOSTWord[];
+/**
+ * Type guard to check if an array contains only GLOSTSentence nodes
+ */
+export declare function isGLOSTSentenceArray(nodes: unknown[]): nodes is GLOSTSentence[];
+/**
+ * Type guard to check if an array contains only GLOSTParagraph nodes
+ */
+export declare function isGLOSTParagraphArray(nodes: unknown[]): nodes is GLOSTParagraph[];
+/**
+ * Type guard to check if an array contains only GLOSTContent nodes
+ */
+export declare function isGLOSTContentArray(nodes: unknown[]): nodes is (GLOSTWord | GLOSTSentence | GLOSTParagraph | GLOSTText | GLOSTPunctuation | GLOSTSymbol | GLOSTWhiteSpace | GLOSTSource)[];
+/**
+ * Type guard to check if a node has children
+ */
+export declare function hasChildren(node: unknown): node is {
+    children: unknown[];
+};
+/**
+ * Type guard to check if a node has metadata
+ */
+export declare function hasMetadata(node: unknown): node is {
+    metadata: Record<string, unknown>;
+};
+/**
+ * Type guard to check if a node has transcription
+ */
+export declare function hasTranscription(node: unknown): node is {
+    transcription: Record<string, unknown>;
+};
+/**
+ * Type guard to check if a node has extras
+ */
+export declare function hasExtras(node: unknown): node is {
+    extras: Record<string, unknown>;
+};
+/**
+ * Check if a node has valid GLOST structure (type guard based validation)
+ * For schema-based validation, use validateGLOSTNode from validators.ts
+ */
+export declare function isGLOSTNodeWithValidChildren(node: unknown): node is GLOSTNode;
+/**
+ * Check if an array contains valid GLOST nodes (type guard based)
+ */
+export declare function isGLOSTNodeArrayValid(nodes: unknown[]): nodes is GLOSTNode[];
+/**
+ * Check if a node is a leaf node (no children)
+ */
+export declare function isLeafNode(node: GLOSTNode): boolean;
+/**
+ * Check if a node is a container node (has children)
+ */
+export declare function isContainerNode(node: GLOSTNode): boolean;
+//# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

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

package/dist/guards.js

@@ -0,0 +1,264 @@
+// ============================================================================
+// GLOST Type Guards for Better Developer Experience
+// ============================================================================
+// ============================================================================
+// Core Node Type Guards
+// ============================================================================
+/**
+ * Type guard to check if a node is an GLOSTWord
+ */
+export function isGLOSTWord(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "WordNode" &&
+        "children" in node &&
+        "lang" in node &&
+        "script" in node &&
+        "level" in node &&
+        "metadata" in node &&
+        "transcription" in node &&
+        "extras" in node);
+}
+/**
+ * Type guard to check if a node is an GLOSTSentence
+ */
+export function isGLOSTSentence(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "SentenceNode" &&
+        "children" in node &&
+        "lang" in node &&
+        "script" in node &&
+        "level" in node &&
+        "metadata" in node);
+}
+/**
+ * Type guard to check if a node is an GLOSTParagraph
+ */
+export function isGLOSTParagraph(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "ParagraphNode" &&
+        "children" in node &&
+        "lang" in node &&
+        "script" in node &&
+        "level" in node &&
+        "metadata" in node);
+}
+/**
+ * Type guard to check if a node is an GLOSTRoot
+ */
+export function isGLOSTRoot(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "RootNode" &&
+        "children" in node &&
+        "lang" in node &&
+        "script" in node &&
+        "level" in node &&
+        "metadata" in node);
+}
+/**
+ * Type guard to check if a node is an GLOSTText
+ */
+export function isGLOSTText(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "TextNode" &&
+        "value" in node &&
+        typeof node.value === "string");
+}
+/**
+ * Type guard to check if a node is an GLOSTPunctuation
+ */
+export function isGLOSTPunctuation(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "PunctuationNode" &&
+        "value" in node &&
+        typeof node.value === "string");
+}
+/**
+ * Type guard to check if a node is an GLOSTSymbol
+ */
+export function isGLOSTSymbol(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "SymbolNode" &&
+        "value" in node &&
+        typeof node.value === "string");
+}
+/**
+ * Type guard to check if a node is an GLOSTWhiteSpace
+ */
+export function isGLOSTWhiteSpace(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "WhiteSpaceNode" &&
+        "value" in node &&
+        typeof node.value === "string");
+}
+/**
+ * Type guard to check if a node is an GLOSTSource
+ */
+export function isGLOSTSource(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "SourceNode" &&
+        "value" in node &&
+        typeof node.value === "string");
+}
+// ============================================================================
+// Content Type Guards
+// ============================================================================
+/**
+ * Type guard to check if a node is GLOSTNode (any GLOST node)
+ */
+export function isGLOSTNode(node) {
+    return (isGLOSTWord(node) ||
+        isGLOSTSentence(node) ||
+        isGLOSTParagraph(node) ||
+        isGLOSTText(node) ||
+        isGLOSTPunctuation(node) ||
+        isGLOSTSymbol(node) ||
+        isGLOSTWhiteSpace(node) ||
+        isGLOSTSource(node) ||
+        isGLOSTRoot(node));
+}
+// ============================================================================
+// Document Type Guards
+// ============================================================================
+/**
+ * Type guard to check if a node is an GLOSTDocument (Root or Content)
+ */
+export function isGLOSTDocument(node) {
+    return isGLOSTRoot(node);
+}
+// ============================================================================
+// Array Type Guards
+// ============================================================================
+/**
+ * Type guard to check if an array contains only GLOSTWord nodes
+ */
+export function isGLOSTWordArray(nodes) {
+    return nodes.every(isGLOSTWord);
+}
+/**
+ * Type guard to check if an array contains only GLOSTSentence nodes
+ */
+export function isGLOSTSentenceArray(nodes) {
+    return nodes.every(isGLOSTSentence);
+}
+/**
+ * Type guard to check if an array contains only GLOSTParagraph nodes
+ */
+export function isGLOSTParagraphArray(nodes) {
+    return nodes.every(isGLOSTParagraph);
+}
+/**
+ * Type guard to check if an array contains only GLOSTContent nodes
+ */
+export function isGLOSTContentArray(nodes) {
+    return nodes.every(node => isGLOSTWord(node) ||
+        isGLOSTSentence(node) ||
+        isGLOSTParagraph(node) ||
+        isGLOSTText(node) ||
+        isGLOSTPunctuation(node) ||
+        isGLOSTSymbol(node) ||
+        isGLOSTWhiteSpace(node) ||
+        isGLOSTSource(node));
+}
+// ============================================================================
+// Utility Type Guards
+// ============================================================================
+/**
+ * Type guard to check if a node has children
+ */
+export function hasChildren(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "children" in node &&
+        Array.isArray(node.children));
+}
+/**
+ * Type guard to check if a node has metadata
+ */
+export function hasMetadata(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "metadata" in node &&
+        typeof node.metadata === "object" &&
+        node.metadata !== null);
+}
+/**
+ * Type guard to check if a node has transcription
+ */
+export function hasTranscription(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "transcription" in node &&
+        typeof node.transcription === "object" &&
+        node.transcription !== null);
+}
+/**
+ * Type guard to check if a node has extras
+ */
+export function hasExtras(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "extras" in node &&
+        typeof node.extras === "object" &&
+        node.extras !== null);
+}
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Check if a node has valid GLOST structure (type guard based validation)
+ * For schema-based validation, use validateGLOSTNode from validators.ts
+ */
+export function isGLOSTNodeWithValidChildren(node) {
+    if (!isGLOSTNode(node)) {
+        return false;
+    }
+    // Additional validation for nodes with children
+    if (hasChildren(node)) {
+        return node.children.every(isGLOSTNode);
+    }
+    return true;
+}
+/**
+ * Check if an array contains valid GLOST nodes (type guard based)
+ */
+export function isGLOSTNodeArrayValid(nodes) {
+    return nodes.every(isGLOSTNodeWithValidChildren);
+}
+/**
+ * Check if a node is a leaf node (no children)
+ */
+export function isLeafNode(node) {
+    return (isGLOSTText(node) ||
+        isGLOSTPunctuation(node) ||
+        isGLOSTSymbol(node) ||
+        isGLOSTWhiteSpace(node) ||
+        isGLOSTSource(node));
+}
+/**
+ * Check if a node is a container node (has children)
+ */
+export function isContainerNode(node) {
+    return (isGLOSTWord(node) ||
+        isGLOSTSentence(node) ||
+        isGLOSTParagraph(node) ||
+        isGLOSTRoot(node));
+}
+//# sourceMappingURL=guards.js.map