@bitrix24/mcp-docs 0.1.0

package/dist/__tests__/methods.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/methods.test.js

@@ -0,0 +1,54 @@
+import { describe, it, expect } from 'vitest';
+import { getRestMethods, getMethodDetail } from '../tools/methods.js';
+describe('getRestMethods', () => {
+    it('returns all methods when no filter', () => {
+        const result = getRestMethods();
+        expect(result).toHaveLength(34);
+    });
+    it('filters by scope "crm"', () => {
+        const result = getRestMethods('crm');
+        expect(result).toHaveLength(12);
+        for (const m of result) {
+            expect(m.scope).toBe('crm');
+        }
+    });
+    it('filters by query matching method name', () => {
+        const result = getRestMethods(undefined, 'deal.list');
+        expect(result.length).toBeGreaterThan(0);
+        for (const m of result) {
+            expect(m.method.toLowerCase()).toContain('deal.list');
+        }
+    });
+    it('filters by query matching description', () => {
+        const result = getRestMethods(undefined, 'paginated');
+        expect(result.length).toBeGreaterThan(0);
+    });
+    it('combines scope and query filters', () => {
+        const result = getRestMethods('crm', 'deal');
+        expect(result.length).toBeGreaterThan(0);
+        for (const m of result) {
+            expect(m.scope).toBe('crm');
+        }
+    });
+    it('returns empty array when no match', () => {
+        const result = getRestMethods('nonexistent_scope_xyz');
+        expect(result).toEqual([]);
+    });
+});
+describe('getMethodDetail', () => {
+    it('returns method for known name', () => {
+        const result = getMethodDetail('crm.deal.list');
+        expect(result).not.toBeNull();
+        expect(result?.method).toBe('crm.deal.list');
+        expect(result).toHaveProperty('description');
+        expect(result).toHaveProperty('scope');
+        expect(result).toHaveProperty('parameters');
+        expect(result).toHaveProperty('returns');
+        expect(result).toHaveProperty('example');
+    });
+    it('returns null for unknown method', () => {
+        const result = getMethodDetail('nonexistent.method.xyz');
+        expect(result).toBeNull();
+    });
+});
+//# sourceMappingURL=methods.test.js.map

package/dist/__tests__/methods.test.js.map

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

package/dist/__tests__/placements.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/placements.test.js

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { getPlacements, getPlacementDetail } from '../tools/placements.js';
+describe('getPlacements', () => {
+    it('returns all placements when no filter', () => {
+        const result = getPlacements();
+        expect(result).toHaveLength(21);
+    });
+    it('filters by module "crm"', () => {
+        const result = getPlacements('crm');
+        expect(result).toHaveLength(16);
+        for (const p of result) {
+            expect(p.module).toBe('crm');
+        }
+    });
+    it('returns empty array for unknown module', () => {
+        const result = getPlacements('nonexistent_module');
+        expect(result).toEqual([]);
+    });
+});
+describe('getPlacementDetail', () => {
+    it('returns placement for known code', () => {
+        const result = getPlacementDetail('CRM_LEAD_LIST_MENU');
+        expect(result).not.toBeNull();
+        expect(result?.code).toBe('CRM_LEAD_LIST_MENU');
+        expect(result).toHaveProperty('title');
+        expect(result).toHaveProperty('description');
+        expect(result).toHaveProperty('module');
+        expect(result).toHaveProperty('handler_params');
+        expect(result).toHaveProperty('example');
+    });
+    it('returns null for unknown code', () => {
+        const result = getPlacementDetail('UNKNOWN_PLACEMENT_CODE');
+        expect(result).toBeNull();
+    });
+});
+//# sourceMappingURL=placements.test.js.map

package/dist/__tests__/placements.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placements.test.js","sourceRoot":"","sources":["../../src/__tests__/placements.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE1E,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;QAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,kBAAkB,CAAC,wBAAwB,CAAC,CAAA;QAC3D,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/references.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/references.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { getAppTypes, getCategories } from '../tools/references.js';
+describe('getAppTypes', () => {
+    it('returns 4 app types', () => {
+        const result = getAppTypes();
+        expect(result).toHaveLength(4);
+    });
+    it('each app type has required fields', () => {
+        const result = getAppTypes();
+        for (const a of result) {
+            expect(a).toHaveProperty('type');
+            expect(a).toHaveProperty('title');
+            expect(a).toHaveProperty('description');
+        }
+    });
+    it('includes IFRAME and EXTERNAL types', () => {
+        const result = getAppTypes();
+        const types = result.map(a => a.type);
+        expect(types).toContain('IFRAME');
+        expect(types).toContain('EXTERNAL');
+    });
+});
+describe('getCategories', () => {
+    it('returns 6 categories', () => {
+        const result = getCategories();
+        expect(result).toHaveLength(6);
+    });
+    it('each category has required fields', () => {
+        const result = getCategories();
+        for (const c of result) {
+            expect(c).toHaveProperty('code');
+            expect(c).toHaveProperty('title');
+            expect(c).toHaveProperty('description');
+        }
+    });
+    it('includes CRM category', () => {
+        const result = getCategories();
+        const codes = result.map(c => c.code);
+        expect(codes).toContain('CRM');
+    });
+});
+//# sourceMappingURL=references.test.js.map

package/dist/__tests__/references.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.test.js","sourceRoot":"","sources":["../../src/__tests__/references.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAEnE,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,WAAW,EAAE,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,WAAW,EAAiE,CAAA;QAC3F,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;YAChC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;YACjC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;QACzC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,WAAW,EAA6B,CAAA;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACjC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,aAAa,EAAiE,CAAA;QAC7F,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;YAChC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;YACjC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;QACzC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,aAAa,EAA6B,CAAA;QACzD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/scopes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/scopes.test.js

@@ -0,0 +1,32 @@
+import { describe, it, expect } from 'vitest';
+import { getScopes } from '../tools/scopes.js';
+describe('getScopes', () => {
+    it('returns all scopes when no filter', () => {
+        const result = getScopes();
+        expect(result).toHaveLength(35);
+        for (const s of result) {
+            expect(s).toHaveProperty('scope');
+            expect(s).toHaveProperty('description');
+            expect(s).toHaveProperty('module');
+        }
+    });
+    it('filters by module "crm"', () => {
+        const result = getScopes('crm');
+        expect(result.length).toBeGreaterThan(0);
+        for (const s of result) {
+            expect(s.module).toBe('crm');
+        }
+    });
+    it('filters by module "tasks"', () => {
+        const result = getScopes('tasks');
+        expect(result.length).toBeGreaterThan(0);
+        for (const s of result) {
+            expect(s.module).toBe('tasks');
+        }
+    });
+    it('returns empty array for unknown module', () => {
+        const result = getScopes('nonexistent_module_xyz');
+        expect(result).toEqual([]);
+    });
+});
+//# sourceMappingURL=scopes.test.js.map

package/dist/__tests__/scopes.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.test.js","sourceRoot":"","sources":["../../src/__tests__/scopes.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAE9C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;QAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;YACjC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;YACvC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;QACpC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QACxC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;QACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QACxC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAChC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,SAAS,CAAC,wBAAwB,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/search.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/search.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from 'vitest';
+import { searchDocs } from '../tools/search.js';
+describe('searchDocs', () => {
+    it('returns results for "crm deal"', () => {
+        const results = searchDocs('crm deal');
+        expect(results.length).toBeGreaterThan(0);
+        // every result should have required fields
+        for (const r of results) {
+            expect(r).toHaveProperty('title');
+            expect(r).toHaveProperty('type');
+            expect(r).toHaveProperty('summary');
+            expect(r).toHaveProperty('ref');
+        }
+    });
+    it('returns empty array for nonexistent query', () => {
+        const results = searchDocs('xyznonexistentterm12345');
+        expect(results).toEqual([]);
+    });
+    it('respects limit parameter', () => {
+        const results = searchDocs('crm', 3);
+        expect(results.length).toBeLessThanOrEqual(3);
+    });
+    it('caps results at 50 even if higher limit is requested', () => {
+        const results = searchDocs('crm', 100);
+        expect(results.length).toBeLessThanOrEqual(50);
+    });
+    it('returns results sorted by relevance (score descending)', () => {
+        const results = searchDocs('crm deal');
+        // Results with higher score should come first - check no score field is exposed
+        for (const r of results) {
+            expect(r).not.toHaveProperty('score');
+        }
+    });
+    it('returns correct result types', () => {
+        const results = searchDocs('crm');
+        const types = new Set(results.map(r => r.type));
+        const validTypes = new Set(['placement', 'scope', 'method', 'category', 'app_type']);
+        for (const t of types) {
+            expect(validTypes.has(t)).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=search.test.js.map

package/dist/__tests__/search.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.test.js","sourceRoot":"","sources":["../../src/__tests__/search.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;QACtC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QACzC,2CAA2C;QAC3C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;YACjC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;YAChC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;YACnC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QACjC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,OAAO,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAA;QACrD,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QACpC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QACtC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;QACtC,gFAAgF;QAChF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACvC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAA;QACpF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtC,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/data/app-types.json

@@ -0,0 +1,64 @@
+[
+    {
+        "type": "IFRAME",
+        "title": "Iframe Application",
+        "description": "The application is embedded directly inside the Bitrix24 interface as an iframe. The application URL is loaded within a frame on the Bitrix24 portal page, and the app can use the BX24 JavaScript SDK to call REST methods, listen to events, and interact with the portal. This is the most common application type for interactive, user-facing tools. Use this type when your application needs to present a UI inside Bitrix24 and communicate with the portal in real time.",
+        "use_cases": [
+            "CRM integrations with custom UI tabs",
+            "Interactive dashboards embedded in Bitrix24",
+            "Custom forms and data-entry tools",
+            "Third-party service widgets displayed inside Bitrix24"
+        ],
+        "requirements": [
+            "Application must be served over HTTPS",
+            "Handler URL must return a valid HTML page",
+            "Use BX24.init() to initialise the JS SDK before calling methods"
+        ]
+    },
+    {
+        "type": "EXTERNAL",
+        "title": "External Application",
+        "description": "The application runs on an external server and communicates with Bitrix24 exclusively via the REST API using server-side requests. Users interact with the application on its own website or interface, not inside Bitrix24. OAuth 2.0 is used for authentication. Use this type for server-side integrations that process data in the background or operate independently of the Bitrix24 UI.",
+        "use_cases": [
+            "Background data synchronisation between Bitrix24 and third-party systems",
+            "Automated pipelines that process CRM data server-side",
+            "Reporting and analytics tools with their own UI",
+            "Webhook consumers that react to Bitrix24 events"
+        ],
+        "requirements": [
+            "Must implement OAuth 2.0 authorisation code flow",
+            "Application server must be publicly accessible for webhook callbacks",
+            "No BX24 JS SDK available (server-to-server only)"
+        ]
+    },
+    {
+        "type": "LINK",
+        "title": "Link Application",
+        "description": "A lightweight application type that simply opens an external URL (with optional parameters) when launched from Bitrix24. No iframe embedding occurs; Bitrix24 redirects or opens the link in a new browser tab. Useful for directing users to an external web application or documentation with context passed as query parameters.",
+        "use_cases": [
+            "Linking to external SaaS tools with pre-filled context (user ID, deal ID)",
+            "Deep-linking to third-party portals from Bitrix24",
+            "Quick-launch shortcuts to external dashboards or reporting systems"
+        ],
+        "requirements": [
+            "Target URL must be accessible to users",
+            "Parameters (user ID, portal domain, etc.) are passed as query string arguments"
+        ]
+    },
+    {
+        "type": "SERVER",
+        "title": "Server Application",
+        "description": "A server-side application that operates entirely via REST API without a user-facing iframe or redirect flow. Typically used for system-level integrations, automation scripts, and backend services that authenticate using application credentials (client_credentials grant) rather than per-user OAuth. Suitable for daemon processes and scheduled jobs that interact with Bitrix24 data.",
+        "use_cases": [
+            "Scheduled batch jobs that sync data between Bitrix24 and external databases",
+            "Event-driven automations triggered by Bitrix24 webhooks",
+            "System integrations running as background services",
+            "Administrative tools that operate under a service account"
+        ],
+        "requirements": [
+            "Must use client_credentials OAuth grant or application-level tokens",
+            "No user interaction or browser-based redirect required",
+            "Application server must handle incoming webhook events if subscribing to events"
+        ]
+    }
+]

package/dist/data/categories.json

@@ -0,0 +1,32 @@
+[
+    {
+        "code": "CRM",
+        "title": "CRM",
+        "description": "Applications that extend or integrate with Bitrix24 CRM. Includes apps for deal automation, lead enrichment, contact synchronisation, and CRM analytics integrations."
+    },
+    {
+        "code": "TELEPHONY",
+        "title": "Telephony",
+        "description": "Applications that integrate VoIP, PBX, or call centre systems with Bitrix24 telephony. Includes SIP connectors, call tracking, and click-to-call integrations."
+    },
+    {
+        "code": "DATA_MIGRATION",
+        "title": "Data Migration",
+        "description": "Applications that import or export data between Bitrix24 and external systems. Includes bulk import tools, CRM migration utilities, and data synchronisation connectors."
+    },
+    {
+        "code": "SMS_PROVIDER",
+        "title": "SMS Provider",
+        "description": "Applications that register a custom SMS provider for sending text messages from Bitrix24. Used to integrate external SMS gateways with Bitrix24 CRM notifications and marketing."
+    },
+    {
+        "code": "PAYMENT_SYSTEM",
+        "title": "Payment System",
+        "description": "Applications that integrate external payment gateways with the Bitrix24 online store. Registers a custom payment handler so customers can pay using third-party payment services."
+    },
+    {
+        "code": "BUSINESS_APP",
+        "title": "Business Application",
+        "description": "General-purpose business applications that extend Bitrix24 with custom functionality. Includes productivity tools, HR integrations, document management, and other business process automation."
+    }
+]