couchset 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+## 0.3.0 - 2026-05-18
+
+### Compatibility
+
+- Kept the default `couchset` entrypoint on the legacy API so existing projects can upgrade without rewriting model imports.
+- Kept `couchset/legacy` as an explicit legacy alias.
+- Added `couchset/next` for the modern API.
+- Shared one Couchbase connection singleton across legacy and modern models, allowing both APIs to run side by side during gradual migrations.
+
+### Modern API
+
+- Added strict modern model helpers: `insert`, `upsert`, `getById`, `replaceById`, `patchById`, `deleteById`, `findMany`, `findOne`, `page`, `exists`, and `count`.
+- Removed old model method names from the modern model surface so the new API can evolve independently.
+- Added hydrated document helpers for reload/save/patch/delete workflows.
+- Added soft-delete/default-scope helpers, TTL helpers, validation/parse hooks, scoped collection support, include helpers, and declarative index helpers.
+- Added safe SQL++ query helpers with named/positional parameters: `queryRows`, `queryOne`, and `queryPage`.
+- Added safer keyspace helpers: `Model.bucket()` and `Model.from(alias?)`.
+
+### Connection Lifecycle
+
+- Added lazy model binding so models can be constructed before `couchset()` connects.
+- Added lifecycle helpers: `ready`, `ping`, `health`, `shutdown`, and `ensureIndexes`.
+- Added reconnect support that is enabled by default, with `COUCHSET_RECONNECT` and `COUCHSET_RECONNECT_INTERVAL_MS` environment controls.
+- Added retry/rebind behavior for reconnectable operation failures.
+
+### Starters
+
+- Added modern env-based starter helpers on `couchset/next`: `getConnectionOptions`, `connectionOptions`, `startCouchbase`, and `startCouchbaseServerless`.
+- Starter helpers read `COUCHBASE_URL`, `COUCHBASE_BUCKET`, `COUCHBASE_USERNAME`, `COUCHBASE_PASSWORD`, and `COUCHBASE_PROXY`.
+
+### Documentation
+
+- Updated the README for the legacy-default and modern-next import paths.
+- Added beta migration notes for running legacy and modern models together.
+
+### Maintenance
+
+- Cleared high and critical `npm audit` findings.
+- Updated the publish workflow to the two-job version bump and npm publish flow.

package/README.md

@@ -10,16 +10,21 @@
 
 CouchSet is a Couchbase model layer for TypeScript and Node.js. The default `couchset` entrypoint keeps the legacy API for safe upgrades; the modern API is available from `couchset/next`.
 
+The additive client-owned primitives—typed definitions, explicit provisioning, transaction-bound models, CAS helpers, and safe index plans—are documented in [Next primitives](./docs/next-primitives.md).
+
 - [Install](#install)
 - [Legacy Default](#legacy-default)
 - [Modern API](#modern-api)
+- [Next primitives](./docs/next-primitives.md)
 - [Connection Lifecycle](#connection-lifecycle)
 - [Models](#models)
 - [Reads](#reads)
+- [Document Modeling](./docs/document-modeling.md)
 - [Writes](#writes)
 - [Queries](#queries)
 - [Gradual Migration](#gradual-migration)
 - [Migration Notes](./docs/beta-migration.md)
+- [Changelog](./CHANGELOG.md)
 - [License](#license)
 
 ## Install
@@ -170,6 +175,10 @@ users.keyspace(); // `dev` or default:`dev`.`scope`.`collection`
 users.from('u'); // `dev` AS u
 ```
 
+For large objects, keep list metadata and heavy payloads in separate models.
+See [Document Modeling](./docs/document-modeling.md) for the recommended read
+shape.
+
 ## Reads
 
 ```ts

package/dist/connection/connection.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {

package/dist/connection/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/connection/connection.ts"],"names":[],"mappings":"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","sourcesContent":["import type {Bucket, Cluster, Collection} from 'couchbase';\nimport * as couchbase from 'couchbase';\n\nimport {envFlag, envNumber} from './env';\nimport {ConnectionHealth, ConnectionSettings, ConnectionState, CouchsetArgs} from './types';\n\n/**\n * CouchbaseConnection class\n * Only one CouchbaseConnection can exist that's why it's a singleton\n */\nexport class CouchbaseConnection implements CouchsetArgs {\n    private static _instance: CouchbaseConnection;\n\n    bucket: Bucket = null;\n    cluster: Cluster = null;\n    private connectionPromise?: Promise<CouchbaseConnection>;\n    private connectionSettings?: ConnectionSettings;\n    private reconnectPromise?: Promise<CouchbaseConnection>;\n    private reconnectReject?: (error: Error) => void;\n    private reconnectTimer?: ReturnType<typeof setTimeout>;\n    private healthTimer?: ReturnType<typeof setTimeout>;\n    private connectionState: ConnectionState = 'idle';\n    private autoReconnectEnabled = true;\n    private reconnectDelayMs = 5000;\n    private manuallyClosed = false;\n    private lastConnectionError?: any;\n\n    // Args\n    connectionString: string = null;\n    bucketName: string = null;\n    username: string = null;\n    password: string = null;\n\n    public static get Instance(): CouchbaseConnection {\n        return this._instance || (this._instance = new this());\n    }\n\n    private constructor() {}\n\n    private configureReconnect(args: CouchsetArgs): void {\n        this.autoReconnectEnabled =\n            typeof args.autoReconnect === 'boolean'\n                ? args.autoReconnect\n                : envFlag(process.env.COUCHSET_RECONNECT, true);\n        this.reconnectDelayMs =\n            typeof args.reconnectIntervalMs === 'number' && args.reconnectIntervalMs > 0\n                ? args.reconnectIntervalMs\n                : envNumber(process.env.COUCHSET_RECONNECT_INTERVAL_MS, 5000);\n    }\n\n    private normalizeArgs(args: CouchsetArgs): ConnectionSettings {\n        const {connectionString, password, username, bucketName = 'default', proxy} = args;\n\n        return {\n            bucketName,\n            connectionString,\n            password,\n            proxy,\n            username,\n        };\n    }\n\n    private sameSettings(next: ConnectionSettings): boolean {\n        const current = this.connectionSettings;\n\n        return (\n            !!current &&\n            current.connectionString === next.connectionString &&\n            current.bucketName === next.bucketName &&\n            current.username === next.username &&\n            current.password === next.password &&\n            current.proxy === next.proxy\n        );\n    }\n\n    private assignSettings(settings: ConnectionSettings): void {\n        this.connectionString = settings.connectionString;\n        this.bucketName = settings.bucketName;\n        this.username = settings.username;\n        this.password = settings.password;\n        this.connectionSettings = settings;\n    }\n\n    private settingsError(): Error {\n        return new Error(\n            'couchset is already connected with different settings; call couchset({...args, force: true}) to reconnect'\n        );\n    }\n\n    private connectionOptions(settings: ConnectionSettings): any {\n        const options: any = {\n            password: settings.password,\n            username: settings.username,\n        };\n\n        if (settings.proxy) {\n            options.proxy = settings.proxy;\n        }\n\n        return options;\n    }\n\n    private clearReconnectTimer(): void {\n        if (this.reconnectTimer) {\n            clearTimeout(this.reconnectTimer);\n            this.reconnectTimer = undefined;\n        }\n    }\n\n    private clearHealthTimer(): void {\n        if (this.healthTimer) {\n            clearTimeout(this.healthTimer);\n            this.healthTimer = undefined;\n        }\n    }\n\n    private scheduleTimer(callback: () => void, unref = true): ReturnType<typeof setTimeout> {\n        const timer = setTimeout(callback, this.reconnectDelayMs);\n\n        if (unref && typeof (timer as any).unref === 'function') {\n            (timer as any).unref();\n        }\n\n        return timer;\n    }\n\n    private rawPing = async (): Promise<any> => {\n        if (!this.cluster) {\n            throw new Error('couchset is not connected; call couchset(args) first');\n        }\n\n        if (typeof (this.cluster as any).ping === 'function') {\n            return (this.cluster as any).ping();\n        }\n\n        return this.cluster.query('SELECT 1');\n    };\n\n    private openCluster = (settings: ConnectionSettings): Promise<Cluster> => {\n        return couchbase.connect(settings.connectionString, this.connectionOptions(settings));\n    };\n\n    private scheduleHealthCheck(): void {\n        this.clearHealthTimer();\n\n        if (!this.autoReconnectEnabled || this.manuallyClosed) {\n            return;\n        }\n\n        this.healthTimer = this.scheduleTimer(async () => {\n            try {\n                await this.rawPing();\n                this.scheduleHealthCheck();\n            } catch (error) {\n                this.markDisconnected(error);\n            }\n        });\n    }\n\n    private connectWithSettings = async (\n        settings: ConnectionSettings\n    ): Promise<CouchbaseConnection> => {\n        const cluster = await this.openCluster(settings);\n\n        if (this.manuallyClosed) {\n            if (cluster && typeof (cluster as any).close === 'function') {\n                await (cluster as any).close();\n            }\n            throw new Error('couchset reconnect stopped');\n        }\n\n        this.cluster = cluster as any;\n        this.bucket = this.cluster.bucket(settings.bucketName);\n        this.connectionState = 'connected';\n        this.lastConnectionError = undefined;\n        this.scheduleHealthCheck();\n\n        return this;\n    };\n\n    private startReconnect = (): Promise<CouchbaseConnection> => {\n        if (this.reconnectPromise) {\n            return this.reconnectPromise;\n        }\n\n        if (!this.autoReconnectEnabled || !this.connectionSettings || this.manuallyClosed) {\n            return Promise.reject(\n                new Error('couchset reconnect is disabled or no connection settings are available')\n            );\n        }\n\n        this.connectionState = 'reconnecting';\n\n        this.reconnectPromise = new Promise<CouchbaseConnection>((resolve, reject) => {\n            this.reconnectReject = reject;\n\n            const attempt = async () => {\n                if (this.manuallyClosed || !this.connectionSettings) {\n                    reject(new Error('couchset reconnect stopped'));\n                    return;\n                }\n\n                try {\n                    const connection = await this.connectWithSettings(this.connectionSettings);\n                    this.reconnectPromise = undefined;\n                    this.reconnectReject = undefined;\n                    this.clearReconnectTimer();\n                    resolve(connection);\n                } catch (error) {\n                    this.lastConnectionError = error;\n                    this.connectionState = 'reconnecting';\n                    this.reconnectTimer = this.scheduleTimer(attempt, false);\n                }\n            };\n\n            attempt();\n        });\n\n        return this.reconnectPromise;\n    };\n\n    /**\n     * start\n     */\n    public init = async (args: CouchsetArgs): Promise<CouchbaseConnection> => {\n        const settings = this.normalizeArgs(args);\n        this.configureReconnect(args);\n\n        if (this.connectionPromise && this.sameSettings(settings)) {\n            return this.connectionPromise;\n        }\n\n        if (this.reconnectPromise && this.sameSettings(settings)) {\n            return this.reconnectPromise;\n        }\n\n        if (this.isConnected() && this.sameSettings(settings)) {\n            return this;\n        }\n\n        if (\n            (this.isConnected() || this.connectionPromise || this.reconnectPromise) &&\n            !args.force\n        ) {\n            throw this.settingsError();\n        }\n\n        if (args.force && this.connectionPromise) {\n            await this.connectionPromise.catch(() => undefined);\n        }\n\n        if (args.force) {\n            await this.shutdown();\n            this.configureReconnect(args);\n        }\n\n        this.manuallyClosed = false;\n        this.clearReconnectTimer();\n        this.clearHealthTimer();\n        this.assignSettings(settings);\n        this.connectionState = 'connecting';\n        this.connectionPromise = this.connectWithSettings(settings)\n            .then((connection) => {\n                this.connectionPromise = undefined;\n\n                return connection;\n            })\n            .catch((error) => {\n                this.connectionPromise = undefined;\n                this.connectionSettings = undefined;\n                this.connectionState = 'idle';\n                this.lastConnectionError = error;\n                throw error;\n            });\n\n        return this.connectionPromise;\n    };\n\n    /**\n     * start serverless start\n     */\n    public initServerless = async (args: CouchsetArgs): Promise<CouchbaseConnection> => {\n        return this.init(args);\n    };\n\n    /**\n     * getCollection\n     */\n    public getCollection = (scopeName?: string, collectionName?: string): Collection => {\n        if (scopeName || collectionName) {\n            return this.bucket\n                .scope(scopeName || '_default')\n                .collection(collectionName || '_default');\n        }\n\n        return this.bucket.defaultCollection();\n    };\n\n    public getCluster = (): Cluster => {\n        return this.cluster;\n    };\n\n    public getBucket = (): string => {\n        return this.bucketName;\n    };\n\n    public isConnected = (): boolean => {\n        return !!this.cluster && !!this.bucket;\n    };\n\n    public ready = async (): Promise<CouchbaseConnection> => {\n        if (this.isConnected()) {\n            return this;\n        }\n\n        if (this.connectionPromise) {\n            return this.connectionPromise;\n        }\n\n        if (this.reconnectPromise) {\n            return this.reconnectPromise;\n        }\n\n        if (this.autoReconnectEnabled && this.connectionSettings && !this.manuallyClosed) {\n            return this.startReconnect();\n        }\n\n        throw new Error('couchset is not connected; call couchset(args) first');\n    };\n\n    public ping = async (): Promise<any> => {\n        await this.ready();\n\n        try {\n            return await this.rawPing();\n        } catch (error) {\n            this.markDisconnected(error);\n            throw error;\n        }\n    };\n\n    public state = (): ConnectionState => {\n        return this.connectionState;\n    };\n\n    public health = (): ConnectionHealth => {\n        return {\n            autoReconnect: this.autoReconnectEnabled,\n            bucketName: this.bucketName,\n            lastError: this.lastConnectionError,\n            reconnectIntervalMs: this.reconnectDelayMs,\n            state: this.connectionState,\n        };\n    };\n\n    public shouldReconnect = (error: unknown): boolean => {\n        if (!this.autoReconnectEnabled || this.manuallyClosed) {\n            return false;\n        }\n\n        const caught = error as any;\n        const name = String(caught?.name || caught?.constructor?.name || '');\n        const message = String(caught?.message || '');\n        const text = `${name} ${message}`.toLowerCase();\n\n        return [\n            'timeout',\n            'network',\n            'connect',\n            'closed',\n            'disconnect',\n            'unavailable',\n            'socket',\n            'econnrefused',\n            'etimedout',\n            'temporary failure',\n        ].some((value) => text.includes(value));\n    };\n\n    public markDisconnected = (error?: unknown): void => {\n        if (!this.connectionSettings || this.manuallyClosed) {\n            return;\n        }\n\n        const cluster = this.cluster;\n\n        this.lastConnectionError = error;\n        this.connectionPromise = undefined;\n        this.cluster = null;\n        this.bucket = null;\n        this.clearHealthTimer();\n\n        if (cluster && typeof (cluster as any).close === 'function') {\n            (cluster as any).close().catch(() => undefined);\n        }\n\n        if (this.autoReconnectEnabled) {\n            this.connectionState = 'reconnecting';\n            this.startReconnect().catch(() => undefined);\n            return;\n        }\n\n        this.connectionState = 'idle';\n    };\n\n    /**\n     * shutdown cluster\n     */\n    public shutdown = async (): Promise<void> => {\n        const cluster = this.cluster;\n\n        this.manuallyClosed = true;\n        this.clearReconnectTimer();\n        this.clearHealthTimer();\n        if (this.reconnectReject) {\n            this.reconnectReject(new Error('couchset reconnect stopped'));\n        }\n        this.reconnectPromise = undefined;\n        this.reconnectReject = undefined;\n        this.connectionPromise = undefined;\n        this.connectionSettings = undefined;\n        this.cluster = null;\n        this.bucket = null;\n        this.connectionString = null;\n        this.bucketName = null;\n        this.username = null;\n        this.password = null;\n        this.connectionState = 'closed';\n        this.lastConnectionError = undefined;\n\n        if (cluster && typeof (cluster as any).close === 'function') {\n            await (cluster as any).close();\n        }\n    };\n}\n\nexport default CouchbaseConnection;\n"]}
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/connection/connection.ts"],"names":[],"mappings":"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","sourcesContent":["import type {Bucket, Cluster, Collection} from 'couchbase';\nimport * as couchbase from 'couchbase';\n\nimport {envFlag, envNumber} from './env';\nimport {ConnectionHealth, ConnectionSettings, ConnectionState, CouchsetArgs} from './types';\n\n/**\n * CouchbaseConnection class\n * Only one CouchbaseConnection can exist that's why it's a singleton\n */\nexport class CouchbaseConnection implements CouchsetArgs {\n    private static _instance: CouchbaseConnection;\n\n    bucket: Bucket = null;\n    cluster: Cluster = null;\n    private connectionPromise?: Promise<CouchbaseConnection>;\n    private connectionSettings?: ConnectionSettings;\n    private reconnectPromise?: Promise<CouchbaseConnection>;\n    private reconnectReject?: (error: Error) => void;\n    private reconnectTimer?: ReturnType<typeof setTimeout>;\n    private healthTimer?: ReturnType<typeof setTimeout>;\n    private connectionState: ConnectionState = 'idle';\n    private autoReconnectEnabled = true;\n    private reconnectDelayMs = 5000;\n    private manuallyClosed = false;\n    private lastConnectionError?: any;\n\n    // Args\n    connectionString: string = null;\n    bucketName: string = null;\n    username: string = null;\n    password: string = null;\n\n    public static get Instance(): CouchbaseConnection {\n        return this._instance || (this._instance = new this());\n    }\n\n    private constructor() {}\n\n    private configureReconnect(args: CouchsetArgs): void {\n        this.autoReconnectEnabled =\n            typeof args.autoReconnect === 'boolean'\n                ? args.autoReconnect\n                : envFlag(process.env.COUCHSET_RECONNECT, true);\n        this.reconnectDelayMs =\n            typeof args.reconnectIntervalMs === 'number' && args.reconnectIntervalMs > 0\n                ? args.reconnectIntervalMs\n                : envNumber(process.env.COUCHSET_RECONNECT_INTERVAL_MS, 5000);\n    }\n\n    private normalizeArgs(args: CouchsetArgs): ConnectionSettings {\n        const {connectionString, password, username, bucketName = 'default', proxy} = args;\n\n        return {\n            bucketName,\n            connectionString,\n            password,\n            proxy,\n            username,\n        };\n    }\n\n    private sameSettings(next: ConnectionSettings): boolean {\n        const current = this.connectionSettings;\n\n        return (\n            !!current &&\n            current.connectionString === next.connectionString &&\n            current.bucketName === next.bucketName &&\n            current.username === next.username &&\n            current.password === next.password &&\n            current.proxy === next.proxy\n        );\n    }\n\n    private assignSettings(settings: ConnectionSettings): void {\n        this.connectionString = settings.connectionString;\n        this.bucketName = settings.bucketName;\n        this.username = settings.username;\n        this.password = settings.password;\n        this.connectionSettings = settings;\n    }\n\n    private settingsError(): Error {\n        return new Error(\n            'couchset is already connected with different settings; call couchset({...args, force: true}) to reconnect'\n        );\n    }\n\n    private connectionOptions(settings: ConnectionSettings): any {\n        const options: any = {\n            password: settings.password,\n            username: settings.username,\n        };\n\n        if (settings.proxy) {\n            options.proxy = settings.proxy;\n        }\n\n        return options;\n    }\n\n    private clearReconnectTimer(): void {\n        if (this.reconnectTimer) {\n            clearTimeout(this.reconnectTimer);\n            this.reconnectTimer = undefined;\n        }\n    }\n\n    private clearHealthTimer(): void {\n        if (this.healthTimer) {\n            clearTimeout(this.healthTimer);\n            this.healthTimer = undefined;\n        }\n    }\n\n    private scheduleTimer(callback: () => void, unref = true): ReturnType<typeof setTimeout> {\n        const timer = setTimeout(callback, this.reconnectDelayMs);\n\n        if (unref && typeof (timer as any).unref === 'function') {\n            (timer as any).unref();\n        }\n\n        return timer;\n    }\n\n    private rawPing = async (): Promise<any> => {\n        if (!this.cluster) {\n            throw new Error('couchset is not connected; call couchset(args) first');\n        }\n\n        if (typeof (this.cluster as any).ping === 'function') {\n            return (this.cluster as any).ping();\n        }\n\n        return this.cluster.query('SELECT 1');\n    };\n\n    private openCluster = (settings: ConnectionSettings): Promise<Cluster> => {\n        return couchbase.connect(settings.connectionString, this.connectionOptions(settings));\n    };\n\n    private scheduleHealthCheck(): void {\n        this.clearHealthTimer();\n\n        if (!this.autoReconnectEnabled || this.manuallyClosed) {\n            return;\n        }\n\n        this.healthTimer = this.scheduleTimer(async () => {\n            try {\n                await this.rawPing();\n                this.scheduleHealthCheck();\n            } catch (error) {\n                this.markDisconnected(error);\n            }\n        });\n    }\n\n    private connectWithSettings = async (\n        settings: ConnectionSettings\n    ): Promise<CouchbaseConnection> => {\n        const cluster = await this.openCluster(settings);\n\n        if (this.manuallyClosed) {\n            if (cluster && typeof (cluster as any).close === 'function') {\n                await (cluster as any).close();\n            }\n            throw new Error('couchset reconnect stopped');\n        }\n\n        this.cluster = cluster as any;\n        this.bucket = this.cluster.bucket(settings.bucketName);\n        this.connectionState = 'connected';\n        this.lastConnectionError = undefined;\n        this.scheduleHealthCheck();\n\n        return this;\n    };\n\n    private startReconnect = (): Promise<CouchbaseConnection> => {\n        if (this.reconnectPromise) {\n            return this.reconnectPromise;\n        }\n\n        if (!this.autoReconnectEnabled || !this.connectionSettings || this.manuallyClosed) {\n            return Promise.reject(\n                new Error('couchset reconnect is disabled or no connection settings are available')\n            );\n        }\n\n        this.connectionState = 'reconnecting';\n\n        this.reconnectPromise = new Promise<CouchbaseConnection>((resolve, reject) => {\n            this.reconnectReject = reject;\n\n            const attempt = async () => {\n                if (this.manuallyClosed || !this.connectionSettings) {\n                    reject(new Error('couchset reconnect stopped'));\n                    return;\n                }\n\n                try {\n                    const connection = await this.connectWithSettings(this.connectionSettings);\n                    this.reconnectPromise = undefined;\n                    this.reconnectReject = undefined;\n                    this.clearReconnectTimer();\n                    resolve(connection);\n                } catch (error) {\n                    this.lastConnectionError = error;\n                    this.connectionState = 'reconnecting';\n                    this.reconnectTimer = this.scheduleTimer(attempt, false);\n                }\n            };\n\n            attempt();\n        });\n\n        return this.reconnectPromise;\n    };\n\n    /**\n     * start\n     */\n    public init = async (args: CouchsetArgs): Promise<CouchbaseConnection> => {\n        const settings = this.normalizeArgs(args);\n        this.configureReconnect(args);\n\n        if (this.connectionPromise && this.sameSettings(settings)) {\n            return this.connectionPromise;\n        }\n\n        if (this.reconnectPromise && this.sameSettings(settings)) {\n            return this.reconnectPromise;\n        }\n\n        if (this.isConnected() && this.sameSettings(settings)) {\n            return this;\n        }\n\n        if (\n            (this.isConnected() || this.connectionPromise || this.reconnectPromise) &&\n            !args.force\n        ) {\n            throw this.settingsError();\n        }\n\n        if (args.force && this.connectionPromise) {\n            await this.connectionPromise.catch(() => undefined);\n        }\n\n        if (args.force) {\n            await this.shutdown();\n            this.configureReconnect(args);\n        }\n\n        this.manuallyClosed = false;\n        this.clearReconnectTimer();\n        this.clearHealthTimer();\n        this.assignSettings(settings);\n        this.connectionState = 'connecting';\n        this.connectionPromise = this.connectWithSettings(settings)\n            .then((connection) => {\n                this.connectionPromise = undefined;\n\n                return connection;\n            })\n            .catch((error) => {\n                this.connectionPromise = undefined;\n                this.connectionSettings = undefined;\n                this.connectionState = 'idle';\n                this.lastConnectionError = error;\n                throw error;\n            });\n\n        return this.connectionPromise;\n    };\n\n    /**\n     * start serverless start\n     */\n    public initServerless = async (args: CouchsetArgs): Promise<CouchbaseConnection> => {\n        return this.init(args);\n    };\n\n    /**\n     * getCollection\n     */\n    public getCollection = (scopeName?: string, collectionName?: string): Collection => {\n        if (scopeName || collectionName) {\n            return this.bucket\n                .scope(scopeName || '_default')\n                .collection(collectionName || '_default');\n        }\n\n        return this.bucket.defaultCollection();\n    };\n\n    public getCluster = (): Cluster => {\n        return this.cluster;\n    };\n\n    public getBucket = (): string => {\n        return this.bucketName;\n    };\n\n    public isConnected = (): boolean => {\n        return !!this.cluster && !!this.bucket;\n    };\n\n    public ready = async (): Promise<CouchbaseConnection> => {\n        if (this.isConnected()) {\n            return this;\n        }\n\n        if (this.connectionPromise) {\n            return this.connectionPromise;\n        }\n\n        if (this.reconnectPromise) {\n            return this.reconnectPromise;\n        }\n\n        if (this.autoReconnectEnabled && this.connectionSettings && !this.manuallyClosed) {\n            return this.startReconnect();\n        }\n\n        throw new Error('couchset is not connected; call couchset(args) first');\n    };\n\n    public ping = async (): Promise<any> => {\n        await this.ready();\n\n        try {\n            return await this.rawPing();\n        } catch (error) {\n            this.markDisconnected(error);\n            throw error;\n        }\n    };\n\n    public state = (): ConnectionState => {\n        return this.connectionState;\n    };\n\n    public health = (): ConnectionHealth => {\n        return {\n            autoReconnect: this.autoReconnectEnabled,\n            bucketName: this.bucketName,\n            lastError: this.lastConnectionError,\n            reconnectIntervalMs: this.reconnectDelayMs,\n            state: this.connectionState,\n        };\n    };\n\n    public shouldReconnect = (error: unknown): boolean => {\n        if (!this.autoReconnectEnabled || this.manuallyClosed) {\n            return false;\n        }\n\n        const caught = error as any;\n        const name = String(caught?.name || caught?.constructor?.name || '');\n        const message = String(caught?.message || '');\n        const text = `${name} ${message}`.toLowerCase();\n\n        return [\n            'timeout',\n            'network',\n            'connect',\n            'closed',\n            'disconnect',\n            'unavailable',\n            'socket',\n            'econnrefused',\n            'etimedout',\n            'temporary failure',\n        ].some((value) => text.includes(value));\n    };\n\n    public markDisconnected = (error?: unknown): void => {\n        if (!this.connectionSettings || this.manuallyClosed) {\n            return;\n        }\n\n        const cluster = this.cluster;\n\n        this.lastConnectionError = error;\n        this.connectionPromise = undefined;\n        this.cluster = null;\n        this.bucket = null;\n        this.clearHealthTimer();\n\n        if (cluster && typeof (cluster as any).close === 'function') {\n            (cluster as any).close().catch(() => undefined);\n        }\n\n        if (this.autoReconnectEnabled) {\n            this.connectionState = 'reconnecting';\n            this.startReconnect().catch(() => undefined);\n            return;\n        }\n\n        this.connectionState = 'idle';\n    };\n\n    /**\n     * shutdown cluster\n     */\n    public shutdown = async (): Promise<void> => {\n        const cluster = this.cluster;\n\n        this.manuallyClosed = true;\n        this.clearReconnectTimer();\n        this.clearHealthTimer();\n        if (this.reconnectReject) {\n            this.reconnectReject(new Error('couchset reconnect stopped'));\n        }\n        this.reconnectPromise = undefined;\n        this.reconnectReject = undefined;\n        this.connectionPromise = undefined;\n        this.connectionSettings = undefined;\n        this.cluster = null;\n        this.bucket = null;\n        this.connectionString = null;\n        this.bucketName = null;\n        this.username = null;\n        this.password = null;\n        this.connectionState = 'closed';\n        this.lastConnectionError = undefined;\n\n        if (cluster && typeof (cluster as any).close === 'function') {\n            await (cluster as any).close();\n        }\n    };\n}\n\nexport default CouchbaseConnection;\n"]}

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export * from './search';
 export * from './pagination';
 export * from './shared';
 export * from './timeseries';
+/** Additive client-owned APIs exposed by couchset/next (and this modern entrypoint). */
+export * from './next';
 export declare const ensureIndexes: (options?: EnsureIndexOptions) => Promise<string[]>;
 export declare const ready: () => Promise<CouchbaseConnection>;
 export declare const ping: () => Promise<any>;

package/dist/index.js

@@ -64,6 +64,8 @@ __exportStar(require("./search"), exports);
 __exportStar(require("./pagination"), exports);
 __exportStar(require("./shared"), exports);
 __exportStar(require("./timeseries"), exports);
+/** Additive client-owned APIs exposed by couchset/next (and this modern entrypoint). */
+__exportStar(require("./next"), exports);
 var ensureIndexes = function (options) { return __awaiter(void 0, void 0, void 0, function () {
     return __generator(this, function (_a) {
         return [2 /*return*/, model_1.Model.ensureIndexes(options)];

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4DAAiF;AACjF,iCAAkD;AAElD,0CAAwB;AACxB,+CAA6B;AAC7B,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,+CAA6B;AAEtB,IAAM,aAAa,GAAG,UAAO,OAA4B;;QAC5D,sBAAO,aAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAAC;;KACvC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAEK,IAAM,KAAK,GAAG;;QACjB,sBAAO,oBAAmB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAC;;KAC/C,CAAC;AAFW,QAAA,KAAK,SAEhB;AAEK,IAAM,IAAI,GAAG;;QAChB,sBAAO,oBAAmB,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAC;;KAC9C,CAAC;AAFW,QAAA,IAAI,QAEf;AAEK,IAAM,MAAM,GAAG;IAClB,OAAO,oBAAmB,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;AACjD,CAAC,CAAC;AAFW,QAAA,MAAM,UAEjB;AAEK,IAAM,QAAQ,GAAG;;QACpB,sBAAO,oBAAmB,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAC;;KAClD,CAAC;AAFW,QAAA,QAAQ,YAEnB;AAWF;;;GAGG;AACH,IAAM,aAAa,GAAG,UAAO,IAAkB;;;;;gBACrC,KAAK,GAAG,oBAAmB,CAAC,QAAQ,CAAC;gBAC3C,qBAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAA;;gBAAtB,SAAsB,CAAC;gBACvB,sBAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAC;;;KAChC,CAAC;AAEW,QAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE;IACjD,aAAa,uBAAA;IACb,MAAM,gBAAA;IACN,IAAI,cAAA;IACJ,KAAK,eAAA;IACL,QAAQ,kBAAA;CACX,CAAoB,CAAC;AAEtB;;;GAGG;AACI,IAAM,kBAAkB,GAAG,UAAO,IAAkB;;;;;gBACjD,KAAK,GAAG,oBAAmB,CAAC,QAAQ,CAAC;gBAC3C,qBAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAA;;gBAAhC,SAAgC,CAAC;gBACjC,sBAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAC;;;KAChC,CAAC;AAJW,QAAA,kBAAkB,sBAI7B;AAEF,kBAAe,gBAAQ,CAAC","sourcesContent":["import CouchbaseConnection, {ConnectionHealth, CouchsetArgs} from './connection';\nimport {EnsureIndexOptions, Model} from './model';\n\nexport * from './model';\nexport * from './connection';\nexport * from './database';\nexport * from './query';\nexport * from './search';\nexport * from './pagination';\nexport * from './shared';\nexport * from './timeseries';\n\nexport const ensureIndexes = async (options?: EnsureIndexOptions): Promise<string[]> => {\n    return Model.ensureIndexes(options);\n};\n\nexport const ready = async (): Promise<CouchbaseConnection> => {\n    return CouchbaseConnection.Instance.ready();\n};\n\nexport const ping = async (): Promise<any> => {\n    return CouchbaseConnection.Instance.ping();\n};\n\nexport const health = (): ConnectionHealth => {\n    return CouchbaseConnection.Instance.health();\n};\n\nexport const shutdown = async (): Promise<void> => {\n    return CouchbaseConnection.Instance.shutdown();\n};\n\nexport interface CouchsetStarter {\n    (args: CouchsetArgs): Promise<boolean>;\n    ensureIndexes: typeof ensureIndexes;\n    health: typeof health;\n    ping: typeof ping;\n    ready: typeof ready;\n    shutdown: typeof shutdown;\n}\n\n/**\n * Main function to start CouchSet\n * @param @interface CouchsetArgs\n */\nconst startCouchset = async (args: CouchsetArgs): Promise<boolean> => {\n    const couch = CouchbaseConnection.Instance;\n    await couch.init(args);\n    return Promise.resolve(true);\n};\n\nexport const couchset = Object.assign(startCouchset, {\n    ensureIndexes,\n    health,\n    ping,\n    ready,\n    shutdown,\n}) as CouchsetStarter;\n\n/**\n * Main function to start CouchSet\n * @param @interface CouchsetArgs\n */\nexport const couchsetServerless = async (args: CouchsetArgs): Promise<boolean> => {\n    const couch = CouchbaseConnection.Instance;\n    await couch.initServerless(args);\n    return Promise.resolve(true);\n};\n\nexport default couchset;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4DAAiF;AACjF,iCAAkD;AAElD,0CAAwB;AACxB,+CAA6B;AAC7B,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,+CAA6B;AAC7B,wFAAwF;AACxF,yCAAuB;AAEhB,IAAM,aAAa,GAAG,UAAO,OAA4B;;QAC5D,sBAAO,aAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAAC;;KACvC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAEK,IAAM,KAAK,GAAG;;QACjB,sBAAO,oBAAmB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAC;;KAC/C,CAAC;AAFW,QAAA,KAAK,SAEhB;AAEK,IAAM,IAAI,GAAG;;QAChB,sBAAO,oBAAmB,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAC;;KAC9C,CAAC;AAFW,QAAA,IAAI,QAEf;AAEK,IAAM,MAAM,GAAG;IAClB,OAAO,oBAAmB,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;AACjD,CAAC,CAAC;AAFW,QAAA,MAAM,UAEjB;AAEK,IAAM,QAAQ,GAAG;;QACpB,sBAAO,oBAAmB,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAC;;KAClD,CAAC;AAFW,QAAA,QAAQ,YAEnB;AAWF;;;GAGG;AACH,IAAM,aAAa,GAAG,UAAO,IAAkB;;;;;gBACrC,KAAK,GAAG,oBAAmB,CAAC,QAAQ,CAAC;gBAC3C,qBAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAA;;gBAAtB,SAAsB,CAAC;gBACvB,sBAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAC;;;KAChC,CAAC;AAEW,QAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE;IACjD,aAAa,uBAAA;IACb,MAAM,gBAAA;IACN,IAAI,cAAA;IACJ,KAAK,eAAA;IACL,QAAQ,kBAAA;CACX,CAAoB,CAAC;AAEtB;;;GAGG;AACI,IAAM,kBAAkB,GAAG,UAAO,IAAkB;;;;;gBACjD,KAAK,GAAG,oBAAmB,CAAC,QAAQ,CAAC;gBAC3C,qBAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAA;;gBAAhC,SAAgC,CAAC;gBACjC,sBAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAC;;;KAChC,CAAC;AAJW,QAAA,kBAAkB,sBAI7B;AAEF,kBAAe,gBAAQ,CAAC","sourcesContent":["import CouchbaseConnection, {ConnectionHealth, CouchsetArgs} from './connection';\nimport {EnsureIndexOptions, Model} from './model';\n\nexport * from './model';\nexport * from './connection';\nexport * from './database';\nexport * from './query';\nexport * from './search';\nexport * from './pagination';\nexport * from './shared';\nexport * from './timeseries';\n/** Additive client-owned APIs exposed by couchset/next (and this modern entrypoint). */\nexport * from './next';\n\nexport const ensureIndexes = async (options?: EnsureIndexOptions): Promise<string[]> => {\n    return Model.ensureIndexes(options);\n};\n\nexport const ready = async (): Promise<CouchbaseConnection> => {\n    return CouchbaseConnection.Instance.ready();\n};\n\nexport const ping = async (): Promise<any> => {\n    return CouchbaseConnection.Instance.ping();\n};\n\nexport const health = (): ConnectionHealth => {\n    return CouchbaseConnection.Instance.health();\n};\n\nexport const shutdown = async (): Promise<void> => {\n    return CouchbaseConnection.Instance.shutdown();\n};\n\nexport interface CouchsetStarter {\n    (args: CouchsetArgs): Promise<boolean>;\n    ensureIndexes: typeof ensureIndexes;\n    health: typeof health;\n    ping: typeof ping;\n    ready: typeof ready;\n    shutdown: typeof shutdown;\n}\n\n/**\n * Main function to start CouchSet\n * @param @interface CouchsetArgs\n */\nconst startCouchset = async (args: CouchsetArgs): Promise<boolean> => {\n    const couch = CouchbaseConnection.Instance;\n    await couch.init(args);\n    return Promise.resolve(true);\n};\n\nexport const couchset = Object.assign(startCouchset, {\n    ensureIndexes,\n    health,\n    ping,\n    ready,\n    shutdown,\n}) as CouchsetStarter;\n\n/**\n * Main function to start CouchSet\n * @param @interface CouchsetArgs\n */\nexport const couchsetServerless = async (args: CouchsetArgs): Promise<boolean> => {\n    const couch = CouchbaseConnection.Instance;\n    await couch.initServerless(args);\n    return Promise.resolve(true);\n};\n\nexport default couchset;\n"]}

package/dist/model/index.d.ts

@@ -1,4 +1,4 @@
-import type { Collection, GetOptions, MutateInOptions, RemoveOptions, ReplaceOptions } from 'couchbase';
+import type { Collection, Cluster, GetOptions, MutateInOptions, RemoveOptions, ReplaceOptions } from 'couchbase';
 import { SchemaTypes } from '../utils';
 import type { ModelPageResult, ModelReadArgs } from './read-helpers';
 import type { QueryPageOptions, QueryPageResult, QueryParameters, SafeQueryOptions } from './safe-query';
@@ -6,6 +6,23 @@ import type { FindByIdWithMetaResult, InsertWriteOptions, PatchByIdArgs, UpsertW
 import { Hydrated } from './hydrated-document';
 import { EnsureIndexOptions, ModelIndexDefinition } from './indexes';
 import type { ParseHook, ValidationHook } from './validation';
+/** A small connection surface used by client-bound models. */
+export interface ModelConnection {
+    bucket?: any;
+    bucketName?: string;
+    cluster: Cluster;
+    getBucket(): string;
+    getCollection(scopeName?: string, collectionName?: string): Collection;
+    isConnected(): boolean;
+    ready(): Promise<any>;
+    shouldReconnect(error: any): boolean;
+    markDisconnected(error: any): void;
+}
+/** Converts a field between the application's value and Couchbase JSON. */
+export interface FieldCodec<T = any, TDatabase = any> {
+    toDatabase(value: T): TDatabase;
+    fromDatabase(value: TDatabase): T;
+}
 export type { ModelPageResult, ModelReadArgs } from './read-helpers';
 export type { QueryLogger, QueryPageOptions, QueryPageResult, QueryParameters, SafeQueryOptions, } from './safe-query';
 export type { FindByIdWithMetaResult, PatchByIdArgs } from './write-helpers';
@@ -38,8 +55,20 @@ export interface ModalOptions {
     validateReplace?: ValidationHook;
     parse?: ParseHook;
     dateFields?: string[];
+    /**
+     * Explicit field transforms. A field cannot also be a dateFields/schema date
+     * transform, since that makes the parse order ambiguous.
+     */
+    codecs?: Record<string, FieldCodec<any, any>>;
     indexes?: ModelIndexDefinition[];
 }
+export type ConsumeOnceResult = {
+    status: 'consumed';
+} | {
+    status: 'missing';
+} | {
+    status: 'conflict';
+};
 export declare class Model {
     private static registeredModels;
     collection: Collection;
@@ -54,9 +83,11 @@ export declare class Model {
     private validateReplaceHook?;
     private parseHook?;
     private dateFields?;
+    private codecs;
+    private readonly connection?;
     private indexes;
     schema: Record<string, SchemaTypes>;
-    constructor(name: string, options?: ModalOptions);
+    constructor(name: string, options?: ModalOptions, connection?: ModelConnection);
     /**
      * Ensure indexes for every constructed model with index declarations.
      */
@@ -147,6 +178,8 @@ export declare class Model {
      * Insert a new document and fail if the id already exists.
      */
     insert<T>(data: T, options?: InsertWriteOptions): Promise<T & AutoModelFields>;
+    /** @internal Prepare a transaction insert without issuing a normal SDK write. */
+    prepareInsert<T>(data: T): Promise<T & AutoModelFields>;
     /**
      * Explicit insert-or-replace write.
      */
@@ -159,10 +192,26 @@ export declare class Model {
      * Find a document with SDK metadata.
      */
     findByIdWithMeta<T>(id: string, options?: GetOptions): Promise<FindByIdWithMetaResult<T>>;
+    /** Ergonomic alias for findByIdWithMeta, intended for CAS workflows. */
+    getWithCas<T>(id: string, options?: GetOptions): Promise<FindByIdWithMetaResult<T>>;
     /**
      * Explicit full-document replace.
      */
     replaceById<T>(id: string, data: T, options?: UpdateOptions): Promise<T & AutoModelFields>;
+    /** @internal Prepare a transaction replace without issuing a normal SDK write. */
+    prepareReplace<T>(id: string, data: T, options?: UpdateOptions): Promise<T & AutoModelFields>;
+    /**
+     * Replace only when the supplied CAS still describes the current document.
+     * CouchSet deliberately performs one SDK operation and never re-reads/retries
+     * with a new CAS, because doing so would defeat the caller's concurrency check.
+     */
+    replaceIfCas<T>(id: string, data: T, cas: any, options?: UpdateOptions): Promise<T & AutoModelFields>;
+    /**
+     * Remove a one-time document with exactly the CAS supplied by the caller.
+     * Missing and CAS-mismatch cases are normal outcomes; transport and ambiguous
+     * failures are rethrown so callers never mistake an unknown commit for success.
+     */
+    consumeOnce(id: string, cas: any): Promise<ConsumeOnceResult>;
     /**
      * Partial document mutation using common patch operators.
      */
@@ -185,5 +234,10 @@ export declare class Model {
         id: string;
     }>(data: T & AutoModelFields): Hydrated<T>;
     parse<T>(data: T): T;
+    /** @internal Used by the typed client before a document reaches the SDK. */
+    serialize<T>(data: T): T;
+    /** @internal Used by patch helpers and transaction-bound models. */
+    serializeField(path: string, value: any): any;
+    private deserialize;
 }
 export default Model;

package/dist/model/index.js

@@ -109,10 +109,11 @@ var hydrated_document_1 = require("./hydrated-document");
 var indexes_1 = require("./indexes");
 var validation_1 = require("./validation");
 var Model = /** @class */ (function () {
-    function Model(name, options) {
+    function Model(name, options, connection) {
         this.scope = '_default';
         this.defaultWhereMode = 'default';
         this.softDelete = false;
+        this.codecs = {};
         this.indexes = [];
         this.schema = {
             createdAt: 'date',
@@ -120,6 +121,7 @@ var Model = /** @class */ (function () {
         };
         // this.collection = CouchbaseConnection.Instance.getCollection();
         this.collectionName = name;
+        this.connection = connection;
         if (options) {
             var hasScope = Object.prototype.hasOwnProperty.call(options, 'scope');
             var hasCollection = Object.prototype.hasOwnProperty.call(options, 'collection');
@@ -134,10 +136,20 @@ var Model = /** @class */ (function () {
             this.validateReplaceHook = options.validateReplace;
             this.parseHook = options.parse;
             this.dateFields = options.dateFields;
+            this.codecs = options.codecs || {};
+            var dateFields_1 = new Set(options.dateFields || []);
+            Object.keys(this.codecs).forEach(function (field) {
+                var _a;
+                if (dateFields_1.has(field) || ((_a = options.schema) === null || _a === void 0 ? void 0 : _a[field]) === 'date') {
+                    throw new Error("codec for ".concat(field, " conflicts with dateFields or schema date; use one transform"));
+                }
+            });
             this.indexes = options.indexes || [];
             this.schema = __assign(__assign(__assign({}, ((options && options.schema) || {})), (0, validation_1.schemaFromDateFields)(options.dateFields)), { createdAt: 'date', updatedAt: 'date' });
         }
-        if (this.indexes.length) {
+        // Legacy models participate in the singleton registry. Client-bound
+        // models are registered only by their owning CouchsetClient.
+        if (this.indexes.length && !this.connection) {
             Model.registeredModels.push(this);
         }
     }
@@ -212,9 +224,9 @@ var Model = /** @class */ (function () {
      */
     Model.prototype.fresh = function () {
         // if couchbase connection has been init
-        if (connection_1.default.Instance.isConnected()) {
+        if (this.couchbaseConnection().isConnected()) {
             var target = this.collectionTarget();
-            this.collection = connection_1.default.Instance.getCollection(target.scopeName, target.collectionName);
+            this.collection = this.couchbaseConnection().getCollection(target.scopeName, target.collectionName);
         }
     };
     Model.prototype.prepare = function () {
@@ -270,8 +282,7 @@ var Model = /** @class */ (function () {
      * getCollection
      */
     Model.prototype.getBucketName = function () {
-        var _a;
-        var bucketName = (_a = connection_1.default.Instance) === null || _a === void 0 ? void 0 : _a.getBucket();
+        var bucketName = this.couchbaseConnection().getBucket();
         if (!bucketName) {
             throw new Error('couchset is not connected; call couchset(args) first');
         }
@@ -281,7 +292,7 @@ var Model = /** @class */ (function () {
      * getCollection
      */
     Model.prototype.couchbaseConnection = function () {
-        return connection_1.default.Instance;
+        return this.connection || connection_1.default.Instance;
     };
     /** Get this collection
      * getCollection
@@ -328,12 +339,15 @@ var Model = /** @class */ (function () {
             collectionName: this.collectionName,
             scope: this.scope,
             parse: function (data) { return _this.parse(data); },
+            serialize: function (data) { return _this.serialize(data); },
+            serializeField: function (path, value) { return _this.serializeField(path, value); },
             validateCreate: this.validateCreateHook,
             validateReplace: this.validateReplaceHook,
         };
     };
     Model.prototype.cloneWithDefaultWhereMode = function (mode) {
         var options = {
+            codecs: this.codecs,
             dateFields: this.dateFields,
             defaultWhere: this.defaultWhere,
             parse: this.parseHook,
@@ -348,7 +362,7 @@ var Model = /** @class */ (function () {
         if (this.collectionTargetName) {
             options.collection = this.collectionTargetName;
         }
-        var model = new Model(this.collectionName, options);
+        var model = new Model(this.collectionName, options, this.connection);
         model.defaultWhereMode = mode;
         return model;
     };
@@ -514,6 +528,10 @@ var Model = /** @class */ (function () {
             });
         });
     };
+    /** @internal Prepare a transaction insert without issuing a normal SDK write. */
+    Model.prototype.prepareInsert = function (data) {
+        return (0, write_helpers_1.prepareInsertDocument)(this.writeContext(), data);
+    };
     /**
      * Explicit insert-or-replace write.
      */
@@ -567,6 +585,14 @@ var Model = /** @class */ (function () {
             });
         });
     };
+    /** Ergonomic alias for findByIdWithMeta, intended for CAS workflows. */
+    Model.prototype.getWithCas = function (id, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.findByIdWithMeta(id, options)];
+            });
+        });
+    };
     /**
      * Explicit full-document replace.
      */
@@ -580,6 +606,58 @@ var Model = /** @class */ (function () {
             });
         });
     };
+    /** @internal Prepare a transaction replace without issuing a normal SDK write. */
+    Model.prototype.prepareReplace = function (id, data, options) {
+        return (0, write_helpers_1.prepareReplacementDocument)(this.writeContext(), id, data, options);
+    };
+    /**
+     * Replace only when the supplied CAS still describes the current document.
+     * CouchSet deliberately performs one SDK operation and never re-reads/retries
+     * with a new CAS, because doing so would defeat the caller's concurrency check.
+     */
+    Model.prototype.replaceIfCas = function (id, data, cas, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.replaceById(id, data, __assign(__assign({}, (options || {})), { cas: cas }))];
+            });
+        });
+    };
+    /**
+     * Remove a one-time document with exactly the CAS supplied by the caller.
+     * Missing and CAS-mismatch cases are normal outcomes; transport and ambiguous
+     * failures are rethrown so callers never mistake an unknown commit for success.
+     */
+    Model.prototype.consumeOnce = function (id, cas) {
+        return __awaiter(this, void 0, void 0, function () {
+            var error_2, name_1, message;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.prepare()];
+                    case 1:
+                        _a.sent();
+                        _a.label = 2;
+                    case 2:
+                        _a.trys.push([2, 4, , 5]);
+                        return [4 /*yield*/, this.collection.remove(id, { cas: cas })];
+                    case 3:
+                        _a.sent();
+                        return [2 /*return*/, { status: 'consumed' }];
+                    case 4:
+                        error_2 = _a.sent();
+                        name_1 = (error_2 === null || error_2 === void 0 ? void 0 : error_2.name) || '';
+                        message = (error_2 === null || error_2 === void 0 ? void 0 : error_2.message) || '';
+                        if (/DocumentNotFound|not found/i.test("".concat(name_1, " ").concat(message))) {
+                            return [2 /*return*/, { status: 'missing' }];
+                        }
+                        if (/CasMismatch|cas mismatch/i.test("".concat(name_1, " ").concat(message))) {
+                            return [2 /*return*/, { status: 'conflict' }];
+                        }
+                        throw error_2;
+                    case 5: return [2 /*return*/];
+                }
+            });
+        });
+    };
     /**
      * Partial document mutation using common patch operators.
      */
@@ -673,13 +751,64 @@ var Model = /** @class */ (function () {
         return (0, hydrated_document_1.hydrate)(this, this.parse(data));
     };
     Model.prototype.parse = function (data) {
-        var parsed = (0, utils_1.parseSchema)(this.schema, data);
+        var decoded = this.deserialize(data);
+        var parsed = (0, utils_1.parseSchema)(this.schema, decoded);
         var parsedDates = (0, validation_1.parseDateFields)(parsed, this.dateFields);
         return this.parseHook ? this.parseHook(parsedDates) : parsedDates;
     };
+    /** @internal Used by the typed client before a document reaches the SDK. */
+    Model.prototype.serialize = function (data) {
+        var _this = this;
+        var result = __assign({}, data);
+        Object.keys(this.codecs).forEach(function (path) {
+            var current = getPath(result, path);
+            if (current !== undefined) {
+                setPath(result, path, _this.codecs[path].toDatabase(current));
+            }
+        });
+        return result;
+    };
+    /** @internal Used by patch helpers and transaction-bound models. */
+    Model.prototype.serializeField = function (path, value) {
+        return this.codecs[path] ? this.codecs[path].toDatabase(value) : value;
+    };
+    Model.prototype.deserialize = function (data) {
+        var _this = this;
+        var result = __assign({}, data);
+        Object.keys(this.codecs).forEach(function (path) {
+            var current = getPath(result, path);
+            if (current !== undefined) {
+                setPath(result, path, _this.codecs[path].fromDatabase(current));
+            }
+        });
+        return result;
+    };
     Model.registeredModels = [];
     return Model;
 }());
 exports.Model = Model;
+var getPath = function (data, path) {
+    return path.split('.').reduce(function (value, key) { return (value == null ? undefined : value[key]); }, data);
+};
+var setPath = function (data, path, value) {
+    var parts = path.split('.');
+    var key = parts.pop();
+    var target = parts.reduce(function (current, part) {
+        var existing = current[part];
+        if (Array.isArray(existing)) {
+            current[part] = existing.slice();
+        }
+        else if (existing && typeof existing === 'object') {
+            // serialize/parse start with a shallow root copy. Clone every branch
+            // we traverse so dotted codecs never mutate caller or SDK content.
+            current[part] = __assign({}, existing);
+        }
+        else {
+            current[part] = {};
+        }
+        return current[part];
+    }, data);
+    target[key] = value;
+};
 exports.default = Model;
 //# sourceMappingURL=index.js.map