captify 0.1.15

package/dist/services/parts-ontology/interfaces/query-interfaces.interface.d.ts

@@ -0,0 +1,433 @@
+/**
+ * Parts Ontology - Query Interfaces
+ *
+ * Defines interfaces for common query operations, search criteria,
+ * and result structures for the parts ontology.
+ *
+ * Supports:
+ * - BOM explosion (recursive assembly breakdown)
+ * - Where-used queries (find all assemblies using a component)
+ * - Part search with filters
+ * - Lifecycle and supplier queries
+ *
+ * @module parts-ontology/interfaces/query-interfaces
+ */
+import type { Applicability, DocumentType, LifecycleState, Part, PartVersion, BomItem, Document, Supplier, SupplierPart, PartCategory, ChangeItem } from "./core-entities.interface";
+/**
+ * Generic paginated result wrapper
+ */
+export interface PaginatedResult<T> {
+    /** Result items for current page */
+    items: T[];
+    /** Total count of items (if available) */
+    totalCount?: number;
+    /** Current page number (1-indexed) */
+    page: number;
+    /** Page size */
+    pageSize: number;
+    /** Whether there are more pages */
+    hasMore: boolean;
+    /** Cursor for next page (if using cursor-based pagination) */
+    nextCursor?: string;
+}
+/**
+ * Generic search criteria base
+ */
+export interface SearchCriteria {
+    /** Search query string */
+    query?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Page size (default 50) */
+    pageSize?: number;
+    /** Sort field */
+    sortBy?: string;
+    /** Sort direction */
+    sortOrder?: "asc" | "desc";
+    /** Cursor for pagination (alternative to page number) */
+    cursor?: string;
+}
+/**
+ * Part search criteria
+ */
+export interface PartSearchCriteria extends SearchCriteria {
+    /** Filter by part number (exact or pattern) */
+    partNumber?: string;
+    /** Filter by name (contains) */
+    name?: string;
+    /** Filter by description (contains) */
+    description?: string;
+    /** Filter by category IDs */
+    categoryIds?: string[];
+    /** Filter by lifecycle states */
+    lifecycleStates?: LifecycleState[];
+    /** Filter by assembly flag */
+    isAssembly?: boolean;
+    /** Filter by tag IDs */
+    tagIds?: string[];
+    /** Filter by custom attributes */
+    customAttributes?: Record<string, unknown>;
+    /** Full-text search across multiple fields */
+    fullTextSearch?: string;
+}
+/**
+ * BOM explosion options
+ */
+export interface BomExplosionOptions {
+    /** Part number of the assembly to explode */
+    partNumber: string;
+    /** Optional specific version ID */
+    versionId?: string;
+    /** Maximum depth to traverse (-1 for unlimited) */
+    maxDepth?: number;
+    /** Whether to include quantities (accumulated from parent) */
+    includeQuantities?: boolean;
+    /** Whether to include BOM item metadata */
+    includeMetadata?: boolean;
+    /** Filter by applicability */
+    applicability?: Partial<Applicability>;
+    /** Whether to resolve alternates */
+    resolveAlternates?: boolean;
+}
+/**
+ * BOM explosion result - single item in the exploded tree
+ */
+export interface BomExplosionItem {
+    /** Level in hierarchy (0 = root) */
+    level: number;
+    /** Path from root (array of part numbers) */
+    path: string[];
+    /** Part information */
+    part: Part;
+    /** Version information (if version-specific) */
+    version?: PartVersion;
+    /** BOM item information */
+    bomItem: BomItem;
+    /** Accumulated quantity from root */
+    accumulatedQuantity: number;
+    /** Direct children (if not leaf) */
+    children?: BomExplosionItem[];
+}
+/**
+ * BOM explosion result
+ */
+export interface BomExplosionResult {
+    /** Root part */
+    rootPart: Part;
+    /** Root version (if version-specific) */
+    rootVersion?: PartVersion;
+    /** Flattened list of all items */
+    items: BomExplosionItem[];
+    /** Total number of unique parts */
+    uniquePartCount: number;
+    /** Maximum depth reached */
+    maxDepth: number;
+    /** Whether the explosion was truncated due to depth limit */
+    wasTruncated: boolean;
+}
+/**
+ * Where-used query options
+ */
+export interface WhereUsedOptions {
+    /** Part number to find usage of */
+    partNumber: string;
+    /** Optional specific version ID */
+    versionId?: string;
+    /** Maximum levels to traverse up (-1 for unlimited) */
+    maxLevels?: number;
+    /** Whether to include indirect usage (parent's parents) */
+    includeIndirect?: boolean;
+    /** Filter by lifecycle states of parent parts */
+    lifecycleStates?: LifecycleState[];
+}
+/**
+ * Where-used result - single usage record
+ */
+export interface WhereUsedItem {
+    /** Level in hierarchy (0 = direct parent) */
+    level: number;
+    /** Path to top-level assembly */
+    path: string[];
+    /** Parent part using this component */
+    parentPart: Part;
+    /** Parent version (if version-specific) */
+    parentVersion?: PartVersion;
+    /** BOM item details */
+    bomItem: BomItem;
+    /** Whether this is direct or indirect usage */
+    isDirect: boolean;
+}
+/**
+ * Where-used result
+ */
+export interface WhereUsedResult {
+    /** Component part being queried */
+    componentPart: Part;
+    /** Component version (if version-specific) */
+    componentVersion?: PartVersion;
+    /** List of all usages */
+    usages: WhereUsedItem[];
+    /** Number of direct parent assemblies */
+    directParentCount: number;
+    /** Total number of assemblies (including indirect) */
+    totalParentCount: number;
+}
+/**
+ * Part version history query options
+ */
+export interface VersionHistoryOptions {
+    /** Part number */
+    partNumber: string;
+    /** Whether to include supersession chain */
+    includeSupersessionChain?: boolean;
+    /** Filter by lifecycle states */
+    lifecycleStates?: LifecycleState[];
+}
+/**
+ * Part version history result
+ */
+export interface VersionHistoryResult {
+    /** Part information */
+    part: Part;
+    /** All versions ordered by effectiveDate */
+    versions: PartVersion[];
+    /** Current/active version */
+    currentVersion?: PartVersion;
+    /** Supersession chain (oldest to newest) */
+    supersessionChain?: PartVersion[];
+}
+/**
+ * Document search criteria
+ */
+export interface DocumentSearchCriteria extends SearchCriteria {
+    /** Filter by document types */
+    documentTypes?: DocumentType[];
+    /** Filter by part numbers */
+    partNumbers?: string[];
+    /** Filter by title (contains) */
+    title?: string;
+    /** Filter by format */
+    formats?: string[];
+    /** Filter by document number */
+    documentNumber?: string;
+}
+/**
+ * Supplier search criteria
+ */
+export interface SupplierSearchCriteria extends SearchCriteria {
+    /** Filter by supplier name (contains) */
+    name?: string;
+    /** Filter by supplier code */
+    code?: string;
+    /** Filter by supplier type */
+    supplierTypes?: string[];
+    /** Filter by active status */
+    isActive?: boolean;
+}
+/**
+ * Supplier parts query options
+ */
+export interface SupplierPartsOptions {
+    /** Supplier ID */
+    supplierId?: string;
+    /** Part number */
+    partNumber?: string;
+    /** Whether to include only preferred suppliers */
+    preferredOnly?: boolean;
+    /** Minimum order quantity filter */
+    maxMinOrderQuantity?: number;
+}
+/**
+ * Part with supplier information
+ */
+export interface PartWithSuppliers {
+    /** Part information */
+    part: Part;
+    /** Associated supplier parts */
+    supplierParts: Array<{
+        supplierPart: SupplierPart;
+        supplier: Supplier;
+    }>;
+    /** Preferred supplier (if any) */
+    preferredSupplier?: {
+        supplierPart: SupplierPart;
+        supplier: Supplier;
+    };
+}
+/**
+ * Change impact analysis options
+ */
+export interface ChangeImpactOptions {
+    /** Part numbers being changed */
+    partNumbers: string[];
+    /** Whether to include where-used impact */
+    includeWhereUsed?: boolean;
+    /** Whether to include document impact */
+    includeDocuments?: boolean;
+    /** Whether to include supplier impact */
+    includeSuppliers?: boolean;
+}
+/**
+ * Change impact analysis result
+ */
+export interface ChangeImpactResult {
+    /** Parts directly affected */
+    affectedParts: Part[];
+    /** Parent assemblies impacted (from where-used) */
+    impactedAssemblies?: WhereUsedItem[];
+    /** Documents that may need updates */
+    impactedDocuments?: Document[];
+    /** Supplier parts that may need updates */
+    impactedSupplierParts?: SupplierPart[];
+    /** Change items related to these parts */
+    relatedChanges?: ChangeItem[];
+    /** Total impact score (for prioritization) */
+    impactScore: number;
+}
+/**
+ * Part comparison options
+ */
+export interface PartComparisonOptions {
+    /** Part numbers to compare */
+    partNumbers: string[];
+    /** Specific version IDs to compare (optional) */
+    versionIds?: string[];
+    /** Fields to compare */
+    compareFields?: string[];
+}
+/**
+ * Part comparison result
+ */
+export interface PartComparisonResult {
+    /** Parts being compared */
+    parts: Part[];
+    /** Versions being compared (if specified) */
+    versions?: PartVersion[];
+    /** Field-by-field comparison */
+    differences: Array<{
+        field: string;
+        values: Record<string, unknown>;
+    }>;
+    /** Common attributes */
+    commonAttributes: Record<string, unknown>;
+}
+/**
+ * Category tree node for hierarchical display
+ */
+export interface CategoryTreeNode {
+    /** Category information */
+    category: PartCategory;
+    /** Child categories */
+    children: CategoryTreeNode[];
+    /** Number of parts in this category (direct) */
+    partCount: number;
+    /** Number of parts including subcategories */
+    totalPartCount: number;
+    /** Depth in tree (0 = root) */
+    depth: number;
+}
+/**
+ * Lifecycle transition validation result
+ */
+export interface LifecycleTransitionValidation {
+    /** Whether the transition is allowed */
+    isAllowed: boolean;
+    /** Current state */
+    currentState: LifecycleState;
+    /** Target state */
+    targetState: LifecycleState;
+    /** Validation messages */
+    messages: string[];
+    /** Warnings (non-blocking) */
+    warnings?: string[];
+    /** Business rules that apply */
+    applicableRules?: string[];
+}
+/**
+ * Bulk operation result
+ */
+export interface BulkOperationResult<T> {
+    /** Successfully processed items */
+    successful: T[];
+    /** Failed items with error messages */
+    failed: Array<{
+        item: T;
+        error: string;
+    }>;
+    /** Total count */
+    totalCount: number;
+    /** Success count */
+    successCount: number;
+    /** Failure count */
+    failureCount: number;
+}
+/**
+ * Part validation result
+ */
+export interface PartValidationResult {
+    /** Whether the part is valid */
+    isValid: boolean;
+    /** Validation errors (blocking) */
+    errors: ValidationMessage[];
+    /** Validation warnings (non-blocking) */
+    warnings: ValidationMessage[];
+    /** Validation info messages */
+    info: ValidationMessage[];
+}
+/**
+ * Validation message
+ */
+export interface ValidationMessage {
+    /** Field or rule that triggered this message */
+    field?: string;
+    /** Message text */
+    message: string;
+    /** Severity */
+    severity: "error" | "warning" | "info";
+    /** Error code for programmatic handling */
+    code?: string;
+}
+/**
+ * Part export options
+ */
+export interface PartExportOptions {
+    /** Part numbers to export */
+    partNumbers?: string[];
+    /** Export format */
+    format: "json" | "csv" | "xlsx" | "xml";
+    /** Whether to include BOMs */
+    includeBoms?: boolean;
+    /** Whether to include documents */
+    includeDocuments?: boolean;
+    /** Whether to include suppliers */
+    includeSuppliers?: boolean;
+    /** Whether to include version history */
+    includeVersions?: boolean;
+    /** Fields to include */
+    fields?: string[];
+}
+/**
+ * Part import result
+ */
+export interface PartImportResult {
+    /** Successfully imported parts */
+    importedParts: Part[];
+    /** Skipped parts (already exist) */
+    skippedParts: Array<{
+        partNumber: string;
+        reason: string;
+    }>;
+    /** Failed imports */
+    failedParts: Array<{
+        partNumber: string;
+        error: string;
+    }>;
+    /** Summary statistics */
+    summary: {
+        total: number;
+        imported: number;
+        skipped: number;
+        failed: number;
+    };
+}
+//# sourceMappingURL=query-interfaces.interface.d.ts.map

package/dist/services/parts-ontology/interfaces/query-interfaces.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-interfaces.interface.d.ts","sourceRoot":"","sources":["../../../../lib/services/parts-ontology/interfaces/query-interfaces.interface.ts"],"names":[],"mappings":"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"}

package/dist/services/parts-ontology/interfaces/query-interfaces.interface.js

@@ -0,0 +1,16 @@
+/**
+ * Parts Ontology - Query Interfaces
+ *
+ * Defines interfaces for common query operations, search criteria,
+ * and result structures for the parts ontology.
+ *
+ * Supports:
+ * - BOM explosion (recursive assembly breakdown)
+ * - Where-used queries (find all assemblies using a component)
+ * - Part search with filters
+ * - Lifecycle and supplier queries
+ *
+ * @module parts-ontology/interfaces/query-interfaces
+ */
+export {};
+//# sourceMappingURL=query-interfaces.interface.js.map

package/dist/services/parts-ontology/interfaces/query-interfaces.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-interfaces.interface.js","sourceRoot":"","sources":["../../../../lib/services/parts-ontology/interfaces/query-interfaces.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/services/parts-ontology/ontology/action-types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Parts Ontology - Action Types
+ *
+ * Following Palantir Foundry's ontology model, Action Types represent
+ * operations that can be performed on objects. Actions are the verbs/operations
+ * in your business domain.
+ *
+ * Actions can:
+ * - Modify objects (create, update, delete)
+ * - Create links between objects
+ * - Trigger workflows
+ * - Generate derived data
+ */
+import type { ObjectTypeName } from './object-types';
+import type { LinkTypeName } from './link-types';
+/**
+ * Parameter definition for actions
+ */
+export interface ActionParameterDefinition {
+    apiName: string;
+    displayName: string;
+    description?: string;
+    dataType: 'string' | 'number' | 'boolean' | 'timestamp' | 'object' | 'array';
+    required?: boolean;
+    defaultValue?: unknown;
+}
+/**
+ * Action effect describes what changes the action makes
+ */
+export interface ActionEffect {
+    type: 'CREATE_OBJECT' | 'MODIFY_OBJECT' | 'DELETE_OBJECT' | 'CREATE_LINK' | 'DELETE_LINK';
+    targetObjectType?: ObjectTypeName;
+    targetLinkType?: LinkTypeName;
+    description: string;
+}
+/**
+ * Action Type Definition
+ * Defines an operation that can be performed in the ontology
+ */
+export interface ActionTypeDefinition {
+    apiName: string;
+    displayName: string;
+    description: string;
+    icon?: string;
+    objectType?: ObjectTypeName;
+    parameters: ActionParameterDefinition[];
+    effects: ActionEffect[];
+    status?: 'ACTIVE' | 'EXPERIMENTAL' | 'DEPRECATED';
+}
+/**
+ * Action: Create Part
+ * Creates a new part in the system
+ */
+export declare const CreatePartAction: ActionTypeDefinition;
+/**
+ * Action: Update Part
+ * Updates an existing part's properties
+ */
+export declare const UpdatePartAction: ActionTypeDefinition;
+/**
+ * Action: Submit Part for Review
+ * Transitions a part from DRAFT to IN_REVIEW state
+ */
+export declare const SubmitPartForReviewAction: ActionTypeDefinition;
+/**
+ * Action: Approve Part
+ * Transitions a part from IN_REVIEW to RELEASED state
+ */
+export declare const ApprovePartAction: ActionTypeDefinition;
+/**
+ * Action: Deprecate Part
+ * Marks a part as deprecated (being phased out)
+ */
+export declare const DeprecatePartAction: ActionTypeDefinition;
+/**
+ * Action: Add BOM Item
+ * Adds a component to an assembly's BOM
+ */
+export declare const AddBomItemAction: ActionTypeDefinition;
+/**
+ * Action: Remove BOM Item
+ * Removes a component from an assembly's BOM
+ */
+export declare const RemoveBomItemAction: ActionTypeDefinition;
+/**
+ * Action: Link Part to Document
+ * Associates a document with a part
+ */
+export declare const LinkPartToDocumentAction: ActionTypeDefinition;
+/**
+ * Action: Link Part to Supplier
+ * Creates a sourcing relationship between part and supplier
+ */
+export declare const LinkPartToSupplierAction: ActionTypeDefinition;
+/**
+ * Action: Categorize Part
+ * Assigns a part to a category
+ */
+export declare const CategorizePartAction: ActionTypeDefinition;
+/**
+ * Action: Explode BOM
+ * Recursively expands an assembly to show all components
+ */
+export declare const ExplodeBomAction: ActionTypeDefinition;
+/**
+ * Action: Where-Used Query
+ * Finds all assemblies that use a specific part
+ */
+export declare const WhereUsedAction: ActionTypeDefinition;
+/**
+ * Registry of all action types in the ontology
+ */
+export declare const ActionTypeRegistry: {
+    readonly createPart: ActionTypeDefinition;
+    readonly updatePart: ActionTypeDefinition;
+    readonly submitPartForReview: ActionTypeDefinition;
+    readonly approvePart: ActionTypeDefinition;
+    readonly deprecatePart: ActionTypeDefinition;
+    readonly addBomItem: ActionTypeDefinition;
+    readonly removeBomItem: ActionTypeDefinition;
+    readonly explodeBom: ActionTypeDefinition;
+    readonly whereUsed: ActionTypeDefinition;
+    readonly linkPartToDocument: ActionTypeDefinition;
+    readonly linkPartToSupplier: ActionTypeDefinition;
+    readonly categorizePart: ActionTypeDefinition;
+};
+/**
+ * Type helper to extract action type names
+ */
+export type ActionTypeName = keyof typeof ActionTypeRegistry;
+/**
+ * Get action type definition by API name
+ */
+export declare function getActionType(apiName: ActionTypeName): ActionTypeDefinition;
+/**
+ * Get all action types
+ */
+export declare function getAllActionTypes(): ActionTypeDefinition[];
+/**
+ * Get action types for a specific object type
+ */
+export declare function getActionTypesForObject(objectType: ObjectTypeName): ActionTypeDefinition[];
+/**
+ * Validate if an action type exists
+ */
+export declare function isValidActionType(apiName: string): apiName is ActionTypeName;
+//# sourceMappingURL=action-types.d.ts.map

package/dist/services/parts-ontology/ontology/action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-types.d.ts","sourceRoot":"","sources":["../../../../lib/services/parts-ontology/ontology/action-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,eAAe,GAAG,aAAa,GAAG,aAAa,CAAC;IAC1F,gBAAgB,CAAC,EAAE,cAAc,CAAC;IAClC,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,YAAY,CAAC;CACnD;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAoD9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBA8B9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,oBA4BvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,oBA2B/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,oBAkCjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAuD9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,oBAgCjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBA2BtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBA2CtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,oBAiClC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAkC9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,oBA4B7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAkBrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE7D;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,oBAAoB,CAE3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,oBAAoB,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,cAAc,GAAG,oBAAoB,EAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,cAAc,CAE5E"}