@goatlab/typesense 0.0.2

package/dist/components/typesense.filter-builder.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Safe filter builder for Typesense to prevent injection and typos
+ */
+export declare class TypesenseFilterBuilder {
+    private filters;
+    /**
+     * Add an equality filter
+     * @param field - Field name to filter on
+     * @param value - Value to match
+     */
+    equals(field: string, value: string | number | boolean): this;
+    /**
+     * Add a not-equals filter
+     * @param field - Field name to filter on
+     * @param value - Value to not match
+     */
+    notEquals(field: string, value: string | number | boolean): this;
+    /**
+     * Add an IN filter for matching multiple values
+     * @param field - Field name to filter on
+     * @param values - Array of values to match
+     */
+    in(field: string, values: Array<string | number>): this;
+    /**
+     * Add a NOT IN filter
+     * @param field - Field name to filter on
+     * @param values - Array of values to not match
+     */
+    notIn(field: string, values: Array<string | number>): this;
+    /**
+     * Add a greater than filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to compare against
+     */
+    greaterThan(field: string, value: number): this;
+    /**
+     * Add a greater than or equal filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to compare against
+     */
+    greaterThanOrEqual(field: string, value: number): this;
+    /**
+     * Add a less than filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to compare against
+     */
+    lessThan(field: string, value: number): this;
+    /**
+     * Add a less than or equal filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to compare against
+     */
+    lessThanOrEqual(field: string, value: number): this;
+    /**
+     * Add a range filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param min - Minimum value (inclusive)
+     * @param max - Maximum value (inclusive)
+     */
+    range(field: string, min: number, max: number): this;
+    /**
+     * Add a contains filter (string fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to search for
+     */
+    contains(field: string, value: string): this;
+    /**
+     * Add a starts with filter (string fields only)
+     * @param field - Field name to filter on
+     * @param value - Prefix to match
+     */
+    startsWith(field: string, value: string): this;
+    /**
+     * Add a ends with filter (string fields only)
+     * @param field - Field name to filter on
+     * @param value - Suffix to match
+     */
+    endsWith(field: string, value: string): this;
+    /**
+     * Add an exists/not null filter
+     * @param field - Field name to check
+     */
+    exists(field: string): this;
+    /**
+     * Add a not exists/null filter
+     * @param field - Field name to check
+     */
+    notExists(field: string): this;
+    /**
+     * Group filters with AND logic
+     * @param callback - Callback to build grouped filters
+     */
+    and(callback: (builder: TypesenseFilterBuilder) => void): this;
+    /**
+     * Group filters with OR logic
+     * @param callback - Callback to build grouped filters
+     */
+    or(callback: (builder: TypesenseFilterBuilder) => void): this;
+    /**
+     * Add a raw filter expression (use with caution)
+     * @param expression - Raw filter expression
+     */
+    raw(expression: string): this;
+    /**
+     * Build the final filter string
+     * @returns The constructed filter string
+     */
+    build(): string;
+    /**
+     * Reset the builder
+     */
+    reset(): this;
+    /**
+     * Escape field name to prevent injection
+     * @private
+     */
+    private escapeField;
+    /**
+     * Escape value to prevent injection
+     * @private
+     */
+    private escapeValue;
+}
+/**
+ * Create a new filter builder instance
+ */
+export declare function filterBuilder(): TypesenseFilterBuilder;

package/dist/components/typesense.filter-builder.js

@@ -0,0 +1,216 @@
+"use strict";
+// npx vitest run ./src/services/search/typesense.filter-builder.test.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypesenseFilterBuilder = void 0;
+exports.filterBuilder = filterBuilder;
+/**
+ * Safe filter builder for Typesense to prevent injection and typos
+ */
+class TypesenseFilterBuilder {
+    filters = [];
+    /**
+     * Add an equality filter
+     * @param field - Field name to filter on
+     * @param value - Value to match
+     */
+    equals(field, value) {
+        this.filters.push(`${this.escapeField(field)}:=${this.escapeValue(value)}`);
+        return this;
+    }
+    /**
+     * Add a not-equals filter
+     * @param field - Field name to filter on
+     * @param value - Value to not match
+     */
+    notEquals(field, value) {
+        this.filters.push(`${this.escapeField(field)}:!=${this.escapeValue(value)}`);
+        return this;
+    }
+    /**
+     * Add an IN filter for matching multiple values
+     * @param field - Field name to filter on
+     * @param values - Array of values to match
+     */
+    in(field, values) {
+        const escapedValues = values.map(v => this.escapeValue(v)).join(', ');
+        this.filters.push(`${this.escapeField(field)}:=[${escapedValues}]`);
+        return this;
+    }
+    /**
+     * Add a NOT IN filter
+     * @param field - Field name to filter on
+     * @param values - Array of values to not match
+     */
+    notIn(field, values) {
+        const escapedValues = values.map(v => this.escapeValue(v)).join(', ');
+        this.filters.push(`${this.escapeField(field)}:!=[${escapedValues}]`);
+        return this;
+    }
+    /**
+     * Add a greater than filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to compare against
+     */
+    greaterThan(field, value) {
+        this.filters.push(`${this.escapeField(field)}:>${value}`);
+        return this;
+    }
+    /**
+     * Add a greater than or equal filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to compare against
+     */
+    greaterThanOrEqual(field, value) {
+        this.filters.push(`${this.escapeField(field)}:>=${value}`);
+        return this;
+    }
+    /**
+     * Add a less than filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to compare against
+     */
+    lessThan(field, value) {
+        this.filters.push(`${this.escapeField(field)}:<${value}`);
+        return this;
+    }
+    /**
+     * Add a less than or equal filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to compare against
+     */
+    lessThanOrEqual(field, value) {
+        this.filters.push(`${this.escapeField(field)}:<=${value}`);
+        return this;
+    }
+    /**
+     * Add a range filter (numeric fields only)
+     * @param field - Field name to filter on
+     * @param min - Minimum value (inclusive)
+     * @param max - Maximum value (inclusive)
+     */
+    range(field, min, max) {
+        this.filters.push(`${this.escapeField(field)}:>=${min} && ${this.escapeField(field)}:<=${max}`);
+        return this;
+    }
+    /**
+     * Add a contains filter (string fields only)
+     * @param field - Field name to filter on
+     * @param value - Value to search for
+     */
+    contains(field, value) {
+        this.filters.push(`${this.escapeField(field)}:*${this.escapeValue(value)}*`);
+        return this;
+    }
+    /**
+     * Add a starts with filter (string fields only)
+     * @param field - Field name to filter on
+     * @param value - Prefix to match
+     */
+    startsWith(field, value) {
+        this.filters.push(`${this.escapeField(field)}:${this.escapeValue(value)}*`);
+        return this;
+    }
+    /**
+     * Add a ends with filter (string fields only)
+     * @param field - Field name to filter on
+     * @param value - Suffix to match
+     */
+    endsWith(field, value) {
+        this.filters.push(`${this.escapeField(field)}:*${this.escapeValue(value)}`);
+        return this;
+    }
+    /**
+     * Add an exists/not null filter
+     * @param field - Field name to check
+     */
+    exists(field) {
+        this.filters.push(`${this.escapeField(field)}:!=null`);
+        return this;
+    }
+    /**
+     * Add a not exists/null filter
+     * @param field - Field name to check
+     */
+    notExists(field) {
+        this.filters.push(`${this.escapeField(field)}:=null`);
+        return this;
+    }
+    /**
+     * Group filters with AND logic
+     * @param callback - Callback to build grouped filters
+     */
+    and(callback) {
+        const subBuilder = new TypesenseFilterBuilder();
+        callback(subBuilder);
+        const subFilter = subBuilder.build();
+        if (subFilter) {
+            this.filters.push(`(${subFilter})`);
+        }
+        return this;
+    }
+    /**
+     * Group filters with OR logic
+     * @param callback - Callback to build grouped filters
+     */
+    or(callback) {
+        const subBuilder = new TypesenseFilterBuilder();
+        callback(subBuilder);
+        const subFilters = subBuilder.filters;
+        if (subFilters.length > 0) {
+            this.filters.push(`(${subFilters.join(' || ')})`);
+        }
+        return this;
+    }
+    /**
+     * Add a raw filter expression (use with caution)
+     * @param expression - Raw filter expression
+     */
+    raw(expression) {
+        this.filters.push(expression);
+        return this;
+    }
+    /**
+     * Build the final filter string
+     * @returns The constructed filter string
+     */
+    build() {
+        return this.filters.join(' && ');
+    }
+    /**
+     * Reset the builder
+     */
+    reset() {
+        this.filters = [];
+        return this;
+    }
+    /**
+     * Escape field name to prevent injection
+     * @private
+     */
+    escapeField(field) {
+        // Field names in Typesense can contain alphanumeric characters and underscores
+        if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(field)) {
+            throw new Error(`Invalid field name: ${field}. Field names must start with a letter or underscore and contain only alphanumeric characters and underscores.`);
+        }
+        return field;
+    }
+    /**
+     * Escape value to prevent injection
+     * @private
+     */
+    escapeValue(value) {
+        if (typeof value === 'string') {
+            // Escape backslashes first, then quotes
+            return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+        }
+        return String(value);
+    }
+}
+exports.TypesenseFilterBuilder = TypesenseFilterBuilder;
+/**
+ * Create a new filter builder instance
+ */
+function filterBuilder() {
+    return new TypesenseFilterBuilder();
+}
+//# sourceMappingURL=typesense.filter-builder.js.map

package/dist/components/typesense.filter-builder.js.map

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

package/dist/examples/multitenancy-example.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Example of using TypesenseApi with multitenancy support
+ */
+export {};

package/dist/examples/multitenancy-example.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * Example of using TypesenseApi with multitenancy support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const TypesenseApi_1 = require("../TypesenseApi");
+const tenant_1 = require("../utils/tenant");
+// Example 1: Creating separate API instances for different tenants
+async function example1() {
+    // API instance for tenant "acme"
+    const acmeApi = new TypesenseApi_1.TypesenseApi({
+        prefixUrl: 'http://localhost:8108',
+        token: 'xyz',
+        tenantId: 'acme',
+        collectionName: 'products'
+    });
+    // API instance for tenant "globex"
+    const globexApi = new TypesenseApi_1.TypesenseApi({
+        prefixUrl: 'http://localhost:8108',
+        token: 'xyz',
+        tenantId: 'globex',
+        collectionName: 'products'
+    });
+    // Define schema
+    const productSchema = {
+        name: 'products',
+        fields: [
+            { name: 'name', type: 'string' },
+            { name: 'price', type: 'float' },
+            { name: 'category', type: 'string', facet: true }
+        ]
+    };
+    // Create collections - each tenant gets their own prefixed collection
+    // This creates "acme__products" collection
+    await acmeApi.collections.create(productSchema);
+    // This creates "globex__products" collection
+    await globexApi.collections.create(productSchema);
+    // Insert documents - completely isolated between tenants
+    await acmeApi.documents.insert({
+        id: '1',
+        name: 'Acme Widget',
+        price: 19.99,
+        category: 'widgets'
+    });
+    await globexApi.documents.insert({
+        id: '1', // Same ID is fine - different collection
+        name: 'Globex Gadget',
+        price: 29.99,
+        category: 'gadgets'
+    });
+    // Search - each tenant only sees their own data
+    const acmeResults = await acmeApi.search.text({
+        q: '*',
+        query_by: 'name'
+    });
+    console.log('Acme products:', acmeResults.hits); // Only Acme Widget
+    const globexResults = await globexApi.search.text({
+        q: '*',
+        query_by: 'name'
+    });
+    console.log('Globex products:', globexResults.hits); // Only Globex Gadget
+}
+// Example 2: Admin operations across tenants
+async function example2() {
+    const adminApi = new TypesenseApi_1.TypesenseApi({
+        prefixUrl: 'http://localhost:8108',
+        token: 'xyz',
+        tenantId: 'acme'
+    });
+    // List all collections for the tenant
+    const tenantCollections = await adminApi.listTenantCollections();
+    console.log('Acme collections:', tenantCollections);
+    // Output: ['acme__products', 'acme__users', 'acme__orders']
+    // Get base collection names (without tenant prefix)
+    const baseNames = await adminApi.listTenantBaseCollectionNames();
+    console.log('Base collection names:', baseNames);
+    // Output: ['products', 'users', 'orders']
+    // Check if a specific collection exists
+    const exists = await adminApi.tenantCollectionExists('products');
+    console.log('Products collection exists:', exists);
+    // Delete all tenant data (use with caution!)
+    // await adminApi.deleteAllTenantCollections()
+}
+// Example 3: Working with multiple collections per tenant
+async function example3() {
+    const api = new TypesenseApi_1.TypesenseApi({
+        prefixUrl: 'http://localhost:8108',
+        token: 'xyz',
+        tenantId: 'acme'
+    });
+    // Create multiple collections for the tenant
+    await api.collections.create({
+        name: 'users',
+        fields: [
+            { name: 'email', type: 'string' },
+            { name: 'name', type: 'string' }
+        ]
+    });
+    await api.collections.create({
+        name: 'orders',
+        fields: [
+            { name: 'order_id', type: 'string' },
+            { name: 'user_email', type: 'string' },
+            { name: 'total', type: 'float' }
+        ]
+    });
+    // Work with different collections by changing the context
+    const userApi = new TypesenseApi_1.TypesenseApi({
+        prefixUrl: 'http://localhost:8108',
+        token: 'xyz',
+        tenantId: 'acme',
+        collectionName: 'users'
+    });
+    const orderApi = new TypesenseApi_1.TypesenseApi({
+        prefixUrl: 'http://localhost:8108',
+        token: 'xyz',
+        tenantId: 'acme',
+        collectionName: 'orders'
+    });
+    // Insert data into different collections
+    await userApi.documents.insert({
+        id: 'user-1',
+        email: 'john@acme.com',
+        name: 'John Doe'
+    });
+    await orderApi.documents.insert({
+        id: 'ORD-001',
+        order_id: 'ORD-001',
+        user_email: 'john@acme.com',
+        total: 99.99
+    });
+}
+// Example 4: Migrating existing non-tenant data
+async function example4() {
+    // API without tenant (legacy mode)
+    const legacyApi = new TypesenseApi_1.TypesenseApi({
+        prefixUrl: 'http://localhost:8108',
+        token: 'xyz',
+        collectionName: 'products'
+    });
+    // API with tenant
+    const tenantApi = new TypesenseApi_1.TypesenseApi({
+        prefixUrl: 'http://localhost:8108',
+        token: 'xyz',
+        tenantId: 'legacy',
+        collectionName: 'products'
+    });
+    // Export from legacy collection
+    const legacyData = await legacyApi.documents.export();
+    // Create new tenant collection
+    const schema = await legacyApi.collections.get('products');
+    await tenantApi.collections.create(schema);
+    // Import into tenant collection
+    await tenantApi.documents.import(legacyData);
+}
+// Example 5: Using tenant utilities directly
+async function example5() {
+    // Validate tenant ID
+    try {
+        const tenantId = (0, tenant_1.sanitizeTenantId)('ACME-Corp');
+        console.log('Sanitized:', tenantId); // 'acme-corp'
+    }
+    catch (error) {
+        console.error('Invalid tenant ID:', error.message);
+    }
+    // Create fully qualified collection name
+    const fqcn = (0, tenant_1.createFQCN)('acme', 'products');
+    console.log('FQCN:', fqcn); // 'acme__products'
+    // Parse collection name
+    const parsed = (0, tenant_1.parseFQCN)('acme__products');
+    console.log('Parsed:', parsed); // { tenantId: 'acme', baseCollectionName: 'products' }
+    // Filter collections by tenant
+    const allCollections = [
+        'acme__products',
+        'acme__users',
+        'globex__products',
+        'legacy_collection'
+    ];
+    const acmeCollections = (0, tenant_1.filterCollectionsByTenant)(allCollections, 'acme');
+    console.log('Acme collections:', acmeCollections); // ['acme__products', 'acme__users']
+}
+//# sourceMappingURL=multitenancy-example.js.map

package/dist/examples/multitenancy-example.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { TypesenseApi } from './TypesenseApi';
+export * from './types';
+export * from './typesense.model';
+export { TypesenseHttpClient } from './components/http-client';
+export { ResiliencePolicy } from './components/resilience-policy';
+export { CollectionSchemaManager } from './components/schema-manager';
+export { ExportFormatter } from './components/export-formatter';
+export { TypesenseFilterBuilder } from './components/typesense.filter-builder';
+export * from './TypesenseApi';
+export type { TypesenseFieldType, TypesenseCollection, TypesenseDocument, TypesenseDocumentGeneric, TypesenseQuery, TypesenseCollectionOutput, TypesenseQueryResults } from './typesense.model';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypesenseFilterBuilder = exports.ExportFormatter = exports.CollectionSchemaManager = exports.ResiliencePolicy = exports.TypesenseHttpClient = exports.TypesenseApi = void 0;
+const tslib_1 = require("tslib");
+// Main exports
+var TypesenseApi_1 = require("./TypesenseApi");
+Object.defineProperty(exports, "TypesenseApi", { enumerable: true, get: function () { return TypesenseApi_1.TypesenseApi; } });
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./typesense.model"), exports);
+// Component exports
+var http_client_1 = require("./components/http-client");
+Object.defineProperty(exports, "TypesenseHttpClient", { enumerable: true, get: function () { return http_client_1.TypesenseHttpClient; } });
+var resilience_policy_1 = require("./components/resilience-policy");
+Object.defineProperty(exports, "ResiliencePolicy", { enumerable: true, get: function () { return resilience_policy_1.ResiliencePolicy; } });
+var schema_manager_1 = require("./components/schema-manager");
+Object.defineProperty(exports, "CollectionSchemaManager", { enumerable: true, get: function () { return schema_manager_1.CollectionSchemaManager; } });
+var export_formatter_1 = require("./components/export-formatter");
+Object.defineProperty(exports, "ExportFormatter", { enumerable: true, get: function () { return export_formatter_1.ExportFormatter; } });
+var typesense_filter_builder_1 = require("./components/typesense.filter-builder");
+Object.defineProperty(exports, "TypesenseFilterBuilder", { enumerable: true, get: function () { return typesense_filter_builder_1.TypesenseFilterBuilder; } });
+// Re-export all action functions
+tslib_1.__exportStar(require("./TypesenseApi"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA,eAAe;AACf,+CAA6C;AAApC,4GAAA,YAAY,OAAA;AACrB,kDAAuB;AACvB,4DAAiC;AAEjC,oBAAoB;AACpB,wDAA8D;AAArD,kHAAA,mBAAmB,OAAA;AAC5B,oEAAiE;AAAxD,qHAAA,gBAAgB,OAAA;AACzB,8DAAqE;AAA5D,yHAAA,uBAAuB,OAAA;AAChC,kEAA+D;AAAtD,mHAAA,eAAe,OAAA;AACxB,kFAA8E;AAArE,kIAAA,sBAAsB,OAAA;AAE/B,iCAAiC;AACjC,yDAA8B"}

package/dist/tests/const.d.ts

@@ -0,0 +1,6 @@
+export type GlobalTempData = {
+    typesenseUrl?: string;
+};
+export declare const getGlobalData: () => GlobalTempData;
+export declare const writeGlobalData: (data: GlobalTempData) => void;
+export declare const cleanGlobalData: () => void;

package/dist/tests/const.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanGlobalData = exports.writeGlobalData = exports.getGlobalData = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const tempDataFilePath = (0, path_1.resolve)((0, path_1.join)(__dirname, '../../'), 'tempData.json');
+const getGlobalData = () => {
+    const data = JSON.parse((0, fs_1.readFileSync)(tempDataFilePath, 'utf-8'));
+    return data;
+};
+exports.getGlobalData = getGlobalData;
+const writeGlobalData = (data) => {
+    (0, fs_1.writeFileSync)(tempDataFilePath, JSON.stringify(data), 'utf-8');
+};
+exports.writeGlobalData = writeGlobalData;
+const cleanGlobalData = () => {
+    if ((0, fs_1.existsSync)(tempDataFilePath)) {
+        (0, fs_1.unlinkSync)(tempDataFilePath);
+    }
+};
+exports.cleanGlobalData = cleanGlobalData;
+//# sourceMappingURL=const.js.map

package/dist/tests/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../src/tests/const.ts"],"names":[],"mappings":";;;AAAA,2BAAwE;AACxE,+BAAoC;AAKpC,MAAM,gBAAgB,GAAG,IAAA,cAAO,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAA;AAErE,MAAM,aAAa,GAAG,GAAmB,EAAE;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAA;IAEhE,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAJY,QAAA,aAAa,iBAIzB;AAEM,MAAM,eAAe,GAAG,CAAC,IAAoB,EAAE,EAAE;IACtD,IAAA,kBAAa,EAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;AAChE,CAAC,CAAA;AAFY,QAAA,eAAe,mBAE3B;AAEM,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,IAAI,IAAA,eAAU,EAAC,gBAAgB,CAAC,EAAE,CAAC;QACjC,IAAA,eAAU,EAAC,gBAAgB,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC,CAAA;AAJY,QAAA,eAAe,mBAI3B"}

package/dist/tests/typesense.d.ts

@@ -0,0 +1,2 @@
+import { GenericContainer } from 'testcontainers';
+export declare const typesenseContainer: GenericContainer;

package/dist/tests/typesense.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typesenseContainer = void 0;
+const testcontainers_1 = require("testcontainers");
+exports.typesenseContainer = new testcontainers_1.GenericContainer('typesense/typesense:29.0')
+    .withEnvironment({
+    TYPESENSE_API_KEY: 'MY_API_KEY'
+})
+    .withCommand([
+    '--data-dir',
+    '/tmp',
+    '--api-key',
+    'MY_API_KEY',
+    '--enable-cors',
+    'true',
+    '--enable-search-analytic',
+    'true',
+    '--analytics-dir',
+    '/path/to/analytics-data',
+    '--analytics-flush-interval',
+    '300'
+])
+    .withExposedPorts(8108);
+//# sourceMappingURL=typesense.js.map

package/dist/tests/typesense.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesense.js","sourceRoot":"","sources":["../../src/tests/typesense.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAEpC,QAAA,kBAAkB,GAAG,IAAI,iCAAgB,CACpD,0BAA0B,CAC3B;KACE,eAAe,CAAC;IACf,iBAAiB,EAAE,YAAY;CAChC,CAAC;KACD,WAAW,CAAC;IACX,YAAY;IACZ,MAAM;IACN,WAAW;IACX,YAAY;IACZ,eAAe;IACf,MAAM;IACN,0BAA0B;IAC1B,MAAM;IACN,iBAAiB;IACjB,yBAAyB;IACzB,4BAA4B;IAC5B,KAAK;CACN,CAAC;KACD,gBAAgB,CAAC,IAAI,CAAC,CAAA"}