@nxgt/mongo 0.1.0

package/dist/sync/validator-diff.d.ts

@@ -0,0 +1,27 @@
+import type { ValidationAction, ValidationLevel } from '../definition/define-collection';
+/** A collection's validation, as `listCollections` reports it in `options`. */
+export interface LiveValidation {
+    validator?: Record<string, unknown>;
+    validationLevel?: string;
+    validationAction?: string;
+}
+/** The validation a definition asks for. `validator` is absent for `off`. */
+export interface WantedValidation {
+    validator: Record<string, unknown> | undefined;
+    level: ValidationLevel;
+    action: ValidationAction;
+}
+/** Has a collection a validator at all? An empty one is no validator. */
+export declare function hasValidator(live: LiveValidation): boolean;
+/**
+ * Does the collection already validate the way the definition says?
+ *
+ * MongoDB reads a `$jsonSchema` back exactly as it was sent, so the two are
+ * compared whole. What it does not read back is a validator that was removed:
+ * `collMod` with `validator: {}` leaves **no `validator` key at all**, while
+ * `validationLevel` and `validationAction` stay behind. And a collection
+ * created without one reports `options: {}`, where the level is `strict` and
+ * the action `error` by default.
+ */
+export declare function validationMatches(wanted: WantedValidation, live: LiveValidation): boolean;
+//# sourceMappingURL=validator-diff.d.ts.map

package/dist/sync/validator-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-diff.d.ts","sourceRoot":"","sources":["../../src/sync/validator-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,eAAe,EACf,MAAM,iCAAiC,CAAC;AAEzC,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAYD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAE1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,cAAc,GAClB,OAAO,CAQT"}

package/dist/transaction/with-transaction.d.ts

@@ -0,0 +1,34 @@
+import type { ClientSession, MongoClient, TransactionOptions } from 'mongodb';
+/** What a transaction can be started from: a client, or a session. */
+export type TransactionHost = MongoClient | ClientSession;
+/**
+ * Runs `fn` in a transaction: committed when it resolves, aborted when it
+ * throws, and a MongoDB error turned into a `DataError` on the way out. The
+ * session is the argument, and **every operation inside has to be given it**:
+ * MongoDB has no ambient session, so an operation without one runs outside the
+ * transaction and is not rolled back. `repository.with(session)` is how a
+ * repository takes it.
+ *
+ * ```ts
+ * await withTransaction(client, async (session) => {
+ * 	const team = await teams.with(session).create({ name: 'Core' });
+ * 	await users.with(session).update(userId, { teamId: team._id });
+ * });
+ * ```
+ *
+ * Given a session that is already in a transaction, it **joins** it: `fn` runs
+ * with that session and nothing is committed until the outer one commits.
+ * MongoDB has no savepoints, so an inner failure cannot be rolled back on its
+ * own, and starting a second transaction on one session throws
+ * `MongoTransactionError`.
+ *
+ * Two things the driver does that are easy to be surprised by:
+ *
+ * - it **retries `fn`** from the start on a `TransientTransactionError`, and
+ *   the commit alone on an `UnknownTransactionCommitResult`, until 120 seconds
+ *   have passed. `fn` must therefore be safe to run twice.
+ * - `session.abortTransaction()` inside `fn` ends the transaction without
+ *   throwing: `withTransaction` then resolves.
+ */
+export declare function withTransaction<T>(host: TransactionHost, fn: (session: ClientSession) => Promise<T>, options?: TransactionOptions): Promise<T>;
+//# sourceMappingURL=with-transaction.d.ts.map

package/dist/transaction/with-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-transaction.d.ts","sourceRoot":"","sources":["../../src/transaction/with-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG9E,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,aAAa,CAAC;AAO1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACtC,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,OAAO,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/package.json

@@ -0,0 +1,61 @@
+{
+	"name": "@nxgt/mongo",
+	"version": "0.1.0",
+	"description": "A typed MongoDB collection from a Zod schema: its indexes and $jsonSchema validator synced idempotently, a typed repository with pagination, transactions, optimistic locking, soft delete and its own errors",
+	"license": "MIT",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"README.md",
+		"package.json",
+		"LICENSE"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		},
+		"./package.json": "./package.json"
+	},
+	"keywords": [
+		"mongodb",
+		"zod",
+		"repository",
+		"pagination",
+		"jsonschema",
+		"typescript"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/softistx/nxgt-data.git",
+		"directory": "packages/mongo"
+	},
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org",
+		"access": "public"
+	},
+	"scripts": {
+		"build": "bun run ../../build.ts",
+		"test": "bun test src",
+		"typecheck": "tsc --noEmit"
+	},
+	"nxgt": {
+		"entrypoints": [
+			"src/index.ts"
+		]
+	},
+	"devDependencies": {
+		"@types/bun": "^1.4.0",
+		"mongodb": "7.6.0",
+		"mongodb-memory-server-core": "11.2.0",
+		"zod": "4.6.5"
+	},
+	"peerDependencies": {
+		"mongodb": ">=7.0.0 <8",
+		"typescript": "^6.0.3",
+		"zod": ">=4.6.5 <5"
+	}
+}