@goatlab/typesense 0.0.2 → 0.0.4

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypesenseFilterBuilder = exports.ExportFormatter = exports.CollectionSchemaManager = exports.ResiliencePolicy = exports.TypesenseHttpClient = exports.TypesenseApi = void 0;
+exports.createSchemaTypedApi = exports.defineCollection = 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");
@@ -20,4 +20,9 @@ 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);
+// Schema utilities
+var schema_to_types_1 = require("./utils/schema-to-types");
+Object.defineProperty(exports, "defineCollection", { enumerable: true, get: function () { return schema_to_types_1.defineCollection; } });
+var schema_typed_api_1 = require("./utils/schema-typed-api");
+Object.defineProperty(exports, "createSchemaTypedApi", { enumerable: true, get: function () { return schema_typed_api_1.createSchemaTypedApi; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAI9B,mBAAmB;AACnB,2DAIgC;AAH9B,mHAAA,gBAAgB,OAAA;AAKlB,6DAEiC;AAD/B,wHAAA,oBAAoB,OAAA"}

package/dist/tests/type-inference-example.d.ts

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

package/dist/tests/type-inference-example.js

@@ -0,0 +1,91 @@
+"use strict";
+// Example demonstrating TypeScript type inference for Typesense
+// npx vitest run ./src/tests/type-inference-example.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+(0, vitest_1.describe)('Type Inference Example', () => {
+    (0, vitest_1.it)('should demonstrate proper type inference', () => {
+        // Define a strongly-typed collection
+        const ProductCollection = (0, index_1.defineCollection)({
+            name: 'products',
+            fields: [
+                { name: 'id', type: 'string' },
+                { name: 'title', type: 'string' },
+                { name: 'description', type: 'string', optional: true },
+                { name: 'price', type: 'float' },
+                { name: 'inStock', type: 'bool' },
+                { name: 'tags', type: 'string[]', optional: true }
+            ]
+        });
+        // These should compile without errors
+        const validDoc1 = {
+            title: 'Laptop',
+            price: 999.99,
+            inStock: true
+        };
+        const validDoc2 = {
+            title: 'Gaming Laptop',
+            description: 'High-performance laptop',
+            price: 1999.99,
+            inStock: true,
+            tags: ['gaming', 'performance']
+        };
+        // Create typed API
+        const api = (0, index_1.createSchemaTypedApi)(ProductCollection)({
+            prefixUrl: 'http://localhost:8108',
+            token: 'xyz'
+        });
+        // Verify API structure
+        (0, vitest_1.expect)(api).toBeDefined();
+        (0, vitest_1.expect)(api.documents).toBeDefined();
+        (0, vitest_1.expect)(typeof api.documents.insert).toBe('function');
+        // The following would be compile errors if uncommented:
+        // ❌ Missing required field
+        // const invalidDoc1: ProductDoc = {
+        //   price: 99.99,
+        //   inStock: true
+        // }
+        // ❌ Wrong type for price
+        // const invalidDoc2: ProductDoc = {
+        //   title: 'Product',
+        //   price: '99.99', // should be number
+        //   inStock: true
+        // }
+        // ❌ Wrong type for optional field
+        // const invalidDoc3: ProductDoc = {
+        //   title: 'Product',
+        //   price: 99.99,
+        //   inStock: true,
+        //   tags: 'single-tag' // should be string[]
+        // }
+    });
+    (0, vitest_1.it)('should handle complex field types', () => {
+        const EventCollection = (0, index_1.defineCollection)({
+            name: 'events',
+            fields: [
+                { name: 'id', type: 'string' },
+                { name: 'name', type: 'string' },
+                { name: 'timestamp', type: 'int64' },
+                { name: 'location', type: 'geopoint' },
+                { name: 'attendees', type: 'int32[]', optional: true },
+                { name: 'metadata', type: 'object', optional: true }
+            ]
+        });
+        const validEvent = {
+            name: 'Tech Conference',
+            timestamp: Date.now(),
+            location: [37.7749, -122.4194]
+        };
+        const validEventWithOptionals = {
+            name: 'Meetup',
+            timestamp: Date.now(),
+            location: [40.7128, -74.0060],
+            attendees: [10, 20, 30],
+            metadata: { organizer: 'John', venue: 'Tech Hub' }
+        };
+        (0, vitest_1.expect)(validEvent).toBeDefined();
+        (0, vitest_1.expect)(validEventWithOptionals).toBeDefined();
+    });
+});
+//# sourceMappingURL=type-inference-example.js.map

package/dist/tests/type-inference-example.js.map

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

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import type { TypesenseHttpClient } from './components/http-client';
 import type { ResiliencePolicy } from './components/resilience-policy';
 import type { CollectionSchemaManager } from './components/schema-manager';
-export interface TypesenseContext {
+export interface TypesenseContext<TDoc = unknown> {
     httpClient: TypesenseHttpClient;
     resilience: ResiliencePolicy;
     schemaManager: CollectionSchemaManager;
@@ -11,6 +11,7 @@ export interface TypesenseContext {
     autoCreateCollection?: boolean;
     suppressLogs?: boolean;
     fqcn: (baseCollectionName?: string) => string;
+    docType?: TDoc;
 }
 export type Rest<Ctx, A> = Omit<A, keyof Ctx>;
 export type Callable<F extends (a: any) => any, Ctx> = Rest<Ctx, Parameters<F>[0]> extends Record<string, never> ? () => ReturnType<F> : (arg: Rest<Ctx, Parameters<F>[0]>) => ReturnType<F>;

package/dist/typesense.model.d.ts

@@ -31,6 +31,7 @@ export interface TypesenseCollectionField {
     num_dim?: number;
     vec_dist?: 'cosine' | 'ip' | 'l2';
     store?: boolean;
+    schema?: TypesenseCollectionField[];
 }
 export interface TypesenseCollection {
     name: string;

package/dist/typesense.model.js.map

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

package/dist/utils/schema-to-types.d.ts

@@ -0,0 +1,46 @@
+import type { TypesenseCollection, TypesenseCollectionField } from '../typesense.model';
+/**
+ * Helper type to preserve literal types
+ */
+type Literal<T> = T extends string ? T : never;
+/**
+ * Maps field type to TypeScript type
+ */
+type FieldTypeToTS<T extends TypesenseCollectionField['type']> = T extends 'string' ? string : T extends 'string[]' ? string[] : T extends 'int32' | 'int64' ? number : T extends 'int32[]' | 'int64[]' ? number[] : T extends 'float' ? number : T extends 'float[]' ? number[] : T extends 'bool' ? boolean : T extends 'bool[]' ? boolean[] : T extends 'geopoint' ? [number, number] : T extends 'geopoint[]' ? [number, number][] : T extends 'auto' ? string | string[] : T extends 'object' ? Record<string, any> : T extends 'object[]' ? Record<string, any>[] : any;
+/**
+ * Extract required fields (fields without optional: true)
+ */
+type RequiredFields<C extends TypesenseCollection> = Exclude<C['fields'][number], {
+    optional: true;
+}>;
+/**
+ * Extract optional fields
+ */
+type OptionalFields<C extends TypesenseCollection> = Extract<C['fields'][number], {
+    optional: true;
+}>;
+/**
+ * Map required fields to object type
+ */
+type RequiredFieldsType<C extends TypesenseCollection> = {
+    [F in RequiredFields<C> as Literal<F['name']> extends 'id' ? never : Literal<F['name']>]: FieldTypeToTS<F['type']>;
+};
+/**
+ * Map optional fields to object type
+ */
+type OptionalFieldsType<C extends TypesenseCollection> = {
+    [F in OptionalFields<C> as Literal<F['name']> extends 'id' ? never : Literal<F['name']>]?: FieldTypeToTS<F['type']>;
+};
+/**
+ * Infers the document type from a collection (excluding id for TypesenseApi compatibility)
+ */
+export type InferDocumentType<C extends TypesenseCollection> = RequiredFieldsType<C> & OptionalFieldsType<C>;
+/**
+ * Infers the TypeScript type from a collection definition
+ */
+export type InferFromCollection<C extends TypesenseCollection> = InferDocumentType<C>;
+/**
+ * Helper to create a typed collection definition
+ */
+export declare function defineCollection<const C extends TypesenseCollection>(collection: C): C;
+export {};

package/dist/utils/schema-to-types.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineCollection = defineCollection;
+/**
+ * Helper to create a typed collection definition
+ */
+function defineCollection(collection) {
+    return collection;
+}
+//# sourceMappingURL=schema-to-types.js.map

package/dist/utils/schema-to-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-types.js","sourceRoot":"","sources":["../../src/utils/schema-to-types.ts"],"names":[],"mappings":";;AAqEA,4CAEC;AALD;;GAEG;AACH,SAAgB,gBAAgB,CAAsC,UAAa;IACjF,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/utils/schema-typed-api.d.ts

@@ -0,0 +1,33 @@
+import type { TypesenseCollection } from '../typesense.model';
+import { TypesenseApi, type TypesenseApiOptions } from '../TypesenseApi';
+import { type InferFromCollection } from './schema-to-types';
+/**
+ * Creates a strongly-typed API instance from a collection definition
+ *
+ * @example
+ * ```typescript
+ * const ProductCollection = defineCollection({
+ *   name: 'products',
+ *   fields: [
+ *     { name: 'id', type: 'string' },
+ *     { name: 'name', type: 'string' },
+ *     { name: 'price', type: 'float' },
+ *     { name: 'inStock', type: 'bool' }
+ *   ]
+ * })
+ *
+ * const api = createSchemaTypedApi(ProductCollection)({
+ *   prefixUrl: 'http://localhost:8108',
+ *   token: 'xyz'
+ * })
+ *
+ * // Fully typed operations
+ * await api.documents.insert({
+ *   id: '1',
+ *   name: 'Widget',
+ *   price: 99.99,
+ *   inStock: true
+ * })
+ * ```
+ */
+export declare function createSchemaTypedApi<const C extends TypesenseCollection>(collection: C): (options: Omit<TypesenseApiOptions, "collectionName">) => TypesenseApi<InferFromCollection<C>>;

package/dist/utils/schema-typed-api.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSchemaTypedApi = createSchemaTypedApi;
+const TypesenseApi_1 = require("../TypesenseApi");
+/**
+ * Creates a strongly-typed API instance from a collection definition
+ *
+ * @example
+ * ```typescript
+ * const ProductCollection = defineCollection({
+ *   name: 'products',
+ *   fields: [
+ *     { name: 'id', type: 'string' },
+ *     { name: 'name', type: 'string' },
+ *     { name: 'price', type: 'float' },
+ *     { name: 'inStock', type: 'bool' }
+ *   ]
+ * })
+ *
+ * const api = createSchemaTypedApi(ProductCollection)({
+ *   prefixUrl: 'http://localhost:8108',
+ *   token: 'xyz'
+ * })
+ *
+ * // Fully typed operations
+ * await api.documents.insert({
+ *   id: '1',
+ *   name: 'Widget',
+ *   price: 99.99,
+ *   inStock: true
+ * })
+ * ```
+ */
+function createSchemaTypedApi(collection) {
+    return (options) => {
+        return new TypesenseApi_1.TypesenseApi({
+            ...options,
+            collectionName: collection.name
+        });
+    };
+}
+//# sourceMappingURL=schema-typed-api.js.map

package/dist/utils/schema-typed-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-typed-api.js","sourceRoot":"","sources":["../../src/utils/schema-typed-api.ts"],"names":[],"mappings":";;AAiCA,oDAWC;AA3CD,kDAAwE;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,oBAAoB,CAClC,UAAa;IAIb,OAAO,CAAC,OAAoD,EAAyB,EAAE;QACrF,OAAO,IAAI,2BAAY,CAAU;YAC/B,GAAG,OAAO;YACV,cAAc,EAAE,UAAU,CAAC,IAAI;SACT,CAAC,CAAA;IAC3B,CAAC,CAAA;AACH,CAAC"}

package/dist/utils/tenant.d.ts

@@ -46,3 +46,12 @@ export declare function isTenantCollection(collectionName: string): boolean;
  * @returns Collections belonging to the specified tenant
  */
 export declare function filterCollectionsByTenant(collections: string[], tenantId: string): string[];
+/**
+ * Creates a tenant-qualified resource name for aliases, synonyms, presets, etc.
+ * This ensures tenant isolation for all Typesense resources, not just collections
+ *
+ * @param tenantId - Optional tenant ID (if not provided, returns the resource name as-is)
+ * @param resourceName - Base resource name
+ * @returns Tenant-qualified resource name or original name
+ */
+export declare function createTenantQualifiedName(tenantId: string | undefined, resourceName: string): string;

package/dist/utils/tenant.js

@@ -8,6 +8,7 @@ exports.createFQCN = createFQCN;
 exports.parseFQCN = parseFQCN;
 exports.isTenantCollection = isTenantCollection;
 exports.filterCollectionsByTenant = filterCollectionsByTenant;
+exports.createTenantQualifiedName = createTenantQualifiedName;
 /**
  * Validates and sanitizes a tenant ID for use in collection names
  * - Enforces allowed characters: a-zA-Z0-9_-
@@ -86,4 +87,15 @@ function filterCollectionsByTenant(collections, tenantId) {
     const prefix = `${tenantId}__`;
     return collections.filter(name => name.startsWith(prefix));
 }
+/**
+ * Creates a tenant-qualified resource name for aliases, synonyms, presets, etc.
+ * This ensures tenant isolation for all Typesense resources, not just collections
+ *
+ * @param tenantId - Optional tenant ID (if not provided, returns the resource name as-is)
+ * @param resourceName - Base resource name
+ * @returns Tenant-qualified resource name or original name
+ */
+function createTenantQualifiedName(tenantId, resourceName) {
+    return tenantId ? `${tenantId}__${resourceName}` : resourceName;
+}
 //# sourceMappingURL=tenant.js.map

package/dist/utils/tenant.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenant.js","sourceRoot":"","sources":["../../src/utils/tenant.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,4CA2BC;AAUD,gCAEC;AAQD,8BAWC;AAQD,gDAEC;AASD,8DAGC;AA1FD;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,CAAC;IAED,kBAAkB;IAClB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;IAE/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;IAED,2BAA2B;IAC3B,MAAM,cAAc,GAAG,mBAAmB,CAAA;IAC1C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAA;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC3D,CAAC;IAED,uBAAuB;IACvB,OAAO,OAAO,CAAC,WAAW,EAAE,CAAA;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,QAAgB,EAAE,kBAA0B;IACrE,OAAO,GAAG,QAAQ,KAAK,kBAAkB,EAAE,CAAA;AAC7C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,IAAY;IACpC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzC,IAAI,cAAc,KAAK,CAAC,CAAC,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC;QAC3C,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC;KACvD,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,cAAsB;IACvD,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAC,WAAqB,EAAE,QAAgB;IAC/E,MAAM,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAA;IAC9B,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AAC5D,CAAC"}
+{"version":3,"file":"tenant.js","sourceRoot":"","sources":["../../src/utils/tenant.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,4CA2BC;AAUD,gCAEC;AAQD,8BAWC;AAQD,gDAEC;AASD,8DAGC;AAUD,8DAEC;AAtGD;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,CAAC;IAED,kBAAkB;IAClB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;IAE/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;IAED,2BAA2B;IAC3B,MAAM,cAAc,GAAG,mBAAmB,CAAA;IAC1C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAA;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC3D,CAAC;IAED,uBAAuB;IACvB,OAAO,OAAO,CAAC,WAAW,EAAE,CAAA;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,QAAgB,EAAE,kBAA0B;IACrE,OAAO,GAAG,QAAQ,KAAK,kBAAkB,EAAE,CAAA;AAC7C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,IAAY;IACpC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzC,IAAI,cAAc,KAAK,CAAC,CAAC,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC;QAC3C,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC;KACvD,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,cAAsB;IACvD,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAC,WAAqB,EAAE,QAAgB;IAC/E,MAAM,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAA;IAC9B,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CAAC,QAA4B,EAAE,YAAoB;IAC1F,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,CAAA;AACjE,CAAC"}

package/package.json

@@ -1,19 +1,20 @@
 {
   "license": "MIT",
   "main": "./dist/index.js",
-  "author": "ignacio.cabrera@goatlab.io",
   "name": "@goatlab/typesense",
-  "version": "0.0.2",
+  "description": "Modern TypeScript wrapper for Typesense search engine API",
+  "author": "ignacio.cabrera@goatlab.io",
+  "version": "0.0.4",
   "private": false,
   "publishConfig": {
     "access": "public"
   },
   "types": "./dist/index.d.ts",
   "dependencies": {
+    "zod": "^4.0.5",
     "@goatlab/js-utils": "0.8.42",
     "@goatlab/tsconfig": "0.0.15"
   },
-  "description": "Metabase API wrapper for TypeScript and Node.js",
   "devDependencies": {
     "@testcontainers/mysql": "^11.0.3",
     "@types/node": "^18.15.9",
@@ -38,10 +39,13 @@
   ],
   "homepage": "https://docs.goatlab.io",
   "keywords": [
-    "metabase",
+    "typesense",
+    "search",
     "api",
     "wrapper",
-    "typescript"
+    "typescript",
+    "search-engine",
+    "full-text-search"
   ],
   "scripts": {
     "build": "tsc",