couchset 0.2.7 → 0.4.0

package/dist/model/validation.js

@@ -0,0 +1,104 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDateFields = exports.schemaFromDateFields = exports.applyValidation = void 0;
+var applyValidation = function (document, hook) { return __awaiter(void 0, void 0, void 0, function () {
+    var result;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                if (!hook) {
+                    return [2 /*return*/, document];
+                }
+                return [4 /*yield*/, hook(document)];
+            case 1:
+                result = _a.sent();
+                return [2 /*return*/, result === undefined ? document : result];
+        }
+    });
+}); };
+exports.applyValidation = applyValidation;
+var schemaFromDateFields = function (dateFields) {
+    return (dateFields || []).reduce(function (schema, field) {
+        schema[field] = 'date';
+        return schema;
+    }, {});
+};
+exports.schemaFromDateFields = schemaFromDateFields;
+var parseDateValue = function (value) {
+    if (value === undefined || value === null || value instanceof Date) {
+        return value;
+    }
+    return new Date(value);
+};
+var parseDateFields = function (document, dateFields) {
+    if (!dateFields || !dateFields.length || !document) {
+        return document;
+    }
+    var cloned = __assign({}, document);
+    dateFields.forEach(function (field) {
+        var parts = field.split('.');
+        var target = cloned;
+        for (var index = 0; index < parts.length - 1; index += 1) {
+            var part = parts[index];
+            if (!target[part]) {
+                return;
+            }
+            target[part] = __assign({}, target[part]);
+            target = target[part];
+        }
+        var leaf = parts[parts.length - 1];
+        if (Object.prototype.hasOwnProperty.call(target, leaf)) {
+            target[leaf] = parseDateValue(target[leaf]);
+        }
+    });
+    return cloned;
+};
+exports.parseDateFields = parseDateFields;
+//# sourceMappingURL=validation.js.map

package/dist/model/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/model/validation.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGO,IAAM,eAAe,GAAG,UAAU,QAAW,EAAE,IAAwB;;;;;gBAC1E,IAAI,CAAC,IAAI,EAAE,CAAC;oBACR,sBAAO,QAAQ,EAAC;gBACpB,CAAC;gBAEc,qBAAM,IAAI,CAAC,QAAQ,CAAC,EAAA;;gBAA7B,MAAM,GAAG,SAAoB;gBAEnC,sBAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,MAAY,EAAC;;;KAC1D,CAAC;AARW,QAAA,eAAe,mBAQ1B;AAEK,IAAM,oBAAoB,GAAG,UAAC,UAAqB;IACtD,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,UAAC,MAAM,EAAE,KAAK;QAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QAEvB,OAAO,MAAM,CAAC;IAClB,CAAC,EAAE,EAA4B,CAAC,CAAC;AACrC,CAAC,CAAC;AANW,QAAA,oBAAoB,wBAM/B;AAEF,IAAM,cAAc,GAAG,UAAC,KAAU;IAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEK,IAAM,eAAe,GAAG,UAAI,QAAW,EAAE,UAAqB;IACjE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,IAAM,MAAM,gBAAa,QAAgB,CAAC,CAAC;IAE3C,UAAU,CAAC,OAAO,CAAC,UAAC,KAAK;QACrB,IAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,GAAG,MAAM,CAAC;QAEpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACvD,IAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChB,OAAO;YACX,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,gBAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACjC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,IAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AA3BW,QAAA,eAAe,mBA2B1B","sourcesContent":["export type ValidationHook<T = any> = (document: T) => T | void | Promise<T | void>;\nexport type ParseHook<T = any> = (document: T) => T;\n\nexport const applyValidation = async <T>(document: T, hook?: ValidationHook<T>): Promise<T> => {\n    if (!hook) {\n        return document;\n    }\n\n    const result = await hook(document);\n\n    return result === undefined ? document : (result as T);\n};\n\nexport const schemaFromDateFields = (dateFields?: string[]): Record<string, 'date'> => {\n    return (dateFields || []).reduce((schema, field) => {\n        schema[field] = 'date';\n\n        return schema;\n    }, {} as Record<string, 'date'>);\n};\n\nconst parseDateValue = (value: any): any => {\n    if (value === undefined || value === null || value instanceof Date) {\n        return value;\n    }\n\n    return new Date(value);\n};\n\nexport const parseDateFields = <T>(document: T, dateFields?: string[]): T => {\n    if (!dateFields || !dateFields.length || !document) {\n        return document;\n    }\n\n    const cloned: any = {...(document as any)};\n\n    dateFields.forEach((field) => {\n        const parts = field.split('.');\n        let target = cloned;\n\n        for (let index = 0; index < parts.length - 1; index += 1) {\n            const part = parts[index];\n            if (!target[part]) {\n                return;\n            }\n            target[part] = {...target[part]};\n            target = target[part];\n        }\n\n        const leaf = parts[parts.length - 1];\n        if (Object.prototype.hasOwnProperty.call(target, leaf)) {\n            target[leaf] = parseDateValue(target[leaf]);\n        }\n    });\n\n    return cloned;\n};\n"]}

package/dist/model/write-helpers.d.ts

@@ -0,0 +1,39 @@
+import type { Collection, GetOptions, InsertOptions, MutateInOptions, UpsertOptions } from 'couchbase';
+import { TtlOptions } from './ttl';
+import { ValidationHook } from './validation';
+import type { AutoModelFields, UpdateOptions } from './index';
+export interface ModelWriteContext {
+    collection: Collection;
+    collectionName: string;
+    scope: string;
+    parse: <T>(data: T) => T;
+    serialize?: <T>(data: T) => T;
+    serializeField?: (path: string, value: any) => any;
+    validateCreate?: ValidationHook;
+    validateReplace?: ValidationHook;
+}
+export interface PatchByIdArgs {
+    $set?: Record<string, any>;
+    $unset?: string[] | Record<string, any>;
+    $inc?: Record<string, number>;
+}
+export interface FindByIdWithMetaResult<T> {
+    content: T & AutoModelFields;
+    cas: any;
+    expiryTime?: any;
+}
+export type InsertWriteOptions = InsertOptions & TtlOptions;
+export type UpsertWriteOptions = UpsertOptions & TtlOptions;
+export declare const modelDocument: <T>(context: ModelWriteContext, data: T, createdAt?: Date) => T & AutoModelFields;
+export declare const replacementDocument: <T>(context: ModelWriteContext, id: string, data: T, options?: UpdateOptions) => T & AutoModelFields;
+/** Prepare an insert using the same metadata, validation, and codec pipeline as Model.insert. */
+export declare const prepareInsertDocument: <T>(context: ModelWriteContext, data: T) => Promise<T & AutoModelFields>;
+/** Prepare a replace using the same metadata, validation, and codec pipeline as Model.replaceById. */
+export declare const prepareReplacementDocument: <T>(context: ModelWriteContext, id: string, data: T, options?: UpdateOptions) => Promise<T & AutoModelFields>;
+export declare const insert: <T>(context: ModelWriteContext, data: T, options?: InsertWriteOptions) => Promise<T & AutoModelFields>;
+export declare const upsert: <T>(context: ModelWriteContext, data: T, options?: UpsertWriteOptions) => Promise<T & AutoModelFields>;
+export declare const replaceById: <T>(context: ModelWriteContext, id: string, data: T, options?: UpdateOptions) => Promise<T & AutoModelFields>;
+export declare const mutateById: (context: ModelWriteContext, id: string, specs: any[], options?: MutateInOptions) => Promise<any>;
+export declare const patchById: <T>(context: ModelWriteContext, id: string, patch: PatchByIdArgs, options?: MutateInOptions) => Promise<T & AutoModelFields>;
+export declare const incrementById: <T>(context: ModelWriteContext, id: string, field: string, delta: number, options?: MutateInOptions) => Promise<T & AutoModelFields>;
+export declare const findByIdWithMeta: <T>(context: ModelWriteContext, id: string, options?: GetOptions) => Promise<FindByIdWithMetaResult<T>>;

package/dist/model/write-helpers.js

@@ -0,0 +1,245 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findByIdWithMeta = exports.incrementById = exports.patchById = exports.mutateById = exports.replaceById = exports.upsert = exports.insert = exports.prepareReplacementDocument = exports.prepareInsertDocument = exports.replacementDocument = exports.modelDocument = void 0;
+var couchbase_1 = __importDefault(require("../couchbase"));
+var uuid_1 = require("../uuid");
+var ttl_1 = require("./ttl");
+var validation_1 = require("./validation");
+var now = function () { return new Date(); };
+var modelDocument = function (context, data, createdAt) {
+    var id = (0, uuid_1.generateUUID)();
+    var timestamp = now();
+    return __assign(__assign({ id: id }, data), { createdAt: createdAt || timestamp, updatedAt: timestamp, _type: context.collectionName, _scope: context.scope });
+};
+exports.modelDocument = modelDocument;
+var replacementDocument = function (context, id, data, options) {
+    var document = __assign(__assign({}, data), { id: id, _type: context.collectionName, _scope: context.scope });
+    if (!options || !options.silent) {
+        document.updatedAt = now();
+    }
+    return document;
+};
+exports.replacementDocument = replacementDocument;
+var unsetPaths = function (value) {
+    if (!value) {
+        return [];
+    }
+    return Array.isArray(value) ? value : Object.keys(value);
+};
+/** Prepare an insert using the same metadata, validation, and codec pipeline as Model.insert. */
+var prepareInsertDocument = function (context, data) { return __awaiter(void 0, void 0, void 0, function () {
+    var validated;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, validation_1.applyValidation)((0, exports.modelDocument)(context, data), context.validateCreate)];
+            case 1:
+                validated = _a.sent();
+                return [2 /*return*/, context.serialize ? context.serialize(validated) : validated];
+        }
+    });
+}); };
+exports.prepareInsertDocument = prepareInsertDocument;
+/** Prepare a replace using the same metadata, validation, and codec pipeline as Model.replaceById. */
+var prepareReplacementDocument = function (context, id, data, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var validated;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, validation_1.applyValidation)((0, exports.replacementDocument)(context, id, data, options), context.validateReplace)];
+            case 1:
+                validated = _a.sent();
+                return [2 /*return*/, context.serialize ? context.serialize(validated) : validated];
+        }
+    });
+}); };
+exports.prepareReplacementDocument = prepareReplacementDocument;
+var insert = function (context, data, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var stored;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, exports.prepareInsertDocument)(context, data)];
+            case 1:
+                stored = _a.sent();
+                return [4 /*yield*/, context.collection.insert(stored.id, stored, (0, ttl_1.applyTtlOptions)(options))];
+            case 2:
+                _a.sent();
+                return [2 /*return*/, context.parse(stored)];
+        }
+    });
+}); };
+exports.insert = insert;
+var upsert = function (context, data, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var stored;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, exports.prepareInsertDocument)(context, data)];
+            case 1:
+                stored = _a.sent();
+                return [4 /*yield*/, context.collection.upsert(stored.id, stored, (0, ttl_1.applyTtlOptions)(options))];
+            case 2:
+                _a.sent();
+                return [2 /*return*/, context.parse(stored)];
+        }
+    });
+}); };
+exports.upsert = upsert;
+var replaceById = function (context, id, data, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var _a, silent, replaceOptions, stored;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                _a = options || {}, silent = _a.silent, replaceOptions = __rest(_a, ["silent"]);
+                return [4 /*yield*/, (0, exports.prepareReplacementDocument)(context, id, data, { silent: silent })];
+            case 1:
+                stored = _b.sent();
+                return [4 /*yield*/, context.collection.replace(id, stored, replaceOptions)];
+            case 2:
+                _b.sent();
+                return [2 /*return*/, context.parse(stored)];
+        }
+    });
+}); };
+exports.replaceById = replaceById;
+var mutateById = function (context, id, specs, options) { return __awaiter(void 0, void 0, void 0, function () {
+    return __generator(this, function (_a) {
+        if (!Array.isArray(specs) || !specs.length) {
+            throw new Error('mutateById requires at least one mutation spec');
+        }
+        return [2 /*return*/, context.collection.mutateIn(id, specs, options)];
+    });
+}); };
+exports.mutateById = mutateById;
+var patchById = function (context, id, patch, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var specs, data;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                specs = __spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(Object.keys(patch.$set || {}).map(function (path) {
+                    return couchbase_1.default.MutateInSpec.upsert(path, context.serializeField
+                        ? context.serializeField(path, patch.$set[path])
+                        : patch.$set[path]);
+                })), false), __read(unsetPaths(patch.$unset).map(function (path) { return couchbase_1.default.MutateInSpec.remove(path); })), false), __read(Object.keys(patch.$inc || {}).map(function (path) {
+                    return couchbase_1.default.MutateInSpec.increment(path, patch.$inc[path]);
+                })), false), [
+                    couchbase_1.default.MutateInSpec.upsert('updatedAt', now()),
+                ], false);
+                return [4 /*yield*/, (0, exports.mutateById)(context, id, specs, options)];
+            case 1:
+                _a.sent();
+                return [4 /*yield*/, context.collection.get(id)];
+            case 2:
+                data = _a.sent();
+                return [2 /*return*/, context.parse(data.content)];
+        }
+    });
+}); };
+exports.patchById = patchById;
+var incrementById = function (context, id, field, delta, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var _a;
+    return __generator(this, function (_b) {
+        return [2 /*return*/, (0, exports.patchById)(context, id, { $inc: (_a = {}, _a[field] = delta, _a) }, options)];
+    });
+}); };
+exports.incrementById = incrementById;
+var findByIdWithMeta = function (context, id, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var data;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, context.collection.get(id, options)];
+            case 1:
+                data = _a.sent();
+                return [2 /*return*/, {
+                        content: context.parse(data.content),
+                        cas: data.cas,
+                        expiryTime: data.expiryTime,
+                    }];
+        }
+    });
+}); };
+exports.findByIdWithMeta = findByIdWithMeta;
+//# sourceMappingURL=write-helpers.js.map

package/dist/model/write-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-helpers.js","sourceRoot":"","sources":["../../src/model/write-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n    Collection,\n    GetOptions,\n    InsertOptions,\n    MutateInOptions,\n    ReplaceOptions,\n    UpsertOptions,\n} from 'couchbase';\n\nimport couchbase from '../couchbase';\nimport {generateUUID} from '../uuid';\n\nimport {applyTtlOptions, TtlOptions} from './ttl';\nimport {applyValidation, ValidationHook} from './validation';\n\nimport type {AutoModelFields, UpdateOptions} from './index';\n\nexport interface ModelWriteContext {\n    collection: Collection;\n    collectionName: string;\n    scope: string;\n    parse: <T>(data: T) => T;\n    serialize?: <T>(data: T) => T;\n    serializeField?: (path: string, value: any) => any;\n    validateCreate?: ValidationHook;\n    validateReplace?: ValidationHook;\n}\n\nexport interface PatchByIdArgs {\n    $set?: Record<string, any>;\n    $unset?: string[] | Record<string, any>;\n    $inc?: Record<string, number>;\n}\n\nexport interface FindByIdWithMetaResult<T> {\n    content: T & AutoModelFields;\n    cas: any;\n    expiryTime?: any;\n}\n\nexport type InsertWriteOptions = InsertOptions & TtlOptions;\nexport type UpsertWriteOptions = UpsertOptions & TtlOptions;\n\nconst now = (): Date => new Date();\n\nexport const modelDocument = <T>(\n    context: ModelWriteContext,\n    data: T,\n    createdAt?: Date\n): T & AutoModelFields => {\n    const id = generateUUID();\n    const timestamp = now();\n\n    return {\n        id,\n        ...data,\n        createdAt: createdAt || timestamp,\n        updatedAt: timestamp,\n        _type: context.collectionName,\n        _scope: context.scope,\n    } as T & AutoModelFields;\n};\n\nexport const replacementDocument = <T>(\n    context: ModelWriteContext,\n    id: string,\n    data: T,\n    options?: UpdateOptions\n): T & AutoModelFields => {\n    const document: any = {\n        ...data,\n        id,\n        _type: context.collectionName,\n        _scope: context.scope,\n    };\n\n    if (!options || !options.silent) {\n        document.updatedAt = now();\n    }\n\n    return document;\n};\n\nconst unsetPaths = (value?: string[] | Record<string, any>): string[] => {\n    if (!value) {\n        return [];\n    }\n\n    return Array.isArray(value) ? value : Object.keys(value);\n};\n\n/** Prepare an insert using the same metadata, validation, and codec pipeline as Model.insert. */\nexport const prepareInsertDocument = async <T>(\n    context: ModelWriteContext,\n    data: T\n): Promise<T & AutoModelFields> => {\n    const validated = await applyValidation(\n        modelDocument<T>(context, data),\n        context.validateCreate\n    );\n    return context.serialize ? context.serialize(validated) : validated;\n};\n\n/** Prepare a replace using the same metadata, validation, and codec pipeline as Model.replaceById. */\nexport const prepareReplacementDocument = async <T>(\n    context: ModelWriteContext,\n    id: string,\n    data: T,\n    options?: UpdateOptions\n): Promise<T & AutoModelFields> => {\n    const validated = await applyValidation(\n        replacementDocument<T>(context, id, data, options),\n        context.validateReplace\n    );\n    return context.serialize ? context.serialize(validated) : validated;\n};\n\nexport const insert = async <T>(\n    context: ModelWriteContext,\n    data: T,\n    options?: InsertWriteOptions\n): Promise<T & AutoModelFields> => {\n    const stored = await prepareInsertDocument<T>(context, data);\n    await context.collection.insert(stored.id, stored, applyTtlOptions(options));\n\n    return context.parse<T & AutoModelFields>(stored);\n};\n\nexport const upsert = async <T>(\n    context: ModelWriteContext,\n    data: T,\n    options?: UpsertWriteOptions\n): Promise<T & AutoModelFields> => {\n    const stored = await prepareInsertDocument<T>(context, data);\n    await context.collection.upsert(stored.id, stored, applyTtlOptions(options));\n\n    return context.parse<T & AutoModelFields>(stored);\n};\n\nexport const replaceById = async <T>(\n    context: ModelWriteContext,\n    id: string,\n    data: T,\n    options?: UpdateOptions\n): Promise<T & AutoModelFields> => {\n    const {silent, ...replaceOptions} = options || {};\n    const stored = await prepareReplacementDocument<T>(context, id, data, {silent});\n    await context.collection.replace(id, stored, replaceOptions as ReplaceOptions);\n\n    return context.parse<T & AutoModelFields>(stored);\n};\n\nexport const mutateById = async (\n    context: ModelWriteContext,\n    id: string,\n    specs: any[],\n    options?: MutateInOptions\n): Promise<any> => {\n    if (!Array.isArray(specs) || !specs.length) {\n        throw new Error('mutateById requires at least one mutation spec');\n    }\n\n    return context.collection.mutateIn(id, specs, options);\n};\n\nexport const patchById = async <T>(\n    context: ModelWriteContext,\n    id: string,\n    patch: PatchByIdArgs,\n    options?: MutateInOptions\n): Promise<T & AutoModelFields> => {\n    const specs = [\n        ...Object.keys(patch.$set || {}).map((path) =>\n            couchbase.MutateInSpec.upsert(\n                path,\n                context.serializeField\n                    ? context.serializeField(path, patch.$set[path])\n                    : patch.$set[path]\n            )\n        ),\n        ...unsetPaths(patch.$unset).map((path) => couchbase.MutateInSpec.remove(path)),\n        ...Object.keys(patch.$inc || {}).map((path) =>\n            couchbase.MutateInSpec.increment(path, patch.$inc[path])\n        ),\n        couchbase.MutateInSpec.upsert('updatedAt', now()),\n    ];\n\n    await mutateById(context, id, specs, options);\n    const data = await context.collection.get(id);\n\n    return context.parse<T & AutoModelFields>(data.content);\n};\n\nexport const incrementById = async <T>(\n    context: ModelWriteContext,\n    id: string,\n    field: string,\n    delta: number,\n    options?: MutateInOptions\n): Promise<T & AutoModelFields> => {\n    return patchById<T>(context, id, {$inc: {[field]: delta}}, options);\n};\n\nexport const findByIdWithMeta = async <T>(\n    context: ModelWriteContext,\n    id: string,\n    options?: GetOptions\n): Promise<FindByIdWithMetaResult<T>> => {\n    const data = await context.collection.get(id, options);\n\n    return {\n        content: context.parse<T & AutoModelFields>(data.content),\n        cas: data.cas,\n        expiryTime: data.expiryTime,\n    };\n};\n"]}

package/dist/next.d.ts

@@ -0,0 +1,204 @@
+import type { Bucket, Cluster } from 'couchbase';
+import type { CouchsetArgs } from './connection';
+import { AutoModelFields, FieldCodec, Model, ModelConnection, ModalOptions } from './model';
+import type { ModelIndexDefinition } from './model';
+import type { SortType } from './query/interface/query.types';
+export type { FieldCodec } from './model';
+/** A JSON-friendly Date codec for models declared with defineModel. */
+export declare const dateCodec: FieldCodec<Date, string>;
+export interface ModelCollectionSettings {
+    maxExpiry?: number;
+    history?: boolean;
+}
+/**
+ * A model definition has no connection and performs no I/O. Definitions may be
+ * reused safely across clients and are the unit the client registers.
+ */
+export type ModelField<T> = Extract<keyof T, string>;
+export type TypedIndexField<T> = ModelField<T> | Partial<Record<ModelField<T>, SortType>>;
+export type ModelCodecs<T> = Partial<{
+    [Field in ModelField<T>]: FieldCodec<T[Field], any>;
+}> & Partial<Record<`${string}.${string}`, FieldCodec<any, any>>>;
+export interface TypedModelIndexDefinition<T> extends Omit<ModelIndexDefinition, 'fields'> {
+    fields?: TypedIndexField<T>[];
+}
+export interface ModelDefinition<T = any> extends Omit<ModalOptions, 'codecs' | 'indexes'> {
+    name: string;
+    collectionSettings?: ModelCollectionSettings;
+    codecs?: ModelCodecs<T>;
+    indexes?: TypedModelIndexDefinition<T>[];
+}
+/** User fields are distinct from CouchSet's generated persistence metadata. */
+export type ModelCreateInput<T> = Omit<T, keyof AutoModelFields> & Partial<Pick<T, Extract<keyof T, keyof AutoModelFields>>>;
+export interface TypedModel<T> extends Omit<Model, 'getById' | 'getWithCas' | 'insert' | 'replaceById' | 'replaceIfCas'> {
+    getById(id: string, options?: any): Promise<T & AutoModelFields>;
+    getWithCas(id: string, options?: any): Promise<{
+        content: T & AutoModelFields;
+        cas: any;
+        expiryTime?: any;
+    }>;
+    insert(data: ModelCreateInput<T>, options?: any): Promise<T & AutoModelFields>;
+    replaceById(id: string, data: T, options?: any): Promise<T & AutoModelFields>;
+    replaceIfCas(id: string, data: T, cas: any, options?: any): Promise<T & AutoModelFields>;
+}
+export declare const defineModel: <T = any>(definition: ModelDefinition<T>) => ModelDefinition<T>;
+export interface CouchsetClientDependencies {
+    /** Supply a fully controlled runtime for tests or an application-owned connection. */
+    connection?: ModelConnection;
+    /** Supply an already connected SDK cluster/bucket without using couchbase.connect. */
+    cluster?: Cluster;
+    bucket?: Bucket;
+    /** Override connection construction; useful for dependency injection and test doubles. */
+    connect?: (settings: CouchsetArgs) => Promise<Cluster>;
+}
+export interface CouchsetClientOptions extends Partial<CouchsetArgs> {
+    models?: Array<ModelDefinition<any>>;
+    dependencies?: CouchsetClientDependencies;
+}
+export interface EnsureCollectionsOptions {
+    models?: Array<ModelDefinition<any>>;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+export interface ProvisionOptions extends EnsureCollectionsOptions {
+    collections?: boolean;
+    indexes?: boolean;
+    waitForIndexes?: boolean;
+}
+export interface RegisterModelOptions extends ProvisionOptions {
+    /** Explicitly provision this dynamic model. Constructors and CRUD never do this. */
+    provision?: boolean | {
+        collections?: boolean;
+        indexes?: boolean;
+        waitForIndexes?: boolean;
+    };
+}
+export interface ProvisionedTarget {
+    scope: string;
+    collection: string;
+    createdScope: boolean;
+    createdCollection: boolean;
+}
+export interface IndexPlanItem {
+    status: 'create' | 'matching' | 'replace';
+    definition: ModelIndexDefinition;
+    keyspace: string;
+    target: CollectionTarget;
+    /** The physical index CouchSet will create. Replacement names are versioned. */
+    createAs: string;
+    /** Only populated for an explicit or detected safe replacement. */
+    replaces?: string;
+    reason?: string;
+}
+export interface IndexPlan {
+    items: IndexPlanItem[];
+}
+export interface ApplyIndexPlanOptions {
+    /** Opt-in only: drop old indexes after the replacement is online. */
+    dropReplaced?: boolean;
+    timeoutMs?: number;
+}
+interface CollectionTarget {
+    scope: string;
+    collection: string;
+    settings?: ModelCollectionSettings;
+}
+/**
+ * A client owns its model-definition registry and connection. It intentionally
+ * does not alter the legacy singleton or register models globally.
+ */
+export declare class CouchsetClient {
+    private readonly connection;
+    private readonly registered;
+    private readonly settings;
+    constructor(options?: CouchsetClientOptions);
+    ready(): Promise<this>;
+    shutdown(): Promise<void>;
+    definitions(): ModelDefinition<any>[];
+    /** Bind and register a definition without provisioning or index DDL. */
+    model<T>(definition: ModelDefinition<T>): TypedModel<T>;
+    /**
+     * Async registration for dynamic models. DDL is performed only when the
+     * caller explicitly opts into provision; ordinary model() is side-effect-free.
+     */
+    registerModel<T>(definition: ModelDefinition<T>, options?: RegisterModelOptions): Promise<TypedModel<T>>;
+    /** Create only missing scopes/collections. Existing resources are never altered. */
+    ensureCollections(options?: EnsureCollectionsOptions): Promise<ProvisionedTarget[]>;
+    /** Explicit bootstrap: provisioning occurs before index creation. */
+    provision(options?: ProvisionOptions): Promise<{
+        collections: ProvisionedTarget[];
+        indexes: string[];
+    }>;
+    /** Normal ensureIndexes stays create-only. It never checks, drops, or changes an existing index. */
+    ensureIndexes(options?: {
+        models?: Array<ModelDefinition<any>>;
+        deferred?: boolean;
+        waitForIndexes?: boolean;
+        timeoutMs?: number;
+    }): Promise<string[]>;
+    /** Report missing, matching, and drifted indexes; this method has no DDL side effects. */
+    planIndexes(options?: {
+        models?: Array<ModelDefinition<any>>;
+    }): Promise<IndexPlan>;
+    /**
+     * Apply a reviewed plan by creating versioned replacements and waiting for
+     * them. Dropping old indexes is deliberately an explicit second opt-in.
+     */
+    applyIndexPlan(plan: IndexPlan, options?: ApplyIndexPlanOptions): Promise<string[]>;
+    /**
+     * Run the callback through Couchbase's transaction retry loop. The callback
+     * may execute more than once; do not perform external side effects inside it.
+     * A commit-ambiguous error is rethrown and must be resolved by the caller via
+     * an idempotency key/outbox, never by blindly retrying a side effect.
+     */
+    transaction<T>(callback: (transaction: CouchsetTransaction) => Promise<T>): Promise<T>;
+    keyspace(definition: ModelDefinition<any>): string;
+    getConnection(): ModelConnection;
+    private targets;
+    private waitForCollectionManifest;
+    private waitForIndexes;
+    private indexCatalog;
+}
+/** A model bound strictly to a Couchbase transaction attempt. */
+export declare class TransactionModel<T = any> {
+    private readonly model;
+    private readonly attempt;
+    constructor(model: TypedModel<T>, attempt: any);
+    get(id: string): Promise<TransactionDocument<T> | null>;
+    getById(id: string): Promise<TransactionDocument<T> | null>;
+    insert(id: string, data: ModelCreateInput<T>): Promise<TransactionDocument<T>>;
+    /** Replace requires the prior transactional read, as required by the SDK. */
+    replace(document: TransactionDocument<T>, data: T): Promise<TransactionDocument<T>>;
+    replaceById(id: string, data: T): Promise<TransactionDocument<T>>;
+    remove(document: TransactionDocument<T>): Promise<void>;
+    query<TRow = any>(statement: string, options?: any): Promise<{
+        rows: TRow[];
+    }>;
+}
+export interface TransactionDocument<T> {
+    content: T & AutoModelFields;
+    /** Opaque transaction SDK result; only pass it back to replace/remove. */
+    document: any;
+}
+export declare class CouchsetTransaction {
+    private readonly client;
+    private readonly attempt;
+    constructor(client: CouchsetClient, attempt: any);
+    model<T>(definition: ModelDefinition<T>): TransactionModel<T>;
+    query<TRow = any>(statement: string, options?: any): Promise<{
+        rows: TRow[];
+    }>;
+}
+/**
+ * Creates a short-lived scoped fixture and a cleanup function. The caller must
+ * invoke cleanup in after/afterEach; no normal client operation ever drops data.
+ */
+export declare const createCouchsetTestFixture: <T = any>(client: CouchsetClient, definition: Omit<ModelDefinition<T>, "scope" | "collection"> & {
+    scope?: string;
+    collection?: string;
+}) => Promise<{
+    definition: ModelDefinition<T>;
+    model: TypedModel<T>;
+    cleanup: () => Promise<void>;
+}>;
+export declare const createCouchsetClient: (options?: CouchsetClientOptions) => CouchsetClient;