@resistdesign/voltra 3.0.0-alpha.2 → 3.0.0-alpha.21

package/{src/common → common}/Testing/Utils.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @packageDocumentation
+ *
+ * Helpers for executing JSON spec tests, including expectation generation.
+ */
 import { ConditionConfig, ResolvedTestConfig, Test, TestComparisonOperation, TestConfig, TestResults } from "./Types";
 /**
  * A map of comparison functions for each `TestComparisonOperation`.
@@ -5,44 +10,103 @@ import { ConditionConfig, ResolvedTestConfig, Test, TestComparisonOperation, Tes
 export declare const OPERATIONS: Record<string, (a: unknown, b: unknown) => boolean>;
 /**
  * Compare a result with an expectation using a specified `TestComparisonOperation`.
+ *
+ * @param result - Actual test result.
+ * @param expectation - Expected value.
+ * @param operation - Comparison operation to use.
+ * @returns Whether the result matches the expectation.
  * */
 export declare const compare: (result: unknown, expectation: unknown, operation?: TestComparisonOperation) => boolean;
 /**
  * Get the target module for testing from a file being tested.
+ *
+ * @param testFilePath - Path to the test file.
+ * @param targetTestIndex - Index of the test in the test array.
+ * @param targetTestExport - Export name for the test.
+ * @param conditions - Conditions array or config to load.
+ * @param isSetup - Whether the conditions are for setup.
+ * @returns Resolved conditions array.
  * */
-export declare const getResolvedConditions: (testFilePath: string, targetTestIndex: number, targetTestExport: string, conditions: unknown[] | ConditionConfig, isSetup?: boolean) => unknown[];
+export declare const getResolvedConditions: (testFilePath: string, targetTestIndex: number, targetTestExport: string, conditions: unknown[] | ConditionConfig, isSetup?: boolean) => Promise<unknown[]>;
 /**
  * Get the target base instance from a module, for a given test setup.
+ *
+ * @param testFilePath - Path to the test file.
+ * @param targetTestIndex - Index of the test in the test array.
+ * @param targetTestExport - Export name for the test.
+ * @param test - Test definition.
+ * @param module - Required module containing exports.
+ * @returns Instance to use for the test function.
  * */
 export declare const getSetupInstance: (testFilePath: string, targetTestIndex: number, targetTestExport: string, test: Test, module: any) => Promise<any>;
+/**
+ * Resolve the test function from the target module or setup instance.
+ *
+ * @param testFilePath - Path to the test file.
+ * @param file - Module file defined in the test config.
+ * @param targetTestIndex - Index of the test in the test array.
+ * @param test - Test definition.
+ * @param targetModule - Required module containing exports.
+ * @returns Test function to execute.
+ */
 export declare const getTestFunction: (testFilePath: string, file: string, targetTestIndex: number, test: Test, targetModule: any) => Promise<(...args: unknown[]) => Promise<unknown> | unknown>;
 /**
  * Get the test configuration from a test file.
+ *
+ * @param testFilePath - Path to the test file.
+ * @returns Parsed test config.
  * */
 export declare const getTestConfig: (testFilePath: string) => Promise<TestConfig>;
 /**
  * Get the target module for testing from a file being tested.
+ *
+ * @param testFilePath - Path to the test file.
+ * @returns Resolved test config with module and tests.
  * */
 export declare const getResolvedTestConfig: (testFilePath: string) => Promise<ResolvedTestConfig>;
 /**
  * Merge multiple test results into a single result.
+ *
+ * @param results - Test result sets to merge.
+ * @returns Combined test results.
  * */
 export declare const mergeTestResults: (...results: TestResults[]) => TestResults;
 /**
  * Run a test using a test function and a test condition.
+ *
+ * @param testFilePath - Path to the test file.
+ * @param testFunction - Test function to execute.
+ * @param test - Test definition.
+ * @param index - Test index in the list.
+ * @param targetExport - Export name for the test.
+ * @param report - Reporter for test results.
+ * @returns Resolves when the test completes.
  * */
 export declare const runTest: (testFilePath: string, testFunction: (...args: unknown[]) => Promise<unknown> | unknown, test: Test, index: number, targetExport: string, report: (results: TestResults) => void) => Promise<void>;
 /**
  * Generate tests for a file by running the tests, capturing the current result and storing it as the new expectation.
+ *
+ * @param testFilePath - Path to the test file.
+ * @param report - Reporter for test results.
+ * @returns Resolves when generation completes.
  * */
 export declare const generateTestsForFile: (testFilePath: string, report: (results: TestResults) => void) => Promise<void>;
 /**
  * Run the tests for a given test file.
  *
  * The test file content is expected to be a JSON in the structure of a `TestConfig`.
+ *
+ * @param testFilePath - Path to the test file.
+ * @param report - Reporter for test results.
+ * @returns Resolves when tests finish.
  * */
 export declare const runTestsForFile: (testFilePath: string, report: (results: TestResults) => void) => Promise<void>;
 /**
  * Run or generate all of the tests in the specified `testPath` glob.
+ *
+ * @param testFiles - Test file paths to execute.
+ * @param generateMode - Whether to generate expectations.
+ * @param report - Reporter for test results.
+ * @returns Resolves when execution completes.
  * */
 export declare const executeTestingCommand: (testFiles: string[], generateMode: boolean | undefined, report: (results: TestResults) => void) => Promise<void>;

package/common/Testing/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @packageDocumentation
+ *
+ * JSON-spec testing helpers used by the custom test runner. Specs live alongside
+ * code in `*.spec.json` files and point to test-utils modules.
+ */
+export * from "./Types";
+export * from "./Utils";

package/common/TypeInfoDataItemUtils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @packageDocumentation
+ *
+ * Helpers for deriving default values from TypeInfo field constraints.
+ */
+import { LiteralValue, TypeInfoField } from "./TypeParsing/TypeInfo";
+/**
+ * Supported default value types for a TypeInfo field.
+ * */
+export type FieldValueType = LiteralValue | LiteralValue[];
+/**
+ * Result describing whether a field has a default value.
+ * */
+export type DefaultValueInfo = {
+    /**
+     * Indicates a default value is present.
+     * */
+    hasDefaultValue: true;
+    /**
+     * Default value for the field.
+     * */
+    defaultValue: FieldValueType;
+} | {
+    /**
+     * Indicates no default value is present.
+     * */
+    hasDefaultValue: false;
+    /**
+     * Always undefined when no default value is present.
+     * */
+    defaultValue: undefined;
+};
+/**
+ * Determine the default value for a TypeInfo field.
+ *
+ * @param typeInfoField - TypeInfo field metadata to inspect.
+ * @returns Default value info for the field.
+ */
+export declare const getDefaultValueInfo: (typeInfoField: TypeInfoField) => DefaultValueInfo;

package/common/TypeInfoORM/Types.d.ts

@@ -0,0 +1,342 @@
+/**
+ * @packageDocumentation
+ *
+ * Shared TypeInfoORM API types, route paths, and error enums used by services
+ * and clients.
+ */
+import { ListItemsConfig, ListItemsResults, ListRelationshipsConfig } from "../SearchTypes";
+import { BaseItemRelationshipInfo, ItemRelationshipInfo } from "../ItemRelationshipInfoTypes";
+import { TypeInfoDataItem, TypeOperation } from "../TypeParsing/TypeInfo";
+/**
+ * The DAC Resource name for item relationships.
+ * */
+export declare const ITEM_RELATIONSHIP_DAC_RESOURCE_NAME = "TYPE_INFO_ORM_ITEM_RELATIONSHIP";
+/**
+ * A set of possible operations for a {@link ItemRelationshipInfo}.
+ * */
+export declare enum RelationshipOperation {
+    /**
+     * Read relationship info.
+     * */
+    GET = "GET",
+    /**
+     * Create or update a relationship.
+     * */
+    SET = "SET",
+    /**
+     * Remove a relationship.
+     * */
+    UNSET = "UNSET"
+}
+/**
+ * A set groups of possible operations for a type, field value or relationship.
+ * */
+export declare enum OperationGroup {
+    /**
+     * All possible operations.
+     * */
+    ALL_OPERATIONS = "ALL_OPERATIONS",
+    /**
+     * All item CRUD operations.
+     * */
+    ALL_ITEM_OPERATIONS = "ALL_ITEM_OPERATIONS",
+    /**
+     * All relationship operations.
+     * */
+    ALL_RELATIONSHIP_OPERATIONS = "ALL_RELATIONSHIP_OPERATIONS"
+}
+/**
+ * A set of possible ORM operations.
+ * */
+export type ORMOperation = TypeOperation | RelationshipOperation | OperationGroup;
+/**
+ * Error types for a TypeInfoORM service.
+ *
+ * @category ORM
+ * */
+export declare enum TypeInfoORMServiceError {
+    /**
+     * No data drivers were supplied.
+     * */
+    NO_DRIVERS_SUPPLIED = "NO_DRIVERS_SUPPLIED",
+    /**
+     * No relationship drivers were supplied.
+     * */
+    NO_RELATIONSHIP_DRIVERS_SUPPLIED = "NO_RELATIONSHIP_DRIVERS_SUPPLIED",
+    /**
+     * Missing required primary field value.
+     * */
+    NO_PRIMARY_FIELD_VALUE_SUPPLIED = "NO_PRIMARY_FIELD_VALUE_SUPPLIED",
+    /**
+     * Driver type is not supported for the request.
+     * */
+    INVALID_DRIVER = "INVALID_DRIVER",
+    /**
+     * Relationship driver type is not supported for the request.
+     * */
+    INVALID_RELATIONSHIP_DRIVER = "INVALID_RELATIONSHIP_DRIVER",
+    /**
+     * TypeInfo definition was not found or invalid.
+     * */
+    INVALID_TYPE_INFO = "INVALID_TYPE_INFO",
+    /**
+     * TypeInfo missing a primary field definition.
+     * */
+    TYPE_INFO_MISSING_PRIMARY_FIELD = "TYPE_INFO_MISSING_PRIMARY_FIELD",
+    /**
+     * Relationship payload is invalid.
+     * */
+    INVALID_RELATIONSHIP = "INVALID_RELATIONSHIP",
+    /**
+     * Operation is not supported.
+     * */
+    INVALID_OPERATION = "INVALID_OPERATION",
+    /**
+     * Accessing role is missing when DAC is required.
+     * */
+    MISSING_ACCESSING_ROLE = "MISSING_ACCESSING_ROLE",
+    /**
+     * Indexing criteria is not supported.
+     * */
+    INDEXING_UNSUPPORTED_CRITERIA = "INDEXING_UNSUPPORTED_CRITERIA",
+    /**
+     * Indexing criteria combination is not supported.
+     * */
+    INDEXING_UNSUPPORTED_COMBINATION = "INDEXING_UNSUPPORTED_COMBINATION",
+    /**
+     * Required index field is missing.
+     * */
+    INDEXING_MISSING_INDEX_FIELD = "INDEXING_MISSING_INDEX_FIELD",
+    /**
+     * Indexing backend dependency is missing.
+     * */
+    INDEXING_MISSING_BACKEND = "INDEXING_MISSING_BACKEND",
+    /**
+     * Indexing operations require criteria to be provided.
+     * */
+    INDEXING_REQUIRES_CRITERIA = "INDEXING_REQUIRES_CRITERIA"
+}
+/**
+ * A collection of kebab-case route paths for a TypeInfoORM API.
+ * */
+export declare enum TypeInfoORMAPIRoutePaths {
+    /**
+     * Create item route.
+     * */
+    CREATE = "create",
+    /**
+     * Read item route.
+     * */
+    READ = "read",
+    /**
+     * Update item route.
+     * */
+    UPDATE = "update",
+    /**
+     * Delete item route.
+     * */
+    DELETE = "delete",
+    /**
+     * List item route.
+     * */
+    LIST = "list",
+    /**
+     * Create relationship route.
+     * */
+    CREATE_RELATIONSHIP = "create-relationship",
+    /**
+     * Delete relationship route.
+     * */
+    DELETE_RELATIONSHIP = "delete-relationship",
+    /**
+     * List relationships route.
+     * */
+    LIST_RELATIONSHIPS = "list-relationships",
+    /**
+     * List related items route.
+     * */
+    LIST_RELATED_ITEMS = "list-related-items"
+}
+/**
+ * The results of a delete relationship operation.
+ */
+export type DeleteRelationshipResults = {
+    /**
+     * Whether the delete operation succeeded.
+     * */
+    success: boolean;
+    /**
+     * Whether related items still exist after deletion.
+     * */
+    remainingItemsExist: boolean;
+};
+/**
+ * Access context for a single ORM call.
+ */
+export type TypeInfoORMContext = {
+    /**
+     * Role identifier for the caller.
+     *
+     * Required when DAC is enabled; ignored when DAC is disabled.
+     */
+    accessingRoleId: string;
+};
+/**
+ * Server-side TypeInfoORM API contract.
+ *
+ * Methods that perform DAC-sensitive work may accept
+ * `context?: TypeInfoORMContext`.
+ */
+export type TypeInfoORMAPI = {
+    /**
+     * Create a relationship record.
+     *
+     * @param relationshipItem - Relationship payload to create.
+     * @returns Whether the create succeeded.
+     */
+    createRelationship: (relationshipItem: BaseItemRelationshipInfo, context?: TypeInfoORMContext) => Promise<boolean>;
+    /**
+     * Delete a relationship record.
+     *
+     * @param relationshipItem - Relationship payload to delete.
+     * @returns Results describing deletion outcome.
+     */
+    deleteRelationship: (relationshipItem: BaseItemRelationshipInfo, context?: TypeInfoORMContext) => Promise<DeleteRelationshipResults>;
+    /**
+     * List relationships matching the query.
+     *
+     * @param config - Relationship list configuration.
+     * @returns Relationship list results.
+     */
+    listRelationships: (config: ListRelationshipsConfig, context?: TypeInfoORMContext) => Promise<ListItemsResults<ItemRelationshipInfo>>;
+    /**
+     * List related items for a relationship query.
+     *
+     * @param config - Relationship list configuration.
+     * @param selectedFields - Optional fields to project.
+     * @returns Related item list results.
+     */
+    listRelatedItems: (config: ListRelationshipsConfig, selectedFields?: (keyof TypeInfoDataItem)[], context?: TypeInfoORMContext) => Promise<ListItemsResults<Partial<TypeInfoDataItem>>>;
+    /**
+     * Create an item.
+     *
+     * @param typeName - Type name to create.
+     * @param item - Item payload to create.
+     * @returns The created item result.
+     */
+    create: (typeName: string, item: TypeInfoDataItem) => Promise<any>;
+    /**
+     * Read an item by primary field value.
+     *
+     * @param typeName - Type name to read.
+     * @param primaryFieldValue - Primary field value to lookup.
+     * @param selectedFields - Optional fields to project.
+     * @returns Retrieved item data.
+     */
+    read: (typeName: string, primaryFieldValue: any, selectedFields?: (keyof TypeInfoDataItem)[], context?: TypeInfoORMContext) => Promise<Partial<TypeInfoDataItem>>;
+    /**
+     * Update an item.
+     *
+     * @param typeName - Type name to update.
+     * @param item - Updated item payload.
+     * @returns Whether the update succeeded.
+     */
+    update: (typeName: string, item: TypeInfoDataItem, context?: TypeInfoORMContext) => Promise<boolean>;
+    /**
+     * Delete an item by primary field value.
+     *
+     * @param typeName - Type name to delete.
+     * @param primaryFieldValue - Primary field value to delete.
+     * @returns Whether the delete succeeded.
+     */
+    delete: (typeName: string, primaryFieldValue: any, context?: TypeInfoORMContext) => Promise<boolean>;
+    /**
+     * List items matching the configuration.
+     *
+     * @param typeName - Type name to list.
+     * @param config - List configuration.
+     * @param selectedFields - Optional fields to project.
+     * @returns List results.
+     */
+    list: (typeName: string, config: ListItemsConfig, selectedFields?: (keyof TypeInfoDataItem)[], context?: TypeInfoORMContext) => Promise<ListItemsResults<Partial<TypeInfoDataItem>>>;
+};
+/**
+ * Client-safe TypeInfoORM API shape derived from {@link TypeInfoORMAPI}.
+ *
+ * This type is intentionally explicit and does not include any
+ * `context?: TypeInfoORMContext` arguments so app-side callers cannot pass
+ * server DAC context.
+ */
+export type TypeInfoORMClientAPI = {
+    /**
+     * Create a relationship record.
+     *
+     * @param relationshipItem - Relationship payload to create.
+     * @returns Whether the create succeeded.
+     */
+    createRelationship: (relationshipItem: BaseItemRelationshipInfo) => Promise<boolean>;
+    /**
+     * Delete a relationship record.
+     *
+     * @param relationshipItem - Relationship payload to delete.
+     * @returns Results describing deletion outcome.
+     */
+    deleteRelationship: (relationshipItem: BaseItemRelationshipInfo) => Promise<DeleteRelationshipResults>;
+    /**
+     * List relationships matching the query.
+     *
+     * @param config - Relationship list configuration.
+     * @returns Relationship list results.
+     */
+    listRelationships: (config: ListRelationshipsConfig) => Promise<ListItemsResults<ItemRelationshipInfo>>;
+    /**
+     * List related items for a relationship query.
+     *
+     * @param config - Relationship list configuration.
+     * @param selectedFields - Optional fields to project.
+     * @returns Related item list results.
+     */
+    listRelatedItems: (config: ListRelationshipsConfig, selectedFields?: (keyof TypeInfoDataItem)[]) => Promise<ListItemsResults<Partial<TypeInfoDataItem>>>;
+    /**
+     * Create an item.
+     *
+     * @param typeName - Type name to create.
+     * @param item - Item payload to create.
+     * @returns The created item result.
+     */
+    create: (typeName: string, item: TypeInfoDataItem) => Promise<any>;
+    /**
+     * Read an item by primary field value.
+     *
+     * @param typeName - Type name to read.
+     * @param primaryFieldValue - Primary field value to lookup.
+     * @param selectedFields - Optional fields to project.
+     * @returns Retrieved item data.
+     */
+    read: (typeName: string, primaryFieldValue: any, selectedFields?: (keyof TypeInfoDataItem)[]) => Promise<Partial<TypeInfoDataItem>>;
+    /**
+     * Update an item.
+     *
+     * @param typeName - Type name to update.
+     * @param item - Updated item payload.
+     * @returns Whether the update succeeded.
+     */
+    update: (typeName: string, item: TypeInfoDataItem) => Promise<boolean>;
+    /**
+     * Delete an item by primary field value.
+     *
+     * @param typeName - Type name to delete.
+     * @param primaryFieldValue - Primary field value to delete.
+     * @returns Whether the delete succeeded.
+     */
+    delete: (typeName: string, primaryFieldValue: any) => Promise<boolean>;
+    /**
+     * List items matching the configuration.
+     *
+     * @param typeName - Type name to list.
+     * @param config - List configuration.
+     * @param selectedFields - Optional fields to project.
+     * @returns List results.
+     */
+    list: (typeName: string, config: ListItemsConfig, selectedFields?: (keyof TypeInfoDataItem)[]) => Promise<ListItemsResults<Partial<TypeInfoDataItem>>>;
+};

package/common/TypeParsing/Constants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Built-in type names used when parsing TypeInfo.
+ * */
+export declare const BUILTIN_TYPE_NAMES: string[];

package/{src/common → common}/TypeParsing/ParsingUtils/Constants.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Field filter tags used when parsing TypeInfo types.
+ * */
 export declare const FIELD_FILTERS: {
     OMIT: string;
     PICK: string;

package/{src/common → common}/TypeParsing/ParsingUtils/checkType.d.ts

@@ -1,5 +1,11 @@
 import { TypeNode } from "typescript";
 import { LiteralValue, TypeKeyword } from "../TypeInfo";
+/**
+ * Inspect a TypeScript type node to determine type metadata.
+ *
+ * @param node - AST type node to inspect.
+ * @returns Type metadata including reference, array, keyword, and options.
+ */
 export declare const checkType: (node: TypeNode) => {
     typeReference?: string | undefined;
     isArray?: boolean;

package/{src/common → common}/TypeParsing/ParsingUtils/checkUnionType.d.ts

@@ -1,5 +1,11 @@
 import { UnionTypeNode } from "typescript";
 import { LiteralValue, TypeKeyword } from "../TypeInfo";
+/**
+ * Determine literal options and base type keyword for a union type.
+ *
+ * @param unionType - Union type node to inspect.
+ * @returns Literal options and inferred type keyword.
+ */
 export declare const checkUnionType: (unionType: UnionTypeNode) => {
     options: LiteralValue[] | undefined;
     typeKeyword: TypeKeyword;

package/common/TypeParsing/ParsingUtils/extractCommentTags.d.ts

@@ -0,0 +1,8 @@
+import { Node } from "typescript";
+/**
+ * Extract structured comment tags from a TypeScript node's JSDoc.
+ *
+ * @param node - AST node to read JSDoc tags from.
+ * @returns Nested object of tag values keyed by tag name paths.
+ */
+export declare const extractCommentTags: (node: Node) => Record<any, any>;

package/common/TypeParsing/ParsingUtils/extractLiteralValues.d.ts

@@ -0,0 +1,12 @@
+import { UnionTypeNode } from "typescript";
+import { LiteralValue, TypeKeyword } from "../TypeInfo";
+/**
+ * Extract literal values and inferred keyword from a union of literals.
+ *
+ * @param node - Union type node containing literal members.
+ * @returns Literal values and detected type keyword, or undefined if mixed.
+ */
+export declare const extractLiteralValues: (node: UnionTypeNode) => {
+    values: LiteralValue[];
+    type: TypeKeyword;
+} | undefined;

package/common/TypeParsing/ParsingUtils/extractTypeDetails.d.ts

@@ -0,0 +1,14 @@
+import { TypeNode } from "typescript";
+import { LiteralValue, TypeKeyword } from "../TypeInfo";
+/**
+ * Extract TypeInfo field details from a type node.
+ *
+ * @param type - Type node to inspect.
+ * @returns Type details including keyword, reference, array flag, and options.
+ */
+export declare const extractTypeDetails: (type: TypeNode) => {
+    type: TypeKeyword;
+    typeReference?: string;
+    array: boolean;
+    options?: LiteralValue[];
+};

package/common/TypeParsing/ParsingUtils/getPrimaryFieldForTypeInfo.d.ts

@@ -0,0 +1,18 @@
+import { TypeInfo } from "../TypeInfo";
+/**
+ * Errors raised while resolving primary fields.
+ */
+export declare enum TypeInfoPrimaryFieldErrors {
+    /**
+     * Primary field cannot be read due to denied operations.
+     * */
+    READ_DENIED_PRIMARY_FIELD_NOT_SUPPORTED = "READ_DENIED_PRIMARY_FIELD_NOT_SUPPORTED"
+}
+/**
+ * Resolve the primary field name for a TypeInfo definition.
+ *
+ * @param typeInfo - TypeInfo definition to inspect.
+ * @returns Primary field name, if available.
+ * @throws Error when the primary field is read-denied.
+ */
+export declare const getPrimaryFieldForTypeInfo: (typeInfo: TypeInfo) => string | undefined;

package/common/TypeParsing/ParsingUtils/getTypeInfo.d.ts

@@ -0,0 +1,9 @@
+import { TypeLiteralNode } from "typescript";
+import { TypeInfo } from "../TypeInfo";
+/**
+ * Build a TypeInfo definition from a type literal node.
+ *
+ * @param typeLiteral - Type literal node to inspect.
+ * @returns TypeInfo definition with fields and tags.
+ */
+export declare const getTypeInfo: (typeLiteral: TypeLiteralNode) => TypeInfo;

package/{src/common → common}/TypeParsing/ParsingUtils/getTypeInfoField.d.ts

@@ -1,3 +1,9 @@
 import { PropertySignature } from "typescript";
 import { TypeInfoField } from "../TypeInfo";
+/**
+ * Build TypeInfo field metadata from a property signature.
+ *
+ * @param propertySignature - Property signature node to inspect.
+ * @returns TypeInfo field metadata.
+ */
 export declare const getTypeInfoField: (propertySignature: PropertySignature) => TypeInfoField;

package/common/TypeParsing/ParsingUtils/getTypeInfoFromAliasType.d.ts

@@ -0,0 +1,11 @@
+import { TypeNode } from "typescript";
+import type { TypeMap } from "../../../build/TypeMapping";
+import { TypeInfo } from "../TypeInfo";
+/**
+ * Resolve TypeInfo for a type alias node based on its kind.
+ *
+ * @param type - Alias type node to inspect.
+ * @param typeMap - Map of available type aliases.
+ * @returns Resolved TypeInfo or undefined when unsupported.
+ */
+export declare const getTypeInfoFromAliasType: (type: TypeNode, typeMap: TypeMap) => TypeInfo | undefined;

package/common/TypeParsing/ParsingUtils/getTypeInfoFromFieldFilter.d.ts

@@ -0,0 +1,12 @@
+import { TypeReferenceNode } from "typescript";
+import type { TypeMap } from "../../../build/TypeMapping";
+import { TypeInfo } from "../TypeInfo";
+/**
+ * Resolve TypeInfo for field-filter helper types (Pick/Omit/Exclude).
+ *
+ * @param typeNameStr - Type name or filter identifier.
+ * @param typeRef - Type reference node with type arguments.
+ * @param typeMap - Map of available type aliases.
+ * @returns Filtered TypeInfo or undefined when not resolvable.
+ */
+export declare const getTypeInfoFromFieldFilter: (typeNameStr: string | undefined, typeRef: TypeReferenceNode, typeMap: TypeMap) => TypeInfo | undefined;

package/common/TypeParsing/ParsingUtils/getTypeInfoFromTypeAlias.d.ts

@@ -0,0 +1,11 @@
+import { TypeAliasDeclaration } from "typescript";
+import type { TypeMap } from "../../../build/TypeMapping";
+import { TypeInfo } from "../TypeInfo";
+/**
+ * Resolve TypeInfo for a type alias declaration.
+ *
+ * @param typeAliasDec - Type alias declaration node.
+ * @param typeMap - Map of available type aliases.
+ * @returns Resolved TypeInfo or undefined when unsupported.
+ */
+export declare const getTypeInfoFromTypeAlias: (typeAliasDec: TypeAliasDeclaration, typeMap: TypeMap) => TypeInfo | undefined;

package/common/TypeParsing/ParsingUtils/getTypeKeyword.d.ts

@@ -0,0 +1,9 @@
+import { TypeNode } from "typescript";
+import { TypeKeyword } from "../TypeInfo";
+/**
+ * Resolve a TypeScript type node into a TypeInfo keyword.
+ *
+ * @param node - Type node to inspect.
+ * @returns TypeInfo keyword (string, number, boolean).
+ */
+export declare const getTypeKeyword: (node: TypeNode) => TypeKeyword;