opencode-snippets 1.4.2 → 1.4.3

package/dist/src/expander.d.ts

@@ -0,0 +1,36 @@
+import type { ExpansionResult, ParsedSnippetContent, SnippetRegistry } from "./types.js";
+/**
+ * Parses snippet content to extract inline text and prepend/append blocks
+ *
+ * Uses a lenient stack-based parser:
+ * - Unclosed tags → treat rest of content as block
+ * - Nesting → log error, return null (skip expansion)
+ * - Multiple blocks → collected in document order
+ *
+ * @param content - The raw snippet content to parse
+ * @returns Parsed content with inline, prepend, and append parts, or null on error
+ */
+export declare function parseSnippetBlocks(content: string): ParsedSnippetContent | null;
+/**
+ * Expands hashtags in text recursively with loop detection
+ *
+ * Returns an ExpansionResult containing the inline-expanded text plus
+ * collected prepend/append blocks from all expanded snippets.
+ *
+ * @param text - The text containing hashtags to expand
+ * @param registry - The snippet registry to look up hashtags
+ * @param expansionCounts - Map tracking how many times each snippet has been expanded
+ * @returns ExpansionResult with text and collected blocks
+ */
+export declare function expandHashtags(text: string, registry: SnippetRegistry, expansionCounts?: Map<string, number>): ExpansionResult;
+/**
+ * Assembles the final message from an expansion result
+ *
+ * Joins: prepend blocks + inline text + append blocks
+ * with double newlines between non-empty sections.
+ *
+ * @param result - The expansion result to assemble
+ * @returns The final assembled message
+ */
+export declare function assembleMessage(result: ExpansionResult): string;
+//# sourceMappingURL=expander.d.ts.map

package/dist/src/expander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expander.d.ts","sourceRoot":"","sources":["../../src/expander.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAYzF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CA4E/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,eAAe,EACzB,eAAe,sBAA4B,GAC1C,eAAe,CA4EjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAmB/D"}

package/dist/src/expander.js

@@ -0,0 +1,187 @@
+import { PATTERNS } from "./constants.js";
+import { logger } from "./logger.js";
+/**
+ * Maximum number of times a snippet can be expanded to prevent infinite loops
+ */
+const MAX_EXPANSION_COUNT = 15;
+/**
+ * Parses snippet content to extract inline text and prepend/append blocks
+ *
+ * Uses a lenient stack-based parser:
+ * - Unclosed tags → treat rest of content as block
+ * - Nesting → log error, return null (skip expansion)
+ * - Multiple blocks → collected in document order
+ *
+ * @param content - The raw snippet content to parse
+ * @returns Parsed content with inline, prepend, and append parts, or null on error
+ */
+export function parseSnippetBlocks(content) {
+    const prepend = [];
+    const append = [];
+    let inline = "";
+    // Regex to find opening and closing tags
+    const tagPattern = /<(\/?)(?<tagName>prepend|append)>/gi;
+    let lastIndex = 0;
+    let currentBlock = null;
+    let match = tagPattern.exec(content);
+    while (match !== null) {
+        const isClosing = match[1] === "/";
+        const tagName = match.groups?.tagName?.toLowerCase();
+        const tagStart = match.index;
+        const tagEnd = tagStart + match[0].length;
+        if (isClosing) {
+            // Closing tag
+            if (currentBlock === null) {
+                // Closing tag without opening - ignore it, treat as inline content
+                continue;
+            }
+            if (currentBlock.type !== tagName) {
+                // Mismatched closing tag - this is a nesting error
+                logger.warn(`Mismatched closing tag: expected </${currentBlock.type}>, found </${tagName}>`);
+                return null;
+            }
+            // Extract block content
+            const blockContent = content.slice(currentBlock.contentStart, tagStart).trim();
+            if (blockContent) {
+                if (currentBlock.type === "prepend") {
+                    prepend.push(blockContent);
+                }
+                else {
+                    append.push(blockContent);
+                }
+            }
+            lastIndex = tagEnd;
+            currentBlock = null;
+        }
+        else {
+            // Opening tag
+            if (currentBlock !== null) {
+                // Nested opening tag - error
+                logger.warn(`Nested tags not allowed: found <${tagName}> inside <${currentBlock.type}>`);
+                return null;
+            }
+            // Add any inline content before this tag
+            const inlinePart = content.slice(lastIndex, tagStart);
+            inline += inlinePart;
+            currentBlock = { type: tagName, startIndex: tagStart, contentStart: tagEnd };
+        }
+        match = tagPattern.exec(content);
+    }
+    // Handle unclosed tag (lenient: treat rest as block content)
+    if (currentBlock !== null) {
+        const blockContent = content.slice(currentBlock.contentStart).trim();
+        if (blockContent) {
+            if (currentBlock.type === "prepend") {
+                prepend.push(blockContent);
+            }
+            else {
+                append.push(blockContent);
+            }
+        }
+    }
+    else {
+        // Add any remaining inline content
+        inline += content.slice(lastIndex);
+    }
+    return {
+        inline: inline.trim(),
+        prepend,
+        append,
+    };
+}
+/**
+ * Expands hashtags in text recursively with loop detection
+ *
+ * Returns an ExpansionResult containing the inline-expanded text plus
+ * collected prepend/append blocks from all expanded snippets.
+ *
+ * @param text - The text containing hashtags to expand
+ * @param registry - The snippet registry to look up hashtags
+ * @param expansionCounts - Map tracking how many times each snippet has been expanded
+ * @returns ExpansionResult with text and collected blocks
+ */
+export function expandHashtags(text, registry, expansionCounts = new Map()) {
+    const collectedPrepend = [];
+    const collectedAppend = [];
+    let expanded = text;
+    let hasChanges = true;
+    // Keep expanding until no more hashtags are found
+    while (hasChanges) {
+        const previous = expanded;
+        let loopDetected = false;
+        // Reset regex state (global flag requires this)
+        PATTERNS.HASHTAG.lastIndex = 0;
+        // We need to collect blocks during replacement, so we track them here
+        const roundPrepend = [];
+        const roundAppend = [];
+        expanded = expanded.replace(PATTERNS.HASHTAG, (match, name) => {
+            const key = name.toLowerCase();
+            const snippet = registry.get(key);
+            if (snippet === undefined) {
+                // Unknown snippet - leave as-is
+                return match;
+            }
+            // Track expansion count to prevent infinite loops
+            const count = (expansionCounts.get(key) || 0) + 1;
+            if (count > MAX_EXPANSION_COUNT) {
+                // Loop detected! Leave the hashtag as-is and stop expanding
+                logger.warn(`Loop detected: snippet '#${key}' expanded ${count} times (max: ${MAX_EXPANSION_COUNT})`);
+                loopDetected = true;
+                return match; // Leave as-is instead of error message
+            }
+            expansionCounts.set(key, count);
+            // Parse the snippet content for blocks
+            const parsed = parseSnippetBlocks(snippet.content);
+            if (parsed === null) {
+                // Parse error - leave hashtag unchanged
+                logger.warn(`Failed to parse snippet '${key}', leaving hashtag unchanged`);
+                return match;
+            }
+            // Collect prepend/append blocks
+            roundPrepend.push(...parsed.prepend);
+            roundAppend.push(...parsed.append);
+            // Recursively expand any hashtags in the inline content
+            const nestedResult = expandHashtags(parsed.inline, registry, expansionCounts);
+            // Collect blocks from nested expansion
+            roundPrepend.push(...nestedResult.prepend);
+            roundAppend.push(...nestedResult.append);
+            return nestedResult.text;
+        });
+        // Add this round's blocks to collected blocks
+        collectedPrepend.push(...roundPrepend);
+        collectedAppend.push(...roundAppend);
+        // Only continue if the text actually changed AND no loop was detected
+        hasChanges = expanded !== previous && !loopDetected;
+    }
+    return {
+        text: expanded,
+        prepend: collectedPrepend,
+        append: collectedAppend,
+    };
+}
+/**
+ * Assembles the final message from an expansion result
+ *
+ * Joins: prepend blocks + inline text + append blocks
+ * with double newlines between non-empty sections.
+ *
+ * @param result - The expansion result to assemble
+ * @returns The final assembled message
+ */
+export function assembleMessage(result) {
+    const parts = [];
+    // Add prepend blocks
+    if (result.prepend.length > 0) {
+        parts.push(result.prepend.join("\n\n"));
+    }
+    // Add main text
+    if (result.text.trim()) {
+        parts.push(result.text);
+    }
+    // Add append blocks
+    if (result.append.length > 0) {
+        parts.push(result.append.join("\n\n"));
+    }
+    return parts.join("\n\n");
+}
+//# sourceMappingURL=expander.js.map

package/dist/src/expander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expander.js","sourceRoot":"","sources":["../../src/expander.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;GAEG;AACH,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAO/B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,yCAAyC;IACzC,MAAM,UAAU,GAAG,qCAAqC,CAAC;IACzD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,YAAY,GAAyE,IAAI,CAAC;IAE9F,IAAI,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAe,CAAC;QAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;QAC7B,MAAM,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAE1C,IAAI,SAAS,EAAE,CAAC;YACd,cAAc;YACd,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,mEAAmE;gBACnE,SAAS;YACX,CAAC;YACD,IAAI,YAAY,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAClC,mDAAmD;gBACnD,MAAM,CAAC,IAAI,CACT,sCAAsC,YAAY,CAAC,IAAI,cAAc,OAAO,GAAG,CAChF,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,wBAAwB;YACxB,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/E,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,YAAY,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBACpC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YACD,SAAS,GAAG,MAAM,CAAC;YACnB,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,cAAc;YACd,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,6BAA6B;gBAC7B,MAAM,CAAC,IAAI,CAAC,mCAAmC,OAAO,aAAa,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;gBACzF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,yCAAyC;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACtD,MAAM,IAAI,UAAU,CAAC;YACrB,YAAY,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QAC/E,CAAC;QACD,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,6DAA6D;IAC7D,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;QACrE,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,YAAY,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,mCAAmC;QACnC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;QACrB,OAAO;QACP,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,QAAyB,EACzB,kBAAkB,IAAI,GAAG,EAAkB;IAE3C,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,UAAU,GAAG,IAAI,CAAC;IAEtB,kDAAkD;IAClD,OAAO,UAAU,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,QAAQ,CAAC;QAC1B,IAAI,YAAY,GAAG,KAAK,CAAC;QAEzB,gDAAgD;QAChD,QAAQ,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;QAE/B,sEAAsE;QACtE,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAE/B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,gCAAgC;gBAChC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,kDAAkD;YAClD,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,GAAG,mBAAmB,EAAE,CAAC;gBAChC,4DAA4D;gBAC5D,MAAM,CAAC,IAAI,CACT,4BAA4B,GAAG,cAAc,KAAK,gBAAgB,mBAAmB,GAAG,CACzF,CAAC;gBACF,YAAY,GAAG,IAAI,CAAC;gBACpB,OAAO,KAAK,CAAC,CAAC,uCAAuC;YACvD,CAAC;YAED,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAEhC,uCAAuC;YACvC,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,wCAAwC;gBACxC,MAAM,CAAC,IAAI,CAAC,4BAA4B,GAAG,8BAA8B,CAAC,CAAC;gBAC3E,OAAO,KAAK,CAAC;YACf,CAAC;YAED,gCAAgC;YAChC,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAEnC,wDAAwD;YACxD,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;YAE9E,uCAAuC;YACvC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YAC3C,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YAEzC,OAAO,YAAY,CAAC,IAAI,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,8CAA8C;QAC9C,gBAAgB,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QACvC,eAAe,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAErC,sEAAsE;QACtE,UAAU,GAAG,QAAQ,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC;IACtD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,gBAAgB;QACzB,MAAM,EAAE,eAAe;KACxB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,qBAAqB;IACrB,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,gBAAgB;IAChB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,oBAAoB;IACpB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/src/loader.d.ts

@@ -0,0 +1,46 @@
+import type { SnippetInfo, SnippetRegistry } from "./types.js";
+/**
+ * Loads all snippets from global and project directories
+ *
+ * @param projectDir - Optional project directory path (from ctx.directory)
+ * @param globalDir - Optional global snippets directory (for testing)
+ * @returns A map of snippet keys (lowercase) to their SnippetInfo
+ */
+export declare function loadSnippets(projectDir?: string, globalDir?: string): Promise<SnippetRegistry>;
+/**
+ * Lists all unique snippets (by name) from the registry
+ *
+ * @param registry - The snippet registry
+ * @returns Array of unique snippet info objects
+ */
+export declare function listSnippets(registry: SnippetRegistry): SnippetInfo[];
+/**
+ * Ensures the snippets directory exists
+ */
+export declare function ensureSnippetsDir(projectDir?: string): Promise<string>;
+/**
+ * Creates a new snippet file
+ *
+ * @param name - The snippet name (without extension)
+ * @param content - The snippet content
+ * @param options - Optional metadata (aliases, description)
+ * @param projectDir - If provided, creates in project directory; otherwise global
+ * @returns The path to the created snippet file
+ */
+export declare function createSnippet(name: string, content: string, options?: {
+    aliases?: string[];
+    description?: string;
+}, projectDir?: string): Promise<string>;
+/**
+ * Deletes a snippet file
+ *
+ * @param name - The snippet name (without extension)
+ * @param projectDir - If provided, looks in project directory first; otherwise global
+ * @returns The path of the deleted file, or null if not found
+ */
+export declare function deleteSnippet(name: string, projectDir?: string): Promise<string | null>;
+/**
+ * Reloads snippets into the registry from disk
+ */
+export declare function reloadSnippets(registry: SnippetRegistry, projectDir?: string): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/src/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAsB,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAc1B;AAqHD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,WAAW,EAAE,CAYrE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,EAC1D,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4B7F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,eAAe,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/src/loader.js

@@ -0,0 +1,223 @@
+import { mkdir, readdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import matter from "gray-matter";
+import { CONFIG, PATHS } from "./constants.js";
+import { logger } from "./logger.js";
+/**
+ * Loads all snippets from global and project directories
+ *
+ * @param projectDir - Optional project directory path (from ctx.directory)
+ * @param globalDir - Optional global snippets directory (for testing)
+ * @returns A map of snippet keys (lowercase) to their SnippetInfo
+ */
+export async function loadSnippets(projectDir, globalDir) {
+    const snippets = new Map();
+    // Load from global directory first (use provided or default)
+    const globalSnippetsDir = globalDir ?? PATHS.SNIPPETS_DIR;
+    await loadFromDirectory(globalSnippetsDir, snippets, "global");
+    // Load from project directory if provided (overrides global)
+    if (projectDir) {
+        const projectSnippetsDir = join(projectDir, ".opencode", "snippet");
+        await loadFromDirectory(projectSnippetsDir, snippets, "project");
+    }
+    return snippets;
+}
+/**
+ * Loads snippets from a specific directory
+ *
+ * @param dir - Directory to load snippets from
+ * @param registry - Registry to populate
+ * @param source - Source label for logging
+ */
+async function loadFromDirectory(dir, registry, source) {
+    try {
+        const files = await readdir(dir);
+        for (const file of files) {
+            if (!file.endsWith(CONFIG.SNIPPET_EXTENSION))
+                continue;
+            const snippet = await loadSnippetFile(dir, file, source);
+            if (snippet) {
+                registerSnippet(registry, snippet);
+            }
+        }
+        logger.debug(`Loaded snippets from ${source} directory`, {
+            path: dir,
+            fileCount: files.length,
+        });
+    }
+    catch (error) {
+        // Snippets directory doesn't exist or can't be read - that's fine
+        logger.debug(`${source} snippets directory not found or unreadable`, {
+            path: dir,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+/**
+ * Loads and parses a single snippet file
+ *
+ * @param dir - Directory containing the snippet file
+ * @param filename - The filename to load (e.g., "my-snippet.md")
+ * @param source - Whether this is a global or project snippet
+ * @returns The parsed snippet info, or null if parsing failed
+ */
+async function loadSnippetFile(dir, filename, source) {
+    try {
+        const name = basename(filename, CONFIG.SNIPPET_EXTENSION);
+        const filePath = join(dir, filename);
+        const fileContent = await readFile(filePath, "utf-8");
+        const parsed = matter(fileContent);
+        const content = parsed.content.trim();
+        const frontmatter = parsed.data;
+        // Handle aliases: accept both 'aliases' (plural) and 'alias' (singular)
+        // Prefer 'aliases' if both are present
+        let aliases = [];
+        const aliasSource = frontmatter.aliases ?? frontmatter.alias;
+        if (aliasSource) {
+            if (Array.isArray(aliasSource)) {
+                aliases = aliasSource;
+            }
+            else {
+                aliases = [aliasSource];
+            }
+        }
+        return {
+            name,
+            content,
+            aliases,
+            description: frontmatter.description,
+            filePath,
+            source,
+        };
+    }
+    catch (error) {
+        // Failed to read or parse this snippet - skip it
+        logger.warn("Failed to load snippet file", {
+            filename,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return null;
+    }
+}
+/**
+ * Registers a snippet and its aliases in the registry
+ *
+ * @param registry - The registry to add the snippet to
+ * @param snippet - The snippet info to register
+ */
+function registerSnippet(registry, snippet) {
+    const key = snippet.name.toLowerCase();
+    // If snippet with same name exists, remove its old aliases first
+    const existing = registry.get(key);
+    if (existing) {
+        for (const alias of existing.aliases) {
+            registry.delete(alias.toLowerCase());
+        }
+    }
+    // Register the snippet under its name
+    registry.set(key, snippet);
+    // Register under all aliases (pointing to the same snippet info)
+    for (const alias of snippet.aliases) {
+        registry.set(alias.toLowerCase(), snippet);
+    }
+}
+/**
+ * Lists all unique snippets (by name) from the registry
+ *
+ * @param registry - The snippet registry
+ * @returns Array of unique snippet info objects
+ */
+export function listSnippets(registry) {
+    const seen = new Set();
+    const snippets = [];
+    for (const snippet of registry.values()) {
+        if (!seen.has(snippet.name)) {
+            seen.add(snippet.name);
+            snippets.push(snippet);
+        }
+    }
+    return snippets;
+}
+/**
+ * Ensures the snippets directory exists
+ */
+export async function ensureSnippetsDir(projectDir) {
+    const dir = projectDir ? join(projectDir, ".opencode", "snippet") : PATHS.SNIPPETS_DIR;
+    await mkdir(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Creates a new snippet file
+ *
+ * @param name - The snippet name (without extension)
+ * @param content - The snippet content
+ * @param options - Optional metadata (aliases, description)
+ * @param projectDir - If provided, creates in project directory; otherwise global
+ * @returns The path to the created snippet file
+ */
+export async function createSnippet(name, content, options = {}, projectDir) {
+    const dir = await ensureSnippetsDir(projectDir);
+    const filePath = join(dir, `${name}${CONFIG.SNIPPET_EXTENSION}`);
+    // Build frontmatter if we have metadata
+    const frontmatter = {};
+    if (options.aliases?.length) {
+        frontmatter.aliases = options.aliases;
+    }
+    if (options.description) {
+        frontmatter.description = options.description;
+    }
+    // Create file content with frontmatter if needed
+    let fileContent;
+    if (Object.keys(frontmatter).length > 0) {
+        fileContent = matter.stringify(content, frontmatter);
+    }
+    else {
+        fileContent = content;
+    }
+    await writeFile(filePath, fileContent, "utf-8");
+    logger.info("Created snippet", { name, path: filePath });
+    return filePath;
+}
+/**
+ * Deletes a snippet file
+ *
+ * @param name - The snippet name (without extension)
+ * @param projectDir - If provided, looks in project directory first; otherwise global
+ * @returns The path of the deleted file, or null if not found
+ */
+export async function deleteSnippet(name, projectDir) {
+    // Try project directory first if provided
+    if (projectDir) {
+        const projectPath = join(projectDir, ".opencode", "snippet", `${name}${CONFIG.SNIPPET_EXTENSION}`);
+        try {
+            await unlink(projectPath);
+            logger.info("Deleted project snippet", { name, path: projectPath });
+            return projectPath;
+        }
+        catch {
+            // Not found in project, try global
+        }
+    }
+    // Try global directory
+    const globalPath = join(PATHS.SNIPPETS_DIR, `${name}${CONFIG.SNIPPET_EXTENSION}`);
+    try {
+        await unlink(globalPath);
+        logger.info("Deleted global snippet", { name, path: globalPath });
+        return globalPath;
+    }
+    catch {
+        logger.warn("Snippet not found for deletion", { name });
+        return null;
+    }
+}
+/**
+ * Reloads snippets into the registry from disk
+ */
+export async function reloadSnippets(registry, projectDir) {
+    registry.clear();
+    const fresh = await loadSnippets(projectDir);
+    for (const [key, value] of fresh) {
+        registry.set(key, value);
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAmB,EACnB,SAAkB;IAElB,MAAM,QAAQ,GAAoB,IAAI,GAAG,EAAE,CAAC;IAE5C,6DAA6D;IAC7D,MAAM,iBAAiB,GAAG,SAAS,IAAI,KAAK,CAAC,YAAY,CAAC;IAC1D,MAAM,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/D,6DAA6D;IAC7D,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;QACpE,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAC9B,GAAW,EACX,QAAyB,EACzB,MAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC;gBAAE,SAAS;YAEvD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACzD,IAAI,OAAO,EAAE,CAAC;gBACZ,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,YAAY,EAAE;YACvD,IAAI,EAAE,GAAG;YACT,SAAS,EAAE,KAAK,CAAC,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kEAAkE;QAClE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,6CAA6C,EAAE;YACnE,IAAI,EAAE,GAAG;YACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,eAAe,CAC5B,GAAW,EACX,QAAgB,EAChB,MAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAEnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,IAA0B,CAAC;QAEtD,wEAAwE;QACxE,uCAAuC;QACvC,IAAI,OAAO,GAAa,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC;QAC7D,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,OAAO,GAAG,WAAW,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI;YACJ,OAAO;YACP,OAAO;YACP,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,QAAQ;YACR,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iDAAiD;QACjD,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACzC,QAAQ;YACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,QAAyB,EAAE,OAAoB;IACtE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAEvC,iEAAiE;IACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE3B,iEAAiE;IACjE,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAmB;IACzD,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IACvF,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,OAAe,EACf,UAAwD,EAAE,EAC1D,UAAmB;IAEnB,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEjE,wCAAwC;IACxC,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5B,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,WAAW,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAChD,CAAC;IAED,iDAAiD;IACjD,IAAI,WAAmB,CAAC;IACxB,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,MAAM,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEzD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,UAAmB;IACnE,0CAA0C;IAC1C,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,IAAI,CACtB,UAAU,EACV,WAAW,EACX,SAAS,EACT,GAAG,IAAI,GAAG,MAAM,CAAC,iBAAiB,EAAE,CACrC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACpE,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAClE,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAyB,EACzB,UAAmB;IAEnB,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1,15 @@
+export declare class Logger {
+    private logDir;
+    constructor(logDirOverride?: string);
+    get enabled(): boolean;
+    private ensureLogDir;
+    private formatData;
+    private getCallerFile;
+    private write;
+    info(message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAYA,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAS;gBAEX,cAAc,CAAC,EAAE,MAAM;IAInC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,KAAK;IAuBb,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKrD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAItD;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/src/logger.js

@@ -0,0 +1,107 @@
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import { PATHS } from "./constants.js";
+/**
+ * Check if debug logging is enabled via environment variable
+ */
+function isDebugEnabled() {
+    const value = process.env.DEBUG_SNIPPETS;
+    return value === "1" || value === "true";
+}
+export class Logger {
+    logDir;
+    constructor(logDirOverride) {
+        this.logDir = logDirOverride ?? join(PATHS.CONFIG_DIR, "logs", "snippets");
+    }
+    get enabled() {
+        return isDebugEnabled();
+    }
+    ensureLogDir() {
+        if (!existsSync(this.logDir)) {
+            mkdirSync(this.logDir, { recursive: true });
+        }
+    }
+    formatData(data) {
+        if (!data)
+            return "";
+        const parts = [];
+        for (const [key, value] of Object.entries(data)) {
+            if (value === undefined || value === null)
+                continue;
+            // Format arrays compactly
+            if (Array.isArray(value)) {
+                if (value.length === 0)
+                    continue;
+                parts.push(`${key}=[${value.slice(0, 3).join(",")}${value.length > 3 ? `...+${value.length - 3}` : ""}]`);
+            }
+            else if (typeof value === "object") {
+                const str = JSON.stringify(value);
+                if (str.length < 50) {
+                    parts.push(`${key}=${str}`);
+                }
+            }
+            else {
+                parts.push(`${key}=${value}`);
+            }
+        }
+        return parts.join(" ");
+    }
+    getCallerFile() {
+        const originalPrepareStackTrace = Error.prepareStackTrace;
+        try {
+            const err = new Error();
+            Error.prepareStackTrace = (_, stack) => stack;
+            const stack = err.stack;
+            Error.prepareStackTrace = originalPrepareStackTrace;
+            for (let i = 3; i < stack.length; i++) {
+                const filename = stack[i]?.getFileName();
+                if (filename && !filename.includes("logger.")) {
+                    const match = filename.match(/([^/\\]+)\.[tj]s$/);
+                    return match ? match[1] : "unknown";
+                }
+            }
+            return "unknown";
+        }
+        catch {
+            return "unknown";
+        }
+    }
+    write(level, component, message, data) {
+        if (!this.enabled)
+            return;
+        try {
+            this.ensureLogDir();
+            const timestamp = new Date().toISOString();
+            const dataStr = this.formatData(data);
+            const dailyLogDir = join(this.logDir, "daily");
+            if (!existsSync(dailyLogDir)) {
+                mkdirSync(dailyLogDir, { recursive: true });
+            }
+            const logLine = `${timestamp} ${level.padEnd(5)} ${component}: ${message}${dataStr ? ` | ${dataStr}` : ""}\n`;
+            const logFile = join(dailyLogDir, `${new Date().toISOString().split("T")[0]}.log`);
+            writeFileSync(logFile, logLine, { flag: "a" });
+        }
+        catch {
+            // Silent fail
+        }
+    }
+    info(message, data) {
+        const component = this.getCallerFile();
+        this.write("INFO", component, message, data);
+    }
+    debug(message, data) {
+        const component = this.getCallerFile();
+        this.write("DEBUG", component, message, data);
+    }
+    warn(message, data) {
+        const component = this.getCallerFile();
+        this.write("WARN", component, message, data);
+    }
+    error(message, data) {
+        const component = this.getCallerFile();
+        this.write("ERROR", component, message, data);
+    }
+}
+// Export singleton logger instance
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

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