@tigerdata/mcp-boilerplate 1.5.3 → 1.6.1

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export { Cache } from './cache.js';
 export { cliEntrypoint } from './cliEntrypoint.js';
 export { httpServerFactory } from './httpServer.js';
 export { log } from './logger.js';
@@ -6,5 +5,6 @@ export type { AdditionalSetupArgs } from './mcpServer.js';
 export { registerExitHandlers } from './registerExitHandlers.js';
 export { StatusError } from './StatusError.js';
 export { stdioServerFactory } from './stdio.js';
+export { ArrayStore, Store } from './store.js';
 export { addAiResultToSpan, withSpan } from './tracing.js';
 export type { ApiFactory, InferSchema, McpFeatureFlags, MigrationsConfig, ParsedQs, PromptFactory, ResourceFactory, } from './types.js';

package/dist/index.js

@@ -1,8 +1,8 @@
-export { Cache } from './cache.js';
 export { cliEntrypoint } from './cliEntrypoint.js';
 export { httpServerFactory } from './httpServer.js';
 export { log } from './logger.js';
 export { registerExitHandlers } from './registerExitHandlers.js';
 export { StatusError } from './StatusError.js';
 export { stdioServerFactory } from './stdio.js';
+export { ArrayStore, Store } from './store.js';
 export { addAiResultToSpan, withSpan } from './tracing.js';

package/dist/skills/utils.d.ts

@@ -1,6 +1,7 @@
 import type { Octokit } from '@octokit/rest';
 import { type McpFeatureFlags } from '@tigerdata/mcp-boilerplate';
 import { type CollectionFlags, type CollectionFlagsCfg, type Skill, type SkillCfgMap, type SkillMatter, type SkillsFlags } from './types.js';
+export declare const setSkillConfigReadOverride: (fn: (() => Promise<SkillCfgMap>) | null) => void;
 export declare const getSkillConfig: (configFilePath?: string) => Promise<SkillCfgMap>;
 export declare const parseSkillFile: (fileContent: string) => Promise<{
     matter: SkillMatter;

package/dist/skills/utils.js

@@ -10,11 +10,24 @@ const TTL = process.env.SKILLS_TTL
     : 5 * 60 * 1000;
 let lastFetchCfg = 0;
 let skillCfgMap = null;
+let getSkillOverride = null;
+// added so that the consumer can control where the skill config comes from
+// e.g. programmatically, rather than from a file
+// chose to use a setter pattern to minimize changing signatures everywhere,
+// this approach has a minimal footprint
+export const setSkillConfigReadOverride = (fn) => {
+    getSkillOverride = fn;
+};
 export const getSkillConfig = async (configFilePath = process.env.SKILLS_FILE || './skills.yaml') => {
     if (skillCfgMap && Date.now() - lastFetchCfg < TTL)
         return skillCfgMap;
-    const data = await readFile(configFilePath, 'utf-8');
-    skillCfgMap = zSkillCfgMap.parse(YAML.parse(data));
+    if (getSkillOverride !== null) {
+        skillCfgMap = await getSkillOverride();
+    }
+    else {
+        const data = await readFile(configFilePath, 'utf-8');
+        skillCfgMap = zSkillCfgMap.parse(YAML.parse(data));
+    }
     lastFetchCfg = Date.now();
     return skillCfgMap;
 };

package/dist/store.d.ts

@@ -0,0 +1,22 @@
+interface StoreProps<T> {
+    fetch: () => Promise<T>;
+    ttl?: number;
+}
+export declare class Store<T> {
+    private contents;
+    private fetch;
+    private ttl?;
+    private expirationDateTime?;
+    constructor({ fetch, ttl }: StoreProps<T>);
+    get(): Promise<T>;
+}
+interface ArrayStoreProps<T> {
+    fetch: () => Promise<T[]>;
+    ttl?: number;
+}
+export declare class ArrayStore<T> extends Store<T[]> {
+    constructor({ fetch, ttl }: ArrayStoreProps<T>);
+    find(predicate: (item: T) => boolean): Promise<T | null>;
+    filter(predicate: (item: T) => boolean): Promise<T[]>;
+}
+export {};

package/dist/{cache.js → store.js}

@@ -1,20 +1,30 @@
-export class Cache {
+export class Store {
     contents = null;
     fetch;
+    ttl;
     expirationDateTime;
     constructor({ fetch, ttl }) {
         this.fetch = fetch;
         if (ttl) {
+            this.ttl = ttl;
             this.expirationDateTime = Date.now() + ttl;
         }
     }
     async get() {
         if (this.expirationDateTime && Date.now() > this.expirationDateTime) {
             this.contents = null;
+            if (this.ttl) {
+                this.expirationDateTime = Date.now() + this.ttl;
+            }
         }
         this.contents ??= this.fetch();
         return this.contents;
     }
+}
+export class ArrayStore extends Store {
+    constructor({ fetch, ttl }) {
+        super({ fetch, ttl });
+    }
     async find(predicate) {
         const items = await this.get();
         return items.find(predicate) ?? null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tigerdata/mcp-boilerplate",
-  "version": "1.5.3",
+  "version": "1.6.1",
   "description": "MCP boilerplate code for Node.js",
   "license": "Apache-2.0",
   "author": "TigerData",

package/dist/cache.d.ts

@@ -1,15 +0,0 @@
-interface CacheProps<T> {
-    contents?: T;
-    fetch: () => Promise<T[]>;
-    ttl?: number;
-}
-export declare class Cache<T> {
-    private contents;
-    private fetch;
-    private expirationDateTime?;
-    constructor({ fetch, ttl }: CacheProps<T>);
-    get(): Promise<T[]>;
-    find(predicate: (item: T) => boolean): Promise<T | null>;
-    filter(predicate: (item: T) => boolean): Promise<T[]>;
-}
-export {};