gitx.do 0.0.1

package/dist/refs/tag.js

@@ -0,0 +1,188 @@
+/**
+ * Git Tag Operations
+ *
+ * Handles creation, deletion, and management of Git tags.
+ * Supports both lightweight tags (refs pointing to commits)
+ * and annotated tags (tag objects with metadata).
+ */
+/**
+ * Error thrown when a tag operation fails
+ */
+export class TagError extends Error {
+    code;
+    tagName;
+    constructor(message, code, tagName) {
+        super(message);
+        this.code = code;
+        this.tagName = tagName;
+        this.name = 'TagError';
+    }
+}
+/**
+ * Tag manager for handling Git tag operations
+ */
+export class TagManager {
+    constructor(refStorage, objectStorage, gpgSigner) {
+        void refStorage; // Suppress unused variable warning until implementation
+        void objectStorage;
+        void gpgSigner;
+        // TODO: Implement in GREEN phase
+    }
+    /**
+     * Create a new tag
+     */
+    async createTag(_name, _target, _options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Delete a tag
+     */
+    async deleteTag(_name, _options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * List all tags
+     */
+    async listTags(_options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get a tag by name
+     */
+    async getTag(_name, _options) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Check if a tag exists
+     */
+    async tagExists(_name) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get the target (commit SHA) that a tag points to
+     */
+    async getTagTarget(_name) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Verify a tag's GPG signature
+     */
+    async verifyTag(_name) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+    /**
+     * Check if a tag is annotated
+     */
+    async isAnnotatedTag(_name) {
+        // TODO: Implement in GREEN phase
+        throw new Error('Not implemented');
+    }
+}
+/**
+ * Validate a tag name according to Git rules
+ * Similar to ref name rules but with tag-specific constraints
+ */
+export function isValidTagName(_name) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Check if a string is a valid annotated tag (has tag object)
+ */
+export function isAnnotatedTag(_tag) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Format a tag message (handle line endings, etc.)
+ */
+export function formatTagMessage(_message) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Parse a tag message from raw content
+ */
+export function parseTagMessage(_content) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+// Convenience functions that wrap TagManager methods
+/**
+ * Create a lightweight tag pointing to a commit
+ */
+export async function createTag(_manager, _name, _target, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Create an annotated tag with message
+ */
+export async function createAnnotatedTag(_manager, _name, _target, _message, _tagger, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Delete a tag
+ */
+export async function deleteTag(_manager, _name, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * List all tags
+ */
+export async function listTags(_manager, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Get a tag by name
+ */
+export async function getTag(_manager, _name, _options) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Check if a tag is an annotated tag
+ */
+export async function checkIsAnnotatedTag(_manager, _name) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Verify a tag's signature
+ */
+export async function verifyTagSignature(_manager, _name) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Get the target commit SHA for a tag
+ */
+export async function getTagTarget(_manager, _name) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Sort tags by semantic version
+ */
+export function sortTagsByVersion(_tags, _direction = 'asc') {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+/**
+ * Filter tags by glob pattern
+ */
+export function filterTagsByPattern(_tags, _pattern) {
+    // TODO: Implement in GREEN phase
+    throw new Error('Not implemented');
+}
+//# sourceMappingURL=tag.js.map

package/dist/refs/tag.js.map

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

package/dist/storage/lru-cache.d.ts

@@ -0,0 +1,188 @@
+/**
+ * LRU Cache implementation for hot objects in gitdo
+ * gitdo-165: LRU cache for hot objects
+ */
+/**
+ * Configuration options for the LRU cache
+ */
+export interface CacheOptions {
+    /** Maximum number of items in the cache */
+    maxCount?: number;
+    /** Maximum size in bytes for the cache */
+    maxBytes?: number;
+    /** Default TTL in milliseconds for cache entries */
+    defaultTTL?: number;
+    /** Function to calculate size of a value in bytes */
+    sizeCalculator?: <T>(value: T) => number;
+    /** Callback when an item is evicted */
+    onEvict?: <K, V>(key: K, value: V, reason: EvictionReason) => void;
+}
+/**
+ * Reason why an item was evicted from the cache
+ */
+export type EvictionReason = 'lru' | 'ttl' | 'size' | 'manual' | 'clear';
+/**
+ * Statistics about cache performance
+ */
+export interface CacheStats {
+    /** Number of cache hits */
+    hits: number;
+    /** Number of cache misses */
+    misses: number;
+    /** Current number of items in the cache */
+    count: number;
+    /** Current size in bytes */
+    bytes: number;
+    /** Number of evictions */
+    evictions: number;
+    /** Hit rate as a percentage (0-100) */
+    hitRate: number;
+}
+/**
+ * Entry stored in the cache
+ */
+export interface CacheEntry<V> {
+    value: V;
+    size: number;
+    createdAt: number;
+    expiresAt: number | null;
+    lastAccessed: number;
+}
+/**
+ * Options for setting a cache entry
+ */
+export interface SetOptions {
+    /** TTL in milliseconds for this specific entry */
+    ttl?: number;
+    /** Size in bytes (overrides sizeCalculator) */
+    size?: number;
+}
+/**
+ * LRU Cache class for storing hot objects with size and count limits
+ */
+export declare class LRUCache<K = string, V = unknown> {
+    private cache;
+    private head;
+    private tail;
+    private _bytes;
+    private _hits;
+    private _misses;
+    private _evictions;
+    private maxCount;
+    private maxBytes;
+    private defaultTTL;
+    private sizeCalculator;
+    private onEvict?;
+    /**
+     * Create a new LRU cache
+     * @param options Configuration options
+     */
+    constructor(options?: CacheOptions);
+    /**
+     * Check if an entry is expired
+     */
+    private isExpired;
+    /**
+     * Move a node to the head (most recently used)
+     */
+    private moveToHead;
+    /**
+     * Remove a node from the linked list
+     */
+    private removeNode;
+    /**
+     * Add a node to the head of the list
+     */
+    private addToHead;
+    /**
+     * Evict items until we're under limits
+     */
+    private evictToFit;
+    /**
+     * Get a value from the cache
+     * @param key The cache key
+     * @returns The cached value or undefined if not found/expired
+     */
+    get(key: K): V | undefined;
+    /**
+     * Set a value in the cache
+     * @param key The cache key
+     * @param value The value to cache
+     * @param options Optional settings for this entry
+     * @returns true if successfully set, false otherwise
+     */
+    set(key: K, value: V, options?: SetOptions): boolean;
+    /**
+     * Check if a key exists in the cache (without updating LRU order)
+     * @param key The cache key
+     * @returns true if the key exists and is not expired
+     */
+    has(key: K): boolean;
+    /**
+     * Delete a key from the cache
+     * @param key The cache key
+     * @returns true if the key was deleted, false if it didn't exist
+     */
+    delete(key: K): boolean;
+    /**
+     * Clear all entries from the cache
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     * @returns Current cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset cache statistics (keeps cached data)
+     */
+    resetStats(): void;
+    /**
+     * Get the number of items currently in the cache
+     */
+    get size(): number;
+    /**
+     * Get the current byte size of the cache
+     */
+    get bytes(): number;
+    /**
+     * Get all keys in the cache (in LRU order, most recent first)
+     */
+    keys(): K[];
+    /**
+     * Get all values in the cache (in LRU order, most recent first)
+     */
+    values(): V[];
+    /**
+     * Get all entries in the cache (in LRU order, most recent first)
+     */
+    entries(): Array<[K, V]>;
+    /**
+     * Peek at a value without updating LRU order
+     * @param key The cache key
+     * @returns The cached value or undefined if not found/expired
+     */
+    peek(key: K): V | undefined;
+    /**
+     * Evict expired entries from the cache
+     * @returns Number of entries evicted
+     */
+    prune(): number;
+    /**
+     * Resize the cache to new limits
+     * @param options New size limits
+     */
+    resize(options: Pick<CacheOptions, 'maxCount' | 'maxBytes'>): void;
+}
+/**
+ * Create a key serializer for complex key types
+ */
+export declare function createKeySerializer<K>(serialize: (key: K) => string, deserialize: (str: string) => K): {
+    serialize: (key: K) => string;
+    deserialize: (str: string) => K;
+};
+/**
+ * Default size calculator for common value types
+ */
+export declare function defaultSizeCalculator<T>(value: T): number;
+//# sourceMappingURL=lru-cache.d.ts.map

package/dist/storage/lru-cache.d.ts.map

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