@samesake/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 octalpixel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# @samesake/core
+
+Config-as-code DSL for commerce search and entity resolution. Declare `collection()` and `entity()` with compile-time validation.
+
+```bash
+bun add @samesake/core
+```
+
+See the [samesake README](https://github.com/asyncdotengineering/samesake#readme) for setup, examples, and docs.

package/dist/index.cjs

@@ -0,0 +1,243 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Channels: () => Channels,
+  IdentError: () => IdentError,
+  Scorers: () => Scorers,
+  assertIdent: () => assertIdent,
+  assertNoIdentCollisions: () => assertNoIdentCollisions,
+  collection: () => collection,
+  entity: () => entity,
+  f: () => f,
+  fields: () => fields,
+  pipeline: () => pipeline,
+  s: () => s,
+  sources: () => sources,
+  stage: () => stage
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/ident.ts
+var IDENT_RE = /^[a-zA-Z][a-zA-Z0-9_]*$/;
+var IDENT_MAX = 63;
+var IdentError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "IdentError";
+  }
+};
+function assertIdent(name, kind) {
+  if (name.length > IDENT_MAX) {
+    throw new IdentError(
+      `${kind} name "${name}" exceeds max length ${IDENT_MAX}`
+    );
+  }
+  if (!IDENT_RE.test(name)) {
+    throw new IdentError(
+      `${kind} name "${name}" is invalid: use letters, digits, underscores; must start with a letter (no hyphens)`
+    );
+  }
+}
+function assertNoIdentCollisions(names, kind) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const name of names) {
+    const key = name.toLowerCase();
+    const prev = seen.get(key);
+    if (prev && prev !== name) {
+      throw new IdentError(
+        `${kind} names "${prev}" and "${name}" collide (case-insensitive)`
+      );
+    }
+    seen.set(key, name);
+  }
+}
+
+// src/index.ts
+var fields = {
+  text(opts = {}) {
+    return { type: "text", ...opts };
+  },
+  number(opts = {}) {
+    return { type: "number", ...opts };
+  }
+};
+var Scorers = {
+  cosine(opts) {
+    return { kind: "cosine", ...opts };
+  },
+  trigram(opts) {
+    return { kind: "trigram", ...opts };
+  },
+  phoneticEq(opts) {
+    return { kind: "phoneticEq", ...opts };
+  },
+  phoneExact(opts) {
+    return { kind: "phoneExact", ...opts };
+  },
+  aliasHit(opts) {
+    return { kind: "aliasHit", ...opts };
+  },
+  internalCodeExact(opts) {
+    return { kind: "internalCodeExact", ...opts };
+  },
+  sizeUnitGate(opts) {
+    return { kind: "sizeUnitGate", ...opts };
+  },
+  brandGate(opts) {
+    return { kind: "brandGate", ...opts };
+  }
+};
+function entity(name, def) {
+  assertIdent(name, "entity");
+  for (const s2 of def.scopes ?? []) assertIdent(s2, "scope");
+  assertNoIdentCollisions(Object.keys(def.fields ?? {}), "field");
+  return { ...def, name };
+}
+var f = {
+  text(opts = {}) {
+    return { type: "text", ...opts };
+  },
+  number(opts = {}) {
+    return { type: "number", ...opts };
+  },
+  boolean(opts = {}) {
+    return { type: "boolean", ...opts };
+  },
+  enum(values, opts = {}) {
+    return { type: "enum", values, ...opts };
+  },
+  array(item, opts = {}) {
+    if (item.type === "enum") {
+      return { type: "array", itemType: "enum", values: item.values, ...opts };
+    }
+    return { type: "array", itemType: "text", ...opts };
+  }
+};
+var Channels = {
+  fts(opts) {
+    return { kind: "fts", ...opts };
+  },
+  cosine(opts) {
+    return { kind: "cosine", ...opts };
+  },
+  recency(opts) {
+    return { kind: "recency", ...opts };
+  },
+  spaces(opts) {
+    return { kind: "spaces", ...opts };
+  }
+};
+var PGVECTOR_HNSW_MAX_DIMS = 2e3;
+function spaceDim(def) {
+  return def.kind === "text" || def.kind === "image" ? def.dim : def.dims;
+}
+function validateSpaceDims(spaces) {
+  let total = 0;
+  for (const def of Object.values(spaces)) {
+    total += spaceDim(def);
+  }
+  if (total > PGVECTOR_HNSW_MAX_DIMS) {
+    throw new Error(
+      `spaces total dimension ${total} exceeds pgvector HNSW limit of ${PGVECTOR_HNSW_MAX_DIMS} for vector columns. Reduce space dims or split spaces across collections. Future escape hatch: halfvec (up to 4000 dims).`
+    );
+  }
+}
+var s = {
+  text(opts) {
+    return { kind: "text", ...opts };
+  },
+  image(opts) {
+    return { kind: "image", ...opts };
+  },
+  number(opts) {
+    return { kind: "number", ...opts };
+  },
+  recency(opts) {
+    return { kind: "recency", ...opts };
+  },
+  categorical(opts) {
+    return { kind: "categorical", ...opts };
+  }
+};
+function collection(name, def) {
+  assertIdent(name, "collection");
+  assertNoIdentCollisions(Object.keys(def.fields ?? {}), "field");
+  if (def.spaces) assertNoIdentCollisions(Object.keys(def.spaces), "space");
+  if (def.embeddings) assertNoIdentCollisions(Object.keys(def.embeddings), "embedding");
+  if (def.spaces && Object.keys(def.spaces).length > 0) {
+    validateSpaceDims(def.spaces);
+  }
+  return { ...def, name };
+}
+function stage(name, def) {
+  return { name, ...def };
+}
+function pipeline(...stages) {
+  return { stages };
+}
+var sources = {
+  shopifyFeed(opts) {
+    return {
+      name: opts.name ?? `shopify:${opts.domain}`,
+      kind: "shopify",
+      options: {
+        domain: opts.domain,
+        currency: opts.currency ?? "LKR",
+        maxPages: opts.maxPages ?? 8
+      }
+    };
+  },
+  wooStoreFeed(opts) {
+    return {
+      name: opts.name ?? `woo:${opts.domain}`,
+      kind: "woocommerce",
+      options: {
+        domain: opts.domain,
+        currency: opts.currency ?? "LKR",
+        maxPages: opts.maxPages ?? 8
+      }
+    };
+  },
+  jsonl(opts) {
+    return {
+      name: opts.name ?? `jsonl:${opts.path}`,
+      kind: "jsonl",
+      options: { path: opts.path }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Channels,
+  IdentError,
+  Scorers,
+  assertIdent,
+  assertNoIdentCollisions,
+  collection,
+  entity,
+  f,
+  fields,
+  pipeline,
+  s,
+  sources,
+  stage
+});

package/dist/index.d.cts

@@ -0,0 +1,153 @@
+import { FtsChannel, CosineChannel, RecencyChannel, SpacesChannel, CosineScorer, TrigramScorer, PhoneticEqScorer, PhoneExactScorer, AliasHitScorer, InternalCodeExactScorer, SizeUnitGateScorer, BrandGateScorer, CollectionFieldDef, CollectionEmbeddingDef, SpaceDef, PipelineDef, ConnectorDef, TypedSearchChannel, CollectionDef, FieldDef, EmbeddingDef, PhoneticDef, ParseDef, TypedScorer, EntityDef, CollectionTextFieldDef, CollectionNumberFieldDef, CollectionBooleanFieldDef, CollectionEnumFieldDef, CollectionArrayFieldDef, StageDef, TextSpaceDef, ImageSpaceDef, NumberSpaceDef, RecencySpaceDef, CategoricalSpaceDef } from './types.cjs';
+export { CollectionSearchDef, ProjectConfig, ScorerDef, ScoringDef, SearchChannelDef, SearchWeightsInput, StageContext } from './types.cjs';
+export { MatchCandidate, MatchComponents, MatchResult, ResolvedMatch } from './schemas.cjs';
+import 'zod';
+
+declare class IdentError extends Error {
+    constructor(message: string);
+}
+declare function assertIdent(name: string, kind: string): void;
+declare function assertNoIdentCollisions(names: readonly string[], kind: string): void;
+
+declare const fields: {
+    readonly text: (opts?: {
+        required?: boolean;
+        optional?: boolean;
+        maxLength?: number;
+    }) => FieldDef;
+    readonly number: (opts?: {
+        required?: boolean;
+        optional?: boolean;
+    }) => FieldDef;
+};
+declare const Scorers: {
+    readonly cosine: <const E extends string>(opts: {
+        embedding: E;
+        weight: number;
+    }) => CosineScorer<E>;
+    readonly trigram: <const F extends string>(opts: {
+        field: F;
+        weight: number;
+        latinOnlyPartial?: boolean;
+    }) => TrigramScorer<F>;
+    readonly phoneticEq: <const P extends string>(opts: {
+        phonetic: P;
+        weight: number;
+    }) => PhoneticEqScorer<P>;
+    readonly phoneExact: <const F extends string>(opts: {
+        field: F;
+        weight: number;
+    }) => PhoneExactScorer<F>;
+    readonly aliasHit: (opts: {
+        weight: number;
+    }) => AliasHitScorer;
+    readonly internalCodeExact: (opts: {
+        field: string;
+        shortCircuit?: boolean;
+    }) => InternalCodeExactScorer;
+    readonly sizeUnitGate: (opts: {
+        value: string;
+        unit: string;
+    }) => SizeUnitGateScorer;
+    readonly brandGate: (opts: {
+        field: string;
+        matchBoost?: number;
+        mismatchFactor?: number;
+    }) => BrandGateScorer;
+};
+type EntityInput<TFields extends Record<string, FieldDef>, TScopes extends readonly string[], TEmbeddings extends Record<string, EmbeddingDef>, TPhonetic extends Record<string, PhoneticDef>> = {
+    fields: TFields;
+    scopes: TScopes;
+    embeddings?: TEmbeddings;
+    phonetic?: TPhonetic;
+    parse?: ParseDef;
+    scoring?: {
+        channels: ReadonlyArray<TypedScorer<NoInfer<keyof TFields & string>, NoInfer<keyof TEmbeddings & string>, NoInfer<keyof TPhonetic & string>>>;
+        combiner?: "probabilistic-or" | "rrf" | "fellegi-sunter";
+        thresholds?: {
+            autoLink?: number;
+            suggest?: number;
+        };
+    };
+};
+declare function entity<const TFields extends Record<string, FieldDef>, const TScopes extends readonly string[], const TEmbeddings extends Record<string, EmbeddingDef> = Record<string, never>, const TPhonetic extends Record<string, PhoneticDef> = Record<string, never>>(name: string, def: EntityInput<TFields, TScopes, TEmbeddings, TPhonetic>): EntityDef & {
+    name: string;
+};
+declare const f: {
+    readonly text: (opts?: Omit<CollectionTextFieldDef, "type">) => CollectionTextFieldDef;
+    readonly number: (opts?: Omit<CollectionNumberFieldDef, "type">) => CollectionNumberFieldDef;
+    readonly boolean: (opts?: Omit<CollectionBooleanFieldDef, "type">) => CollectionBooleanFieldDef;
+    readonly enum: <const T extends readonly string[]>(values: T, opts?: Omit<CollectionEnumFieldDef, "type" | "values">) => CollectionEnumFieldDef;
+    readonly array: (item: CollectionEnumFieldDef | {
+        type: "text";
+    }, opts?: Omit<CollectionArrayFieldDef, "type" | "itemType" | "values">) => CollectionArrayFieldDef;
+};
+declare const Channels: {
+    readonly fts: <const F extends string>(opts: {
+        fields: readonly F[];
+        weight: number;
+    }) => FtsChannel<F>;
+    readonly cosine: <const E extends string>(opts: {
+        embedding: E;
+        weight: number;
+    }) => CosineChannel<E>;
+    readonly recency: <const F extends string>(opts: {
+        field: F;
+        halfLifeDays: number;
+        weight: number;
+    }) => RecencyChannel<F>;
+    readonly spaces: (opts: {
+        weight: number;
+    }) => SpacesChannel;
+};
+declare const s: {
+    readonly text: (opts: Omit<TextSpaceDef, "kind">) => TextSpaceDef;
+    readonly image: (opts: Omit<ImageSpaceDef, "kind">) => ImageSpaceDef;
+    readonly number: (opts: Omit<NumberSpaceDef, "kind">) => NumberSpaceDef;
+    readonly recency: (opts: Omit<RecencySpaceDef, "kind">) => RecencySpaceDef;
+    readonly categorical: (opts: Omit<CategoricalSpaceDef, "kind">) => CategoricalSpaceDef;
+};
+type CollectionInput<TFields extends Record<string, CollectionFieldDef>, TEmbeddings extends Record<string, CollectionEmbeddingDef>, TSpaces extends Record<string, SpaceDef> = Record<string, never>> = {
+    fields: TFields;
+    enrich?: PipelineDef;
+    sources?: ConnectorDef[];
+    embeddings?: TEmbeddings;
+    spaces?: TSpaces;
+    search?: {
+        channels: ReadonlyArray<TypedSearchChannel<NoInfer<keyof TFields & string>, NoInfer<keyof TEmbeddings & string>>>;
+        combiner?: "rrf";
+        defaultSpaceWeights?: Partial<Record<NoInfer<keyof TSpaces & string>, number>>;
+        nlq?: {
+            instructions?: string;
+            semanticRewrite?: boolean;
+            enable?: boolean;
+            schema?: Record<string, unknown>;
+            model?: string;
+        };
+    };
+};
+declare function collection<const TFields extends Record<string, CollectionFieldDef>, const TEmbeddings extends Record<string, CollectionEmbeddingDef> = Record<string, never>, const TSpaces extends Record<string, SpaceDef> = Record<string, never>>(name: string, def: CollectionInput<TFields, TEmbeddings, TSpaces>): CollectionDef & {
+    name: string;
+};
+declare function stage(name: string, def: Omit<StageDef, "name">): StageDef;
+declare function pipeline(...stages: StageDef[]): PipelineDef;
+declare const sources: {
+    readonly shopifyFeed: (opts: {
+        domain: string;
+        currency?: string;
+        maxPages?: number;
+        name?: string;
+    }) => ConnectorDef;
+    readonly wooStoreFeed: (opts: {
+        domain: string;
+        currency?: string;
+        maxPages?: number;
+        name?: string;
+    }) => ConnectorDef;
+    readonly jsonl: (opts: {
+        path: string;
+        name?: string;
+    }) => ConnectorDef;
+};
+
+export { AliasHitScorer, BrandGateScorer, CategoricalSpaceDef, Channels, CollectionArrayFieldDef, CollectionBooleanFieldDef, CollectionDef, CollectionEmbeddingDef, CollectionEnumFieldDef, CollectionFieldDef, CollectionNumberFieldDef, CollectionTextFieldDef, ConnectorDef, CosineChannel, CosineScorer, EmbeddingDef, EntityDef, FieldDef, FtsChannel, IdentError, ImageSpaceDef, InternalCodeExactScorer, NumberSpaceDef, ParseDef, PhoneExactScorer, PhoneticDef, PhoneticEqScorer, PipelineDef, RecencyChannel, RecencySpaceDef, Scorers, SizeUnitGateScorer, SpaceDef, SpacesChannel, StageDef, TextSpaceDef, TrigramScorer, TypedScorer, TypedSearchChannel, assertIdent, assertNoIdentCollisions, collection, entity, f, fields, pipeline, s, sources, stage };

package/dist/index.d.ts

@@ -0,0 +1,153 @@
+import { FtsChannel, CosineChannel, RecencyChannel, SpacesChannel, CosineScorer, TrigramScorer, PhoneticEqScorer, PhoneExactScorer, AliasHitScorer, InternalCodeExactScorer, SizeUnitGateScorer, BrandGateScorer, CollectionFieldDef, CollectionEmbeddingDef, SpaceDef, PipelineDef, ConnectorDef, TypedSearchChannel, CollectionDef, FieldDef, EmbeddingDef, PhoneticDef, ParseDef, TypedScorer, EntityDef, CollectionTextFieldDef, CollectionNumberFieldDef, CollectionBooleanFieldDef, CollectionEnumFieldDef, CollectionArrayFieldDef, StageDef, TextSpaceDef, ImageSpaceDef, NumberSpaceDef, RecencySpaceDef, CategoricalSpaceDef } from './types.js';
+export { CollectionSearchDef, ProjectConfig, ScorerDef, ScoringDef, SearchChannelDef, SearchWeightsInput, StageContext } from './types.js';
+export { MatchCandidate, MatchComponents, MatchResult, ResolvedMatch } from './schemas.js';
+import 'zod';
+
+declare class IdentError extends Error {
+    constructor(message: string);
+}
+declare function assertIdent(name: string, kind: string): void;
+declare function assertNoIdentCollisions(names: readonly string[], kind: string): void;
+
+declare const fields: {
+    readonly text: (opts?: {
+        required?: boolean;
+        optional?: boolean;
+        maxLength?: number;
+    }) => FieldDef;
+    readonly number: (opts?: {
+        required?: boolean;
+        optional?: boolean;
+    }) => FieldDef;
+};
+declare const Scorers: {
+    readonly cosine: <const E extends string>(opts: {
+        embedding: E;
+        weight: number;
+    }) => CosineScorer<E>;
+    readonly trigram: <const F extends string>(opts: {
+        field: F;
+        weight: number;
+        latinOnlyPartial?: boolean;
+    }) => TrigramScorer<F>;
+    readonly phoneticEq: <const P extends string>(opts: {
+        phonetic: P;
+        weight: number;
+    }) => PhoneticEqScorer<P>;
+    readonly phoneExact: <const F extends string>(opts: {
+        field: F;
+        weight: number;
+    }) => PhoneExactScorer<F>;
+    readonly aliasHit: (opts: {
+        weight: number;
+    }) => AliasHitScorer;
+    readonly internalCodeExact: (opts: {
+        field: string;
+        shortCircuit?: boolean;
+    }) => InternalCodeExactScorer;
+    readonly sizeUnitGate: (opts: {
+        value: string;
+        unit: string;
+    }) => SizeUnitGateScorer;
+    readonly brandGate: (opts: {
+        field: string;
+        matchBoost?: number;
+        mismatchFactor?: number;
+    }) => BrandGateScorer;
+};
+type EntityInput<TFields extends Record<string, FieldDef>, TScopes extends readonly string[], TEmbeddings extends Record<string, EmbeddingDef>, TPhonetic extends Record<string, PhoneticDef>> = {
+    fields: TFields;
+    scopes: TScopes;
+    embeddings?: TEmbeddings;
+    phonetic?: TPhonetic;
+    parse?: ParseDef;
+    scoring?: {
+        channels: ReadonlyArray<TypedScorer<NoInfer<keyof TFields & string>, NoInfer<keyof TEmbeddings & string>, NoInfer<keyof TPhonetic & string>>>;
+        combiner?: "probabilistic-or" | "rrf" | "fellegi-sunter";
+        thresholds?: {
+            autoLink?: number;
+            suggest?: number;
+        };
+    };
+};
+declare function entity<const TFields extends Record<string, FieldDef>, const TScopes extends readonly string[], const TEmbeddings extends Record<string, EmbeddingDef> = Record<string, never>, const TPhonetic extends Record<string, PhoneticDef> = Record<string, never>>(name: string, def: EntityInput<TFields, TScopes, TEmbeddings, TPhonetic>): EntityDef & {
+    name: string;
+};
+declare const f: {
+    readonly text: (opts?: Omit<CollectionTextFieldDef, "type">) => CollectionTextFieldDef;
+    readonly number: (opts?: Omit<CollectionNumberFieldDef, "type">) => CollectionNumberFieldDef;
+    readonly boolean: (opts?: Omit<CollectionBooleanFieldDef, "type">) => CollectionBooleanFieldDef;
+    readonly enum: <const T extends readonly string[]>(values: T, opts?: Omit<CollectionEnumFieldDef, "type" | "values">) => CollectionEnumFieldDef;
+    readonly array: (item: CollectionEnumFieldDef | {
+        type: "text";
+    }, opts?: Omit<CollectionArrayFieldDef, "type" | "itemType" | "values">) => CollectionArrayFieldDef;
+};
+declare const Channels: {
+    readonly fts: <const F extends string>(opts: {
+        fields: readonly F[];
+        weight: number;
+    }) => FtsChannel<F>;
+    readonly cosine: <const E extends string>(opts: {
+        embedding: E;
+        weight: number;
+    }) => CosineChannel<E>;
+    readonly recency: <const F extends string>(opts: {
+        field: F;
+        halfLifeDays: number;
+        weight: number;
+    }) => RecencyChannel<F>;
+    readonly spaces: (opts: {
+        weight: number;
+    }) => SpacesChannel;
+};
+declare const s: {
+    readonly text: (opts: Omit<TextSpaceDef, "kind">) => TextSpaceDef;
+    readonly image: (opts: Omit<ImageSpaceDef, "kind">) => ImageSpaceDef;
+    readonly number: (opts: Omit<NumberSpaceDef, "kind">) => NumberSpaceDef;
+    readonly recency: (opts: Omit<RecencySpaceDef, "kind">) => RecencySpaceDef;
+    readonly categorical: (opts: Omit<CategoricalSpaceDef, "kind">) => CategoricalSpaceDef;
+};
+type CollectionInput<TFields extends Record<string, CollectionFieldDef>, TEmbeddings extends Record<string, CollectionEmbeddingDef>, TSpaces extends Record<string, SpaceDef> = Record<string, never>> = {
+    fields: TFields;
+    enrich?: PipelineDef;
+    sources?: ConnectorDef[];
+    embeddings?: TEmbeddings;
+    spaces?: TSpaces;
+    search?: {
+        channels: ReadonlyArray<TypedSearchChannel<NoInfer<keyof TFields & string>, NoInfer<keyof TEmbeddings & string>>>;
+        combiner?: "rrf";
+        defaultSpaceWeights?: Partial<Record<NoInfer<keyof TSpaces & string>, number>>;
+        nlq?: {
+            instructions?: string;
+            semanticRewrite?: boolean;
+            enable?: boolean;
+            schema?: Record<string, unknown>;
+            model?: string;
+        };
+    };
+};
+declare function collection<const TFields extends Record<string, CollectionFieldDef>, const TEmbeddings extends Record<string, CollectionEmbeddingDef> = Record<string, never>, const TSpaces extends Record<string, SpaceDef> = Record<string, never>>(name: string, def: CollectionInput<TFields, TEmbeddings, TSpaces>): CollectionDef & {
+    name: string;
+};
+declare function stage(name: string, def: Omit<StageDef, "name">): StageDef;
+declare function pipeline(...stages: StageDef[]): PipelineDef;
+declare const sources: {
+    readonly shopifyFeed: (opts: {
+        domain: string;
+        currency?: string;
+        maxPages?: number;
+        name?: string;
+    }) => ConnectorDef;
+    readonly wooStoreFeed: (opts: {
+        domain: string;
+        currency?: string;
+        maxPages?: number;
+        name?: string;
+    }) => ConnectorDef;
+    readonly jsonl: (opts: {
+        path: string;
+        name?: string;
+    }) => ConnectorDef;
+};
+
+export { AliasHitScorer, BrandGateScorer, CategoricalSpaceDef, Channels, CollectionArrayFieldDef, CollectionBooleanFieldDef, CollectionDef, CollectionEmbeddingDef, CollectionEnumFieldDef, CollectionFieldDef, CollectionNumberFieldDef, CollectionTextFieldDef, ConnectorDef, CosineChannel, CosineScorer, EmbeddingDef, EntityDef, FieldDef, FtsChannel, IdentError, ImageSpaceDef, InternalCodeExactScorer, NumberSpaceDef, ParseDef, PhoneExactScorer, PhoneticDef, PhoneticEqScorer, PipelineDef, RecencyChannel, RecencySpaceDef, Scorers, SizeUnitGateScorer, SpaceDef, SpacesChannel, StageDef, TextSpaceDef, TrigramScorer, TypedScorer, TypedSearchChannel, assertIdent, assertNoIdentCollisions, collection, entity, f, fields, pipeline, s, sources, stage };