couchset 0.2.7 → 0.4.0

package/dist/model/read-helpers.js

@@ -0,0 +1,275 @@
+"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 __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));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.page = exports.count = exports.exists = exports.findOne = exports.findMany = void 0;
+var safe_pagination_1 = require("../pagination/safe-pagination");
+var include_1 = require("./include");
+var scopedWhere = function (collectionName, where) {
+    var typeWhere = { _type: { $eq: collectionName } };
+    if (!where || !Object.keys(where).length) {
+        return typeWhere;
+    }
+    return { $and: [typeWhere, where] };
+};
+var shouldThrow = function (args) { return args.throwOnError !== false; };
+var unwrapRows = function (rows, bucketName, selectAll, parse) {
+    return rows.map(function (row) {
+        var data = selectAll ? row[bucketName] : row;
+        return parse(data);
+    });
+};
+var runReadQuery = function (context, args, queryArgs) { return __awaiter(void 0, void 0, void 0, function () {
+    var hasIncludes, builtQuery, query, parameters, selectAll, resultKey, _a, rows, error_1;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                hasIncludes = Array.isArray(queryArgs.include) && queryArgs.include.length > 0;
+                builtQuery = hasIncludes
+                    ? (0, include_1.buildIncludedSelectionQuery)({
+                        keyspace: context.bucketName,
+                        collectionName: context.collectionName,
+                        select: queryArgs.select || '*',
+                        where: scopedWhere(context.collectionName, queryArgs.where),
+                        limit: queryArgs.limit,
+                        page: queryArgs.page,
+                        offset: queryArgs.offset,
+                        orderBy: queryArgs.orderBy,
+                        include: queryArgs.include,
+                    })
+                    : __assign(__assign({}, (0, safe_pagination_1.buildSelectionQuery)({
+                        bucketName: context.bucketName,
+                        select: queryArgs.select || '*',
+                        where: { where: scopedWhere(context.collectionName, queryArgs.where) },
+                        limit: queryArgs.limit,
+                        page: queryArgs.page,
+                        offset: queryArgs.offset,
+                        orderBy: queryArgs.orderBy,
+                    }, { includeLimitOffset: true })), { resultKey: undefined });
+                query = builtQuery.query, parameters = builtQuery.parameters, selectAll = builtQuery.selectAll, resultKey = builtQuery.resultKey;
+                _b.label = 1;
+            case 1:
+                _b.trys.push([1, 3, , 4]);
+                return [4 /*yield*/, context.cluster.query(query, { parameters: parameters })];
+            case 2:
+                _a = (_b.sent()).rows, rows = _a === void 0 ? [] : _a;
+                return [2 /*return*/, unwrapRows(rows, resultKey || context.resultKey || context.bucketName, selectAll, context.parse)];
+            case 3:
+                error_1 = _b.sent();
+                if (shouldThrow(args)) {
+                    throw error_1;
+                }
+                return [2 /*return*/, []];
+            case 4: return [2 /*return*/];
+        }
+    });
+}); };
+var findMany = function (context_1) {
+    var args_1 = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args_1[_i - 1] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([context_1], __read(args_1), false), void 0, function (context, args) {
+        if (args === void 0) { args = {}; }
+        return __generator(this, function (_a) {
+            return [2 /*return*/, runReadQuery(context, args, __assign(__assign({}, args), { limit: typeof args.limit === 'number' ? args.limit : 10, page: typeof args.page === 'number' ? args.page : 0 }))];
+        });
+    });
+};
+exports.findMany = findMany;
+var findOne = function (context_1) {
+    var args_1 = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args_1[_i - 1] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([context_1], __read(args_1), false), void 0, function (context, args) {
+        var rows;
+        if (args === void 0) { args = {}; }
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, runReadQuery(context, args, __assign(__assign({}, args), { limit: 1, page: 0, offset: args.offset }))];
+                case 1:
+                    rows = _a.sent();
+                    return [2 /*return*/, rows.length ? rows[0] : null];
+            }
+        });
+    });
+};
+exports.findOne = findOne;
+var exists = function (context_1) {
+    var args_1 = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args_1[_i - 1] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([context_1], __read(args_1), false), void 0, function (context, args) {
+        var _a, query, parameters, _b, rows, error_2;
+        if (args === void 0) { args = {}; }
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    _a = (0, safe_pagination_1.buildSelectionQuery)({
+                        bucketName: context.bucketName,
+                        select: 'RAW 1',
+                        where: { where: scopedWhere(context.collectionName, args.where) },
+                        limit: 1,
+                        page: 0,
+                    }, { includeLimitOffset: true }), query = _a.query, parameters = _a.parameters;
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, context.cluster.query(query, { parameters: parameters })];
+                case 2:
+                    _b = (_c.sent()).rows, rows = _b === void 0 ? [] : _b;
+                    return [2 /*return*/, rows.length > 0];
+                case 3:
+                    error_2 = _c.sent();
+                    if (shouldThrow(args)) {
+                        throw error_2;
+                    }
+                    return [2 /*return*/, false];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+};
+exports.exists = exists;
+var count = function (context_1) {
+    var args_1 = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args_1[_i - 1] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([context_1], __read(args_1), false), void 0, function (context, args) {
+        var _a, query, parameters, _b, rows, error_3;
+        if (args === void 0) { args = {}; }
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    _a = (0, safe_pagination_1.buildSelectionQuery)({
+                        bucketName: context.bucketName,
+                        select: 'RAW COUNT(1)',
+                        where: { where: scopedWhere(context.collectionName, args.where) },
+                    }), query = _a.query, parameters = _a.parameters;
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, context.cluster.query(query, { parameters: parameters })];
+                case 2:
+                    _b = (_c.sent()).rows, rows = _b === void 0 ? [] : _b;
+                    return [2 /*return*/, Number(rows[0] || 0)];
+                case 3:
+                    error_3 = _c.sent();
+                    if (shouldThrow(args)) {
+                        throw error_3;
+                    }
+                    return [2 /*return*/, 0];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+};
+exports.count = count;
+var page = function (context_1) {
+    var args_1 = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args_1[_i - 1] = arguments[_i];
+    }
+    return __awaiter(void 0, __spreadArray([context_1], __read(args_1), false), void 0, function (context, args) {
+        var limit, pageNumber, offset, rows, hasNext;
+        if (args === void 0) { args = {}; }
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    limit = typeof args.limit === 'number' ? args.limit : 10;
+                    pageNumber = typeof args.page === 'number' ? args.page : 0;
+                    offset = typeof args.offset === 'number' ? args.offset : pageNumber * limit;
+                    return [4 /*yield*/, runReadQuery(context, args, __assign(__assign({}, args), { limit: limit + 1, page: pageNumber, offset: offset }))];
+                case 1:
+                    rows = _a.sent();
+                    hasNext = rows.length > limit;
+                    return [2 /*return*/, {
+                            items: hasNext ? rows.slice(0, limit) : rows,
+                            hasNext: hasNext,
+                            pageInfo: {
+                                limit: limit,
+                                page: pageNumber,
+                                offset: offset,
+                                nextPage: hasNext ? pageNumber + 1 : null,
+                                nextOffset: hasNext ? offset + limit : null,
+                            },
+                        }];
+            }
+        });
+    });
+};
+exports.page = page;
+//# sourceMappingURL=read-helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-helpers.js","sourceRoot":"","sources":["../../src/model/read-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type {Cluster} from 'couchbase';\n\nimport {buildSelectionQuery} from '../pagination/safe-pagination';\n\nimport {buildIncludedSelectionQuery, IncludeDefinition} from './include';\n\nexport interface ModelReadArgs {\n    select?: any[] | string;\n    where?: any;\n    orderBy?: any;\n    limit?: number;\n    page?: number;\n    offset?: number;\n    throwOnError?: boolean;\n    include?: IncludeDefinition[];\n}\n\nexport interface ModelPageInfo {\n    limit: number;\n    page: number;\n    offset: number;\n    nextPage: number | null;\n    nextOffset: number | null;\n}\n\nexport interface ModelPageResult<T> {\n    items: T[];\n    hasNext: boolean;\n    pageInfo: ModelPageInfo;\n}\n\nexport interface ModelReadContext {\n    bucketName: string;\n    collectionName: string;\n    cluster: Cluster;\n    parse: <T>(data: T) => T;\n    resultKey?: string;\n}\n\nconst scopedWhere = (collectionName: string, where?: any): any => {\n    const typeWhere = {_type: {$eq: collectionName}};\n\n    if (!where || !Object.keys(where).length) {\n        return typeWhere;\n    }\n\n    return {$and: [typeWhere, where]};\n};\n\nconst shouldThrow = (args: ModelReadArgs): boolean => args.throwOnError !== false;\n\nconst unwrapRows = <T>(\n    rows: any[],\n    bucketName: string,\n    selectAll: boolean,\n    parse: <TItem>(data: TItem) => TItem\n): T[] => {\n    return rows.map((row) => {\n        const data = selectAll ? row[bucketName] : row;\n\n        return parse<T>(data);\n    });\n};\n\nconst runReadQuery = async <T>(\n    context: ModelReadContext,\n    args: ModelReadArgs,\n    queryArgs: ModelReadArgs\n): Promise<T[]> => {\n    const hasIncludes = Array.isArray(queryArgs.include) && queryArgs.include.length > 0;\n    const builtQuery = hasIncludes\n        ? buildIncludedSelectionQuery({\n              keyspace: context.bucketName,\n              collectionName: context.collectionName,\n              select: queryArgs.select || '*',\n              where: scopedWhere(context.collectionName, queryArgs.where),\n              limit: queryArgs.limit,\n              page: queryArgs.page,\n              offset: queryArgs.offset,\n              orderBy: queryArgs.orderBy,\n              include: queryArgs.include,\n          })\n        : {\n              ...buildSelectionQuery(\n                  {\n                      bucketName: context.bucketName,\n                      select: queryArgs.select || '*',\n                      where: {where: scopedWhere(context.collectionName, queryArgs.where)},\n                      limit: queryArgs.limit,\n                      page: queryArgs.page,\n                      offset: queryArgs.offset,\n                      orderBy: queryArgs.orderBy,\n                  },\n                  {includeLimitOffset: true}\n              ),\n              resultKey: undefined,\n          };\n    const {query, parameters, selectAll, resultKey} = builtQuery;\n\n    try {\n        const {rows = []} = await context.cluster.query(query, {parameters});\n\n        return unwrapRows<T>(\n            rows,\n            resultKey || context.resultKey || context.bucketName,\n            selectAll,\n            context.parse\n        );\n    } catch (error) {\n        if (shouldThrow(args)) {\n            throw error;\n        }\n\n        return [];\n    }\n};\n\nexport const findMany = async <T>(\n    context: ModelReadContext,\n    args: ModelReadArgs = {}\n): Promise<T[]> => {\n    return runReadQuery<T>(context, args, {\n        ...args,\n        limit: typeof args.limit === 'number' ? args.limit : 10,\n        page: typeof args.page === 'number' ? args.page : 0,\n    });\n};\n\nexport const findOne = async <T>(\n    context: ModelReadContext,\n    args: ModelReadArgs = {}\n): Promise<T | null> => {\n    const rows = await runReadQuery<T>(context, args, {\n        ...args,\n        limit: 1,\n        page: 0,\n        offset: args.offset,\n    });\n\n    return rows.length ? rows[0] : null;\n};\n\nexport const exists = async (\n    context: ModelReadContext,\n    args: ModelReadArgs = {}\n): Promise<boolean> => {\n    const {query, parameters} = buildSelectionQuery(\n        {\n            bucketName: context.bucketName,\n            select: 'RAW 1',\n            where: {where: scopedWhere(context.collectionName, args.where)},\n            limit: 1,\n            page: 0,\n        },\n        {includeLimitOffset: true}\n    );\n\n    try {\n        const {rows = []} = await context.cluster.query(query, {parameters});\n\n        return rows.length > 0;\n    } catch (error) {\n        if (shouldThrow(args)) {\n            throw error;\n        }\n\n        return false;\n    }\n};\n\nexport const count = async (\n    context: ModelReadContext,\n    args: ModelReadArgs = {}\n): Promise<number> => {\n    const {query, parameters} = buildSelectionQuery({\n        bucketName: context.bucketName,\n        select: 'RAW COUNT(1)',\n        where: {where: scopedWhere(context.collectionName, args.where)},\n    });\n\n    try {\n        const {rows = []} = await context.cluster.query(query, {parameters});\n\n        return Number(rows[0] || 0);\n    } catch (error) {\n        if (shouldThrow(args)) {\n            throw error;\n        }\n\n        return 0;\n    }\n};\n\nexport const page = async <T>(\n    context: ModelReadContext,\n    args: ModelReadArgs = {}\n): Promise<ModelPageResult<T>> => {\n    const limit = typeof args.limit === 'number' ? args.limit : 10;\n    const pageNumber = typeof args.page === 'number' ? args.page : 0;\n    const offset = typeof args.offset === 'number' ? args.offset : pageNumber * limit;\n    const rows = await runReadQuery<T>(context, args, {\n        ...args,\n        limit: limit + 1,\n        page: pageNumber,\n        offset,\n    });\n    const hasNext = rows.length > limit;\n\n    return {\n        items: hasNext ? rows.slice(0, limit) : rows,\n        hasNext,\n        pageInfo: {\n            limit,\n            page: pageNumber,\n            offset,\n            nextPage: hasNext ? pageNumber + 1 : null,\n            nextOffset: hasNext ? offset + limit : null,\n        },\n    };\n};\n"]}

package/dist/model/safe-query.d.ts

@@ -0,0 +1,23 @@
+import type { Cluster, QueryOptions } from 'couchbase';
+import { bucketIdentifier, fromTarget } from './keyspace';
+export type QueryParameters = {
+    [key: string]: any;
+} | any[];
+export type QueryLogger = (message: string, details?: any) => void;
+export interface SafeQueryOptions extends Omit<QueryOptions, 'parameters'> {
+    debug?: boolean;
+    logger?: QueryLogger;
+}
+export interface QueryPageOptions extends SafeQueryOptions {
+    limit?: number;
+    limitParamIndex?: number;
+}
+export interface QueryPageResult<T> {
+    items: T[];
+    hasNext: boolean;
+    params?: any;
+}
+export { bucketIdentifier, fromTarget };
+export declare const runQueryRows: <T>(cluster: Cluster, query: string, params?: QueryParameters, options?: SafeQueryOptions) => Promise<T[]>;
+export declare const runQueryOne: <T>(cluster: Cluster, query: string, params?: QueryParameters, options?: SafeQueryOptions) => Promise<T | null>;
+export declare const runQueryPage: <T>(cluster: Cluster, query: string, params?: QueryParameters, options?: QueryPageOptions) => Promise<QueryPageResult<T>>;

package/dist/model/safe-query.js

@@ -0,0 +1,138 @@
+"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.runQueryPage = exports.runQueryOne = exports.runQueryRows = exports.fromTarget = exports.bucketIdentifier = void 0;
+var keyspace_1 = require("./keyspace");
+Object.defineProperty(exports, "bucketIdentifier", { enumerable: true, get: function () { return keyspace_1.bucketIdentifier; } });
+Object.defineProperty(exports, "fromTarget", { enumerable: true, get: function () { return keyspace_1.fromTarget; } });
+var queryOptionsWithParameters = function (params, options) {
+    var queryOptions = __assign({}, (options || {}));
+    delete queryOptions.debug;
+    delete queryOptions.logger;
+    return __assign(__assign({}, queryOptions), (params === undefined ? {} : { parameters: params }));
+};
+var resolvePageLimit = function (params, options) {
+    var limit = options && typeof options.limit === 'number'
+        ? options.limit
+        : !Array.isArray(params) && params && typeof params.limit === 'number'
+            ? params.limit
+            : null;
+    if (!limit || limit < 1) {
+        throw new Error('queryPage requires a positive limit option or named params.limit');
+    }
+    return limit;
+};
+var pageParameters = function (params, limit, options) {
+    var nextLimit = limit + 1;
+    if (Array.isArray(params)) {
+        if (options && typeof options.limitParamIndex === 'number') {
+            var updatedParams = params.slice();
+            updatedParams[options.limitParamIndex] = nextLimit;
+            return updatedParams;
+        }
+        return params;
+    }
+    return __assign(__assign({}, (params || {})), { limit: nextLimit });
+};
+var queryPageOptions = function (options) {
+    var queryOptions = __assign({}, (options || {}));
+    delete queryOptions.limit;
+    delete queryOptions.limitParamIndex;
+    return queryOptions;
+};
+var runQueryRows = function (cluster, query, params, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var queryOptions, _a, rows;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                queryOptions = queryOptionsWithParameters(params, options);
+                if (options && options.debug && options.logger) {
+                    options.logger('couchset queryRows', { query: query, options: queryOptions });
+                }
+                return [4 /*yield*/, cluster.query(query, queryOptions)];
+            case 1:
+                _a = (_b.sent()).rows, rows = _a === void 0 ? [] : _a;
+                return [2 /*return*/, rows];
+        }
+    });
+}); };
+exports.runQueryRows = runQueryRows;
+var runQueryOne = function (cluster, query, params, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var rows;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, (0, exports.runQueryRows)(cluster, query, params, options)];
+            case 1:
+                rows = _a.sent();
+                return [2 /*return*/, rows.length ? rows[0] : null];
+        }
+    });
+}); };
+exports.runQueryOne = runQueryOne;
+var runQueryPage = function (cluster, query, params, options) { return __awaiter(void 0, void 0, void 0, function () {
+    var limit, pagedParams, rows, hasNext;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                limit = resolvePageLimit(params, options);
+                pagedParams = pageParameters(params, limit, options);
+                return [4 /*yield*/, (0, exports.runQueryRows)(cluster, query, pagedParams, queryPageOptions(options))];
+            case 1:
+                rows = _a.sent();
+                hasNext = rows.length > limit;
+                return [2 /*return*/, {
+                        items: hasNext ? rows.slice(0, limit) : rows,
+                        hasNext: hasNext,
+                        params: pagedParams,
+                    }];
+        }
+    });
+}); };
+exports.runQueryPage = runQueryPage;
+//# sourceMappingURL=safe-query.js.map

package/dist/model/safe-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-query.js","sourceRoot":"","sources":["../../src/model/safe-query.ts"],"names":[],"mappings":"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","sourcesContent":["import type {Cluster, QueryOptions} from 'couchbase';\n\nimport {bucketIdentifier, fromTarget} from './keyspace';\n\nexport type QueryParameters = {[key: string]: any} | any[];\n\nexport type QueryLogger = (message: string, details?: any) => void;\n\nexport interface SafeQueryOptions extends Omit<QueryOptions, 'parameters'> {\n    debug?: boolean;\n    logger?: QueryLogger;\n}\n\nexport interface QueryPageOptions extends SafeQueryOptions {\n    limit?: number;\n    limitParamIndex?: number;\n}\n\nexport interface QueryPageResult<T> {\n    items: T[];\n    hasNext: boolean;\n    params?: any;\n}\n\nconst queryOptionsWithParameters = (\n    params?: QueryParameters,\n    options?: SafeQueryOptions\n): QueryOptions => {\n    const queryOptions: any = {...(options || {})};\n    delete queryOptions.debug;\n    delete queryOptions.logger;\n\n    return {\n        ...queryOptions,\n        ...(params === undefined ? {} : {parameters: params}),\n    };\n};\n\nconst resolvePageLimit = (params?: QueryParameters, options?: QueryPageOptions): number => {\n    const limit =\n        options && typeof options.limit === 'number'\n            ? options.limit\n            : !Array.isArray(params) && params && typeof params.limit === 'number'\n            ? params.limit\n            : null;\n\n    if (!limit || limit < 1) {\n        throw new Error('queryPage requires a positive limit option or named params.limit');\n    }\n\n    return limit;\n};\n\nconst pageParameters = (\n    params: QueryParameters | undefined,\n    limit: number,\n    options?: QueryPageOptions\n): QueryParameters | undefined => {\n    const nextLimit = limit + 1;\n\n    if (Array.isArray(params)) {\n        if (options && typeof options.limitParamIndex === 'number') {\n            const updatedParams = params.slice();\n            updatedParams[options.limitParamIndex] = nextLimit;\n            return updatedParams;\n        }\n\n        return params;\n    }\n\n    return {...(params || {}), limit: nextLimit};\n};\n\nconst queryPageOptions = (options?: QueryPageOptions): SafeQueryOptions => {\n    const queryOptions: any = {...(options || {})};\n    delete queryOptions.limit;\n    delete queryOptions.limitParamIndex;\n\n    return queryOptions;\n};\n\nexport {bucketIdentifier, fromTarget};\n\nexport const runQueryRows = async <T>(\n    cluster: Cluster,\n    query: string,\n    params?: QueryParameters,\n    options?: SafeQueryOptions\n): Promise<T[]> => {\n    const queryOptions = queryOptionsWithParameters(params, options);\n\n    if (options && options.debug && options.logger) {\n        options.logger('couchset queryRows', {query, options: queryOptions});\n    }\n\n    const {rows = []} = await cluster.query<T>(query, queryOptions);\n\n    return rows;\n};\n\nexport const runQueryOne = async <T>(\n    cluster: Cluster,\n    query: string,\n    params?: QueryParameters,\n    options?: SafeQueryOptions\n): Promise<T | null> => {\n    const rows = await runQueryRows<T>(cluster, query, params, options);\n\n    return rows.length ? rows[0] : null;\n};\n\nexport const runQueryPage = async <T>(\n    cluster: Cluster,\n    query: string,\n    params?: QueryParameters,\n    options?: QueryPageOptions\n): Promise<QueryPageResult<T>> => {\n    const limit = resolvePageLimit(params, options);\n    const pagedParams = pageParameters(params, limit, options);\n    const rows = await runQueryRows<T>(cluster, query, pagedParams, queryPageOptions(options));\n    const hasNext = rows.length > limit;\n\n    return {\n        items: hasNext ? rows.slice(0, limit) : rows,\n        hasNext,\n        params: pagedParams,\n    };\n};\n"]}

package/dist/model/ttl.d.ts

@@ -0,0 +1,9 @@
+export interface TtlOptions {
+    ttl?: string | number;
+    ttlSeconds?: number;
+    strictTtl?: boolean;
+}
+export declare const ttlToSeconds: (ttl: string | number, strictTtl?: boolean) => number | undefined;
+export declare const applyTtlOptions: <T extends {
+    expiry?: number | Date;
+}>(options?: T & TtlOptions) => T | undefined;

package/dist/model/ttl.js

@@ -0,0 +1,73 @@
+"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 __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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyTtlOptions = exports.ttlToSeconds = void 0;
+var unitSeconds = {
+    s: 1,
+    m: 60,
+    h: 60 * 60,
+    d: 60 * 60 * 24,
+    w: 60 * 60 * 24 * 7,
+};
+var parseTtlString = function (ttl, strictTtl) {
+    var match = ttl.trim().match(/^(\d+)([smhdw])$/i);
+    if (!match) {
+        if (strictTtl) {
+            throw new Error('ttl must include a supported unit: s, m, h, d, or w');
+        }
+        return undefined;
+    }
+    var amount = Number(match[1]);
+    var unit = match[2].toLowerCase();
+    return amount * unitSeconds[unit];
+};
+var ttlToSeconds = function (ttl, strictTtl) {
+    if (typeof ttl === 'number') {
+        if (strictTtl) {
+            throw new Error('numeric ttl is ambiguous; use ttlSeconds or a unit string');
+        }
+        return ttl;
+    }
+    return parseTtlString(ttl, strictTtl);
+};
+exports.ttlToSeconds = ttlToSeconds;
+var applyTtlOptions = function (options) {
+    if (!options) {
+        return undefined;
+    }
+    var _a = options, ttl = _a.ttl, ttlSeconds = _a.ttlSeconds, strictTtl = _a.strictTtl, sdkOptions = __rest(_a, ["ttl", "ttlSeconds", "strictTtl"]);
+    var normalizedOptions = __assign({}, sdkOptions);
+    if (typeof ttlSeconds === 'number') {
+        normalizedOptions.expiry = ttlSeconds;
+    }
+    else if (ttl !== undefined) {
+        var expiry = (0, exports.ttlToSeconds)(ttl, strictTtl);
+        if (typeof expiry === 'number') {
+            normalizedOptions.expiry = expiry;
+        }
+    }
+    return normalizedOptions;
+};
+exports.applyTtlOptions = applyTtlOptions;
+//# sourceMappingURL=ttl.js.map

package/dist/model/ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../src/model/ttl.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAMA,IAAM,WAAW,GAA2B;IACxC,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE,GAAG,EAAE;IACV,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;IACf,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACtB,CAAC;AAEF,IAAM,cAAc,GAAG,UAAC,GAAW,EAAE,SAAmB;IACpD,IAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAEpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,IAAI,SAAS,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,IAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpC,OAAO,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC;AAEK,IAAM,YAAY,GAAG,UAAC,GAAoB,EAAE,SAAmB;IAClE,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,SAAS,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QACjF,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC;IAED,OAAO,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC,CAAC;AAVW,QAAA,YAAY,gBAUvB;AAEK,IAAM,eAAe,GAAG,UAC3B,OAAwB;IAExB,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAM,KAA8C,OAAyB,EAAtE,GAAG,SAAA,EAAE,UAAU,gBAAA,EAAE,SAAS,eAAA,EAAK,UAAU,cAA1C,kCAA2C,CAA4B,CAAC;IAC9E,IAAM,iBAAiB,gBAAY,UAAU,CAAC,CAAC;IAE/C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACjC,iBAAiB,CAAC,MAAM,GAAG,UAAU,CAAC;IAC1C,CAAC;SAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,iBAAiB,CAAC,MAAM,GAAG,MAAM,CAAC;QACtC,CAAC;IACL,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC7B,CAAC,CAAC;AApBW,QAAA,eAAe,mBAoB1B","sourcesContent":["export interface TtlOptions {\n    ttl?: string | number;\n    ttlSeconds?: number;\n    strictTtl?: boolean;\n}\n\nconst unitSeconds: Record<string, number> = {\n    s: 1,\n    m: 60,\n    h: 60 * 60,\n    d: 60 * 60 * 24,\n    w: 60 * 60 * 24 * 7,\n};\n\nconst parseTtlString = (ttl: string, strictTtl?: boolean): number | undefined => {\n    const match = ttl.trim().match(/^(\\d+)([smhdw])$/i);\n\n    if (!match) {\n        if (strictTtl) {\n            throw new Error('ttl must include a supported unit: s, m, h, d, or w');\n        }\n\n        return undefined;\n    }\n\n    const amount = Number(match[1]);\n    const unit = match[2].toLowerCase();\n\n    return amount * unitSeconds[unit];\n};\n\nexport const ttlToSeconds = (ttl: string | number, strictTtl?: boolean): number | undefined => {\n    if (typeof ttl === 'number') {\n        if (strictTtl) {\n            throw new Error('numeric ttl is ambiguous; use ttlSeconds or a unit string');\n        }\n\n        return ttl;\n    }\n\n    return parseTtlString(ttl, strictTtl);\n};\n\nexport const applyTtlOptions = <T extends {expiry?: number | Date}>(\n    options?: T & TtlOptions\n): T | undefined => {\n    if (!options) {\n        return undefined;\n    }\n\n    const {ttl, ttlSeconds, strictTtl, ...sdkOptions} = options as T & TtlOptions;\n    const normalizedOptions: any = {...sdkOptions};\n\n    if (typeof ttlSeconds === 'number') {\n        normalizedOptions.expiry = ttlSeconds;\n    } else if (ttl !== undefined) {\n        const expiry = ttlToSeconds(ttl, strictTtl);\n        if (typeof expiry === 'number') {\n            normalizedOptions.expiry = expiry;\n        }\n    }\n\n    return normalizedOptions;\n};\n"]}

package/dist/model/validation.d.ts

@@ -0,0 +1,5 @@
+export type ValidationHook<T = any> = (document: T) => T | void | Promise<T | void>;
+export type ParseHook<T = any> = (document: T) => T;
+export declare const applyValidation: <T>(document: T, hook?: ValidationHook<T>) => Promise<T>;
+export declare const schemaFromDateFields: (dateFields?: string[]) => Record<string, "date">;
+export declare const parseDateFields: <T>(document: T, dateFields?: string[]) => T;