@mastra/duckdb 1.0.1 → 1.1.0-alpha.0

package/dist/storage/domains/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/observability/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAG7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA8NvD,2DAA2D;AAC3D,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C1G;AAED,oEAAoE;AACpE,wBAAsB,WAAW,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyB3G;AAMD,2GAA2G;AAC3G,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,gBAAgB,EACpB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAmGrC;AAED,4DAA4D;AAC5D,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,gBAAgB,EACpB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAoCrC;AAED,uFAAuF;AACvF,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,gBAAgB,EACpB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,2BAA2B,CAAC,CAsGtC;AAED,2EAA2E;AAC3E,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,gBAAgB,EACpB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,4BAA4B,CAAC,CAoCvC;AAMD,mEAAmE;AACnE,wBAAsB,cAAc,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAmBpH;AAED,0DAA0D;AAC1D,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,gBAAgB,EACpB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAMrC;AAED,mEAAmE;AACnE,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,gBAAgB,EACpB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,4BAA4B,CAAC,CAmBvC"}

package/dist/storage/domains/observability/scores.d.ts

@@ -0,0 +1,9 @@
+import type { BatchCreateScoresArgs, CreateScoreArgs, ListScoresArgs, ListScoresResponse } from '@mastra/core/storage';
+import type { DuckDBConnection } from '../../db/index.js';
+/** Insert a single score event. */
+export declare function createScore(db: DuckDBConnection, args: CreateScoreArgs): Promise<void>;
+/** Insert multiple score events in a single statement. */
+export declare function batchCreateScores(db: DuckDBConnection, args: BatchCreateScoresArgs): Promise<void>;
+/** Query score events with filtering, ordering, and pagination. */
+export declare function listScores(db: DuckDBConnection, args: ListScoresArgs): Promise<ListScoresResponse>;
+//# sourceMappingURL=scores.d.ts.map

package/dist/storage/domains/observability/scores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scores.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/observability/scores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,mCAAmC;AACnC,wBAAsB,WAAW,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5F;AAED,0DAA0D;AAC1D,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBxG;AAED,mEAAmE;AACnE,wBAAsB,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0CxG"}

package/dist/storage/domains/observability/tracing.d.ts

@@ -0,0 +1,17 @@
+import type { CreateSpanArgs, GetSpanArgs, GetSpanResponse, GetRootSpanArgs, GetRootSpanResponse, GetTraceArgs, GetTraceResponse, ListTracesArgs, ListTracesResponse, BatchCreateSpansArgs, BatchDeleteTracesArgs } from '@mastra/core/storage';
+import type { DuckDBConnection } from '../../db/index.js';
+/** Insert a 'start' event for a new span. */
+export declare function createSpan(db: DuckDBConnection, args: CreateSpanArgs): Promise<void>;
+/** Insert 'start' events for multiple spans in a single statement. */
+export declare function batchCreateSpans(db: DuckDBConnection, args: BatchCreateSpansArgs): Promise<void>;
+/** Delete all span events for the given trace IDs. */
+export declare function batchDeleteTraces(db: DuckDBConnection, args: BatchDeleteTracesArgs): Promise<void>;
+/** Reconstruct a single span from its event history. */
+export declare function getSpan(db: DuckDBConnection, args: GetSpanArgs): Promise<GetSpanResponse | null>;
+/** Reconstruct the root span (no parent) for a trace. */
+export declare function getRootSpan(db: DuckDBConnection, args: GetRootSpanArgs): Promise<GetRootSpanResponse | null>;
+/** Reconstruct all spans belonging to a trace. */
+export declare function getTrace(db: DuckDBConnection, args: GetTraceArgs): Promise<GetTraceResponse | null>;
+/** List root spans (traces) with filtering, ordering, and pagination. */
+export declare function listTraces(db: DuckDBConnection, args: ListTracesArgs): Promise<ListTracesResponse>;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/storage/domains/observability/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/observability/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA+SvD,6CAA6C;AAC7C,wBAAsB,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F;AAED,sEAAsE;AACtE,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtG;AAED,sDAAsD;AACtD,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxG;AAMD,wDAAwD;AACxD,wBAAsB,OAAO,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOtG;AAED,yDAAyD;AACzD,wBAAsB,WAAW,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAOlH;AAED,kDAAkD;AAClD,wBAAsB,QAAQ,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAOzG;AAED,yEAAyE;AACzE,wBAAsB,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoDxG"}

package/dist/storage/index.d.ts

@@ -0,0 +1,101 @@
+import type { StorageDomains } from '@mastra/core/storage';
+import { MastraCompositeStore, ObservabilityStorage as CoreObservabilityStorage } from '@mastra/core/storage';
+import { DuckDBConnection } from './db/index.js';
+import type { ObservabilityDuckDBConfig, ObservabilityStorageDuckDB as ObservabilityStorageDuckDBImpl } from './domains/observability/index.js';
+export { DuckDBConnection } from './db/index.js';
+export type { DuckDBStorageConfig } from './db/index.js';
+export type { ObservabilityDuckDBConfig } from './domains/observability/index.js';
+type ObservabilityStoreImpl = ObservabilityStorageDuckDBImpl;
+/**
+ * Lazy DuckDB observability facade.
+ *
+ * This avoids loading the concrete observability implementation until init or first use,
+ * which lets DuckDBStore degrade cleanly when paired with an older @mastra/core runtime.
+ */
+export declare class ObservabilityStorageDuckDB extends CoreObservabilityStorage {
+    private db;
+    private delegate;
+    private loadPromise;
+    private unavailableError;
+    constructor(config: ObservabilityDuckDBConfig);
+    private createUnavailableError;
+    private loadDelegate;
+    private requireDelegate;
+    get observabilityStrategy(): ObservabilityStoreImpl['observabilityStrategy'];
+    get tracingStrategy(): ObservabilityStoreImpl['tracingStrategy'];
+    init(...args: Parameters<ObservabilityStoreImpl['init']>): ReturnType<ObservabilityStoreImpl['init']>;
+    dangerouslyClearAll(...args: Parameters<ObservabilityStoreImpl['dangerouslyClearAll']>): ReturnType<ObservabilityStoreImpl['dangerouslyClearAll']>;
+    createSpan(...args: Parameters<ObservabilityStoreImpl['createSpan']>): ReturnType<ObservabilityStoreImpl['createSpan']>;
+    updateSpan(...args: Parameters<ObservabilityStoreImpl['updateSpan']>): ReturnType<ObservabilityStoreImpl['updateSpan']>;
+    getSpan(...args: Parameters<ObservabilityStoreImpl['getSpan']>): ReturnType<ObservabilityStoreImpl['getSpan']>;
+    getRootSpan(...args: Parameters<ObservabilityStoreImpl['getRootSpan']>): ReturnType<ObservabilityStoreImpl['getRootSpan']>;
+    getTrace(...args: Parameters<ObservabilityStoreImpl['getTrace']>): ReturnType<ObservabilityStoreImpl['getTrace']>;
+    listTraces(...args: Parameters<ObservabilityStoreImpl['listTraces']>): ReturnType<ObservabilityStoreImpl['listTraces']>;
+    batchCreateSpans(...args: Parameters<ObservabilityStoreImpl['batchCreateSpans']>): ReturnType<ObservabilityStoreImpl['batchCreateSpans']>;
+    batchUpdateSpans(...args: Parameters<ObservabilityStoreImpl['batchUpdateSpans']>): ReturnType<ObservabilityStoreImpl['batchUpdateSpans']>;
+    batchDeleteTraces(...args: Parameters<ObservabilityStoreImpl['batchDeleteTraces']>): ReturnType<ObservabilityStoreImpl['batchDeleteTraces']>;
+    batchCreateLogs(...args: Parameters<ObservabilityStoreImpl['batchCreateLogs']>): ReturnType<ObservabilityStoreImpl['batchCreateLogs']>;
+    listLogs(...args: Parameters<ObservabilityStoreImpl['listLogs']>): ReturnType<ObservabilityStoreImpl['listLogs']>;
+    batchCreateMetrics(...args: Parameters<ObservabilityStoreImpl['batchCreateMetrics']>): ReturnType<ObservabilityStoreImpl['batchCreateMetrics']>;
+    listMetrics(...args: Parameters<ObservabilityStoreImpl['listMetrics']>): ReturnType<ObservabilityStoreImpl['listMetrics']>;
+    getMetricAggregate(...args: Parameters<ObservabilityStoreImpl['getMetricAggregate']>): ReturnType<ObservabilityStoreImpl['getMetricAggregate']>;
+    getMetricBreakdown(...args: Parameters<ObservabilityStoreImpl['getMetricBreakdown']>): ReturnType<ObservabilityStoreImpl['getMetricBreakdown']>;
+    getMetricTimeSeries(...args: Parameters<ObservabilityStoreImpl['getMetricTimeSeries']>): ReturnType<ObservabilityStoreImpl['getMetricTimeSeries']>;
+    getMetricPercentiles(...args: Parameters<ObservabilityStoreImpl['getMetricPercentiles']>): ReturnType<ObservabilityStoreImpl['getMetricPercentiles']>;
+    getMetricNames(...args: Parameters<ObservabilityStoreImpl['getMetricNames']>): ReturnType<ObservabilityStoreImpl['getMetricNames']>;
+    getMetricLabelKeys(...args: Parameters<ObservabilityStoreImpl['getMetricLabelKeys']>): ReturnType<ObservabilityStoreImpl['getMetricLabelKeys']>;
+    getMetricLabelValues(...args: Parameters<ObservabilityStoreImpl['getMetricLabelValues']>): ReturnType<ObservabilityStoreImpl['getMetricLabelValues']>;
+    getEntityTypes(...args: Parameters<ObservabilityStoreImpl['getEntityTypes']>): ReturnType<ObservabilityStoreImpl['getEntityTypes']>;
+    getEntityNames(...args: Parameters<ObservabilityStoreImpl['getEntityNames']>): ReturnType<ObservabilityStoreImpl['getEntityNames']>;
+    getServiceNames(...args: Parameters<ObservabilityStoreImpl['getServiceNames']>): ReturnType<ObservabilityStoreImpl['getServiceNames']>;
+    getEnvironments(...args: Parameters<ObservabilityStoreImpl['getEnvironments']>): ReturnType<ObservabilityStoreImpl['getEnvironments']>;
+    getTags(...args: Parameters<ObservabilityStoreImpl['getTags']>): ReturnType<ObservabilityStoreImpl['getTags']>;
+    createScore(...args: Parameters<ObservabilityStoreImpl['createScore']>): ReturnType<ObservabilityStoreImpl['createScore']>;
+    batchCreateScores(...args: Parameters<ObservabilityStoreImpl['batchCreateScores']>): ReturnType<ObservabilityStoreImpl['batchCreateScores']>;
+    listScores(...args: Parameters<ObservabilityStoreImpl['listScores']>): ReturnType<ObservabilityStoreImpl['listScores']>;
+    createFeedback(...args: Parameters<ObservabilityStoreImpl['createFeedback']>): ReturnType<ObservabilityStoreImpl['createFeedback']>;
+    batchCreateFeedback(...args: Parameters<ObservabilityStoreImpl['batchCreateFeedback']>): ReturnType<ObservabilityStoreImpl['batchCreateFeedback']>;
+    listFeedback(...args: Parameters<ObservabilityStoreImpl['listFeedback']>): ReturnType<ObservabilityStoreImpl['listFeedback']>;
+}
+/** Configuration for the top-level DuckDBStore composite. */
+export interface DuckDBStoreConfig {
+    /** Store identifier. Defaults to 'duckdb'. */
+    id?: string;
+    /**
+     * Path to the DuckDB database file.
+     * @default 'mastra.duckdb'
+     * Use ':memory:' for an ephemeral in-memory database.
+     */
+    path?: string;
+}
+/**
+ * DuckDB storage adapter for Mastra.
+ *
+ * Currently provides observability storage (traces, metrics, logs, scores, feedback).
+ * Use via composition with another store for domains DuckDB doesn't yet cover.
+ *
+ * @example
+ * ```typescript
+ * // As the observability backend in a composed store
+ * const storage = new MastraCompositeStore({
+ *   id: 'my-store',
+ *   default: new LibSQLStore({ id: 'my-store', url: 'file:./dev.db' }),
+ *   domains: {
+ *     observability: new DuckDBStore().observability,
+ *   },
+ * });
+ *
+ * // Or standalone (only observability domain available)
+ * const duckdb = new DuckDBStore();
+ * const obs = await duckdb.getStore('observability');
+ * ```
+ */
+export declare class DuckDBStore extends MastraCompositeStore {
+    readonly db: DuckDBConnection;
+    private observabilityStore;
+    stores: StorageDomains;
+    constructor(config?: DuckDBStoreConfig);
+    /** Convenience accessor for the observability domain. */
+    get observability(): ObservabilityStorageDuckDB;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,IAAI,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,IAAI,8BAA8B,EAC7D,MAAM,+BAA+B,CAAC;AAoBvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E,KAAK,sBAAsB,GAAG,8BAA8B,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,wBAAwB;IACtE,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,WAAW,CAAuD;IAC1E,OAAO,CAAC,gBAAgB,CAA4B;gBAExC,MAAM,EAAE,yBAAyB;IAK7C,OAAO,CAAC,sBAAsB;YAYhB,YAAY;YA6BZ,eAAe;IAS7B,IAAI,qBAAqB,IAAI,sBAAsB,CAAC,uBAAuB,CAAC,CAO3E;IAED,IAAI,eAAe,IAAI,sBAAsB,CAAC,iBAAiB,CAAC,CAE/D;IAEK,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IASrG,mBAAmB,CACvB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,GACjE,UAAU,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;IAKtD,UAAU,CACd,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,GACxD,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAK7C,UAAU,CACd,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,GACxD,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAK7C,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,GAAG,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAK9G,WAAW,CACf,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,GACzD,UAAU,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAK9C,QAAQ,CACZ,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,GACtD,UAAU,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAK3C,UAAU,CACd,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,GACxD,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAK7C,gBAAgB,CACpB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,GAC9D,UAAU,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAKnD,gBAAgB,CACpB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,GAC9D,UAAU,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAKnD,iBAAiB,CACrB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC,GAC/D,UAAU,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAKpD,eAAe,CACnB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,GAC7D,UAAU,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAKlD,QAAQ,CACZ,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,GACtD,UAAU,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAK3C,kBAAkB,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,GAChE,UAAU,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAKrD,WAAW,CACf,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,GACzD,UAAU,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAK9C,kBAAkB,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,GAChE,UAAU,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAKrD,kBAAkB,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,GAChE,UAAU,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAKrD,mBAAmB,CACvB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,GACjE,UAAU,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;IAKtD,oBAAoB,CACxB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC,GAClE,UAAU,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC;IAKvD,cAAc,CAClB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,GAC5D,UAAU,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAKjD,kBAAkB,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC,GAChE,UAAU,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAKrD,oBAAoB,CACxB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC,GAClE,UAAU,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC;IAKvD,cAAc,CAClB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,GAC5D,UAAU,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAKjD,cAAc,CAClB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,GAC5D,UAAU,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAKjD,eAAe,CACnB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,GAC7D,UAAU,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAKlD,eAAe,CACnB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,GAC7D,UAAU,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAKlD,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,GAAG,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAK9G,WAAW,CACf,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,GACzD,UAAU,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAK9C,iBAAiB,CACrB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC,GAC/D,UAAU,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAKpD,UAAU,CACd,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,GACxD,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAK7C,cAAc,CAClB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,GAC5D,UAAU,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAKjD,mBAAmB,CACvB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC,GACjE,UAAU,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;IAKtD,YAAY,CAChB,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,GAC1D,UAAU,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC;CAItD;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,SAAQ,oBAAoB;IACnD,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,MAAM,EAAE,cAAc,CAAC;gBAEX,MAAM,GAAE,iBAAsB;IAY1C,yDAAyD;IACzD,IAAI,aAAa,IAAI,0BAA0B,CAE9C;CACF"}

package/dist/vector/filter-builder.d.ts

@@ -1,4 +1,5 @@
 import type { DuckDBVectorFilter } from './types.js';
+/** Result of building a SQL filter: a WHERE clause fragment and bound parameters. */
 export interface FilterResult {
     clause: string;
     params: unknown[];

package/dist/vector/filter-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter-builder.d.ts","sourceRoot":"","sources":["../../src/vector/filter-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AA8BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAkE1E"}
+{"version":3,"file":"filter-builder.d.ts","sourceRoot":"","sources":["../../src/vector/filter-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AA8BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAkE1E"}

package/dist/vector/index.d.ts

@@ -43,14 +43,23 @@ export declare class DuckDBVector extends MastraVector<DuckDBVectorFilter> {
      * Get the distance function for the configured metric.
      */
     private getDistanceFunction;
+    /** Perform a vector similarity search with optional metadata filtering. */
     query(params: QueryVectorParams<DuckDBVectorFilter>): Promise<QueryResult[]>;
+    /** Insert or replace vectors with metadata. Returns the vector IDs. */
     upsert(params: UpsertVectorParams): Promise<string[]>;
+    /** Create a vector table with HNSW index for similarity search. */
     createIndex(params: CreateIndexParams): Promise<void>;
+    /** List all vector table names in the database. */
     listIndexes(): Promise<string[]>;
+    /** Return dimension, row count, and metric for a vector index. */
     describeIndex(params: DescribeIndexParams): Promise<IndexStats>;
+    /** Drop a vector table and its HNSW index. */
     deleteIndex(params: DeleteIndexParams): Promise<void>;
+    /** Update a vector's embedding and/or metadata by ID or filter. */
     updateVector(params: UpdateVectorParams<DuckDBVectorFilter>): Promise<void>;
+    /** Delete a single vector by ID. */
     deleteVector(params: DeleteVectorParams): Promise<void>;
+    /** Delete multiple vectors by IDs or metadata filter (mutually exclusive). */
     deleteVectors(params: DeleteVectorsParams<DuckDBVectorFilter>): Promise<void>;
     /**
      * Close the database connection.

package/dist/vector/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAqC,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAChE,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,EAAE,kBAAkB;IAUtC;;OAEG;YACW,UAAU;IAgDxB;;OAEG;YACW,aAAa;IAQ3B;;OAEG;YACW,QAAQ;IA2BtB;;OAEG;YACW,YAAY;IAoB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAarB,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkF5E,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkCrD,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCrD,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAehC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsC/D,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkD3E,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD,aAAa,CAAC,MAAM,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCnF;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAqC,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAChE,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,EAAE,kBAAkB;IAUtC;;OAEG;YACW,UAAU;IAgDxB;;OAEG;YACW,aAAa;IAQ3B;;OAEG;YACW,QAAQ;IA4BtB;;OAEG;YACW,YAAY;IAqB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B,2EAA2E;IACrE,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkFlF,uEAAuE;IACjE,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkC3D,mEAAmE;IAC7D,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC3D,mDAAmD;IAC7C,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAetC,kEAAkE;IAC5D,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsCrE,8CAA8C;IACxC,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D,mEAAmE;IAC7D,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDjF,oCAAoC;IAC9B,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D,8EAA8E;IACxE,aAAa,CAAC,MAAM,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCnF;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/duckdb",
-  "version": "1.0.1",
+  "version": "1.1.0-alpha.0",
   "description": "DuckDB vector store provider for Mastra - embedded high-performance vector storage with HNSW indexing",
   "type": "module",
   "main": "dist/index.js",
@@ -23,18 +23,18 @@
     "@duckdb/node-api": "1.4.2-r.1"
   },
   "devDependencies": {
-    "@types/node": "22.19.7",
+    "@types/node": "22.19.15",
     "@vitest/coverage-v8": "4.0.18",
     "@vitest/ui": "4.0.18",
-    "eslint": "^9.37.0",
+    "eslint": "^9.39.4",
     "rimraf": "^5.0.10",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
-    "@internal/lint": "0.0.63",
-    "@internal/storage-test-utils": "0.0.59",
-    "@internal/types-builder": "0.0.38",
-    "@mastra/core": "1.8.0"
+    "@internal/storage-test-utils": "0.0.70",
+    "@internal/lint": "0.0.74",
+    "@mastra/core": "1.16.1-alpha.1",
+    "@internal/types-builder": "0.0.49"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"