@utilarium/overcontext 0.0.4-dev.0

package/dist/api/query-builder.d.ts

@@ -0,0 +1,51 @@
+import { QueryOptions, SortDirection } from './query';
+/**
+ * Fluent query builder for constructing search queries.
+ */
+export declare class QueryBuilder {
+    private options;
+    /**
+     * Filter by entity type(s).
+     */
+    type(type: string | string[]): this;
+    /**
+     * Filter by namespace(s).
+     */
+    namespace(ns: string | string[]): this;
+    /**
+     * Filter by specific IDs.
+     */
+    ids(ids: string[]): this;
+    /**
+     * Add text search.
+     */
+    search(query: string, fields?: string[]): this;
+    /**
+     * Enable case-sensitive search.
+     */
+    caseSensitive(enabled?: boolean): this;
+    /**
+     * Add sort field.
+     */
+    sortBy(field: string, direction?: SortDirection): this;
+    /**
+     * Set result limit.
+     */
+    limit(n: number): this;
+    /**
+     * Set result offset.
+     */
+    offset(n: number): this;
+    /**
+     * Set page (calculates offset from limit).
+     */
+    page(pageNum: number, pageSize: number): this;
+    /**
+     * Build the query options.
+     */
+    build(): QueryOptions;
+}
+/**
+ * Start building a query.
+ */
+export declare const query: () => QueryBuilder;

package/dist/api/query-builder.js

@@ -0,0 +1,95 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * Fluent query builder for constructing search queries.
+ */ class QueryBuilder {
+    /**
+     * Filter by entity type(s).
+     */ type(type) {
+        this.options.type = type;
+        return this;
+    }
+    /**
+     * Filter by namespace(s).
+     */ namespace(ns) {
+        this.options.namespace = ns;
+        return this;
+    }
+    /**
+     * Filter by specific IDs.
+     */ ids(ids) {
+        this.options.ids = ids;
+        return this;
+    }
+    /**
+     * Add text search.
+     */ search(query, fields) {
+        this.options.search = query;
+        if (fields) this.options.searchFields = fields;
+        return this;
+    }
+    /**
+     * Enable case-sensitive search.
+     */ caseSensitive(enabled = true) {
+        this.options.caseSensitive = enabled;
+        return this;
+    }
+    /**
+     * Add sort field.
+     */ sortBy(field, direction = 'asc') {
+        this.options.sort = [
+            ...this.options.sort || [],
+            {
+                field,
+                direction
+            }
+        ];
+        return this;
+    }
+    /**
+     * Set result limit.
+     */ limit(n) {
+        this.options.limit = n;
+        return this;
+    }
+    /**
+     * Set result offset.
+     */ offset(n) {
+        this.options.offset = n;
+        return this;
+    }
+    /**
+     * Set page (calculates offset from limit).
+     */ page(pageNum, pageSize) {
+        this.options.limit = pageSize;
+        this.options.offset = (pageNum - 1) * pageSize;
+        return this;
+    }
+    /**
+     * Build the query options.
+     */ build() {
+        return {
+            ...this.options
+        };
+    }
+    constructor(){
+        _define_property(this, "options", {});
+    }
+}
+/**
+ * Start building a query.
+ */ const query = ()=>new QueryBuilder();
+
+export { QueryBuilder, query };
+//# sourceMappingURL=query-builder.js.map

package/dist/api/query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.js","sources":["../../src/api/query-builder.ts"],"sourcesContent":["import { QueryOptions, SortDirection } from './query';\n\n/**\n * Fluent query builder for constructing search queries.\n */\nexport class QueryBuilder {\n    private options: QueryOptions = {};\n\n    /**\n     * Filter by entity type(s).\n     */\n    type(type: string | string[]): this {\n        this.options.type = type;\n        return this;\n    }\n\n    /**\n     * Filter by namespace(s).\n     */\n    namespace(ns: string | string[]): this {\n        this.options.namespace = ns;\n        return this;\n    }\n\n    /**\n     * Filter by specific IDs.\n     */\n    ids(ids: string[]): this {\n        this.options.ids = ids;\n        return this;\n    }\n\n    /**\n     * Add text search.\n     */\n    search(query: string, fields?: string[]): this {\n        this.options.search = query;\n        if (fields) this.options.searchFields = fields;\n        return this;\n    }\n\n    /**\n     * Enable case-sensitive search.\n     */\n    caseSensitive(enabled: boolean = true): this {\n        this.options.caseSensitive = enabled;\n        return this;\n    }\n\n    /**\n     * Add sort field.\n     */\n    sortBy(field: string, direction: SortDirection = 'asc'): this {\n        this.options.sort = [...(this.options.sort || []), { field, direction }];\n        return this;\n    }\n\n    /**\n     * Set result limit.\n     */\n    limit(n: number): this {\n        this.options.limit = n;\n        return this;\n    }\n\n    /**\n     * Set result offset.\n     */\n    offset(n: number): this {\n        this.options.offset = n;\n        return this;\n    }\n\n    /**\n     * Set page (calculates offset from limit).\n     */\n    page(pageNum: number, pageSize: number): this {\n        this.options.limit = pageSize;\n        this.options.offset = (pageNum - 1) * pageSize;\n        return this;\n    }\n\n    /**\n     * Build the query options.\n     */\n    build(): QueryOptions {\n        return { ...this.options };\n    }\n}\n\n/**\n * Start building a query.\n */\nexport const query = () => new QueryBuilder();\n"],"names":["QueryBuilder","type","options","namespace","ns","ids","search","query","fields","searchFields","caseSensitive","enabled","sortBy","field","direction","sort","limit","n","offset","page","pageNum","pageSize","build"],"mappings":";;;;;;;;;;;;;AAEA;;AAEC,IACM,MAAMA,YAAAA,CAAAA;AAGT;;QAGAC,IAAAA,CAAKA,IAAuB,EAAQ;AAChC,QAAA,IAAI,CAACC,OAAO,CAACD,IAAI,GAAGA,IAAAA;AACpB,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;QAGAE,SAAAA,CAAUC,EAAqB,EAAQ;AACnC,QAAA,IAAI,CAACF,OAAO,CAACC,SAAS,GAAGC,EAAAA;AACzB,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;QAGAC,GAAAA,CAAIA,GAAa,EAAQ;AACrB,QAAA,IAAI,CAACH,OAAO,CAACG,GAAG,GAAGA,GAAAA;AACnB,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;AAEC,QACDC,MAAAA,CAAOC,KAAa,EAAEC,MAAiB,EAAQ;AAC3C,QAAA,IAAI,CAACN,OAAO,CAACI,MAAM,GAAGC,KAAAA;AACtB,QAAA,IAAIC,QAAQ,IAAI,CAACN,OAAO,CAACO,YAAY,GAAGD,MAAAA;AACxC,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;QAGAE,aAAAA,CAAcC,OAAAA,GAAmB,IAAI,EAAQ;AACzC,QAAA,IAAI,CAACT,OAAO,CAACQ,aAAa,GAAGC,OAAAA;AAC7B,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;AAEC,QACDC,MAAAA,CAAOC,KAAa,EAAEC,SAAAA,GAA2B,KAAK,EAAQ;AAC1D,QAAA,IAAI,CAACZ,OAAO,CAACa,IAAI,GAAG;AAAK,YAAA,GAAA,IAAI,CAACb,OAAO,CAACa,IAAI,IAAI,EAAE;AAAG,YAAA;AAAEF,gBAAAA,KAAAA;AAAOC,gBAAAA;AAAU;AAAE,SAAA;AACxE,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;QAGAE,KAAAA,CAAMC,CAAS,EAAQ;AACnB,QAAA,IAAI,CAACf,OAAO,CAACc,KAAK,GAAGC,CAAAA;AACrB,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;QAGAC,MAAAA,CAAOD,CAAS,EAAQ;AACpB,QAAA,IAAI,CAACf,OAAO,CAACgB,MAAM,GAAGD,CAAAA;AACtB,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;AAEC,QACDE,IAAAA,CAAKC,OAAe,EAAEC,QAAgB,EAAQ;AAC1C,QAAA,IAAI,CAACnB,OAAO,CAACc,KAAK,GAAGK,QAAAA;QACrB,IAAI,CAACnB,OAAO,CAACgB,MAAM,GAAG,CAACE,OAAAA,GAAU,CAAA,IAAKC,QAAAA;AACtC,QAAA,OAAO,IAAI;AACf,IAAA;AAEA;;AAEC,QACDC,KAAAA,GAAsB;QAClB,OAAO;YAAE,GAAG,IAAI,CAACpB;AAAQ,SAAA;AAC7B,IAAA;;AAjFA,QAAA,gBAAA,CAAA,IAAA,EAAQA,WAAwB,EAAC,CAAA;;AAkFrC;AAEA;;AAEC,IACM,MAAMK,KAAAA,GAAQ,IAAM,IAAIP,YAAAA;;;;"}

package/dist/api/query.d.ts

@@ -0,0 +1,32 @@
+import { BaseEntity } from '../schema/base';
+export type SortDirection = 'asc' | 'desc';
+export interface SortOption {
+    field: string;
+    direction: SortDirection;
+}
+export interface QueryOptions {
+    /** Filter by entity type(s) */
+    type?: string | string[];
+    /** Filter by namespace(s) */
+    namespace?: string | string[];
+    /** Filter by specific IDs */
+    ids?: string[];
+    /** Text search across name and searchable fields */
+    search?: string;
+    /** Additional fields to include in search */
+    searchFields?: string[];
+    /** Case sensitive search (default: false) */
+    caseSensitive?: boolean;
+    /** Pagination limit */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+    /** Sort options */
+    sort?: SortOption[];
+}
+export interface QueryResult<T extends BaseEntity> {
+    items: T[];
+    total: number;
+    hasMore: boolean;
+    query: QueryOptions;
+}

package/dist/api/search.d.ts

@@ -0,0 +1,20 @@
+import { BaseEntity } from '../schema/base';
+import { SchemaRegistry } from '../schema/registry';
+import { StorageProvider } from '../storage/interface';
+import { QueryOptions, QueryResult } from './query';
+export interface SearchEngine {
+    /**
+     * Search entities with filtering, pagination, and sorting.
+     */
+    search<T extends BaseEntity>(options: QueryOptions): Promise<QueryResult<T>>;
+    /**
+     * Quick search by name across all types.
+     */
+    quickSearch<T extends BaseEntity>(query: string, options?: Pick<QueryOptions, 'type' | 'namespace' | 'limit'>): Promise<T[]>;
+}
+export interface SearchEngineOptions {
+    provider: StorageProvider;
+    registry: SchemaRegistry;
+    defaultNamespace?: string;
+}
+export declare const createSearchEngine: (options: SearchEngineOptions) => SearchEngine;

package/dist/api/search.js

@@ -0,0 +1,112 @@
+const createSearchEngine = (options)=>{
+    const { provider, registry, defaultNamespace } = options;
+    const textMatch = (text, query, caseSensitive)=>{
+        if (!text) return false;
+        const a = caseSensitive ? text : text.toLowerCase();
+        const b = caseSensitive ? query : query.toLowerCase();
+        return a.includes(b);
+    };
+    const matchesSearch = (entity, search, searchFields, caseSensitive)=>{
+        // Always search name
+        if (textMatch(entity.name, search, caseSensitive)) {
+            return true;
+        }
+        // Search additional fields
+        for (const field of searchFields){
+            const value = entity[field];
+            if (typeof value === 'string' && textMatch(value, search, caseSensitive)) {
+                return true;
+            }
+            // Handle arrays of strings (like sounds_like)
+            if (Array.isArray(value)) {
+                for (const item of value){
+                    if (typeof item === 'string' && textMatch(item, search, caseSensitive)) {
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    };
+    const sortEntities = (entities, sort)=>{
+        return [
+            ...entities
+        ].sort((a, b)=>{
+            for (const { field, direction } of sort){
+                const aVal = a[field];
+                const bVal = b[field];
+                if (aVal === bVal) continue;
+                if (aVal === undefined || aVal === null) return direction === 'asc' ? 1 : -1;
+                if (bVal === undefined || bVal === null) return direction === 'asc' ? -1 : 1;
+                let cmp;
+                if (typeof aVal === 'string' && typeof bVal === 'string') {
+                    cmp = aVal.localeCompare(bVal);
+                } else if (aVal instanceof Date && bVal instanceof Date) {
+                    cmp = aVal.getTime() - bVal.getTime();
+                } else {
+                    cmp = aVal < bVal ? -1 : 1;
+                }
+                return direction === 'asc' ? cmp : -cmp;
+            }
+            return 0;
+        });
+    };
+    return {
+        async search (options) {
+            const { type, namespace, ids, search, searchFields = [], caseSensitive = false, limit, offset = 0, sort = [
+                {
+                    field: 'name',
+                    direction: 'asc'
+                }
+            ] } = options;
+            // Determine which types to search
+            const types = type ? Array.isArray(type) ? type : [
+                type
+            ] : registry.types();
+            // Determine which namespaces to search
+            const namespaces = namespace ? Array.isArray(namespace) ? namespace : [
+                namespace
+            ] : [
+                defaultNamespace
+            ];
+            // Collect entities
+            let allEntities = [];
+            for (const t of types){
+                for (const ns of namespaces){
+                    const entities = await provider.getAll(t, ns);
+                    allEntities = allEntities.concat(entities);
+                }
+            }
+            // Apply ID filter
+            if (ids === null || ids === void 0 ? void 0 : ids.length) {
+                allEntities = allEntities.filter((e)=>ids.includes(e.id));
+            }
+            // Apply search filter
+            if (search) {
+                allEntities = allEntities.filter((e)=>matchesSearch(e, search, searchFields, caseSensitive));
+            }
+            // Apply sorting
+            allEntities = sortEntities(allEntities, sort);
+            // Get total before pagination
+            const total = allEntities.length;
+            // Apply pagination
+            const paginated = allEntities.slice(offset, limit ? offset + limit : undefined);
+            return {
+                items: paginated,
+                total,
+                hasMore: limit ? offset + limit < total : false,
+                query: options
+            };
+        },
+        async quickSearch (query, options = {}) {
+            const result = await this.search({
+                ...options,
+                search: query
+            });
+            return result.items;
+        }
+    };
+};
+
+export { createSearchEngine };
+//# sourceMappingURL=search.js.map

package/dist/api/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sources":["../../src/api/search.ts"],"sourcesContent":["import { BaseEntity } from '../schema/base';\nimport { SchemaRegistry } from '../schema/registry';\nimport { StorageProvider } from '../storage/interface';\nimport { QueryOptions, QueryResult, SortOption } from './query';\n\nexport interface SearchEngine {\n    /**\n     * Search entities with filtering, pagination, and sorting.\n     */\n    search<T extends BaseEntity>(options: QueryOptions): Promise<QueryResult<T>>;\n\n    /**\n     * Quick search by name across all types.\n     */\n    quickSearch<T extends BaseEntity>(\n        query: string,\n        options?: Pick<QueryOptions, 'type' | 'namespace' | 'limit'>\n    ): Promise<T[]>;\n}\n\nexport interface SearchEngineOptions {\n    provider: StorageProvider;\n    registry: SchemaRegistry;\n    defaultNamespace?: string;\n}\n\nexport const createSearchEngine = (options: SearchEngineOptions): SearchEngine => {\n    const { provider, registry, defaultNamespace } = options;\n\n    const textMatch = (\n        text: string | undefined,\n        query: string,\n        caseSensitive: boolean\n    ): boolean => {\n        if (!text) return false;\n        const a = caseSensitive ? text : text.toLowerCase();\n        const b = caseSensitive ? query : query.toLowerCase();\n        return a.includes(b);\n    };\n\n    const matchesSearch = (\n        entity: BaseEntity,\n        search: string,\n        searchFields: string[],\n        caseSensitive: boolean\n    ): boolean => {\n        // Always search name\n        if (textMatch(entity.name, search, caseSensitive)) {\n            return true;\n        }\n\n        // Search additional fields\n        for (const field of searchFields) {\n            const value = (entity as Record<string, unknown>)[field];\n            if (typeof value === 'string' && textMatch(value, search, caseSensitive)) {\n                return true;\n            }\n            // Handle arrays of strings (like sounds_like)\n            if (Array.isArray(value)) {\n                for (const item of value) {\n                    if (typeof item === 'string' && textMatch(item, search, caseSensitive)) {\n                        return true;\n                    }\n                }\n            }\n        }\n\n        return false;\n    };\n\n    const sortEntities = <T extends BaseEntity>(\n        entities: T[],\n        sort: SortOption[]\n    ): T[] => {\n        return [...entities].sort((a, b) => {\n            for (const { field, direction } of sort) {\n                const aVal = (a as Record<string, unknown>)[field];\n                const bVal = (b as Record<string, unknown>)[field];\n\n                if (aVal === bVal) continue;\n                if (aVal === undefined || aVal === null) return direction === 'asc' ? 1 : -1;\n                if (bVal === undefined || bVal === null) return direction === 'asc' ? -1 : 1;\n\n                let cmp: number;\n                if (typeof aVal === 'string' && typeof bVal === 'string') {\n                    cmp = aVal.localeCompare(bVal);\n                } else if (aVal instanceof Date && bVal instanceof Date) {\n                    cmp = aVal.getTime() - bVal.getTime();\n                } else {\n                    cmp = aVal < bVal ? -1 : 1;\n                }\n\n                return direction === 'asc' ? cmp : -cmp;\n            }\n            return 0;\n        });\n    };\n\n    return {\n        async search<T extends BaseEntity>(options: QueryOptions): Promise<QueryResult<T>> {\n            const {\n                type,\n                namespace,\n                ids,\n                search,\n                searchFields = [],\n                caseSensitive = false,\n                limit,\n                offset = 0,\n                sort = [{ field: 'name', direction: 'asc' }],\n            } = options;\n\n            // Determine which types to search\n            const types = type\n                ? (Array.isArray(type) ? type : [type])\n                : registry.types();\n\n            // Determine which namespaces to search\n            const namespaces = namespace\n                ? (Array.isArray(namespace) ? namespace : [namespace])\n                : [defaultNamespace];\n\n            // Collect entities\n            let allEntities: T[] = [];\n\n            for (const t of types) {\n                for (const ns of namespaces) {\n                    const entities = await provider.getAll<T>(t, ns);\n                    allEntities = allEntities.concat(entities);\n                }\n            }\n\n            // Apply ID filter\n            if (ids?.length) {\n                allEntities = allEntities.filter(e => ids.includes(e.id));\n            }\n\n            // Apply search filter\n            if (search) {\n                allEntities = allEntities.filter(e =>\n                    matchesSearch(e, search, searchFields, caseSensitive)\n                );\n            }\n\n            // Apply sorting\n            allEntities = sortEntities(allEntities, sort);\n\n            // Get total before pagination\n            const total = allEntities.length;\n\n            // Apply pagination\n            const paginated = allEntities.slice(offset, limit ? offset + limit : undefined);\n\n            return {\n                items: paginated,\n                total,\n                hasMore: limit ? offset + limit < total : false,\n                query: options,\n            };\n        },\n\n        async quickSearch<T extends BaseEntity>(\n            query: string,\n            options: Pick<QueryOptions, 'type' | 'namespace' | 'limit'> = {}\n        ): Promise<T[]> {\n            const result = await this.search<T>({\n                ...options,\n                search: query,\n            });\n            return result.items;\n        },\n    };\n};\n"],"names":["createSearchEngine","options","provider","registry","defaultNamespace","textMatch","text","query","caseSensitive","a","toLowerCase","b","includes","matchesSearch","entity","search","searchFields","name","field","value","Array","isArray","item","sortEntities","entities","sort","direction","aVal","bVal","undefined","cmp","localeCompare","Date","getTime","type","namespace","ids","limit","offset","types","namespaces","allEntities","t","ns","getAll","concat","length","filter","e","id","total","paginated","slice","items","hasMore","quickSearch","result"],"mappings":"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"}

package/dist/api/slug.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generate a slug from a name.
+ * "John Doe" -> "john-doe"
+ * "API Reference" -> "api-reference"
+ */
+export declare const slugify: (name: string) => string;
+/**
+ * Generate a unique ID, appending a number if needed.
+ */
+export declare const generateUniqueId: (baseName: string, exists: (id: string) => Promise<boolean>) => Promise<string>;

package/dist/api/slug.js

@@ -0,0 +1,55 @@
+/**
+ * Generate a slug from a name.
+ * "John Doe" -> "john-doe"
+ * "API Reference" -> "api-reference"
+ */ const slugify = (name)=>{
+    const cleaned = name.toLowerCase().trim().replace(/[^\w\s-]/g, '') // Remove non-word chars
+    .replace(/[\s_]+/g, '-'); // Replace spaces/underscores
+    // Single-pass algorithm to collapse hyphens and trim (avoid ReDoS)
+    const result = [];
+    let prevWasHyphen = false;
+    let startIdx = 0;
+    let endIdx = cleaned.length;
+    // Skip leading hyphens
+    while(startIdx < cleaned.length && cleaned[startIdx] === '-'){
+        startIdx++;
+    }
+    // Skip trailing hyphens
+    while(endIdx > startIdx && cleaned[endIdx - 1] === '-'){
+        endIdx--;
+    }
+    // Build result, collapsing consecutive hyphens
+    for(let i = startIdx; i < endIdx; i++){
+        const char = cleaned[i];
+        if (char === '-') {
+            if (!prevWasHyphen) {
+                result.push('-');
+                prevWasHyphen = true;
+            }
+        } else {
+            result.push(char);
+            prevWasHyphen = false;
+        }
+    }
+    return result.join('');
+};
+/**
+ * Generate a unique ID, appending a number if needed.
+ */ const generateUniqueId = async (baseName, exists)=>{
+    const baseId = slugify(baseName);
+    if (!await exists(baseId)) {
+        return baseId;
+    }
+    // Try appending numbers
+    for(let i = 2; i <= 100; i++){
+        const candidateId = `${baseId}-${i}`;
+        if (!await exists(candidateId)) {
+            return candidateId;
+        }
+    }
+    // Fallback to timestamp
+    return `${baseId}-${Date.now()}`;
+};
+
+export { generateUniqueId, slugify };
+//# sourceMappingURL=slug.js.map

package/dist/api/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sources":["../../src/api/slug.ts"],"sourcesContent":["/**\n * Generate a slug from a name.\n * \"John Doe\" -> \"john-doe\"\n * \"API Reference\" -> \"api-reference\"\n */\nexport const slugify = (name: string): string => {\n    const cleaned = name\n        .toLowerCase()\n        .trim()\n        .replace(/[^\\w\\s-]/g, '')     // Remove non-word chars\n        .replace(/[\\s_]+/g, '-');     // Replace spaces/underscores\n    \n    // Single-pass algorithm to collapse hyphens and trim (avoid ReDoS)\n    const result: string[] = [];\n    let prevWasHyphen = false;\n    let startIdx = 0;\n    let endIdx = cleaned.length;\n    \n    // Skip leading hyphens\n    while (startIdx < cleaned.length && cleaned[startIdx] === '-') {\n        startIdx++;\n    }\n    \n    // Skip trailing hyphens\n    while (endIdx > startIdx && cleaned[endIdx - 1] === '-') {\n        endIdx--;\n    }\n    \n    // Build result, collapsing consecutive hyphens\n    for (let i = startIdx; i < endIdx; i++) {\n        const char = cleaned[i];\n        if (char === '-') {\n            if (!prevWasHyphen) {\n                result.push('-');\n                prevWasHyphen = true;\n            }\n        } else {\n            result.push(char);\n            prevWasHyphen = false;\n        }\n    }\n    \n    return result.join('');\n};\n\n/**\n * Generate a unique ID, appending a number if needed.\n */\nexport const generateUniqueId = async (\n    baseName: string,\n    exists: (id: string) => Promise<boolean>\n): Promise<string> => {\n    const baseId = slugify(baseName);\n\n    if (!await exists(baseId)) {\n        return baseId;\n    }\n\n    // Try appending numbers\n    for (let i = 2; i <= 100; i++) {\n        const candidateId = `${baseId}-${i}`;\n        if (!await exists(candidateId)) {\n            return candidateId;\n        }\n    }\n\n    // Fallback to timestamp\n    return `${baseId}-${Date.now()}`;\n};\n"],"names":["slugify","name","cleaned","toLowerCase","trim","replace","result","prevWasHyphen","startIdx","endIdx","length","i","char","push","join","generateUniqueId","baseName","exists","baseId","candidateId","Date","now"],"mappings":"AAAA;;;;IAKO,MAAMA,OAAAA,GAAU,CAACC,IAAAA,GAAAA;IACpB,MAAMC,OAAAA,GAAUD,IAAAA,CACXE,WAAW,EAAA,CACXC,IAAI,GACJC,OAAO,CAAC,WAAA,EAAa,EAAA,CAAA;KACrBA,OAAO,CAAC,SAAA,EAAW,GAAA,CAAA,CAAA;;AAGxB,IAAA,MAAMC,SAAmB,EAAE;AAC3B,IAAA,IAAIC,aAAAA,GAAgB,KAAA;AACpB,IAAA,IAAIC,QAAAA,GAAW,CAAA;IACf,IAAIC,MAAAA,GAASP,QAAQQ,MAAM;;IAG3B,MAAOF,QAAAA,GAAWN,QAAQQ,MAAM,IAAIR,OAAO,CAACM,QAAAA,CAAS,KAAK,GAAA,CAAK;AAC3DA,QAAAA,QAAAA,EAAAA;AACJ,IAAA;;AAGA,IAAA,MAAOC,SAASD,QAAAA,IAAYN,OAAO,CAACO,MAAAA,GAAS,CAAA,CAAE,KAAK,GAAA,CAAK;AACrDA,QAAAA,MAAAA,EAAAA;AACJ,IAAA;;AAGA,IAAA,IAAK,IAAIE,CAAAA,GAAIH,QAAAA,EAAUG,CAAAA,GAAIF,QAAQE,CAAAA,EAAAA,CAAK;QACpC,MAAMC,IAAAA,GAAOV,OAAO,CAACS,CAAAA,CAAE;AACvB,QAAA,IAAIC,SAAS,GAAA,EAAK;AACd,YAAA,IAAI,CAACL,aAAAA,EAAe;AAChBD,gBAAAA,MAAAA,CAAOO,IAAI,CAAC,GAAA,CAAA;gBACZN,aAAAA,GAAgB,IAAA;AACpB,YAAA;QACJ,CAAA,MAAO;AACHD,YAAAA,MAAAA,CAAOO,IAAI,CAACD,IAAAA,CAAAA;YACZL,aAAAA,GAAgB,KAAA;AACpB,QAAA;AACJ,IAAA;IAEA,OAAOD,MAAAA,CAAOQ,IAAI,CAAC,EAAA,CAAA;AACvB;AAEA;;AAEC,IACM,MAAMC,gBAAAA,GAAmB,OAC5BC,QAAAA,EACAC,MAAAA,GAAAA;AAEA,IAAA,MAAMC,SAASlB,OAAAA,CAAQgB,QAAAA,CAAAA;IAEvB,IAAI,CAAC,MAAMC,MAAAA,CAAOC,MAAAA,CAAAA,EAAS;QACvB,OAAOA,MAAAA;AACX,IAAA;;AAGA,IAAA,IAAK,IAAIP,CAAAA,GAAI,CAAA,EAAGA,CAAAA,IAAK,KAAKA,CAAAA,EAAAA,CAAK;AAC3B,QAAA,MAAMQ,WAAAA,GAAc,CAAA,EAAGD,MAAAA,CAAO,CAAC,EAAEP,CAAAA,CAAAA,CAAG;QACpC,IAAI,CAAC,MAAMM,MAAAA,CAAOE,WAAAA,CAAAA,EAAc;YAC5B,OAAOA,WAAAA;AACX,QAAA;AACJ,IAAA;;AAGA,IAAA,OAAO,GAAGD,MAAAA,CAAO,CAAC,EAAEE,IAAAA,CAAKC,GAAG,EAAA,CAAA,CAAI;AACpC;;;;"}

package/dist/cli/builder.d.ts

@@ -0,0 +1,74 @@
+import { SchemaMap } from '../schema/registry';
+import { OvercontextAPI } from '../api/context';
+import { OutputFormat } from './formatters';
+export interface CLIBuilderOptions<TSchemas extends SchemaMap> {
+    api: OvercontextAPI<TSchemas>;
+    defaultFormat?: OutputFormat;
+}
+/**
+ * CLI builder for consumers to create their own CLIs.
+ *
+ * @example
+ * const cli = createCLIBuilder({ api });
+ *
+ * // In your CLI tool:
+ * const result = await cli.list({ type: 'person' });
+ * console.log(result);
+ */
+export declare const createCLIBuilder: <TSchemas extends SchemaMap>(options: CLIBuilderOptions<TSchemas>) => {
+    /**
+     * List entities.
+     */
+    list: (opts: {
+        type: string;
+        search?: string;
+        limit?: number;
+        fields?: string[];
+        format?: OutputFormat;
+        namespace?: string;
+    }) => Promise<string>;
+    /**
+     * Get a single entity.
+     */
+    get: (opts: {
+        type: string;
+        id: string;
+        format?: OutputFormat;
+        namespace?: string;
+    }) => Promise<string>;
+    /**
+     * Create an entity.
+     */
+    create: (opts: {
+        type: string;
+        name: string;
+        data?: Record<string, unknown>;
+        id?: string;
+        format?: OutputFormat;
+        namespace?: string;
+    }) => Promise<string>;
+    /**
+     * Update an entity.
+     */
+    update: (opts: {
+        type: string;
+        id: string;
+        data: Record<string, unknown>;
+        format?: OutputFormat;
+        namespace?: string;
+    }) => Promise<string>;
+    /**
+     * Delete an entity.
+     */
+    delete: (opts: {
+        type: string;
+        id: string;
+        format?: OutputFormat;
+        namespace?: string;
+    }) => Promise<string>;
+    /**
+     * List available entity types.
+     */
+    types: () => string[];
+};
+export type CLIBuilder<TSchemas extends SchemaMap> = ReturnType<typeof createCLIBuilder<TSchemas>>;

package/dist/cli/builder.js

@@ -0,0 +1,42 @@
+import { deleteCommand, updateCommand, createCommand, getCommand, listCommand } from './commands.js';
+
+/**
+ * CLI builder for consumers to create their own CLIs.
+ * 
+ * @example
+ * const cli = createCLIBuilder({ api });
+ * 
+ * // In your CLI tool:
+ * const result = await cli.list({ type: 'person' });
+ * console.log(result);
+ */ const createCLIBuilder = (options)=>{
+    const { api, defaultFormat = 'table' } = options;
+    const createContext = (format, namespace)=>({
+            api,
+            outputFormat: format || defaultFormat,
+            namespace
+        });
+    return {
+        /**
+         * List entities.
+         */ list: (opts)=>listCommand(createContext(opts.format, opts.namespace), opts),
+        /**
+         * Get a single entity.
+         */ get: (opts)=>getCommand(createContext(opts.format, opts.namespace), opts),
+        /**
+         * Create an entity.
+         */ create: (opts)=>createCommand(createContext(opts.format, opts.namespace), opts),
+        /**
+         * Update an entity.
+         */ update: (opts)=>updateCommand(createContext(opts.format, opts.namespace), opts),
+        /**
+         * Delete an entity.
+         */ delete: (opts)=>deleteCommand(createContext(opts.format, opts.namespace), opts),
+        /**
+         * List available entity types.
+         */ types: ()=>api.types()
+    };
+};
+
+export { createCLIBuilder };
+//# sourceMappingURL=builder.js.map

package/dist/cli/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sources":["../../src/cli/builder.ts"],"sourcesContent":["import { SchemaMap } from '../schema/registry';\nimport { OvercontextAPI } from '../api/context';\nimport {\n    CommandContext,\n    listCommand,\n    getCommand,\n    createCommand,\n    updateCommand,\n    deleteCommand,\n} from './commands';\nimport { OutputFormat } from './formatters';\n\nexport interface CLIBuilderOptions<TSchemas extends SchemaMap> {\n    api: OvercontextAPI<TSchemas>;\n    defaultFormat?: OutputFormat;\n}\n\n/**\n * CLI builder for consumers to create their own CLIs.\n * \n * @example\n * const cli = createCLIBuilder({ api });\n * \n * // In your CLI tool:\n * const result = await cli.list({ type: 'person' });\n * console.log(result);\n */\nexport const createCLIBuilder = <TSchemas extends SchemaMap>(\n    options: CLIBuilderOptions<TSchemas>\n) => {\n    const { api, defaultFormat = 'table' } = options;\n\n    const createContext = (\n        format?: OutputFormat,\n        namespace?: string\n    ): CommandContext<TSchemas> => ({\n        api,\n        outputFormat: format || defaultFormat,\n        namespace,\n    });\n\n    return {\n        /**\n         * List entities.\n         */\n        list: (opts: {\n            type: string;\n            search?: string;\n            limit?: number;\n            fields?: string[];\n            format?: OutputFormat;\n            namespace?: string;\n        }) => listCommand(createContext(opts.format, opts.namespace), opts),\n\n        /**\n         * Get a single entity.\n         */\n        get: (opts: {\n            type: string;\n            id: string;\n            format?: OutputFormat;\n            namespace?: string;\n        }) => getCommand(createContext(opts.format, opts.namespace), opts),\n\n        /**\n         * Create an entity.\n         */\n        create: (opts: {\n            type: string;\n            name: string;\n            data?: Record<string, unknown>;\n            id?: string;\n            format?: OutputFormat;\n            namespace?: string;\n        }) => createCommand(createContext(opts.format, opts.namespace), opts),\n\n        /**\n         * Update an entity.\n         */\n        update: (opts: {\n            type: string;\n            id: string;\n            data: Record<string, unknown>;\n            format?: OutputFormat;\n            namespace?: string;\n        }) => updateCommand(createContext(opts.format, opts.namespace), opts),\n\n        /**\n         * Delete an entity.\n         */\n        delete: (opts: {\n            type: string;\n            id: string;\n            format?: OutputFormat;\n            namespace?: string;\n        }) => deleteCommand(createContext(opts.format, opts.namespace), opts),\n\n        /**\n         * List available entity types.\n         */\n        types: () => api.types(),\n    };\n};\n\nexport type CLIBuilder<TSchemas extends SchemaMap> = ReturnType<\n    typeof createCLIBuilder<TSchemas>\n>;\n"],"names":["createCLIBuilder","options","api","defaultFormat","createContext","format","namespace","outputFormat","list","opts","listCommand","get","getCommand","create","createCommand","update","updateCommand","delete","deleteCommand","types"],"mappings":";;AAiBA;;;;;;;;;IAUO,MAAMA,gBAAAA,GAAmB,CAC5BC,OAAAA,GAAAA;AAEA,IAAA,MAAM,EAAEC,GAAG,EAAEC,aAAAA,GAAgB,OAAO,EAAE,GAAGF,OAAAA;AAEzC,IAAA,MAAMG,aAAAA,GAAgB,CAClBC,MAAAA,EACAC,SAAAA,IAC4B;AAC5BJ,YAAAA,GAAAA;AACAK,YAAAA,YAAAA,EAAcF,MAAAA,IAAUF,aAAAA;AACxBG,YAAAA;SACJ,CAAA;IAEA,OAAO;AACH;;YAGAE,IAAAA,EAAM,CAACC,IAAAA,GAODC,WAAAA,CAAYN,aAAAA,CAAcK,KAAKJ,MAAM,EAAEI,IAAAA,CAAKH,SAAS,CAAA,EAAGG,IAAAA,CAAAA;AAE9D;;YAGAE,GAAAA,EAAK,CAACF,IAAAA,GAKAG,UAAAA,CAAWR,aAAAA,CAAcK,KAAKJ,MAAM,EAAEI,IAAAA,CAAKH,SAAS,CAAA,EAAGG,IAAAA,CAAAA;AAE7D;;YAGAI,MAAAA,EAAQ,CAACJ,IAAAA,GAOHK,aAAAA,CAAcV,aAAAA,CAAcK,KAAKJ,MAAM,EAAEI,IAAAA,CAAKH,SAAS,CAAA,EAAGG,IAAAA,CAAAA;AAEhE;;YAGAM,MAAAA,EAAQ,CAACN,IAAAA,GAMHO,aAAAA,CAAcZ,aAAAA,CAAcK,KAAKJ,MAAM,EAAEI,IAAAA,CAAKH,SAAS,CAAA,EAAGG,IAAAA,CAAAA;AAEhE;;YAGAQ,MAAAA,EAAQ,CAACR,IAAAA,GAKHS,aAAAA,CAAcd,aAAAA,CAAcK,KAAKJ,MAAM,EAAEI,IAAAA,CAAKH,SAAS,CAAA,EAAGG,IAAAA,CAAAA;AAEhE;;YAGAU,KAAAA,EAAO,IAAMjB,GAAAA,CAAIiB,KAAK;AAC1B,KAAA;AACJ;;;;"}

package/dist/cli/commands.d.ts

@@ -0,0 +1,53 @@
+import { SchemaMap } from '../schema/registry';
+import { OvercontextAPI } from '../api/context';
+import { OutputFormat } from './formatters';
+export interface CommandContext<TSchemas extends SchemaMap = SchemaMap> {
+    api: OvercontextAPI<TSchemas>;
+    outputFormat: OutputFormat;
+    namespace?: string;
+}
+export interface ListCommandOptions {
+    type: string;
+    search?: string;
+    limit?: number;
+    fields?: string[];
+}
+/**
+ * Build a list command handler.
+ */
+export declare const listCommand: <TSchemas extends SchemaMap>(ctx: CommandContext<TSchemas>, options: ListCommandOptions) => Promise<string>;
+export interface GetCommandOptions {
+    type: string;
+    id: string;
+}
+/**
+ * Build a get command handler.
+ */
+export declare const getCommand: <TSchemas extends SchemaMap>(ctx: CommandContext<TSchemas>, options: GetCommandOptions) => Promise<string>;
+export interface CreateCommandOptions {
+    type: string;
+    name: string;
+    data?: Record<string, unknown>;
+    id?: string;
+}
+/**
+ * Build a create command handler.
+ */
+export declare const createCommand: <TSchemas extends SchemaMap>(ctx: CommandContext<TSchemas>, options: CreateCommandOptions) => Promise<string>;
+export interface UpdateCommandOptions {
+    type: string;
+    id: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Build an update command handler.
+ */
+export declare const updateCommand: <TSchemas extends SchemaMap>(ctx: CommandContext<TSchemas>, options: UpdateCommandOptions) => Promise<string>;
+export interface DeleteCommandOptions {
+    type: string;
+    id: string;
+}
+/**
+ * Build a delete command handler.
+ */
+export declare const deleteCommand: <TSchemas extends SchemaMap>(ctx: CommandContext<TSchemas>, options: DeleteCommandOptions) => Promise<string>;

package/dist/cli/commands.js

@@ -0,0 +1,57 @@
+import { formatEntity, formatEntities } from './formatters.js';
+
+/**
+ * Build a list command handler.
+ */ const listCommand = async (ctx, options)=>{
+    const result = await ctx.api.search({
+        type: options.type,
+        namespace: ctx.namespace,
+        search: options.search,
+        limit: options.limit || 20
+    });
+    return formatEntities(result.items, {
+        format: ctx.outputFormat,
+        fields: options.fields
+    });
+};
+/**
+ * Build a get command handler.
+ */ const getCommand = async (ctx, options)=>{
+    const entity = await ctx.api.get(options.type, options.id, ctx.namespace);
+    if (!entity) {
+        throw new Error(`Entity not found: ${options.type}/${options.id}`);
+    }
+    return formatEntity(entity, {
+        format: ctx.outputFormat
+    });
+};
+/**
+ * Build a create command handler.
+ */ const createCommand = async (ctx, options)=>{
+    const entity = await ctx.api.create(options.type, {
+        name: options.name,
+        ...options.data
+    }, {
+        id: options.id,
+        namespace: ctx.namespace
+    });
+    return `Created ${options.type}: ${entity.id}`;
+};
+/**
+ * Build an update command handler.
+ */ const updateCommand = async (ctx, options)=>{
+    await ctx.api.update(options.type, options.id, options.data, ctx.namespace);
+    return `Updated ${options.type}: ${options.id}`;
+};
+/**
+ * Build a delete command handler.
+ */ const deleteCommand = async (ctx, options)=>{
+    const deleted = await ctx.api.delete(options.type, options.id, ctx.namespace);
+    if (!deleted) {
+        throw new Error(`Entity not found: ${options.type}/${options.id}`);
+    }
+    return `Deleted ${options.type}: ${options.id}`;
+};
+
+export { createCommand, deleteCommand, getCommand, listCommand, updateCommand };
+//# sourceMappingURL=commands.js.map