@varity-labs/types 2.0.0-alpha.1

package/dist/storage.d.ts

@@ -0,0 +1,600 @@
+/**
+ * Varity Storage Types - Core Storage Infrastructure
+ *
+ * This module defines the complete type system for Varity's multi-backend storage architecture,
+ * supporting Filecoin/IPFS, S3-compatible, GCS-compatible, and multi-tier storage strategies.
+ *
+ * Part of Varity's 3-layer encrypted storage architecture:
+ * - Layer 1: Varity Internal (company docs, internal knowledge)
+ * - Layer 2: Industry RAG (shared industry knowledge)
+ * - Layer 3: Customer Data (private business data)
+ */
+/**
+ * Storage layer for Varity's 3-layer architecture
+ */
+export declare enum StorageLayer {
+    /** Varity company documents and internal knowledge */
+    VARITY_INTERNAL = "varity-internal",
+    /** Industry-specific RAG knowledge (shared across customers) */
+    INDUSTRY_RAG = "industry-rag",
+    /** Customer-specific private data */
+    CUSTOMER_DATA = "customer-data"
+}
+/**
+ * Storage backend types supported by Varity
+ */
+export declare enum StorageBackend {
+    /** Filecoin/IPFS via Pinata API (current default) */
+    FILECOIN_IPFS = "filecoin-ipfs",
+    /** Celestia Data Availability Layer */
+    CELESTIA = "celestia",
+    /** S3-compatible storage (MinIO, AWS S3, etc.) */
+    S3_COMPATIBLE = "s3-compatible",
+    /** Google Cloud Storage compatible */
+    GCS_COMPATIBLE = "gcs-compatible",
+    /** Multi-tier storage with automatic tiering */
+    MULTI_TIER = "multi-tier"
+}
+/**
+ * Storage tier for multi-tier architecture
+ * Balances access speed vs cost optimization
+ */
+export declare enum StorageTier {
+    /** Fast access, higher cost (IPFS pinned, in-memory cache) */
+    HOT = "hot",
+    /** Moderate access, moderate cost (standard storage) */
+    WARM = "warm",
+    /** Infrequent access, lower cost (archive storage) */
+    COLD = "cold",
+    /** Long-term archive, lowest cost (deep archive) */
+    GLACIER = "glacier"
+}
+/**
+ * Base storage adapter interface - ALL storage backends must implement this
+ *
+ * This interface ensures consistent behavior across all storage backends,
+ * whether Filecoin, S3, GCS, or multi-tier strategies.
+ */
+export interface IStorageAdapter {
+    /**
+     * Upload data to storage
+     * @param data - Data to upload (Buffer, string, Blob, or any binary data)
+     * @param options - Upload configuration options
+     * @returns Storage result with identifier and metadata
+     */
+    upload(data: any, options: UploadOptions): Promise<StorageResult>;
+    /**
+     * Download data from storage
+     * @param identifier - Storage identifier (CID, S3 key, etc.)
+     * @returns Downloaded data (Buffer, Blob, or binary data)
+     */
+    download(identifier: string): Promise<any>;
+    /**
+     * Delete data from storage
+     * @param identifier - Storage identifier to delete
+     */
+    delete(identifier: string): Promise<void>;
+    /**
+     * List stored objects matching criteria
+     * @param options - List filtering and pagination options
+     * @returns Array of storage items
+     */
+    list(options?: ListOptions): Promise<StorageItem[]>;
+    /**
+     * Check if object exists in storage
+     * @param identifier - Storage identifier to check
+     * @returns True if exists, false otherwise
+     */
+    exists(identifier: string): Promise<boolean>;
+    /**
+     * Get object metadata without downloading content
+     * @param identifier - Storage identifier
+     * @returns Object metadata
+     */
+    getMetadata(identifier: string): Promise<StorageMetadata>;
+    /**
+     * Get the storage backend type
+     */
+    getBackendType(): StorageBackend;
+}
+/**
+ * Upload options for storage operations
+ */
+export interface UploadOptions {
+    /** Storage layer (Varity Internal, Industry RAG, Customer Data) */
+    layer: StorageLayer;
+    /** Storage tier (hot, warm, cold, glacier) */
+    tier?: StorageTier;
+    /** Custom metadata to attach to object */
+    metadata?: Record<string, any>;
+    /** Pin to IPFS (for Filecoin backend) */
+    pin?: boolean;
+    /** Enable Lit Protocol encryption */
+    encrypt?: boolean;
+    /** Storage namespace (layer-specific prefix) */
+    namespace?: string;
+    /** Content type (MIME type) */
+    contentType?: string;
+    /** Cache control header */
+    cacheControl?: string;
+    /** ACL/permissions (backend-specific) */
+    acl?: string;
+    /** Tags for organization */
+    tags?: Record<string, string>;
+}
+/**
+ * Storage result returned after upload operation
+ */
+export interface StorageResult {
+    /** Primary identifier (CID for Filecoin, key for S3, etc.) */
+    identifier: string;
+    /** Gateway URL for accessing the content */
+    gatewayUrl: string;
+    /** Size in bytes */
+    size: number;
+    /** Content hash (SHA256 or backend-specific) */
+    hash: string;
+    /** Upload timestamp (Unix milliseconds) */
+    timestamp: number;
+    /** Storage backend used */
+    backend: StorageBackend;
+    /** Storage tier assigned */
+    tier?: StorageTier;
+    /** Storage layer used */
+    layer?: StorageLayer;
+    /** Encryption metadata (if encrypted) */
+    encryptionMetadata?: {
+        encrypted: boolean;
+        walletAddress?: string;
+        layer: StorageLayer;
+        algorithm?: string;
+    };
+    /** Additional backend-specific metadata */
+    backendMetadata?: Record<string, any>;
+}
+/**
+ * Storage item returned from list operations
+ */
+export interface StorageItem {
+    /** Storage identifier */
+    identifier: string;
+    /** Object key/name */
+    key: string;
+    /** Size in bytes */
+    size: number;
+    /** Last modified timestamp */
+    lastModified: Date;
+    /** ETag (if supported by backend) */
+    etag?: string;
+    /** Custom metadata */
+    metadata?: Record<string, any>;
+    /** Storage tier */
+    tier?: StorageTier;
+    /** Storage class (backend-specific) */
+    storageClass?: string;
+    /** Whether object is encrypted */
+    encrypted?: boolean;
+}
+/**
+ * List options for querying storage
+ */
+export interface ListOptions {
+    /** Prefix filter (e.g., 'varity-internal/', 'customer-123/') */
+    prefix?: string;
+    /** Delimiter for hierarchical listing */
+    delimiter?: string;
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Continuation token for pagination */
+    continuationToken?: string;
+    /** Filter by storage tier */
+    tier?: StorageTier;
+    /** Start after this key (for pagination) */
+    startAfter?: string;
+    /** Include metadata in results */
+    includeMetadata?: boolean;
+}
+/**
+ * Storage metadata for objects
+ */
+export interface StorageMetadata {
+    /** Storage identifier */
+    identifier: string;
+    /** Size in bytes */
+    size: number;
+    /** Content type */
+    contentType?: string;
+    /** Last modified timestamp */
+    lastModified: Date;
+    /** ETag */
+    etag?: string;
+    /** Custom metadata */
+    customMetadata?: Record<string, any>;
+    /** Storage tier */
+    tier?: StorageTier;
+    /** Storage layer */
+    layer?: StorageLayer;
+    /** Access statistics */
+    accessCount?: number;
+    /** Last accessed timestamp */
+    lastAccessed?: Date;
+    /** Whether object is encrypted */
+    encrypted?: boolean;
+    /** Cache control settings */
+    cacheControl?: string;
+}
+/**
+ * Multi-tier storage configuration
+ * Enables automatic cost optimization through intelligent tiering
+ */
+export interface MultiTierStorageConfig {
+    /** Hot tier configuration (fast access) */
+    hotTier: TierConfig;
+    /** Warm tier configuration (moderate access) */
+    warmTier?: TierConfig;
+    /** Cold tier configuration (infrequent access) */
+    coldTier: TierConfig;
+    /** Auto-tiering configuration */
+    autoTiering: AutoTieringConfig;
+}
+/**
+ * Configuration for a specific storage tier
+ */
+export interface TierConfig {
+    /** Storage backend to use */
+    backend: StorageBackend;
+    /** Replication factor */
+    replication: number;
+    /** Cost per GB per month (USD) */
+    costPerGB: number;
+    /** Expected access latency in milliseconds */
+    accessLatency: number;
+    /** Minimum object size for this tier */
+    minObjectSize?: number;
+    /** Maximum object size for this tier */
+    maxObjectSize?: number;
+}
+/**
+ * Auto-tiering configuration
+ */
+export interface AutoTieringConfig {
+    /** Enable automatic tiering */
+    enabled: boolean;
+    /** Tiering policy to use */
+    policy: TieringPolicy;
+    /** Check interval in hours */
+    checkInterval: number;
+    /** Tiering rules */
+    rules?: TieringRule[];
+}
+/**
+ * Tiering policies
+ */
+export declare enum TieringPolicy {
+    /** Based on object age */
+    TIME_BASED = "time-based",
+    /** Based on access frequency */
+    ACCESS_BASED = "access-based",
+    /** Based on object size */
+    SIZE_BASED = "size-based",
+    /** Cost optimization strategy */
+    COST_OPTIMIZED = "cost-optimized",
+    /** Custom policy */
+    CUSTOM = "custom"
+}
+/**
+ * Tiering rule for automatic tier transitions
+ */
+export interface TieringRule {
+    /** Rule name */
+    name: string;
+    /** Rule description */
+    description?: string;
+    /** Condition to trigger tiering */
+    condition: TieringCondition;
+    /** Action to take when condition is met */
+    action: TieringAction;
+    /** Rule priority (higher = evaluated first) */
+    priority?: number;
+    /** Whether rule is enabled */
+    enabled?: boolean;
+}
+/**
+ * Condition for tiering rule
+ */
+export interface TieringCondition {
+    /** Condition type */
+    type: 'age' | 'access_count' | 'size' | 'cost' | 'last_accessed';
+    /** Comparison operator */
+    operator: 'gt' | 'lt' | 'eq' | 'gte' | 'lte' | 'ne';
+    /** Comparison value */
+    value: number;
+    /** Unit for the value */
+    unit?: 'days' | 'mb' | 'gb' | 'usd' | 'accesses';
+}
+/**
+ * Action to take when tiering condition is met
+ */
+export interface TieringAction {
+    /** Target tier to move object to */
+    moveTo: StorageTier;
+    /** Send notification */
+    notify?: boolean;
+    /** Notification recipients */
+    notifyTo?: string[];
+    /** Delete object instead of moving */
+    delete?: boolean;
+}
+/**
+ * Access pattern analytics for cost optimization
+ */
+export interface AccessPattern {
+    /** Object identifier */
+    identifier: string;
+    /** Total access count */
+    accessCount: number;
+    /** Last accessed timestamp */
+    lastAccessed: Date;
+    /** Average interval between accesses (days) */
+    averageAccessInterval: number;
+    /** Total bandwidth consumed (bytes) */
+    totalBandwidth: number;
+    /** Current storage tier */
+    currentTier: StorageTier;
+    /** Recommended tier based on access pattern */
+    recommendedTier: StorageTier;
+    /** Estimated monthly cost savings if moved to recommended tier */
+    costSavingsEstimate: number;
+    /** Confidence score for recommendation (0-1) */
+    recommendationConfidence: number;
+}
+/**
+ * Storage usage statistics
+ */
+export interface StorageStats {
+    /** Total objects stored */
+    totalObjects: number;
+    /** Total size in bytes */
+    totalSize: number;
+    /** Breakdown by tier */
+    byTier: Record<StorageTier, TierStats>;
+    /** Breakdown by layer */
+    byLayer: Record<StorageLayer, LayerStats>;
+    /** Total monthly cost estimate */
+    monthlyCostEstimate: number;
+    /** Last updated timestamp */
+    lastUpdated: Date;
+}
+/**
+ * Statistics for a specific tier
+ */
+export interface TierStats {
+    /** Number of objects */
+    objectCount: number;
+    /** Total size in bytes */
+    totalSize: number;
+    /** Monthly cost */
+    monthlyCost: number;
+    /** Average object size */
+    avgObjectSize: number;
+}
+/**
+ * Statistics for a specific layer
+ */
+export interface LayerStats {
+    /** Number of objects */
+    objectCount: number;
+    /** Total size in bytes */
+    totalSize: number;
+    /** Percentage of total storage */
+    percentage: number;
+}
+/**
+ * Storage operation result with metrics
+ */
+export interface StorageOperationResult {
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Operation type */
+    operation: 'upload' | 'download' | 'delete' | 'list';
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Bytes transferred */
+    bytesTransferred: number;
+    /** Error message (if failed) */
+    error?: string;
+    /** Additional details */
+    details?: Record<string, any>;
+}
+/**
+ * Encryption options for storage operations
+ */
+export interface EncryptionOptions {
+    /** Enable encryption */
+    enabled: boolean;
+    /** Encryption algorithm */
+    algorithm?: 'aes-256-gcm' | 'aes-256-cbc';
+    /** Key derivation function */
+    keyDerivation?: 'pbkdf2' | 'scrypt';
+    /** Use Lit Protocol for access control */
+    litProtocol?: boolean;
+    /** Custom encryption key (base64) */
+    customKey?: string;
+}
+/**
+ * Encryption metadata stored with encrypted objects
+ */
+export interface EncryptionMetadata {
+    /** Whether object is encrypted */
+    encrypted: boolean;
+    /** Encryption algorithm used */
+    algorithm: string;
+    /** Wallet address used for encryption */
+    walletAddress: string;
+    /** Storage layer */
+    layer: StorageLayer;
+    /** Lit Protocol enabled */
+    litProtocolEnabled: boolean;
+    /** Key identifier (for Lit Protocol or KMS) */
+    keyId?: string;
+    /** Initialization vector (for some algorithms) */
+    iv?: string;
+    /** Authentication tag (for GCM mode) */
+    authTag?: string;
+}
+/**
+ * Comprehensive storage metrics and analytics
+ */
+export interface StorageMetrics {
+    /** Total storage size (bytes) */
+    totalSize: number;
+    /** Total object count */
+    objectCount: number;
+    /** Metrics by storage layer */
+    byLayer: Record<StorageLayer, LayerMetrics>;
+    /** Metrics by storage tier */
+    byTier: Record<StorageTier, TierMetrics>;
+    /** Metrics by backend */
+    byBackend: Record<StorageBackend, BackendMetrics>;
+    /** Cost breakdown */
+    costs: StorageCosts;
+    /** Last updated timestamp */
+    lastUpdated: Date;
+    /** Bandwidth usage (bytes) */
+    bandwidthUsage?: BandwidthMetrics;
+}
+/**
+ * Metrics for a specific storage layer
+ */
+export interface LayerMetrics {
+    /** Number of objects */
+    objectCount: number;
+    /** Total size (bytes) */
+    totalSize: number;
+    /** Last updated timestamp */
+    lastUpdated: Date;
+    /** Encrypted object count */
+    encryptedObjects?: number;
+    /** Average object size */
+    avgObjectSize?: number;
+}
+/**
+ * Metrics for a specific storage tier
+ */
+export interface TierMetrics {
+    /** Number of objects */
+    objectCount: number;
+    /** Total size (bytes) */
+    totalSize: number;
+    /** Average access time (milliseconds) */
+    averageAccessTime: number;
+    /** Cost per GB per month */
+    costPerGB: number;
+    /** Monthly cost estimate */
+    monthlyCost: number;
+    /** Average object size */
+    avgObjectSize: number;
+}
+/**
+ * Metrics for a specific storage backend
+ */
+export interface BackendMetrics {
+    /** Number of objects */
+    objectCount: number;
+    /** Total size (bytes) */
+    totalSize: number;
+    /** Backend availability (percentage 0-100) */
+    availability: number;
+    /** Latency metrics */
+    latency: LatencyMetrics;
+    /** Request count */
+    requestCount?: number;
+    /** Error count */
+    errorCount?: number;
+    /** Last health check */
+    lastHealthCheck?: Date;
+}
+/**
+ * Latency metrics for a backend
+ */
+export interface LatencyMetrics {
+    /** 50th percentile latency (ms) */
+    p50: number;
+    /** 95th percentile latency (ms) */
+    p95: number;
+    /** 99th percentile latency (ms) */
+    p99: number;
+    /** Average latency (ms) */
+    avg: number;
+    /** Minimum latency (ms) */
+    min?: number;
+    /** Maximum latency (ms) */
+    max?: number;
+}
+/**
+ * Storage cost breakdown
+ */
+export interface StorageCosts {
+    /** Total monthly cost (USD) */
+    monthlyTotal: number;
+    /** Cost breakdown by category */
+    breakdown: {
+        /** Storage costs */
+        storage: number;
+        /** Bandwidth/egress costs */
+        bandwidth: number;
+        /** API operation costs */
+        operations: number;
+        /** Replication costs */
+        replication?: number;
+    };
+    /** Comparison to AWS S3 */
+    comparisonToAWS: CostComparison;
+    /** Comparison to Google Cloud Storage */
+    comparisonToGCP: CostComparison;
+    /** Monthly savings amount */
+    monthlySavings: number;
+    /** Savings percentage */
+    savingsPercent: number;
+}
+/**
+ * Cost comparison between platforms
+ */
+export interface CostComparison {
+    /** Source platform monthly cost */
+    sourceMonthlyCost: number;
+    /** Target platform monthly cost */
+    targetMonthlyCost: number;
+    /** Savings amount */
+    savingsAmount: number;
+    /** Savings percentage */
+    savingsPercent: number;
+    /** Storage cost breakdown */
+    storageCost: number;
+    /** Bandwidth cost breakdown */
+    bandwidthCost: number;
+    /** Operations cost breakdown */
+    operationsCost: number;
+}
+/**
+ * Bandwidth usage metrics
+ */
+export interface BandwidthMetrics {
+    /** Total upload bytes */
+    uploadBytes: number;
+    /** Total download bytes */
+    downloadBytes: number;
+    /** Upload requests count */
+    uploadRequests: number;
+    /** Download requests count */
+    downloadRequests: number;
+    /** Period start */
+    periodStart: Date;
+    /** Period end */
+    periodEnd: Date;
+    /** Average upload speed (bytes/sec) */
+    avgUploadSpeed?: number;
+    /** Average download speed (bytes/sec) */
+    avgDownloadSpeed?: number;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,oBAAY,YAAY;IACtB,sDAAsD;IACtD,eAAe,oBAAoB;IACnC,gEAAgE;IAChE,YAAY,iBAAiB;IAC7B,qCAAqC;IACrC,aAAa,kBAAkB;CAChC;AAMD;;GAEG;AACH,oBAAY,cAAc;IACxB,qDAAqD;IACrD,aAAa,kBAAkB;IAC/B,uCAAuC;IACvC,QAAQ,aAAa;IACrB,kDAAkD;IAClD,aAAa,kBAAkB;IAC/B,sCAAsC;IACtC,cAAc,mBAAmB;IACjC,gDAAgD;IAChD,UAAU,eAAe;CAC1B;AAED;;;GAGG;AACH,oBAAY,WAAW;IACrB,8DAA8D;IAC9D,GAAG,QAAQ;IACX,wDAAwD;IACxD,IAAI,SAAS;IACb,sDAAsD;IACtD,IAAI,SAAS;IACb,oDAAoD;IACpD,OAAO,YAAY;CACpB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAEjE;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAE1C;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzC;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAEnD;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE5C;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAEzD;;OAEG;IACH,cAAc,IAAI,cAAc,CAAA;CACjC;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,KAAK,EAAE,YAAY,CAAA;IAEnB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE9B,yCAAyC;IACzC,GAAG,CAAC,EAAE,OAAO,CAAA;IAEb,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAElB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAA;IAElB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IAEZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IAEZ,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAA;IAEjB,2BAA2B;IAC3B,OAAO,EAAE,cAAc,CAAA;IAEvB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB,yBAAyB;IACzB,KAAK,CAAC,EAAE,YAAY,CAAA;IAEpB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE;QACnB,SAAS,EAAE,OAAO,CAAA;QAClB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,KAAK,EAAE,YAAY,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;IAED,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAA;IAElB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAA;IAEX,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IAEZ,8BAA8B;IAC9B,YAAY,EAAE,IAAI,CAAA;IAElB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE9B,mBAAmB;IACnB,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,6BAA6B;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,kCAAkC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAA;IAElB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IAEZ,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,8BAA8B;IAC9B,YAAY,EAAE,IAAI,CAAA;IAElB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAEpC,mBAAmB;IACnB,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB,oBAAoB;IACpB,KAAK,CAAC,EAAE,YAAY,CAAA;IAEpB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,IAAI,CAAA;IAEnB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAMD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,OAAO,EAAE,UAAU,CAAA;IAEnB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,UAAU,CAAA;IAErB,kDAAkD;IAClD,QAAQ,EAAE,UAAU,CAAA;IAEpB,iCAAiC;IACjC,WAAW,EAAE,iBAAiB,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,OAAO,EAAE,cAAc,CAAA;IAEvB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IAEnB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IAEjB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAA;IAErB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAA;IAEhB,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAA;IAErB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAA;IAErB,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,0BAA0B;IAC1B,UAAU,eAAe;IACzB,gCAAgC;IAChC,YAAY,iBAAiB;IAC7B,2BAA2B;IAC3B,UAAU,eAAe;IACzB,iCAAiC;IACjC,cAAc,mBAAmB;IACjC,oBAAoB;IACpB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;IAEZ,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,mCAAmC;IACnC,SAAS,EAAE,gBAAgB,CAAA;IAE3B,2CAA2C;IAC3C,MAAM,EAAE,aAAa,CAAA;IAErB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,KAAK,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAA;IAEhE,0BAA0B;IAC1B,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAA;IAEnD,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;IAEb,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,CAAA;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAA;IAEnB,wBAAwB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAA;IAElB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IAEnB,8BAA8B;IAC9B,YAAY,EAAE,IAAI,CAAA;IAElB,+CAA+C;IAC/C,qBAAqB,EAAE,MAAM,CAAA;IAE7B,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAA;IAEtB,2BAA2B;IAC3B,WAAW,EAAE,WAAW,CAAA;IAExB,+CAA+C;IAC/C,eAAe,EAAE,WAAW,CAAA;IAE5B,kEAAkE;IAClE,mBAAmB,EAAE,MAAM,CAAA;IAE3B,gDAAgD;IAChD,wBAAwB,EAAE,MAAM,CAAA;CACjC;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAA;IAEpB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;IAEjB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAEtC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;IAEzC,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,CAAA;IAE3B,6BAA6B;IAC7B,WAAW,EAAE,IAAI,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IAEnB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;IAEjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAA;IAEnB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IAEnB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;IAEjB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAA;IAEhB,qBAAqB;IACrB,SAAS,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAA;IAEpD,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAA;IAElB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAA;IAExB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC9B;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAA;IAEhB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,aAAa,GAAG,aAAa,CAAA;IAEzC,8BAA8B;IAC9B,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAEnC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAA;IAErB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAA;IAElB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAA;IAErB,oBAAoB;IACpB,KAAK,EAAE,YAAY,CAAA;IAEnB,2BAA2B;IAC3B,kBAAkB,EAAE,OAAO,CAAA;IAE3B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAA;IAEjB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IAEnB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAE3C,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IAExC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;IAEjD,qBAAqB;IACrB,KAAK,EAAE,YAAY,CAAA;IAEnB,6BAA6B;IAC7B,WAAW,EAAE,IAAI,CAAA;IAEjB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,gBAAgB,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IAEnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IAEjB,6BAA6B;IAC7B,WAAW,EAAE,IAAI,CAAA;IAEjB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IAEnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IAEjB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAA;IAEzB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IAEjB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IAEnB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IAEnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IAEjB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAA;IAEpB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAA;IAEvB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,wBAAwB;IACxB,eAAe,CAAC,EAAE,IAAI,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAA;IAEX,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAA;IAEX,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAA;IAEX,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAA;IAEX,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAA;IAEpB,iCAAiC;IACjC,SAAS,EAAE;QACT,oBAAoB;QACpB,OAAO,EAAE,MAAM,CAAA;QACf,6BAA6B;QAC7B,SAAS,EAAE,MAAM,CAAA;QACjB,0BAA0B;QAC1B,UAAU,EAAE,MAAM,CAAA;QAClB,wBAAwB;QACxB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IAED,2BAA2B;IAC3B,eAAe,EAAE,cAAc,CAAA;IAE/B,yCAAyC;IACzC,eAAe,EAAE,cAAc,CAAA;IAE/B,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAA;IAEtB,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAA;IAEzB,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAA;IAEzB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAA;IAErB,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAA;IAEtB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAA;IAEnB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAA;IAErB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAA;IAEnB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAA;IAErB,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAA;IAEtB,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAA;IAExB,mBAAmB;IACnB,WAAW,EAAE,IAAI,CAAA;IAEjB,iBAAiB;IACjB,SAAS,EAAE,IAAI,CAAA;IAEf,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B"}

package/dist/storage.js

@@ -0,0 +1,75 @@
+/**
+ * Varity Storage Types - Core Storage Infrastructure
+ *
+ * This module defines the complete type system for Varity's multi-backend storage architecture,
+ * supporting Filecoin/IPFS, S3-compatible, GCS-compatible, and multi-tier storage strategies.
+ *
+ * Part of Varity's 3-layer encrypted storage architecture:
+ * - Layer 1: Varity Internal (company docs, internal knowledge)
+ * - Layer 2: Industry RAG (shared industry knowledge)
+ * - Layer 3: Customer Data (private business data)
+ */
+/**
+ * Storage layer for Varity's 3-layer architecture
+ */
+export var StorageLayer;
+(function (StorageLayer) {
+    /** Varity company documents and internal knowledge */
+    StorageLayer["VARITY_INTERNAL"] = "varity-internal";
+    /** Industry-specific RAG knowledge (shared across customers) */
+    StorageLayer["INDUSTRY_RAG"] = "industry-rag";
+    /** Customer-specific private data */
+    StorageLayer["CUSTOMER_DATA"] = "customer-data";
+})(StorageLayer || (StorageLayer = {}));
+// ============================================================================
+// Storage Backend Types
+// ============================================================================
+/**
+ * Storage backend types supported by Varity
+ */
+export var StorageBackend;
+(function (StorageBackend) {
+    /** Filecoin/IPFS via Pinata API (current default) */
+    StorageBackend["FILECOIN_IPFS"] = "filecoin-ipfs";
+    /** Celestia Data Availability Layer */
+    StorageBackend["CELESTIA"] = "celestia";
+    /** S3-compatible storage (MinIO, AWS S3, etc.) */
+    StorageBackend["S3_COMPATIBLE"] = "s3-compatible";
+    /** Google Cloud Storage compatible */
+    StorageBackend["GCS_COMPATIBLE"] = "gcs-compatible";
+    /** Multi-tier storage with automatic tiering */
+    StorageBackend["MULTI_TIER"] = "multi-tier";
+})(StorageBackend || (StorageBackend = {}));
+/**
+ * Storage tier for multi-tier architecture
+ * Balances access speed vs cost optimization
+ */
+export var StorageTier;
+(function (StorageTier) {
+    /** Fast access, higher cost (IPFS pinned, in-memory cache) */
+    StorageTier["HOT"] = "hot";
+    /** Moderate access, moderate cost (standard storage) */
+    StorageTier["WARM"] = "warm";
+    /** Infrequent access, lower cost (archive storage) */
+    StorageTier["COLD"] = "cold";
+    /** Long-term archive, lowest cost (deep archive) */
+    StorageTier["GLACIER"] = "glacier";
+})(StorageTier || (StorageTier = {}));
+/**
+ * Tiering policies
+ */
+export var TieringPolicy;
+(function (TieringPolicy) {
+    /** Based on object age */
+    TieringPolicy["TIME_BASED"] = "time-based";
+    /** Based on access frequency */
+    TieringPolicy["ACCESS_BASED"] = "access-based";
+    /** Based on object size */
+    TieringPolicy["SIZE_BASED"] = "size-based";
+    /** Cost optimization strategy */
+    TieringPolicy["COST_OPTIMIZED"] = "cost-optimized";
+    /** Custom policy */
+    TieringPolicy["CUSTOM"] = "custom";
+})(TieringPolicy || (TieringPolicy = {}));
+// NOTE: Types are declared above and exported via interface/enum declarations
+// No need for duplicate export statements at the end