@goatlab/typesense 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. package/LICENSE +21 -0
  2. package/dist/TypesenseApi.d.ts +229 -0
  3. package/dist/TypesenseApi.js +423 -0
  4. package/dist/TypesenseApi.js.map +1 -0
  5. package/dist/actions/admin/getCollectionStats.d.ts +3 -0
  6. package/dist/actions/admin/getCollectionStats.js +8 -0
  7. package/dist/actions/admin/getCollectionStats.js.map +1 -0
  8. package/dist/actions/admin/health.d.ts +4 -0
  9. package/dist/actions/admin/health.js +22 -0
  10. package/dist/actions/admin/health.js.map +1 -0
  11. package/dist/actions/admin/metrics.d.ts +4 -0
  12. package/dist/actions/admin/metrics.js +11 -0
  13. package/dist/actions/admin/metrics.js.map +1 -0
  14. package/dist/actions/aliases/createOrUpdateAlias.d.ts +3 -0
  15. package/dist/actions/aliases/createOrUpdateAlias.js +10 -0
  16. package/dist/actions/aliases/createOrUpdateAlias.js.map +1 -0
  17. package/dist/actions/aliases/deleteAlias.d.ts +3 -0
  18. package/dist/actions/aliases/deleteAlias.js +7 -0
  19. package/dist/actions/aliases/deleteAlias.js.map +1 -0
  20. package/dist/actions/aliases/getAlias.d.ts +3 -0
  21. package/dist/actions/aliases/getAlias.js +7 -0
  22. package/dist/actions/aliases/getAlias.js.map +1 -0
  23. package/dist/actions/aliases/listAliases.d.ts +3 -0
  24. package/dist/actions/aliases/listAliases.js +7 -0
  25. package/dist/actions/aliases/listAliases.js.map +1 -0
  26. package/dist/actions/collections/createCollection.d.ts +3 -0
  27. package/dist/actions/collections/createCollection.js +18 -0
  28. package/dist/actions/collections/createCollection.js.map +1 -0
  29. package/dist/actions/collections/deleteCollection.d.ts +3 -0
  30. package/dist/actions/collections/deleteCollection.js +13 -0
  31. package/dist/actions/collections/deleteCollection.js.map +1 -0
  32. package/dist/actions/collections/getCollection.d.ts +3 -0
  33. package/dist/actions/collections/getCollection.js +11 -0
  34. package/dist/actions/collections/getCollection.js.map +1 -0
  35. package/dist/actions/collections/getOrCreateCollection.d.ts +3 -0
  36. package/dist/actions/collections/getOrCreateCollection.js +19 -0
  37. package/dist/actions/collections/getOrCreateCollection.js.map +1 -0
  38. package/dist/actions/collections/listCollections.d.ts +3 -0
  39. package/dist/actions/collections/listCollections.js +7 -0
  40. package/dist/actions/collections/listCollections.js.map +1 -0
  41. package/dist/actions/collections/updateCollection.d.ts +3 -0
  42. package/dist/actions/collections/updateCollection.js +14 -0
  43. package/dist/actions/collections/updateCollection.js.map +1 -0
  44. package/dist/actions/documents/clearCollection.d.ts +5 -0
  45. package/dist/actions/documents/clearCollection.js +11 -0
  46. package/dist/actions/documents/clearCollection.js.map +1 -0
  47. package/dist/actions/documents/deleteByFilter.d.ts +5 -0
  48. package/dist/actions/documents/deleteByFilter.js +15 -0
  49. package/dist/actions/documents/deleteByFilter.js.map +1 -0
  50. package/dist/actions/documents/deleteDocument.d.ts +3 -0
  51. package/dist/actions/documents/deleteDocument.js +14 -0
  52. package/dist/actions/documents/deleteDocument.js.map +1 -0
  53. package/dist/actions/documents/exportDocuments.d.ts +5 -0
  54. package/dist/actions/documents/exportDocuments.js +51 -0
  55. package/dist/actions/documents/exportDocuments.js.map +1 -0
  56. package/dist/actions/documents/getDocumentById.d.ts +3 -0
  57. package/dist/actions/documents/getDocumentById.js +12 -0
  58. package/dist/actions/documents/getDocumentById.js.map +1 -0
  59. package/dist/actions/documents/importDocuments.d.ts +4 -0
  60. package/dist/actions/documents/importDocuments.js +58 -0
  61. package/dist/actions/documents/importDocuments.js.map +1 -0
  62. package/dist/actions/documents/insertDocument.d.ts +3 -0
  63. package/dist/actions/documents/insertDocument.js +38 -0
  64. package/dist/actions/documents/insertDocument.js.map +1 -0
  65. package/dist/actions/documents/updateDocument.d.ts +5 -0
  66. package/dist/actions/documents/updateDocument.js +15 -0
  67. package/dist/actions/documents/updateDocument.js.map +1 -0
  68. package/dist/actions/documents/upsertDocument.d.ts +3 -0
  69. package/dist/actions/documents/upsertDocument.js +16 -0
  70. package/dist/actions/documents/upsertDocument.js.map +1 -0
  71. package/dist/actions/overrides/deleteOverride.d.ts +3 -0
  72. package/dist/actions/overrides/deleteOverride.js +8 -0
  73. package/dist/actions/overrides/deleteOverride.js.map +1 -0
  74. package/dist/actions/overrides/getOverride.d.ts +3 -0
  75. package/dist/actions/overrides/getOverride.js +8 -0
  76. package/dist/actions/overrides/getOverride.js.map +1 -0
  77. package/dist/actions/overrides/listOverrides.d.ts +5 -0
  78. package/dist/actions/overrides/listOverrides.js +8 -0
  79. package/dist/actions/overrides/listOverrides.js.map +1 -0
  80. package/dist/actions/overrides/upsertOverride.d.ts +3 -0
  81. package/dist/actions/overrides/upsertOverride.js +11 -0
  82. package/dist/actions/overrides/upsertOverride.js.map +1 -0
  83. package/dist/actions/presets/deletePreset.d.ts +3 -0
  84. package/dist/actions/presets/deletePreset.js +7 -0
  85. package/dist/actions/presets/deletePreset.js.map +1 -0
  86. package/dist/actions/presets/getPreset.d.ts +3 -0
  87. package/dist/actions/presets/getPreset.js +7 -0
  88. package/dist/actions/presets/getPreset.js.map +1 -0
  89. package/dist/actions/presets/listPresets.d.ts +5 -0
  90. package/dist/actions/presets/listPresets.js +7 -0
  91. package/dist/actions/presets/listPresets.js.map +1 -0
  92. package/dist/actions/presets/upsertPreset.d.ts +3 -0
  93. package/dist/actions/presets/upsertPreset.js +10 -0
  94. package/dist/actions/presets/upsertPreset.js.map +1 -0
  95. package/dist/actions/search/multiSearch.d.ts +3 -0
  96. package/dist/actions/search/multiSearch.js +10 -0
  97. package/dist/actions/search/multiSearch.js.map +1 -0
  98. package/dist/actions/search/search.d.ts +5 -0
  99. package/dist/actions/search/search.js +19 -0
  100. package/dist/actions/search/search.js.map +1 -0
  101. package/dist/actions/synonyms/deleteSynonym.d.ts +3 -0
  102. package/dist/actions/synonyms/deleteSynonym.js +8 -0
  103. package/dist/actions/synonyms/deleteSynonym.js.map +1 -0
  104. package/dist/actions/synonyms/getSynonym.d.ts +3 -0
  105. package/dist/actions/synonyms/getSynonym.js +8 -0
  106. package/dist/actions/synonyms/getSynonym.js.map +1 -0
  107. package/dist/actions/synonyms/listSynonyms.d.ts +5 -0
  108. package/dist/actions/synonyms/listSynonyms.js +8 -0
  109. package/dist/actions/synonyms/listSynonyms.js.map +1 -0
  110. package/dist/actions/synonyms/upsertSynonym.d.ts +3 -0
  111. package/dist/actions/synonyms/upsertSynonym.js +11 -0
  112. package/dist/actions/synonyms/upsertSynonym.js.map +1 -0
  113. package/dist/components/export-formatter.d.ts +16 -0
  114. package/dist/components/export-formatter.js +226 -0
  115. package/dist/components/export-formatter.js.map +1 -0
  116. package/dist/components/http-client.d.ts +50 -0
  117. package/dist/components/http-client.js +149 -0
  118. package/dist/components/http-client.js.map +1 -0
  119. package/dist/components/resilience-policy.d.ts +33 -0
  120. package/dist/components/resilience-policy.js +115 -0
  121. package/dist/components/resilience-policy.js.map +1 -0
  122. package/dist/components/schema-manager.d.ts +30 -0
  123. package/dist/components/schema-manager.js +227 -0
  124. package/dist/components/schema-manager.js.map +1 -0
  125. package/dist/components/typesense.filter-builder.d.ts +127 -0
  126. package/dist/components/typesense.filter-builder.js +216 -0
  127. package/dist/components/typesense.filter-builder.js.map +1 -0
  128. package/dist/examples/multitenancy-example.d.ts +4 -0
  129. package/dist/examples/multitenancy-example.js +182 -0
  130. package/dist/examples/multitenancy-example.js.map +1 -0
  131. package/dist/index.d.ts +10 -0
  132. package/dist/index.js +23 -0
  133. package/dist/index.js.map +1 -0
  134. package/dist/tests/const.d.ts +6 -0
  135. package/dist/tests/const.js +22 -0
  136. package/dist/tests/const.js.map +1 -0
  137. package/dist/tests/typesense.d.ts +2 -0
  138. package/dist/tests/typesense.js +24 -0
  139. package/dist/tests/typesense.js.map +1 -0
  140. package/dist/types.d.ts +16 -0
  141. package/dist/types.js +3 -0
  142. package/dist/types.js.map +1 -0
  143. package/dist/typesense.model.d.ts +455 -0
  144. package/dist/typesense.model.js +98 -0
  145. package/dist/typesense.model.js.map +1 -0
  146. package/dist/utils/tenant.d.ts +48 -0
  147. package/dist/utils/tenant.js +89 -0
  148. package/dist/utils/tenant.js.map +1 -0
  149. package/package.json +60 -0
@@ -0,0 +1,50 @@
1
+ import type { KyInstance } from '@goatlab/js-utils';
2
+ export interface HttpClientOptions {
3
+ prefixUrl: string;
4
+ token: string;
5
+ searchTimeout?: number;
6
+ importTimeout?: number;
7
+ defaultTimeout?: number;
8
+ beforeRequest?: Array<(request: Request) => void | Promise<void>>;
9
+ afterResponse?: any[];
10
+ beforeError?: Array<(error: any) => any | Promise<any>>;
11
+ kyInstance?: KyInstance;
12
+ enforceTLS?: boolean;
13
+ }
14
+ export declare class TypesenseHttpClient {
15
+ private kyInstance;
16
+ private readonly enforceTLS;
17
+ private readonly options;
18
+ constructor(options: HttpClientOptions);
19
+ private createDefaultClient;
20
+ private sanitizeHeaders;
21
+ request<T>(endpoint: string, options?: {
22
+ method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
23
+ body?: any;
24
+ searchParams?: Record<string, any>;
25
+ timeout?: number;
26
+ signal?: AbortSignal;
27
+ }): Promise<T>;
28
+ requestText(endpoint: string, options?: {
29
+ method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
30
+ body?: any;
31
+ searchParams?: Record<string, any>;
32
+ timeout?: number;
33
+ signal?: AbortSignal;
34
+ }): Promise<string>;
35
+ requestTextWithRawBody(endpoint: string, options?: {
36
+ method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
37
+ body?: any;
38
+ searchParams?: Record<string, any>;
39
+ timeout?: number;
40
+ signal?: AbortSignal;
41
+ }): Promise<string>;
42
+ stream(endpoint: string, options?: {
43
+ method?: 'GET' | 'POST';
44
+ body?: any;
45
+ searchParams?: Record<string, any>;
46
+ signal?: AbortSignal;
47
+ }): Promise<ReadableStream>;
48
+ getClient(): KyInstance;
49
+ getOptions(): HttpClientOptions;
50
+ }
@@ -0,0 +1,149 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.TypesenseHttpClient = void 0;
4
+ // TypesenseHttpClient - Handles network wrapper concerns
5
+ const js_utils_1 = require("@goatlab/js-utils");
6
+ const typesense_model_1 = require("../typesense.model");
7
+ class TypesenseHttpClient {
8
+ kyInstance;
9
+ enforceTLS;
10
+ options;
11
+ constructor(options) {
12
+ this.enforceTLS = options.enforceTLS ?? process.env.NODE_ENV === 'production';
13
+ this.options = options;
14
+ // Security: Enforce HTTPS in production
15
+ if (this.enforceTLS && !options.prefixUrl.startsWith('https://')) {
16
+ throw new Error('HTTPS is required in production environment');
17
+ }
18
+ this.kyInstance = options.kyInstance || this.createDefaultClient(options);
19
+ }
20
+ createDefaultClient(options) {
21
+ return js_utils_1.Http.getClient({
22
+ prefixUrl: options.prefixUrl,
23
+ timeout: options.defaultTimeout || 10000,
24
+ headers: {
25
+ 'X-TYPESENSE-API-KEY': options.token,
26
+ 'Content-Type': 'application/json'
27
+ },
28
+ hooks: {
29
+ beforeRequest: options.beforeRequest || [],
30
+ afterResponse: options.afterResponse || [],
31
+ beforeError: [
32
+ ...(options.beforeError || []),
33
+ async (error) => {
34
+ const { response } = error;
35
+ if (response) {
36
+ try {
37
+ const errorBody = await response.json();
38
+ // Security: Redact token from headers before throwing
39
+ const sanitizedHeaders = this.sanitizeHeaders(error.request.headers);
40
+ throw new typesense_model_1.TypesenseError(errorBody.message || error.message, response.status, errorBody, sanitizedHeaders);
41
+ }
42
+ catch (parseError) {
43
+ // If we can't parse the response, fall back to basic error
44
+ throw new typesense_model_1.TypesenseError(error.message, response.status, null, this.sanitizeHeaders(error.request.headers));
45
+ }
46
+ }
47
+ throw error;
48
+ }
49
+ ]
50
+ }
51
+ });
52
+ }
53
+ sanitizeHeaders(headers) {
54
+ const sanitized = {};
55
+ headers.forEach((value, key) => {
56
+ // Security: Redact sensitive headers
57
+ if (key.toLowerCase().includes('api-key') || key.toLowerCase().includes('authorization')) {
58
+ sanitized[key] = '[REDACTED]';
59
+ }
60
+ else {
61
+ sanitized[key] = value;
62
+ }
63
+ });
64
+ return sanitized;
65
+ }
66
+ async request(endpoint, options = {}) {
67
+ const { method = 'GET', body, searchParams, timeout, signal } = options;
68
+ // Remove leading slash for prefixUrl compatibility
69
+ const cleanEndpoint = endpoint.startsWith('/') ? endpoint.slice(1) : endpoint;
70
+ const requestOptions = {
71
+ method,
72
+ timeout: timeout || 10000,
73
+ signal
74
+ };
75
+ if (body) {
76
+ requestOptions.json = body;
77
+ }
78
+ if (searchParams) {
79
+ requestOptions.searchParams = searchParams;
80
+ }
81
+ const response = await this.kyInstance(cleanEndpoint, requestOptions);
82
+ return response.json();
83
+ }
84
+ async requestText(endpoint, options = {}) {
85
+ const { method = 'GET', body, searchParams, timeout, signal } = options;
86
+ // Remove leading slash for prefixUrl compatibility
87
+ const cleanEndpoint = endpoint.startsWith('/') ? endpoint.slice(1) : endpoint;
88
+ const requestOptions = {
89
+ method,
90
+ timeout: timeout || 10000,
91
+ signal
92
+ };
93
+ if (body) {
94
+ requestOptions.json = body;
95
+ }
96
+ if (searchParams) {
97
+ requestOptions.searchParams = searchParams;
98
+ }
99
+ const response = await this.kyInstance(cleanEndpoint, requestOptions);
100
+ return response.text();
101
+ }
102
+ async requestTextWithRawBody(endpoint, options = {}) {
103
+ const { method = 'GET', body, searchParams, timeout, signal } = options;
104
+ // Remove leading slash for prefixUrl compatibility
105
+ const cleanEndpoint = endpoint.startsWith('/') ? endpoint.slice(1) : endpoint;
106
+ const requestOptions = {
107
+ method,
108
+ timeout: timeout || 10000,
109
+ signal
110
+ };
111
+ if (body) {
112
+ // Use raw body instead of JSON encoding
113
+ requestOptions.body = body;
114
+ }
115
+ if (searchParams) {
116
+ requestOptions.searchParams = searchParams;
117
+ }
118
+ const response = await this.kyInstance(cleanEndpoint, requestOptions);
119
+ return response.text();
120
+ }
121
+ async stream(endpoint, options = {}) {
122
+ const { method = 'GET', body, searchParams, signal } = options;
123
+ // Remove leading slash for prefixUrl compatibility
124
+ const cleanEndpoint = endpoint.startsWith('/') ? endpoint.slice(1) : endpoint;
125
+ const requestOptions = {
126
+ method,
127
+ signal
128
+ };
129
+ if (body) {
130
+ requestOptions.body = body;
131
+ }
132
+ if (searchParams) {
133
+ requestOptions.searchParams = searchParams;
134
+ }
135
+ const response = await this.kyInstance(cleanEndpoint, requestOptions);
136
+ if (!response.body) {
137
+ throw new Error('Response body is not available for streaming');
138
+ }
139
+ return response.body;
140
+ }
141
+ getClient() {
142
+ return this.kyInstance;
143
+ }
144
+ getOptions() {
145
+ return this.options;
146
+ }
147
+ }
148
+ exports.TypesenseHttpClient = TypesenseHttpClient;
149
+ //# sourceMappingURL=http-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/components/http-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ import { TypesenseRateLimitInfo } from '../typesense.model';
2
+ export interface ResiliencePolicyOptions {
3
+ maxFailures?: number;
4
+ resetTimeout?: number;
5
+ retryDelay?: number;
6
+ maxRetries?: number;
7
+ }
8
+ export declare class ResiliencePolicy {
9
+ private options;
10
+ private failures;
11
+ private circuitOpenUntil;
12
+ private rateLimitInfo;
13
+ private retryAfterUntil;
14
+ constructor(options?: ResiliencePolicyOptions);
15
+ isCircuitOpen(): boolean;
16
+ shouldRetry(retryCount: number, error: any): boolean;
17
+ getRetryDelay(retryCount: number): number;
18
+ recordSuccess(): void;
19
+ recordFailure(): void;
20
+ updateRateLimit(headers: Headers): void;
21
+ getRateLimit(): TypesenseRateLimitInfo | null;
22
+ getTimeUntilReset(): number | undefined;
23
+ isRateLimited(): boolean;
24
+ reset(): void;
25
+ getStatus(): {
26
+ failures: number;
27
+ circuitOpen: boolean;
28
+ circuitOpenUntil: number;
29
+ rateLimited: boolean;
30
+ retryAfterUntil: number;
31
+ rateLimit: TypesenseRateLimitInfo | null;
32
+ };
33
+ }
@@ -0,0 +1,115 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ResiliencePolicy = void 0;
4
+ class ResiliencePolicy {
5
+ options;
6
+ failures = 0;
7
+ circuitOpenUntil = 0;
8
+ rateLimitInfo = null;
9
+ retryAfterUntil = 0;
10
+ constructor(options = {}) {
11
+ this.options = options;
12
+ this.options = {
13
+ maxFailures: 5,
14
+ resetTimeout: 60000, // 1 minute
15
+ retryDelay: 1000,
16
+ maxRetries: 3,
17
+ ...options
18
+ };
19
+ }
20
+ isCircuitOpen() {
21
+ if (this.circuitOpenUntil > Date.now()) {
22
+ return true;
23
+ }
24
+ // Reset circuit if timeout has passed
25
+ if (this.circuitOpenUntil > 0 && this.circuitOpenUntil <= Date.now()) {
26
+ this.reset();
27
+ }
28
+ return false;
29
+ }
30
+ shouldRetry(retryCount, error) {
31
+ // Don't retry if circuit is open
32
+ if (this.isCircuitOpen()) {
33
+ return false;
34
+ }
35
+ // Don't retry if we're in a retry-after period
36
+ if (this.retryAfterUntil > Date.now()) {
37
+ return false;
38
+ }
39
+ // Don't retry beyond max retries
40
+ if (retryCount >= (this.options.maxRetries || 3)) {
41
+ return false;
42
+ }
43
+ // Don't retry on 4xx errors (except 429)
44
+ if (error.status >= 400 && error.status < 500 && error.status !== 429) {
45
+ return false;
46
+ }
47
+ return true;
48
+ }
49
+ getRetryDelay(retryCount) {
50
+ // Exponential backoff with jitter
51
+ const baseDelay = this.options.retryDelay || 1000;
52
+ const exponentialDelay = baseDelay * Math.pow(2, retryCount);
53
+ const jitter = Math.random() * 0.1 * exponentialDelay;
54
+ return exponentialDelay + jitter;
55
+ }
56
+ recordSuccess() {
57
+ this.failures = 0;
58
+ this.circuitOpenUntil = 0;
59
+ }
60
+ recordFailure() {
61
+ this.failures++;
62
+ if (this.failures >= (this.options.maxFailures || 5)) {
63
+ this.circuitOpenUntil = Date.now() + (this.options.resetTimeout || 60000);
64
+ }
65
+ }
66
+ updateRateLimit(headers) {
67
+ const limit = headers.get('X-RateLimit-Limit');
68
+ const remaining = headers.get('X-RateLimit-Remaining');
69
+ const resetMs = headers.get('X-RateLimit-ResetMs'); // Typesense uses milliseconds
70
+ const retryAfter = headers.get('Retry-After');
71
+ this.rateLimitInfo = {
72
+ limit: limit ? parseInt(limit, 10) : undefined,
73
+ remaining: remaining ? parseInt(remaining, 10) : undefined,
74
+ resetMs: resetMs ? parseInt(resetMs, 10) : undefined,
75
+ retryAfter: retryAfter ? parseInt(retryAfter, 10) : undefined
76
+ };
77
+ // Set retry-after period if present
78
+ if (retryAfter) {
79
+ this.retryAfterUntil = Date.now() + (parseInt(retryAfter, 10) * 1000);
80
+ }
81
+ }
82
+ getRateLimit() {
83
+ return this.rateLimitInfo;
84
+ }
85
+ getTimeUntilReset() {
86
+ if (!this.rateLimitInfo?.resetMs) {
87
+ return undefined;
88
+ }
89
+ const timeUntilReset = this.rateLimitInfo.resetMs - Date.now();
90
+ return Math.max(0, timeUntilReset);
91
+ }
92
+ isRateLimited() {
93
+ if (!this.rateLimitInfo) {
94
+ return false;
95
+ }
96
+ return this.rateLimitInfo.remaining === 0 || this.retryAfterUntil > Date.now();
97
+ }
98
+ reset() {
99
+ this.failures = 0;
100
+ this.circuitOpenUntil = 0;
101
+ this.retryAfterUntil = 0;
102
+ }
103
+ getStatus() {
104
+ return {
105
+ failures: this.failures,
106
+ circuitOpen: this.isCircuitOpen(),
107
+ circuitOpenUntil: this.circuitOpenUntil,
108
+ rateLimited: this.isRateLimited(),
109
+ retryAfterUntil: this.retryAfterUntil,
110
+ rateLimit: this.rateLimitInfo
111
+ };
112
+ }
113
+ }
114
+ exports.ResiliencePolicy = ResiliencePolicy;
115
+ //# sourceMappingURL=resilience-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resilience-policy.js","sourceRoot":"","sources":["../../src/components/resilience-policy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import { TypesenseCollection } from '../typesense.model';
2
+ interface SchemaManagerOptions {
3
+ cacheSize?: number;
4
+ cacheTtl?: number;
5
+ enableNestedFields?: boolean;
6
+ typesenseVersion?: string;
7
+ suppressLogs?: boolean;
8
+ }
9
+ export declare class CollectionSchemaManager {
10
+ private schemaCache;
11
+ private options;
12
+ constructor(options?: SchemaManagerOptions);
13
+ private isVersionSupported;
14
+ private compareVersions;
15
+ getCachedSchema(collectionName: string): TypesenseCollection | null;
16
+ setCachedSchema(collectionName: string, schema: TypesenseCollection): void;
17
+ deleteCachedSchema(collectionName: string): void;
18
+ inferSchemaFromDocument(document: any, collectionName: string): TypesenseCollection;
19
+ validateSchema(schema: TypesenseCollection): {
20
+ valid: boolean;
21
+ errors: string[];
22
+ };
23
+ clearCache(): void;
24
+ getCacheStats(): {
25
+ size: number;
26
+ maxSize: number;
27
+ };
28
+ setTypesenseVersion(version: string): void;
29
+ }
30
+ export {};
@@ -0,0 +1,227 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.CollectionSchemaManager = void 0;
4
+ class LRUCache {
5
+ cache = new Map();
6
+ maxSize;
7
+ constructor(maxSize) {
8
+ this.maxSize = maxSize;
9
+ }
10
+ get(key) {
11
+ const value = this.cache.get(key);
12
+ if (value !== undefined) {
13
+ // Move to end (most recently used)
14
+ this.cache.delete(key);
15
+ this.cache.set(key, value);
16
+ }
17
+ return value;
18
+ }
19
+ set(key, value) {
20
+ if (this.cache.has(key)) {
21
+ this.cache.delete(key);
22
+ }
23
+ else if (this.cache.size >= this.maxSize) {
24
+ // Remove least recently used (first item)
25
+ const firstKey = this.cache.keys().next().value;
26
+ this.cache.delete(firstKey);
27
+ }
28
+ this.cache.set(key, value);
29
+ }
30
+ has(key) {
31
+ return this.cache.has(key);
32
+ }
33
+ delete(key) {
34
+ return this.cache.delete(key);
35
+ }
36
+ clear() {
37
+ this.cache.clear();
38
+ }
39
+ size() {
40
+ return this.cache.size;
41
+ }
42
+ }
43
+ class CollectionSchemaManager {
44
+ schemaCache;
45
+ options;
46
+ constructor(options = {}) {
47
+ this.options = {
48
+ cacheSize: options.cacheSize || 100,
49
+ cacheTtl: options.cacheTtl || 300000, // 5 minutes
50
+ enableNestedFields: options.enableNestedFields ?? false,
51
+ typesenseVersion: options.typesenseVersion || '0.24.0',
52
+ suppressLogs: options.suppressLogs ?? false
53
+ };
54
+ this.schemaCache = new LRUCache(this.options.cacheSize);
55
+ }
56
+ isVersionSupported(feature, minVersion) {
57
+ const currentVersion = this.options.typesenseVersion;
58
+ return this.compareVersions(currentVersion, minVersion) >= 0;
59
+ }
60
+ compareVersions(version1, version2) {
61
+ const v1Parts = version1.split('.').map(Number);
62
+ const v2Parts = version2.split('.').map(Number);
63
+ for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
64
+ const v1Part = v1Parts[i] || 0;
65
+ const v2Part = v2Parts[i] || 0;
66
+ if (v1Part > v2Part)
67
+ return 1;
68
+ if (v1Part < v2Part)
69
+ return -1;
70
+ }
71
+ return 0;
72
+ }
73
+ getCachedSchema(collectionName) {
74
+ const cacheKey = `schema:${collectionName}`;
75
+ const cached = this.schemaCache.get(cacheKey);
76
+ if (cached && Date.now() - cached.timestamp < this.options.cacheTtl) {
77
+ return cached.schema;
78
+ }
79
+ if (cached) {
80
+ this.schemaCache.delete(cacheKey);
81
+ }
82
+ return null;
83
+ }
84
+ setCachedSchema(collectionName, schema) {
85
+ const cacheKey = `schema:${collectionName}`;
86
+ this.schemaCache.set(cacheKey, {
87
+ schema,
88
+ timestamp: Date.now()
89
+ });
90
+ }
91
+ deleteCachedSchema(collectionName) {
92
+ const cacheKey = `schema:${collectionName}`;
93
+ this.schemaCache.delete(cacheKey);
94
+ }
95
+ inferSchemaFromDocument(document, collectionName) {
96
+ const fields = [];
97
+ const processedFields = new Set();
98
+ const inferFieldType = (key, value, path = []) => {
99
+ if (processedFields.has(key))
100
+ return;
101
+ const field = { name: key };
102
+ if (value === null || value === undefined) {
103
+ field.type = 'string';
104
+ field.optional = true;
105
+ }
106
+ else if (typeof value === 'string') {
107
+ field.type = 'string';
108
+ }
109
+ else if (typeof value === 'number') {
110
+ field.type = Number.isInteger(value) ? 'int64' : 'float';
111
+ }
112
+ else if (typeof value === 'boolean') {
113
+ field.type = 'bool';
114
+ }
115
+ else if (Array.isArray(value)) {
116
+ if (value.length === 0) {
117
+ field.type = 'string[]';
118
+ }
119
+ else {
120
+ // Check if array is homogeneous by sampling elements
121
+ const sampleSize = Math.min(value.length, 10);
122
+ const types = new Set();
123
+ for (let i = 0; i < sampleSize; i++) {
124
+ const item = value[i];
125
+ if (typeof item === 'string')
126
+ types.add('string');
127
+ else if (typeof item === 'number') {
128
+ types.add(Number.isInteger(item) ? 'int64' : 'float');
129
+ }
130
+ else if (typeof item === 'boolean')
131
+ types.add('bool');
132
+ else
133
+ types.add('object');
134
+ }
135
+ if (types.size === 1) {
136
+ const type = Array.from(types)[0];
137
+ field.type = `${type}[]`;
138
+ }
139
+ else {
140
+ // Heterogeneous array - fall back to auto
141
+ field.type = 'auto';
142
+ }
143
+ }
144
+ }
145
+ else if (typeof value === 'object') {
146
+ // Check if nested fields are supported
147
+ if (this.isVersionSupported('nested_fields', '0.25.0') && this.options.enableNestedFields) {
148
+ field.type = 'object';
149
+ // Could recursively process nested fields here
150
+ }
151
+ else {
152
+ field.type = 'string'; // Store as JSON string
153
+ }
154
+ }
155
+ else {
156
+ field.type = 'auto';
157
+ }
158
+ processedFields.add(key);
159
+ fields.push(field);
160
+ };
161
+ // Process document fields
162
+ Object.entries(document).forEach(([key, value]) => {
163
+ inferFieldType(key, value);
164
+ });
165
+ // Ensure id field exists
166
+ if (!processedFields.has('id')) {
167
+ fields.unshift({ name: 'id', type: 'string' });
168
+ }
169
+ const collection = {
170
+ name: collectionName,
171
+ fields
172
+ };
173
+ // Add version-gated features
174
+ if (this.isVersionSupported('nested_fields', '0.25.0') && this.options.enableNestedFields) {
175
+ collection.enable_nested_fields = true;
176
+ }
177
+ return collection;
178
+ }
179
+ validateSchema(schema) {
180
+ const errors = [];
181
+ if (!schema.name) {
182
+ errors.push('Collection name is required');
183
+ }
184
+ if (!schema.fields || schema.fields.length === 0) {
185
+ errors.push('At least one field is required');
186
+ }
187
+ const hasIdField = schema.fields?.some(field => field.name === 'id');
188
+ if (!hasIdField) {
189
+ errors.push('Collection must have an "id" field');
190
+ }
191
+ // Validate field types
192
+ const validTypes = [
193
+ 'string', 'string[]', 'int32', 'int32[]', 'int64', 'int64[]',
194
+ 'float', 'float[]', 'bool', 'bool[]', 'geopoint', 'geopoint[]',
195
+ 'object', 'object[]', 'auto', 'image'
196
+ ];
197
+ schema.fields?.forEach(field => {
198
+ if (!validTypes.includes(field.type)) {
199
+ errors.push(`Invalid field type "${field.type}" for field "${field.name}"`);
200
+ }
201
+ });
202
+ // Check version-specific features
203
+ if (schema.enable_nested_fields && !this.isVersionSupported('nested_fields', '0.25.0')) {
204
+ errors.push('enable_nested_fields requires Typesense v0.25.0 or higher');
205
+ }
206
+ return {
207
+ valid: errors.length === 0,
208
+ errors
209
+ };
210
+ }
211
+ clearCache() {
212
+ this.schemaCache.clear();
213
+ }
214
+ getCacheStats() {
215
+ return {
216
+ size: this.schemaCache.size(),
217
+ maxSize: this.options.cacheSize
218
+ };
219
+ }
220
+ setTypesenseVersion(version) {
221
+ this.options.typesenseVersion = version;
222
+ // Clear cache when version changes as feature availability may change
223
+ this.clearCache();
224
+ }
225
+ }
226
+ exports.CollectionSchemaManager = CollectionSchemaManager;
227
+ //# sourceMappingURL=schema-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-manager.js","sourceRoot":"","sources":["../../src/components/schema-manager.ts"],"names":[],"mappings":"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"}