mbd-studio-sdk 2.0.3

package/V1/search/filters/DateFilter.js

@@ -0,0 +1,23 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Date range filter. Accepts dateFrom/dateTo (ISO 8601) and exposes value as { date_from, date_to } for the API.
+ */
+export class DateFilter extends Filter {
+  /**
+   * @param {string} field - Date field to filter (e.g. "item_creation_timestamp")
+   * @param {string | null} [dateFrom=null] - Start date (ISO 8601)
+   * @param {string | null} [dateTo=null] - End date (ISO 8601)
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(field, dateFrom = null, dateTo = null, boost = null) {
+    super('date', field, boost);
+    if (dateFrom == null && dateTo == null) {
+      throw new Error('DateFilter: at least one of dateFrom or dateTo must be provided');
+    }
+    const value = {};
+    if (dateFrom != null) value.date_from = dateFrom;
+    if (dateTo != null) value.date_to = dateTo;
+    this.value = value;
+  }
+}

package/V1/search/filters/Filter.js

@@ -0,0 +1,20 @@
+/**
+ * Abstract base class for filter objects used in Search include, exclude and boost arrays.
+ * All subclasses have filter (type), field, and optional boost.
+ * Use null for optional values so logic can be transposed to Python.
+ */
+export class Filter {
+  /**
+   * @param {string} filterType - Filter type (e.g. "term", "terms", "numeric")
+   * @param {string} field - Field to filter on
+   * @param {number | null} [boost=null] - Optional boost multiplier
+   */
+  constructor(filterType, field, boost = null) {
+    if (new.target === Filter) {
+      throw new Error('Filter is abstract and cannot be instantiated directly');
+    }
+    this.filter = filterType;
+    this.field = field;
+    this.boost = boost;
+  }
+}

package/V1/search/filters/GeoFilter.js

@@ -0,0 +1,16 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Geographic distance filter. Value items format: "geo:lat,lon".
+ */
+export class GeoFilter extends Filter {
+  /**
+   * @param {string} field - Geo point field (e.g. "location")
+   * @param {string[]} value - Coordinates, e.g. ["geo:40.7128,-74.0060"]
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(field, value, boost = null) {
+    super('geo', field, boost);
+    this.value = value;
+  }
+}

package/V1/search/filters/GroupBoostFilter.js

@@ -0,0 +1,26 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Hierarchical boosting from a grouped lookup index (boost lists only).
+ * Paths in the document: {group}_01, {group}_02, ... {group}_n.
+ */
+export class GroupBoostFilter extends Filter {
+  /**
+   * @param {string} lookup_index - Lookup index (e.g. "polymarket-wallets", "user-prefs")
+   * @param {string} field - Target field in the lookup index (e.g. "ai_labels_med")
+   * @param {string} value - Lookup document ID
+   * @param {string} group - Group path prefix (e.g. "label" -> label_01, label_02, ...)
+   * @param {number | null} [min_boost=null] - Minimum boost (default 1)
+   * @param {number | null} [max_boost=null] - Maximum boost (default 5)
+   * @param {number | null} [n=null] - Number of groups (default 10)
+   */
+  constructor(lookup_index, field, value, group, min_boost = null, max_boost = null, n = null) {
+    super('group_boost', field, null);
+    this.lookup_index = lookup_index;
+    this.value = value;
+    this.group = group;
+    this.min_boost = min_boost;
+    this.max_boost = max_boost;
+    this.n = n;
+  }
+}

package/V1/search/filters/IsNullFilter.js

@@ -0,0 +1,14 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Match documents where the field is null/missing.
+ */
+export class IsNullFilter extends Filter {
+  /**
+   * @param {string} field - Field that must be empty/null (e.g. "embed_items")
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(field, boost = null) {
+    super('is_null', field, boost);
+  }
+}

package/V1/search/filters/MatchFilter.js

@@ -0,0 +1,16 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Full-text search on a text field (keywords array).
+ */
+export class MatchFilter extends Filter {
+  /**
+   * @param {string} field - Text field to match against (e.g. "text")
+   * @param {string[]} value - Keywords to match (e.g. ["technical", "development"])
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(field, value, boost = null) {
+    super('match', field, boost);
+    this.value = value;
+  }
+}

package/V1/search/filters/NotNullFilter.js

@@ -0,0 +1,14 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Match documents where the field exists and has a value.
+ */
+export class NotNullFilter extends Filter {
+  /**
+   * @param {string} field - Field that must exist (e.g. "user_id")
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(field, boost = null) {
+    super('not_null', field, boost);
+  }
+}

package/V1/search/filters/NumericFilter.js

@@ -0,0 +1,18 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Range comparison on a numeric field (>, >=, <, <=).
+ */
+export class NumericFilter extends Filter {
+  /**
+   * @param {string} field - Field to filter on (e.g. "score_popular")
+   * @param {">" | ">=" | "<" | "<="} operator - Comparison operator
+   * @param {number} value - Numeric threshold value
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(field, operator, value, boost = null) {
+    super('numeric', field, boost);
+    this.operator = operator;
+    this.value = value;
+  }
+}

package/V1/search/filters/TermFilter.js

@@ -0,0 +1,16 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Exact match on a keyword/text field (single value).
+ */
+export class TermFilter extends Filter {
+  /**
+   * @param {string} field - Field to filter on (e.g. "lang")
+   * @param {string} value - Exact value to match (e.g. "en")
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(field, value, boost = null) {
+    super('term', field, boost);
+    this.value = value;
+  }
+}

package/V1/search/filters/TermsFilter.js

@@ -0,0 +1,16 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Multiple values where at least one must match (OR logic).
+ */
+export class TermsFilter extends Filter {
+  /**
+   * @param {string} field - Field to filter on (e.g. "channels")
+   * @param {string[]} value - Values to match (e.g. ["en", "fr"])
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(field, value, boost = null) {
+    super('terms', field, boost);
+    this.value = value;
+  }
+}

package/V1/search/filters/TermsLookupFilter.js

@@ -0,0 +1,20 @@
+import { Filter } from './Filter.js';
+
+/**
+ * Match field values against terms from another Elasticsearch document.
+ */
+export class TermsLookupFilter extends Filter {
+  /**
+   * @param {string} lookup_index - Index to look up terms from (e.g. "user-prefs", "following-graph")
+   * @param {string} field - Target field in the current index to match (e.g. "item_id", "user_id")
+   * @param {string} value - Document ID in lookup_index
+   * @param {string} path - JSON path in the lookup document (e.g. "followed_items")
+   * @param {number | null} [boost=null] - Optional boost multiplier (0.1–100)
+   */
+  constructor(lookup_index, field, value, path, boost = null) {
+    super('terms_lookup', field, boost);
+    this.lookup_index = lookup_index;
+    this.value = value;
+    this.path = path;
+  }
+}

package/V1/search/filters/index.js

@@ -0,0 +1,13 @@
+export { Filter } from './Filter.js';
+export { TermFilter } from './TermFilter.js';
+export { TermsFilter } from './TermsFilter.js';
+export { NumericFilter } from './NumericFilter.js';
+export { MatchFilter } from './MatchFilter.js';
+export { GeoFilter } from './GeoFilter.js';
+export { DateFilter } from './DateFilter.js';
+export { IsNullFilter } from './IsNullFilter.js';
+export { NotNullFilter } from './NotNullFilter.js';
+export { CustomFilter } from './CustomFilter.js';
+export { GroupBoostFilter } from './GroupBoostFilter.js';
+export { TermsLookupFilter } from './TermsLookupFilter.js';
+export { ConsoleAccountFilter } from './ConsoleAccountFilter.js';

package/V1/utils/indexUtils.js

@@ -0,0 +1,12 @@
+/**
+ * Resolve index name from a hit _index (e.g. "farcaster-items-xyz" -> "farcaster-items").
+ * @param {string} index - Raw index string from a hit
+ * @returns {string | null}
+ */
+export function findIndex(index) {
+  const indexOptions = ['farcaster-items', 'zora-coins', 'polymarket-items', 'polymarket-wallets'];
+  for (const option of indexOptions) {
+    if (index.startsWith(option)) return option;
+  }
+  return null;
+}

package/index.js

@@ -0,0 +1,4 @@
+import * as V1 from './V1/index.js';
+
+export { StudioConfig } from './StudioConfig.js';
+export const StudioV1 = V1.Studio;

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "mbd-studio-sdk",
+  "version": "2.0.3",
+  "description": "SDK for MBD Studio backend services",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "V1"
+  ]
+}