@mastra/oracledb 0.0.0 → 0.2.0-alpha.0

package/dist/storage/migrations.d.ts

@@ -0,0 +1,55 @@
+import type { ObjectRow } from '../shared/connection.js';
+import type { OracleQueryBinds, OracleTxClient } from './db/index.js';
+export declare const DEFAULT_ORACLE_MIGRATIONS_TABLE = "MASTRA_ORACLE_MIGRATIONS";
+export type OracleMigrationKind = 'versioned' | 'repeatable';
+export type OracleMigrationStatus = 'applied' | 'reapplied' | 'skipped';
+export interface OracleMigration {
+    id: string;
+    name: string;
+    description?: string;
+    kind?: OracleMigrationKind;
+    checksum?: string;
+    run(): Promise<void>;
+}
+export interface OracleMigrationRecord {
+    id: string;
+    name: string;
+    kind: OracleMigrationKind;
+    checksum: string;
+    description?: string | null;
+    appliedAt?: unknown;
+    updatedAt?: unknown;
+}
+export interface OracleMigrationResult {
+    id: string;
+    name: string;
+    kind: OracleMigrationKind;
+    status: OracleMigrationStatus;
+    checksum: string;
+}
+export interface OracleMigrationRunOptions {
+    forceRepeatable?: boolean;
+}
+export interface OracleMigrationDatabase {
+    table(tableName: string): string;
+    executeDdl(sql: string, ignoredErrorCodes?: number[]): Promise<void>;
+    manyOrNone<T extends ObjectRow = ObjectRow>(sql: string, binds?: OracleQueryBinds): Promise<T[]>;
+    tx<T>(callback: (client: OracleTxClient) => Promise<T>): Promise<T>;
+}
+export interface OracleMigrationRegistryConfig {
+    db: OracleMigrationDatabase;
+    tableName?: string;
+}
+export declare class OracleMigrationRegistry {
+    private readonly db;
+    private readonly tableName;
+    constructor(config: OracleMigrationRegistryConfig);
+    init(): Promise<void>;
+    list(): Promise<OracleMigrationRecord[]>;
+    run(migrations: OracleMigration[], options?: OracleMigrationRunOptions): Promise<OracleMigrationResult[]>;
+    private table;
+    private readRecords;
+    private record;
+}
+export declare function oracleMigrationTableSql(qualifiedTableName: string): string;
+//# sourceMappingURL=migrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE7D,eAAO,MAAM,+BAA+B,6BAA6B,CAAC;AAI1E,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,YAAY,CAAC;AAC7D,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,UAAU,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACjG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,uBAAuB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,6BAA6B;IAK3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAKxC,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IA8CnH,OAAO,CAAC,KAAK;YAIC,WAAW;YAeX,MAAM;CAiCrB;AAED,wBAAgB,uBAAuB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAU1E"}

package/dist/storage/types.d.ts

@@ -0,0 +1,44 @@
+import type { MastraCompositeStoreConfig } from '@mastra/core/storage';
+import type { OracleConnectionConfig, OraclePoolManager } from '../shared/connection.js';
+import type { OracleCreateIndexOptions } from './db/index.js';
+export interface OracleStoreConfig extends OracleConnectionConfig, Pick<MastraCompositeStoreConfig, 'disableInit'> {
+    id: string;
+    schemaName?: string;
+    poolManager?: OraclePoolManager;
+    /**
+     * Number of messages to send per Oracle executeMany call. The full
+     * saveMessages operation still commits once at the transaction boundary.
+     */
+    messageBatchSize?: number;
+    /**
+     * When true, default performance indexes are not created during initialization.
+     * Use this when DBAs manage indexes separately or custom indexes replace the defaults.
+     */
+    skipDefaultIndexes?: boolean;
+    /**
+     * Oracle-native custom indexes to create during initialization. Indexes are
+     * routed to the storage domain that owns the target table.
+     */
+    indexes?: OracleCreateIndexOptions[];
+    /**
+     * Oracle table used to track storage schema migrations. Override only when
+     * multiple logical Mastra deployments share the same Oracle schema.
+     */
+    migrationTableName?: string;
+    /**
+     * OracleVector registry table used to discover semantic-recall vector tables
+     * during message/thread deletion. Set this to the same value as
+     * OracleVector.registryTableName when that option is customized.
+     */
+    vectorRegistryTableName?: string;
+}
+export interface OracleDomainConfig {
+    poolManager: OraclePoolManager;
+    schemaName?: string;
+    messageBatchSize?: number;
+    skipDefaultIndexes?: boolean;
+    indexes?: OracleCreateIndexOptions[];
+    vectorRegistryTableName?: string;
+}
+export type { OracleCreateIndexOptions, OracleIndexType } from './db/index.js';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,MAAM,CAAC;AAIrD,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB,EAAE,IAAI,CAAC,0BAA0B,EAAE,aAAa,CAAC;IAChH,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACrC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAID,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,YAAY,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC"}

package/dist/vector/ddl.d.ts

@@ -0,0 +1,58 @@
+import type { DeleteIndexParams } from '@mastra/core/vector';
+import type { Connection } from 'oracledb';
+import type { OracleBuildIndexParams, OracleCreateIndexParams, OracleIndexStats, OracleMetric, OracleRebuildIndexParams, OracleVectorFormat, OracleVectorIndexConfig, OracleVectorIndexType } from './types.js';
+export declare const DEFAULT_TABLE_PREFIX = "MASTRA_VEC";
+export declare const DEFAULT_REGISTRY_TABLE = "MASTRA_VECTOR_INDEXES";
+export declare const DEFAULT_METADATA_INDEXES: string[];
+export declare const DEFAULT_VECTOR_FORMAT: OracleVectorFormat;
+export type WithConnection = <T>(callback: (connection: Connection) => Promise<T>) => Promise<T>;
+export interface IndexInfo extends OracleIndexStats {
+    qualifiedTableName: string;
+}
+export type CachedIndexInfo = Omit<IndexInfo, 'count'>;
+export interface IndexRegistryConfig {
+    schemaName?: string;
+    tablePrefix: string;
+    registryTableName: string;
+    defaultMetadataIndexes: string[];
+    defaultVectorFormat: OracleVectorFormat;
+    defaultIndexConfig: OracleVectorIndexConfig;
+}
+export declare class IndexRegistry {
+    readonly schemaName?: string;
+    private readonly tablePrefix;
+    private readonly registryTableName;
+    private readonly defaultMetadataIndexes;
+    private readonly defaultVectorFormat;
+    private readonly defaultIndexConfig;
+    private readonly indexLocks;
+    private readonly indexInfoCache;
+    private registryReady;
+    private registryPromise?;
+    constructor(config: IndexRegistryConfig);
+    createIndex(withConnection: WithConnection, { indexName, dimension, metric, vectorFormat, indexConfig, buildIndex, metadataIndexes, }: OracleCreateIndexParams): Promise<void>;
+    buildIndex(withConnection: WithConnection, { indexName, metric, indexConfig }: OracleBuildIndexParams): Promise<void>;
+    rebuildIndex(withConnection: WithConnection, { indexName, metric, indexConfig }: OracleRebuildIndexParams): Promise<void>;
+    deleteIndex(withConnection: WithConnection, { indexName }: DeleteIndexParams): Promise<void>;
+    withIndexLock<T>(indexName: string, callback: () => Promise<T>): Promise<T>;
+    ensureRegistry(connection: Connection): Promise<void>;
+    createVectorTable(connection: Connection, indexName: string, dimension: number, vectorFormat: OracleVectorFormat): Promise<void>;
+    upsertRegistry(connection: Connection, indexName: string, dimension: number, metric: OracleMetric, vectorFormat: OracleVectorFormat, indexConfig?: OracleVectorIndexConfig): Promise<void>;
+    updateRegistryIndexConfig(connection: Connection, indexName: string, metric: OracleMetric, indexConfig: OracleVectorIndexConfig): Promise<void>;
+    createVectorIndex(connection: Connection, indexName: string, metric: OracleMetric, indexConfig?: OracleVectorIndexConfig, tableNameOverride?: string): Promise<boolean>;
+    dropVectorIndex(connection: Connection, indexName: string, tableNameOverride?: string): Promise<void>;
+    createMetadataIndexes(connection: Connection, indexName: string, metadataFields: string[], tableNameOverride?: string): Promise<void>;
+    getIndexMetadata(connection: Connection, indexName: string): Promise<CachedIndexInfo>;
+    cacheIndexMetadata(indexName: string, indexInfo: CachedIndexInfo): CachedIndexInfo;
+    clearIndexMetadata(indexName: string): void;
+    getRegistryEntry(connection: Connection, indexName: string): Promise<Omit<IndexInfo, 'qualifiedTableName' | 'count'> | null>;
+    findRegistryEntryByTableName(connection: Connection, tableName: string): Promise<string | null>;
+    vectorTableExists(connection: Connection, tableName: string): Promise<boolean>;
+    assertCompatibleExistingIndex(existing: Omit<IndexInfo, 'qualifiedTableName' | 'count'>, indexName: string, dimension: number, metric: OracleMetric, vectorFormat: OracleVectorFormat): void;
+    mergeIndexConfig(indexConfig?: OracleVectorIndexConfig): Required<Pick<OracleVectorIndexConfig, 'type'>> & OracleVectorIndexConfig;
+    qualifiedRegistryTable(): string;
+    qualifiedTableName(indexName: string): string;
+    qualifiedIndexName(indexName: string): string;
+}
+export declare function normalizeIndexType(indexType: string): OracleVectorIndexType;
+//# sourceMappingURL=ddl.d.ts.map

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

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

package/dist/vector/filter.d.ts

@@ -0,0 +1,7 @@
+import type { OracleVectorFilter } from './types.js';
+export interface SqlFragment {
+    sql: string;
+    binds: Record<string, unknown>;
+}
+export declare function buildMetadataWhereClause(filter?: OracleVectorFilter): SqlFragment;
+//# sourceMappingURL=filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/vector/filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAeD,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAQjF"}

package/dist/vector/identifiers.d.ts

@@ -0,0 +1,11 @@
+export declare function normalizeIdentifier(value: string, label: string): string;
+export declare function normalizeLogicalIndexName(value: string, label?: string): string;
+export declare function legacyCanonicalIndexName(value: string): string;
+export declare function quoteIdentifier(value: string, label: string): string;
+export declare function qualifyName(name: string, schemaName?: string): string;
+export declare function tableNameForIndex(indexName: string, tablePrefix?: string): string;
+export declare function indexNameForTable(tableName: string, suffix: string): string;
+export declare function indexNameForMetadataField(tableName: string, field: string): string;
+export declare function assertJsonPath(path: string): string;
+export declare function jsonPathForPredicatePrefix(path: string): string;
+//# sourceMappingURL=identifiers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../src/vector/identifiers.ts"],"names":[],"mappings":"AAQA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CASxE;AAGD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAe,GAAG,MAAM,CASrF;AAGD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrE;AAGD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAe,GAAG,MAAM,CAUvF;AAGD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlF;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD;AAGD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/D"}

package/dist/vector/index.d.ts

@@ -0,0 +1,32 @@
+export type * from './types.js';
+import { MastraVector } from '@mastra/core/vector';
+import type { DeleteIndexParams, DeleteVectorParams, DeleteVectorsParams, DescribeIndexParams, IndexStats, QueryResult, UpdateVectorParams, UpsertVectorParams } from '@mastra/core/vector';
+import type { OracleBuildIndexParams, OracleConfigureVectorMemoryParams, OracleCreateIndexParams, OracleIndexAccuracyParams, OracleIndexStatusParams, OracleQueryVectorParams, OracleRebuildIndexParams, OracleVectorConfig, OracleVectorFilter } from './types.js';
+export declare class OracleVector extends MastraVector<OracleVectorFilter> {
+    private readonly poolManager;
+    private readonly ownsPoolManager;
+    private readonly defaultIndexConfig;
+    private readonly upsertBatchSize;
+    private readonly registry;
+    constructor(config: OracleVectorConfig);
+    createIndex(params: OracleCreateIndexParams): Promise<void>;
+    buildIndex(params: OracleBuildIndexParams): Promise<void>;
+    rebuildIndex(params: OracleRebuildIndexParams): Promise<void>;
+    deleteIndex(params: DeleteIndexParams): Promise<void>;
+    configureVectorMemory(params: OracleConfigureVectorMemoryParams): Promise<void>;
+    getIndexStatus(params: OracleIndexStatusParams): Promise<string>;
+    indexAccuracyQuery(params: OracleIndexAccuracyParams): Promise<string>;
+    upsert(params: UpsertVectorParams): Promise<string[]>;
+    query(params: OracleQueryVectorParams): Promise<QueryResult[]>;
+    listIndexes(): Promise<string[]>;
+    describeIndex(params: DescribeIndexParams): Promise<IndexStats>;
+    updateVector(params: UpdateVectorParams<OracleVectorFilter>): Promise<void>;
+    deleteVector(params: DeleteVectorParams): Promise<void>;
+    deleteVectors(params: DeleteVectorsParams<OracleVectorFilter>): Promise<void>;
+    disconnect(): Promise<void>;
+    close(): Promise<void>;
+    private withConnection;
+    private cacheIndexMetadata;
+    private createVectorIndex;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,SAAS,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAsB7B,OAAO,KAAK,EACV,sBAAsB,EACtB,iCAAiC,EACjC,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EAEvB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAEnB,MAAM,SAAS,CAAC;AAcjB,qBAAa,YAAa,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,MAAM,EAAE,kBAAkB;IAkChC,WAAW,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,UAAU,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,YAAY,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,qBAAqB,CAAC,MAAM,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhE,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAItE,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIrD,KAAK,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9D,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/D,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,aAAa,CAAC,MAAM,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,cAAc;IAM5B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,iBAAiB;CAS1B"}

package/dist/vector/prompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Vector store specific prompt that details supported Oracle JSON metadata filter operators and examples.
+ * This prompt helps users construct valid filters for Oracle Database Vector Search.
+ */
+export declare const ORACLEDB_PROMPT = "When querying Oracle Database Vector Search, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nOracle-specific behavior:\n- Metadata is stored as Oracle JSON.\n- Scalar comparisons are compiled to JSON_VALUE(metadata, ...).\n- Array, existence, and element-match checks are compiled to JSON_EXISTS(metadata, ...).\n- Regex filters are compiled to Oracle REGEXP_LIKE.\n- String contains filters are compiled to case-insensitive LIKE predicates.\n- User metadata values are always bound as parameters; do not generate raw SQL fragments inside filters.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in an array or scalar field\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in an array or scalar field\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n- $all: Match all values in an array field\n  Example: { \"tags\": { \"$all\": [\"premium\", \"sale\"] } }\n- $elemMatch: Match array elements that meet all specified conditions\n  Example: { \"items\": { \"$elemMatch\": { \"price\": { \"$gt\": 100 } } } }\n- $contains: For strings, perform case-insensitive substring matching. For arrays, require contained values.\n  Example: { \"title\": { \"$contains\": \"oracle\" } }\n  Example: { \"tags\": { \"$contains\": \"premium\" } }\n\nLogical Operators:\n- $and: Logical AND (implicit when using multiple conditions)\n  Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n- $not: Logical NOT\n  Example: { \"$not\": { \"category\": \"electronics\" } }\n- $nor: Logical NOR\n  Example: { \"$nor\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if a JSON metadata field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nSpecial Operators:\n- $size: Array length check\n  Example: { \"tags\": { \"$size\": 2 } }\n- $regex: Oracle regular expression match using REGEXP_LIKE\n  Example: { \"source\": { \"$regex\": \"oracle.*database\" } }\n\nRestrictions:\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported with both implicit and explicit $and\n- Array operations should be used only on JSON array fields\n- Empty arrays in $in, $nin, and $all conditions are handled gracefully\n- Only logical operators ($and, $or, $not, $nor) can be used at the top level\n- All other operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$gt\": 100 }\n  Invalid: { \"$contains\": \"value\" }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- $not operator:\n  - Must be a non-empty object\n  - Can be used at field level or top level\n  - Valid: { \"$not\": { \"field\": \"value\" } }\n  - Valid: { \"field\": { \"$not\": { \"$eq\": \"value\" } } }\n- Other logical operators ($and, $or, $nor):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n- $elemMatch requires an object with conditions\n  Valid: { \"array\": { \"$elemMatch\": { \"field\": \"value\" } } }\n  Invalid: { \"array\": { \"$elemMatch\": \"value\" } }\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"resource_id\": \"docs\" },\n    { \"thread_id\": { \"$exists\": true } },\n    { \"score\": { \"$gte\": 0.75 } },\n    { \"tags\": { \"$all\": [\"oracle\", \"mastra\"] } },\n    { \"chunks\": { \"$elemMatch\": { \"page\": { \"$gte\": 2 }, \"kind\": \"reference\" } } },\n    { \"$or\": [\n      { \"source\": { \"$regex\": \"oracle.*database\" } },\n      { \"title\": { \"$contains\": \"vector search\" } }\n    ]}\n  ]\n}";
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/vector/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,shKAwG1B,CAAC"}

package/dist/vector/query.d.ts

@@ -0,0 +1,5 @@
+import type { QueryResult } from '@mastra/core/vector';
+import type { IndexRegistry, WithConnection } from './ddl.js';
+import type { OracleQueryVectorParams } from './types.js';
+export declare function query(registry: IndexRegistry, withConnection: WithConnection, { indexName, queryVector, topK, filter, includeVector, minScore, sparseVector, queryMode, targetAccuracy, }: OracleQueryVectorParams): Promise<QueryResult[]>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/vector/query.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG3D,OAAO,KAAK,EAAgB,uBAAuB,EAAsB,MAAM,SAAS,CAAC;AAKzF,wBAAsB,KAAK,CACzB,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,cAAc,EAC9B,EACE,SAAS,EACT,WAAW,EACX,IAAS,EACT,MAAM,EACN,aAAqB,EACrB,QAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,GACf,EAAE,uBAAuB,GACzB,OAAO,CAAC,WAAW,EAAE,CAAC,CAkHxB"}

package/dist/vector/sql.d.ts

@@ -0,0 +1,12 @@
+import type { OracleMetric, OracleVectorFormat, OracleVectorIndexConfig, OracleVectorIndexType } from './types.js';
+export declare function normalizeMetric(metric: string): OracleMetric;
+export declare function normalizeVectorFormat(format: string): OracleVectorFormat;
+export declare function metricToken(metric: OracleMetric): string;
+export declare function defaultMetricForFormat(vectorFormat: OracleVectorFormat): OracleMetric;
+export declare function vectorFormatToken(vectorFormat: OracleVectorFormat): string;
+export declare function validateMetricForFormat(metric: OracleMetric, vectorFormat: OracleVectorFormat, indexType?: OracleVectorIndexType): void;
+export declare function buildVectorIndexParameterClause(indexConfig: OracleVectorIndexConfig): string;
+export declare function validateDimension(dimension: number): number;
+export declare function validateVectorFormatDimension(vectorFormat: OracleVectorFormat, dimension: number): void;
+export declare function validateAccuracy(accuracy: number): number;
+//# sourceMappingURL=sql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/vector/sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAIhH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAY5D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAMxE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAcxD;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,kBAAkB,GAAG,YAAY,CAErF;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,GAAG,MAAM,CAU1E;AAID,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,kBAAkB,EAChC,SAAS,CAAC,EAAE,qBAAqB,GAChC,IAAI,CAgBN;AAED,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,uBAAuB,GAAG,MAAM,CAkB5F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAIvG;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/vector/stats.d.ts

@@ -0,0 +1,9 @@
+import type { DescribeIndexParams, IndexStats } from '@mastra/core/vector';
+import type { IndexRegistry, WithConnection } from './ddl.js';
+import type { OracleConfigureVectorMemoryParams, OracleIndexAccuracyParams, OracleIndexStatusParams } from './types.js';
+export declare function listIndexes(registry: IndexRegistry, withConnection: WithConnection): Promise<string[]>;
+export declare function describeIndex(registry: IndexRegistry, withConnection: WithConnection, { indexName }: DescribeIndexParams): Promise<IndexStats>;
+export declare function getIndexStatus(registry: IndexRegistry, withConnection: WithConnection, { indexName, ownerName }: OracleIndexStatusParams): Promise<string>;
+export declare function indexAccuracyQuery(registry: IndexRegistry, withConnection: WithConnection, { indexName, queryVector, topK, targetAccuracy }: OracleIndexAccuracyParams): Promise<string>;
+export declare function configureVectorMemory(withConnection: WithConnection, { size, scope }: OracleConfigureVectorMemoryParams): Promise<void>;
+//# sourceMappingURL=stats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/vector/stats.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAM3E,OAAO,KAAK,EAAa,aAAa,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGtE,OAAO,KAAK,EAAE,iCAAiC,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAOrH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc5G;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,cAAc,EAC9B,EAAE,SAAS,EAAE,EAAE,mBAAmB,GACjC,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,cAAc,EAC9B,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,uBAAuB,GAChD,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,cAAc,EAC9B,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,yBAAyB,GAC1E,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,wBAAsB,qBAAqB,CACzC,cAAc,EAAE,cAAc,EAC9B,EAAE,IAAI,EAAE,KAAgB,EAAE,EAAE,iCAAiC,GAC5D,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/vector/types.d.ts

@@ -0,0 +1,80 @@
+import type { CreateIndexParams, QueryVectorParams, VectorFilter } from '@mastra/core/vector';
+import type { OracleConnectionConfig, OraclePoolManager } from '../shared/connection.js';
+export type OracleMetric = 'cosine' | 'euclidean' | 'dotproduct' | 'hamming' | 'jaccard';
+export type OracleVectorIndexType = 'hnsw' | 'ivf' | 'none';
+export type OracleVectorFormat = 'vector' | 'bit' | 'int8';
+export type OracleQueryMode = 'approx' | 'exact';
+export type OracleVectorMemoryScope = 'MEMORY' | 'SPFILE' | 'BOTH';
+export type OracleVectorFilter = VectorFilter;
+export interface OracleVectorIndexConfig {
+    type?: OracleVectorIndexType;
+    accuracy?: number;
+    hnsw?: {
+        neighbors?: number;
+        efConstruction?: number;
+    };
+    ivf?: {
+        neighborPartitions?: number;
+    };
+}
+export interface OracleVectorMemoryConfig {
+    size: string;
+    scope?: OracleVectorMemoryScope;
+}
+export interface OracleVectorConfig extends OracleConnectionConfig {
+    id: string;
+    poolManager?: OraclePoolManager;
+    schemaName?: string;
+    tablePrefix?: string;
+    registryTableName?: string;
+    defaultIndexConfig?: OracleVectorIndexConfig;
+    defaultMetadataIndexes?: string[];
+    defaultVectorFormat?: OracleVectorFormat;
+    /**
+     * Number of vectors to send per Oracle executeMany call. A single upsert
+     * operation still commits once after all batches succeed.
+     */
+    upsertBatchSize?: number;
+}
+export interface OracleBuildIndexParams {
+    indexName: string;
+    metric?: OracleMetric;
+    indexConfig?: OracleVectorIndexConfig;
+}
+export interface OracleCreateIndexParams extends Omit<CreateIndexParams, 'metric'> {
+    metric?: OracleMetric;
+    vectorFormat?: OracleVectorFormat;
+    indexConfig?: OracleVectorIndexConfig;
+    buildIndex?: boolean;
+    metadataIndexes?: string[];
+}
+export interface OracleQueryVectorParams extends QueryVectorParams<OracleVectorFilter> {
+    minScore?: number;
+    queryMode?: OracleQueryMode;
+    targetAccuracy?: number;
+}
+export interface OracleIndexStats {
+    indexName: string;
+    tableName: string;
+    dimension: number;
+    count: number;
+    metric: OracleMetric;
+    indexType: OracleVectorIndexType;
+    vectorFormat: OracleVectorFormat;
+    accuracy?: number;
+}
+export interface OracleRebuildIndexParams extends OracleBuildIndexParams {
+}
+export interface OracleConfigureVectorMemoryParams extends OracleVectorMemoryConfig {
+}
+export interface OracleIndexStatusParams {
+    indexName: string;
+    ownerName?: string;
+}
+export interface OracleIndexAccuracyParams {
+    indexName: string;
+    queryVector: number[];
+    topK: number;
+    targetAccuracy?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/vector/upsert.d.ts

@@ -0,0 +1,20 @@
+import { ErrorCategory, MastraError } from '@mastra/core/error';
+import type { DeleteVectorParams, DeleteVectorsParams, UpdateVectorParams, UpsertVectorParams } from '@mastra/core/vector';
+import oracledb from 'oracledb';
+import type { IndexRegistry, WithConnection } from './ddl.js';
+import type { OracleIndexStats, OracleVectorFilter, OracleVectorFormat } from './types.js';
+export declare const VECTOR_ID_DELETE_CHUNK_SIZE = 900;
+export declare const DEFAULT_VECTOR_UPSERT_BATCH_SIZE = 200;
+export declare const STORE_NAME = "ORACLE";
+export declare function upsert(registry: IndexRegistry, withConnection: WithConnection, upsertBatchSize: number, { indexName, vectors, metadata, ids, sparseVectors, deleteFilter }: UpsertVectorParams): Promise<string[]>;
+export declare function updateVector(registry: IndexRegistry, withConnection: WithConnection, { indexName, id, filter, update }: UpdateVectorParams<OracleVectorFilter>): Promise<void>;
+export declare function deleteVector(registry: IndexRegistry, withConnection: WithConnection, { indexName, id }: DeleteVectorParams): Promise<void>;
+export declare function deleteVectors(registry: IndexRegistry, withConnection: WithConnection, { indexName, ids, filter }: DeleteVectorsParams<OracleVectorFilter>): Promise<void>;
+export declare function validateVectors(vectors: number[][]): void;
+export declare function validateVectorForIndex(vector: number[], indexInfo: Pick<OracleIndexStats, 'dimension' | 'vectorFormat'>, indexName: string): void;
+export declare function vectorBind(vector: number[], vectorFormat: OracleVectorFormat): oracledb.BindParameter;
+export declare function vectorValue(vector: number[], vectorFormat: OracleVectorFormat): Float32Array | Int8Array | Uint8Array;
+export declare function chunkArray<T>(values: T[], chunkSize: number): T[][];
+export declare function withCause(error: Error, cause: unknown): Error;
+export declare function asMastraError(operation: string, reason: string, details: Record<string, string | number | boolean | undefined>, cause: unknown, category?: ErrorCategory): MastraError;
+//# sourceMappingURL=upsert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../src/vector/upsert.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAe,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAGhC,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAExF,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAOpD,eAAO,MAAM,UAAU,WAAW,CAAC;AAInC,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,MAAM,EACvB,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,kBAAkB,GACrF,OAAO,CAAC,MAAM,EAAE,CAAC,CAyFnB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,cAAc,EAC9B,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GACxE,OAAO,CAAC,IAAI,CAAC,CA+Df;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,cAAc,EAC9B,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,kBAAkB,GACpC,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EACvB,cAAc,EAAE,cAAc,EAC9B,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,GAClE,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAazD;AAcD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,cAAc,CAAC,EAC/D,SAAS,EAAE,MAAM,GAChB,IAAI,CA8BN;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,kBAAkB,GAAG,QAAQ,CAAC,aAAa,CAErG;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,kBAAkB,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,CAWrH;AAcD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAMnE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CAG7D;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,EAC9D,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,aAAyC,GAClD,WAAW,CAcb"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/oracledb",
-  "version": "0.0.0",
+  "version": "0.2.0-alpha.0",
   "description": "Oracle Database provider for Mastra storage and vector retrieval",
   "type": "module",
   "main": "dist/index.js",
@@ -18,37 +18,23 @@
     },
     "./package.json": "./package.json"
   },
-  "scripts": {
-    "build:lib": "tsup --silent --config tsup.config.ts",
-    "prepack": "tsx ../../scripts/generate-package-docs.ts",
-    "build:watch": "pnpm build:lib --watch",
-    "test": "pnpm test:unit",
-    "test:unit": "vitest run --exclude \"src/**/*.integration.test.ts\"",
-    "pretest:integration": "docker compose up -d --wait",
-    "test:integration": "pnpm test:storage-integration && pnpm test:vector-integration",
-    "posttest:integration": "docker compose down -v",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
-    "test:vector-integration": "RUN_ORACLE_VECTOR_INTEGRATION=true vitest run src/vector/index.integration.test.ts",
-    "test:storage-integration": "RUN_ORACLE_STORAGE_INTEGRATION=true vitest run --fileParallelism=false src/storage/index.test.ts src/storage/index.integration.test.ts"
-  },
   "license": "Apache-2.0",
   "dependencies": {
     "oracledb": "^6.10.0"
   },
   "devDependencies": {
-    "@internal/lint": "workspace:*",
-    "@internal/types-builder": "workspace:*",
-    "@mastra/core": "workspace:*",
     "@types/node": "22.19.15",
     "@types/oracledb": "6.5.2",
-    "@vitest/coverage-v8": "catalog:",
-    "@vitest/ui": "catalog:",
+    "@vitest/coverage-v8": "4.1.10",
+    "@vitest/ui": "4.1.10",
     "eslint": "^10.4.1",
     "tsup": "^8.5.1",
-    "tsx": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "tsx": "^4.23.1",
+    "typescript": "^6.0.3",
+    "vitest": "4.1.10",
+    "@internal/lint": "0.0.121",
+    "@internal/types-builder": "0.0.96",
+    "@mastra/core": "1.58.0-alpha.6"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.34.0-0 <2.0.0-0"
@@ -68,5 +54,18 @@
   },
   "engines": {
     "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build:lib": "tsup --silent --config tsup.config.ts",
+    "build:watch": "pnpm build:lib --watch",
+    "test": "pnpm test:unit",
+    "test:unit": "vitest run --exclude \"src/**/*.integration.test.ts\"",
+    "pretest:integration": "docker compose up -d --wait",
+    "test:integration": "pnpm test:storage-integration && pnpm test:vector-integration",
+    "posttest:integration": "docker compose down -v",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test:vector-integration": "RUN_ORACLE_VECTOR_INTEGRATION=true vitest run src/vector/index.integration.test.ts",
+    "test:storage-integration": "RUN_ORACLE_STORAGE_INTEGRATION=true vitest run --fileParallelism=false src/storage/index.test.ts src/storage/index.integration.test.ts"
   }
-}
+}