@yongdall/connection 0.1.0

package/hooks.yongdall.mjs

@@ -0,0 +1,117 @@
+import { Connection } from "@yongdall/model";
+
+//#region packages/connection/hooks.yongdall.mjs
+/** @import {Hooks, Providers, ProvidersConverted, Connections} from './types.mjs' */
+/** @type {Hooks.providerDefines} */
+const providerDefines = {
+	fs: {
+		convert: (fs) => fs,
+		connect: (fs) => ({
+			read: (path) => fs.then((s) => s.read(path)),
+			write: (path, data, size) => fs.then((s) => s.write(path, data, size)),
+			urlRead: (path, expires) => fs.then((s) => s.urlRead(path, expires)),
+			urlWrite: (path, expires) => fs.then((s) => s.urlWrite(path, expires))
+		})
+	},
+	mq: {
+		convert: (service) => ({
+			channels: /* @__PURE__ */ new Map(),
+			service,
+			abort() {}
+		}),
+		connect: (param) => ({
+			async subscribe(channelName, listener) {
+				const { channels, service } = await param;
+				let channel = channels.get(channelName);
+				if (!channel) {
+					/** @type {Set<(val: any) => any>} */
+					const listeners = /* @__PURE__ */ new Set();
+					channel = {
+						listeners,
+						promise: Promise.resolve(null),
+						run(value) {
+							try {
+								for (const f of [...listeners]) f(value);
+							} catch {}
+						}
+					};
+					channels.set(channelName, channel);
+				}
+				const listeners = channel.listeners;
+				if (!listeners.size) channel.promise = channel.promise.then((v) => v || service.subscribe(channelName, channel.run));
+				listeners.add(listener);
+				let done = false;
+				return () => {
+					if (done) return;
+					done = true;
+					listeners.delete(listener);
+					if (!listeners.size) {
+						const promise = channel.promise;
+						channel.promise = promise.then((v) => v?.()).then(() => null);
+					}
+				};
+			},
+			async publish(channel, message) {
+				const { channels, service } = await param;
+				await service.publish(channel, message);
+			}
+		})
+	},
+	tq: {
+		convert: (service) => ({
+			channels: /* @__PURE__ */ new Map(),
+			service,
+			abort() {
+				service.disconnect();
+			}
+		}),
+		connect: (param) => ({
+			async publish(queue, message) {
+				const { channels, service } = await param;
+				await service.publish(queue, message);
+			},
+			async get(queue) {
+				const { channels, service } = await param;
+				const promise = (channels.get(queue) || Promise.resolve()).then(() => service).then((v) => v.get(queue));
+				channels.set(queue, promise.catch(() => {}));
+				return promise;
+			},
+			abort() {}
+		})
+	},
+	rdb: {
+		convert: (conn) => conn,
+		connect: (conn) => new Connection(conn)
+	},
+	cache: {
+		default: {
+			set: async (key, field, value) => {},
+			get: async (key, field) => {},
+			exists: async (key, field) => false,
+			del: async (key, field) => {},
+			clear: async (key) => {},
+			abort() {}
+		},
+		convert: ({ disconnect, ...cache }) => ({
+			...cache,
+			abort: disconnect
+		}),
+		connect: (cache) => ({
+			set: (key, field, value) => cache.then((c) => c.set(key, field, value)),
+			get: (key, field) => cache.then((c) => c.get(key, field)),
+			exists: (key, field) => cache.then((c) => c.exists(key, field)),
+			del: (key, field) => cache.then((c) => c.del(key, field)),
+			clear: (key) => cache.then((c) => c.clear(key)),
+			memoize: (key, field, exec) => cache.then((c) => c.get(key, field).then(async (v) => {
+				if (v !== void 0) return v;
+				const val = await exec();
+				await c.set(key, field, val);
+				return val;
+			}))
+		})
+	}
+};
+
+//#endregion
+export { providerDefines };
+//# sourceMappingURL=hooks.yongdall.mjs.map

package/hooks.yongdall.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.yongdall.mjs","names":[],"sources":["../../packages/connection/hooks.yongdall.mjs"],"sourcesContent":["import { Connection } from '@yongdall/model';\n/** @import {Hooks, Providers, ProvidersConverted, Connections} from './types.mjs' */\n\n\n/** @type {Hooks.providerDefines} */\nexport const providerDefines = {\n\tfs: {\n\t\tconvert: (/** @type {Providers['fs']} */ fs) => fs,\n\t\tconnect: (/** @type {Promise<ProvidersConverted['fs']>} */ fs) => /** @type {Connections['fs']} */({\n\t\t\tread: path => fs.then(s => s.read(path)),\n\t\t\twrite: (path, data, size) => fs.then(s => s.write(path, data, size)),\n\t\t\turlRead: (path, expires) => fs.then(s => s.urlRead(path, expires)),\n\t\t\turlWrite: (path, expires) => fs.then(s => s.urlWrite(path, expires)),\n\t\t}),\n\t},\n\tmq: {\n\t\tconvert: (/** @type {Providers['mq']} */ service) => /** @type {ProvidersConverted['mq']} */({\n\t\t\tchannels: new Map(),\n\t\t\tservice,\n\t\t\tabort() {\n\t\t\t\t// TODO: \n\t\t\t},\n\t\t}),\n\t\tconnect: (/** @type {Promise<ProvidersConverted['mq']>} */param) => ({\n\t\t\t/**\n\t\t\t * \n\t\t\t * @param {string} channelName \n\t\t\t * @param {(val: any) => any} listener \n\t\t\t */\n\t\t\tasync subscribe(channelName, listener) {\n\t\t\t\tconst { channels, service } = await param;\n\t\t\t\tlet channel = channels.get(channelName);\n\t\t\t\tif (!channel) {\n\t\t\t\t\t/** @type {Set<(val: any) => any>} */\n\t\t\t\t\tconst listeners = new Set();\n\t\t\t\t\tchannel = {\n\t\t\t\t\t\tlisteners, promise: Promise.resolve(null), run(value) {\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tfor (const f of [...listeners]) { f(value); }\n\t\t\t\t\t\t\t} catch {\n\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t\tchannels.set(channelName, channel);\n\t\t\t\t}\n\n\t\t\t\tconst listeners = channel.listeners;\n\n\t\t\t\tif (!listeners.size) {\n\t\t\t\t\tchannel.promise = channel.promise\n\t\t\t\t\t\t.then(v => v || service.subscribe(channelName, channel.run));\n\t\t\t\t}\n\t\t\t\tlisteners.add(listener);\n\n\t\t\t\tlet done = false;\n\t\t\t\treturn () => {\n\t\t\t\t\tif (done) { return; }\n\t\t\t\t\tdone = true;\n\t\t\t\t\tlisteners.delete(listener);\n\t\t\t\t\tif (!listeners.size) {\n\n\t\t\t\t\t\tconst promise = channel.promise;\n\t\t\t\t\t\tchannel.promise = promise.then(v => v?.()).then(() => null);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t},\n\t\t\t/**\n\t\t\t * \n\t\t\t * @param {string} channel \n\t\t\t * @param {any} message \n\t\t\t */\n\t\t\tasync publish(channel, message) {\n\t\t\t\tconst { channels, service } = await param;\n\t\t\t\tawait service.publish(channel, message);\n\t\t\t},\n\t\t}),\n\t},\n\ttq: {\n\t\tconvert: (/** @type {Providers['tq']} */ service) => /** @type {ProvidersConverted['tq']} */({\n\t\t\tchannels: new Map(),\n\t\t\tservice,\n\t\t\tabort() { service.disconnect(); },\n\t\t}),\n\t\tconnect: (/** @type {Promise<ProvidersConverted['tq']>} */param) => ({\n\t\t\t/**\n\t\t\t * \n\t\t\t * @param {string} queue \n\t\t\t * @param {any} message \n\t\t\t */\n\t\t\tasync publish(queue, message) {\n\t\t\t\tconst { channels, service } = await param;\n\t\t\t\tawait service.publish(queue, message);\n\t\t\t},\n\t\t\t/**\n\t\t\t * @template T\n\t\t\t * @param {string} queue \n\t\t\t * @returns {Promise<T | void>}\n\t\t\t */\n\t\t\tasync get(queue) {\n\t\t\t\tconst { channels, service } = await param;\n\t\t\t\tconst taskQueueChannel = channels.get(queue) || Promise.resolve();\n\n\t\t\t\tconst promise = taskQueueChannel\n\t\t\t\t\t.then(() => service)\n\t\t\t\t\t.then(v => v.get(queue));\n\n\t\t\t\tchannels.set(queue, promise.catch(() => { }));\n\t\t\t\treturn promise;\n\t\t\t},\n\t\t\tabort() { },\n\t\t}),\n\t},\n\trdb: {\n\t\tconvert: (/** @type {Providers['rdb']} */ conn) => conn,\n\t\tconnect: (/** @type {Promise<ProvidersConverted['rdb']>} */ conn) => new Connection(conn),\n\t},\n\tcache: {\n\t\tdefault: /** @type {ProvidersConverted['cache']} */({\n\t\t\tset: async (key, field, value) => { },\n\t\t\tget: async (key, field) => { },\n\t\t\texists: async (key, field) => false,\n\t\t\tdel: async (key, field) => { },\n\t\t\tclear: async (key) => { },\n\t\t\tabort() { },\n\t\t}),\n\t\tconvert: (/** @type {Providers['cache']} */ { disconnect, ...cache }) => ({\n\t\t\t...cache,\n\t\t\tabort: disconnect,\n\t\t}),\n\t\tconnect: (/** @type {Promise<ProvidersConverted['cache']>} */ cache) => /** @type {Connections['cache']} */({\n\t\t\tset: (key, field, value) => cache.then(c => c.set(key, field, value)),\n\t\t\tget: (key, field) => cache.then(c => c.get(key, field)),\n\t\t\texists: (key, field) => cache.then(c => c.exists(key, field)),\n\t\t\tdel: (key, field) => cache.then(c => c.del(key, field)),\n\t\t\tclear: (key) => cache.then(c => c.clear(key)),\n\t\t\tmemoize: (key, field, exec) => cache.then(c => c.get(key, field).then(async v => {\n\t\t\t\tif (v !== undefined) { return v; }\n\t\t\t\tconst val = await exec();\n\t\t\t\tawait c.set(key, field, val);\n\t\t\t\treturn val;\n\t\t\t}))\n\t\t}),\n\t},\n};\n"],"mappings":"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"}

package/index.mjs

@@ -0,0 +1,249 @@
+import { Query } from "@yongdall/model";
+import { addFinally, createStore, has } from "@yongdall/context";
+import { getModel, hooks, useTenant } from "@yongdall/core";
+
+//#region packages/connection/main.mjs
+/** @import { Tenant } from '@yongdall/types' */
+/** @import {Connections, Hooks, Providers, ProvidersConverted} from './types.mjs' */
+/**
+* @returns {[
+* Hooks['providers'],
+* Hooks['providerDefines'],
+* ]}
+*/
+function getProviders() {
+	/** @type {[string, Hooks['providers'][keyof Hooks['providers']]][]} */
+	const list = [...hooks.get("providers").values()].flatMap((v) => v ? Object.entries(v) : []);
+	const allProviders = Object.assign(Object.create(null), Object.fromEntries(Object.entries(Object.groupBy(list, (v) => v[0])).map(([t, v]) => [t, v ? Object.assign(Object.create(null), ...v.map((v) => v[1])) : Object.create(null)])));
+	/** @type {[string, Hooks['providerDefines'][keyof Hooks['providerDefines']]][]} */
+	const list0 = [...hooks.get("providerDefines").values()].flatMap((v) => v ? Object.entries(v) : []);
+	return [allProviders, Object.assign(Object.create(null), Object.fromEntries(list0))];
+}
+let [allProviders, allDefines] = getProviders();
+hooks.listen(() => {
+	[allProviders, allDefines] = getProviders();
+}, -1e6);
+/**
+* @type {Record<string, { [K in keyof ProvidersConverted]: Record<string, Promise<ProvidersConverted[K]>>}>}
+*/
+let allConnections = Object.create(null);
+/**
+* 
+* @template {string} K
+* @param {K} type
+* @param {string} name 
+* @param {Tenant?} [tenant] 
+*/
+async function clear(type, name, tenant) {
+	const tenantId = (tenant || await useTenant()).id;
+	const tenantConnections = allConnections[tenantId];
+	if (!tenantConnections) return;
+	const connections = tenantConnections[type];
+	if (!connections) return;
+	const db = connections[name];
+	delete connections[name];
+	return (await db)?.abort?.();
+}
+async function stop() {
+	const oldConnections = allConnections;
+	allConnections = Object.create(null);
+	for (const tenantConnections of Object.values(oldConnections)) for (const connections of Object.values(tenantConnections)) for (const db of Object.values(connections)) (await db)?.abort?.();
+}
+/**
+* 
+* @template {string} T
+* @param {T} type
+* @param {string} name 
+* @param {Tenant} tenant 
+* @returns {Promise<string | null | void>}
+*/
+async function getUri(type, name, tenant) {
+	if (!name) {
+		const provider = tenant.providers[type];
+		return typeof provider === "string" && provider || null;
+	}
+	const model = await getModel("database");
+	if (!model) return;
+	let sql = new Query(model, true).where("type", type).where("name", name);
+	return (await connect("rdb", "", tenant).first(sql.select("uri")))?.uri;
+}
+/**
+* @template {string & keyof Providers} K
+* @param {K} type 
+* @param {string} name 
+* @param {Tenant} tenant
+*/
+async function link(type, name, tenant) {
+	const providers = allProviders[type];
+	if (!providers) throw new Error(`不支持 ${type} 类型`);
+	const uri = await getUri(type, name, tenant);
+	if (!uri || typeof uri !== "string") {
+		/** @type {ProvidersConverted[K] | Providers[K]} */
+		const conn = allDefines[type]?.default;
+		if (!conn) throw new Error(`找不到 URI (${type}, ${name})`);
+		return conn;
+	}
+	const protocol = uri.split(":", 1)[0].split("+", 1)[0].toLowerCase();
+	const provider = providers[protocol];
+	if (typeof provider !== "function") throw new Error(`不支持 ${protocol} 协议`);
+	const promise = await provider(uri);
+	/** @type {ProvidersConverted[K] | Providers[K]} */
+	const conn = allDefines[type]?.convert?.(promise) || promise;
+	if (!conn) throw new Error();
+	return conn;
+}
+/**
+* 
+* @template {string & keyof Providers} K
+* @param {K} type
+* @param {string} [dbId] 
+* @param {Tenant?} [tenant] 
+*/
+async function findConnection(type, dbId, tenant) {
+	const currentTenant = tenant || await useTenant();
+	const tenantId = currentTenant.id;
+	let tenantConnections = allConnections[tenantId];
+	if (!tenantConnections) {
+		tenantConnections = Object.create(null);
+		allConnections[type] = tenantConnections;
+	}
+	/** @type {Record<string, Promise<ProvidersConverted[K]>>} */
+	let connections = tenantConnections[type];
+	if (!connections) {
+		connections = Object.create(null);
+		tenantConnections[type] = connections;
+	}
+	const dbName = String(dbId || "");
+	const connection = connections[dbName];
+	if (connection) return connection;
+	const conn = link(type, dbName, currentTenant);
+	connections[dbName] = conn;
+	return conn;
+}
+/**
+* 
+* @template {string} K
+* @param {K} type
+* @param {string} [dbId] 
+* @param {Tenant?} [tenant] 
+* @returns {Connections[K]}
+*/
+function connect(type, dbId, tenant) {
+	const res = allDefines[type]?.connect?.(findConnection(type, dbId, tenant));
+	if (!res) throw new Error();
+	return res;
+}
+const [dbGetter, dbSetter] = createStore(null);
+/**
+* @template {string & keyof ProvidersConverted} T
+* @param {T} type
+* @param {string?} [dbId]
+* @returns {Connections[T]}
+*/
+function useConnection(type, dbId) {
+	has(true);
+	let dbs = dbGetter();
+	if (!dbs) {
+		dbs = {};
+		dbSetter(dbs);
+	}
+	let typed = dbs[type];
+	if (!typed) {
+		typed = {};
+		dbs[type] = typed;
+	}
+	const dbName = String(dbId || "");
+	if (Object.hasOwn(typed, dbName)) return typed[dbName];
+	const db = connect(type, dbName);
+	typed[dbName] = db;
+	addFinally(() => {
+		db.abort?.();
+	});
+	return db;
+}
+
+//#endregion
+//#region packages/connection/rdb.mjs
+/**
+* @param {string?} [dbId]
+*/
+function useDatabase(dbId) {
+	return useConnection("rdb", dbId);
+}
+/**
+* 
+* @param  {...string | null | (string | null)[]} names 
+*/
+function transaction(...names) {
+	const allNames = new Set(names.flat().filter((v) => v && typeof v === "string" || v === null));
+	if (!allNames.size) allNames.add(null);
+	/**
+	* @template {any[]} P
+	* @template {any} R
+	* @template {any} T
+	* @param {(this:T, ...p: P) => Promise<R>} f
+	* @param {ClassMethodDecoratorContext} ctx
+	* @returns {(this:T, ...p: P) => Promise<R>}
+	*/
+	return function decorator(f, ctx) {
+		if (typeof f !== "function") throw new Error("事务修饰器只能加在方法上");
+		if (ctx.kind !== "method") throw new Error("事务修饰器只能加在方法上");
+		let fn = f;
+		for (const name of allNames) fn = async function(...p) {
+			return useDatabase(name).transaction((signal) => {
+				return f.apply(this, p);
+			});
+		};
+		return fn;
+	};
+}
+
+//#endregion
+//#region packages/connection/mq.mjs
+/** @import { Tenant } from '@yongdall/types' */
+/**
+* 
+* @param {string} channel 
+* @param {any} message 
+* @param {string} [service] 
+* @param {Tenant?} [tenant]
+*/
+async function publishMessage(channel, message, service, tenant) {
+	return connect("mq", service, tenant).publish(channel, message);
+}
+/**
+* 
+* @param {string} channel 
+* @param {(val: any) => any} listener
+* @param {string} [service] 
+*/
+function subscribeMessage(channel, listener, service) {
+	return connect("mq", service).subscribe(channel, listener);
+}
+
+//#endregion
+//#region packages/connection/tq.mjs
+/** @import { Tenant } from '@yongdall/types' */
+/**
+* 
+* @param {string} queue 
+* @param {any} message 
+* @param {string} [service] 
+* @param {Tenant?} [tenant]
+*/
+async function publishTask(queue, message, service, tenant) {
+	return connect("tq", service, tenant).publish(queue, message);
+}
+/**
+* @template T
+* @param {string} queue 
+* @param {string} [service] 
+* @returns {Promise<T | void>}
+*/
+function waitTask(queue, service) {
+	return connect("tq", service).get(queue);
+}
+
+//#endregion
+export { clear, connect, publishMessage, publishTask, stop, subscribeMessage, transaction, useConnection, useDatabase, waitTask };
+//# sourceMappingURL=index.mjs.map

package/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../packages/connection/main.mjs","../../packages/connection/rdb.mjs","../../packages/connection/mq.mjs","../../packages/connection/tq.mjs"],"sourcesContent":["import { addFinally, createStore, has } from '@yongdall/context';\nimport { getModel, useTenant, hooks } from '@yongdall/core';\nimport { Query } from '@yongdall/model';\n/** @import { Tenant } from '@yongdall/types' */\n\n/** @import {Connections, Hooks, Providers, ProvidersConverted} from './types.mjs' */\n\n\n\n\n/**\n * @returns {[\n * Hooks['providers'],\n * Hooks['providerDefines'],\n * ]}\n */\nfunction getProviders() {\n\n\t/** @type {[string, Hooks['providers'][keyof Hooks['providers']]][]} */\n\tconst list = [...hooks.get('providers').values()].flatMap(v => v ? Object.entries(v) : []);\n\tconst allProviders = Object.assign(Object.create(null), Object.fromEntries(\n\t\tObject.entries(Object.groupBy(list, v => v[0])).map(([t, v]) => [\n\t\t\tt, v ? Object.assign(Object.create(null), ...v.map(v => v[1])) : Object.create(null)\n\t\t]),\n\t));\n\t/** @type {[string, Hooks['providerDefines'][keyof Hooks['providerDefines']]][]} */\n\tconst list0 = [...hooks.get('providerDefines').values()].flatMap(v => v ? Object.entries(v) : []);\n\tconst allDefines = Object.assign(Object.create(null), Object.fromEntries(list0));\n\n\n\treturn [allProviders, allDefines];\n}\nlet [allProviders, allDefines] = getProviders();\nhooks.listen(() => {\n\t[allProviders, allDefines] = getProviders();\n}, -1000000);\n\n\n/**\n * @type {Record<string, { [K in keyof ProvidersConverted]: Record<string, Promise<ProvidersConverted[K]>>}>}\n */\nlet allConnections = Object.create(null);\n/**\n * \n * @template {string} K\n * @param {K} type\n * @param {string} name \n * @param {Tenant?} [tenant] \n */\nexport async function clear(type, name, tenant) {\n\tconst tenantId = (tenant || await useTenant()).id;\n\tconst tenantConnections = allConnections[tenantId];\n\tif (!tenantConnections) { return; }\n\tconst connections = tenantConnections[type];\n\tif (!connections) { return; }\n\tconst db = connections[name];\n\tdelete connections[name];\n\tconst k = await db;\n\treturn k?.abort?.();\n}\nexport async function stop() {\n\tconst oldConnections = allConnections;\n\tallConnections = Object.create(null);\n\tfor (const tenantConnections of Object.values(oldConnections)) {\n\t\tfor (const connections of Object.values(tenantConnections)) {\n\t\t\tfor (const db of Object.values(connections)) {\n\t\t\t\tconst k = await db;\n\t\t\t\tk?.abort?.();\n\t\t\t}\n\t\t}\n\t}\n\n}\n/**\n * \n * @template {string} T\n * @param {T} type\n * @param {string} name \n * @param {Tenant} tenant \n * @returns {Promise<string | null | void>}\n */\nasync function getUri(type, name, tenant) {\n\tif (!name) {\n\t\tconst provider = tenant.providers[type];\n\t\treturn typeof provider === 'string' && provider || null;\n\t}\n\tconst model = await getModel('database');\n\tif (!model) { return; }\n\tconst modelQuery = new Query(model, true);\n\tlet sql = modelQuery.where('type', type).where('name', name);\n\tconst a = await connect('rdb', '', tenant).first(sql.select('uri'));\n\treturn a?.uri;\n}\n\n/**\n * @template {string & keyof Providers} K\n * @param {K} type \n * @param {string} name \n * @param {Tenant} tenant\n */\nasync function link(type, name, tenant) {\n\tconst providers = allProviders[type];\n\tif (!providers) { throw new Error(`不支持 ${type} 类型`); }\n\tconst uri = await getUri(type, name, tenant);\n\tif (!uri || typeof uri !== 'string') {\n\t\t/** @type {ProvidersConverted[K] | Providers[K]} */\n\t\tconst conn = allDefines[type]?.default\n\t\tif (!conn) {\n\t\t\tthrow new Error(`找不到 URI (${type}, ${name})`);\n\t\t}\n\t\treturn conn;\n\t}\n\n\n\tconst protocol = uri.split(':', 1)[0].split('+', 1)[0].toLowerCase();\n\tconst provider = providers[protocol];\n\tif (typeof provider !== 'function') {\n\t\tthrow new Error(`不支持 ${protocol} 协议`);\n\t}\n\tconst promise = await provider(uri);\n\t/** @type {ProvidersConverted[K] | Providers[K]} */\n\tconst conn = allDefines[type]?.convert?.(promise) || promise;\n\tif (!conn) { throw new Error(); }\n\treturn conn;\n\n};\n\n/**\n * \n * @template {string & keyof Providers} K\n * @param {K} type\n * @param {string} [dbId] \n * @param {Tenant?} [tenant] \n */\nasync function findConnection(type, dbId, tenant) {\n\tconst currentTenant = tenant || await useTenant();\n\tconst tenantId = currentTenant.id;\n\tlet tenantConnections = allConnections[tenantId];\n\tif (!tenantConnections) {\n\t\ttenantConnections = Object.create(null);\n\t\tallConnections[type] = tenantConnections;\n\t}\n\t// TODO: 实现多组合支持\n\t/** @type {Record<string, Promise<ProvidersConverted[K]>>} */\n\tlet connections = tenantConnections[type];\n\tif (!connections) {\n\t\tconnections = Object.create(null);\n\t\ttenantConnections[type] = connections;\n\t}\n\tconst dbName = String(dbId || '');\n\tconst connection = connections[dbName];\n\tif (connection) { return connection; }\n\tconst conn = link(type, dbName, currentTenant);\n\tconnections[dbName] = conn;\n\treturn conn;\n}\n\n/**\n * \n * @template {string} K\n * @param {K} type\n * @param {string} [dbId] \n * @param {Tenant?} [tenant] \n * @returns {Connections[K]}\n */\nexport function connect(type, dbId, tenant) {\n\tconst res = allDefines[type]?.connect?.(findConnection(type, dbId, tenant));\n\tif (!res) {\n\t\tthrow new Error();\n\t}\n\treturn res;\n}\n\n\n\nconst [dbGetter, dbSetter] = createStore(/** @type {{ [K in keyof Connections]?: Record<String, Connections[K]>}?} */(null));\n\n/**\n * @template {string & keyof ProvidersConverted} T\n * @param {T} type\n * @param {string?} [dbId]\n * @returns {Connections[T]}\n */\nexport function useConnection(type, dbId) {\n\thas(true);\n\tlet dbs = dbGetter();\n\tif (!dbs) {\n\t\tdbs = {};\n\t\tdbSetter(dbs);\n\t}\n\tlet typed = dbs[type];\n\tif (!typed) {\n\t\ttyped = {};\n\t\tdbs[type] = typed;\n\t}\n\tconst dbName = String(dbId || '');\n\tif (Object.hasOwn(typed, dbName)) {\n\t\treturn typed[dbName];\n\t}\n\tconst db = connect(type, dbName);\n\ttyped[dbName] = db;\n\taddFinally(() => { db.abort?.(); });\n\treturn db;\n}\n","import { useConnection } from './main.mjs';\n\n\n\n/**\n * @param {string?} [dbId]\n */\nexport function useDatabase(dbId) {\n\treturn useConnection('rdb', dbId);\n}\n\n/**\n * \n * @param  {...string | null | (string | null)[]} names \n */\nexport function transaction(...names) {\n\tconst allNames = new Set(names.flat().filter(v => v && typeof v === 'string' || v === null));\n\tif (!allNames.size) {\n\t\tallNames.add(null);\n\t}\n\t/**\n\t * @template {any[]} P\n\t * @template {any} R\n\t * @template {any} T\n\t * @param {(this:T, ...p: P) => Promise<R>} f\n\t * @param {ClassMethodDecoratorContext} ctx\n\t * @returns {(this:T, ...p: P) => Promise<R>}\n\t */\n\treturn function decorator(f, ctx) {\n\t\t// TODO: 修饰器\n\t\tif (typeof f !== 'function') {\n\t\t\tthrow new Error('事务修饰器只能加在方法上');\n\t\t}\n\t\tif (ctx.kind !== 'method') {\n\t\t\tthrow new Error('事务修饰器只能加在方法上');\n\t\t}\n\t\tlet fn = f;\n\t\tfor (const name of allNames) {\n\t\t\tfn = async function(...p) {\n\t\t\t\treturn useDatabase(name).transaction(signal => {\n\t\t\t\t\treturn f.apply(this, p);\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\treturn fn;\n\t}\n}\n","import { connect } from './main.mjs';\n/** @import { Tenant } from '@yongdall/types' */\n\n/**\n * \n * @param {string} channel \n * @param {any} message \n * @param {string} [service] \n * @param {Tenant?} [tenant]\n */\nexport async function publishMessage(channel, message, service, tenant) {\n\treturn connect('mq', service, tenant).publish(channel, message);\n}\n\n\n\n/**\n * \n * @param {string} channel \n * @param {(val: any) => any} listener\n * @param {string} [service] \n */\nexport function subscribeMessage(channel, listener, service) {\n\treturn connect('mq', service).subscribe(channel, listener);\n}\n","import { connect } from './main.mjs';\n/** @import { Tenant } from '@yongdall/types' */\n\n/**\n * \n * @param {string} queue \n * @param {any} message \n * @param {string} [service] \n * @param {Tenant?} [tenant]\n */\nexport async function publishTask(queue, message, service, tenant) {\n\treturn connect('tq', service, tenant).publish(queue, message);\n}\n\n/**\n * @template T\n * @param {string} queue \n * @param {string} [service] \n * @returns {Promise<T | void>}\n */\nexport function waitTask(queue, service) {\n\treturn connect('tq', service).get(queue);\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@yongdall/connection",
+  "type": "module",
+  "main": "./index.mjs",
+  "exports": {
+    ".": "./index.mjs"
+  },
+  "version": "0.1.0",
+  "description": "",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@yongdall/common": "^0.1.0",
+    "@yongdall/context": "^0.1.0",
+    "@yongdall/core": "^0.1.0",
+    "@yongdall/model": "^0.1.0"
+  },
+  "devDependencies": {
+    "@yongdall/types": "^0.1.0"
+  }
+}

package/types.d.mts

@@ -0,0 +1,186 @@
+import { Hook } from "@yongdall/common";
+import { Connection, IConnection, MaybePromise } from "@yongdall/model";
+import { Readable } from "node:stream";
+import { Tenant } from "@yongdall/types";
+import * as imodel0 from "imodel";
+
+//#region packages/connection/main.d.mts
+/**
+ *
+ * @template {string} K
+ * @param {K} type
+ * @param {string} name
+ * @param {Tenant?} [tenant]
+ */
+declare function clear<K extends string>(type: K, name: string, tenant?: Tenant | null): Promise<void>;
+declare function stop(): Promise<void>;
+/**
+ *
+ * @template {string} K
+ * @param {K} type
+ * @param {string} [dbId]
+ * @param {Tenant?} [tenant]
+ * @returns {Connections[K]}
+ */
+declare function connect<K extends string>(type: K, dbId?: string, tenant?: Tenant | null): Connections[K];
+/**
+ * @template {string & keyof ProvidersConverted} T
+ * @param {T} type
+ * @param {string?} [dbId]
+ * @returns {Connections[T]}
+ */
+declare function useConnection<T extends string & keyof ProvidersConverted>(type: T, dbId?: string | null): Connections[T];
+//#endregion
+//#region packages/connection/rdb.d.mts
+/**
+ * @param {string?} [dbId]
+ */
+declare function useDatabase(dbId?: string | null): imodel0.Connection<any>;
+/**
+ *
+ * @param  {...string | null | (string | null)[]} names
+ */
+declare function transaction(...names: (string | null | (string | null)[])[]): (f: (this: T, ...p: P) => Promise<R>, ctx: ClassMethodDecoratorContext) => (this: T, ...p: P) => Promise<R>;
+//#endregion
+//#region packages/connection/mq.d.mts
+/** @import { Tenant } from '@yongdall/types' */
+/**
+ *
+ * @param {string} channel
+ * @param {any} message
+ * @param {string} [service]
+ * @param {Tenant?} [tenant]
+ */
+declare function publishMessage(channel: string, message: any, service?: string, tenant?: Tenant | null): Promise<void>;
+/**
+ *
+ * @param {string} channel
+ * @param {(val: any) => any} listener
+ * @param {string} [service]
+ */
+declare function subscribeMessage(channel: string, listener: (val: any) => any, service?: string): () => void;
+//#endregion
+//#region packages/connection/tq.d.mts
+/** @import { Tenant } from '@yongdall/types' */
+/**
+ *
+ * @param {string} queue
+ * @param {any} message
+ * @param {string} [service]
+ * @param {Tenant?} [tenant]
+ */
+declare function publishTask(queue: string, message: any, service?: string, tenant?: Tenant | null): Promise<void>;
+/**
+ * @template T
+ * @param {string} queue
+ * @param {string} [service]
+ * @returns {Promise<T | void>}
+ */
+declare function waitTask<T>(queue: string, service?: string): Promise<T | void>;
+//#endregion
+//#region packages/connection/types.d.mts
+type Provider<T> = (uri: string) => T | PromiseLike<T>;
+interface MessageQueue {
+  publish(channel: string, data: any): void;
+  subscribe(channel: string, subscriber: (data: any) => void): PromiseLike<() => void> | (() => void);
+}
+interface TaskQueue {
+  publish(queue: string, data: any): void;
+  get<T>(queue: string): PromiseLike<T | void> | T | void;
+  disconnect(): void;
+}
+interface Cache {
+  set(key: string, field: string, value: any): PromiseLike<void> | void;
+  get<T>(key: string, field: string): PromiseLike<T | void> | T | void;
+  exists(key: string, field: string): PromiseLike<boolean> | boolean;
+  del(key: string, field: string): PromiseLike<void> | void;
+  clear(key: string): PromiseLike<void> | void;
+  disconnect(): void;
+}
+interface FileStore {
+  read(path: string): Promise<ReadableStream>;
+  write(path: string, data: ReadableStream | Blob | ArrayBufferView | ArrayBuffer | string | Buffer | Readable, size?: number): Promise<void>;
+  urlRead(path: string, expires?: number): Promise<string>;
+  urlWrite(path: string, expires?: number): Promise<string>;
+  abort?(): void;
+}
+interface Providers {
+  rdb: IConnection<any>;
+  tq: TaskQueue;
+  mq: MessageQueue;
+  fs: FileStore;
+  cache: Cache;
+  [k: string]: unknown;
+}
+interface ProvidersConverted {
+  rdb: IConnection<any> & {
+    abort?(): void;
+  };
+  tq: {
+    channels: Map<string, Promise<void>>;
+    service: TaskQueue;
+    abort?(): void;
+  };
+  mq: {
+    channels: Map<string, {
+      listeners: Set<(val: any) => any>;
+      promise: Promise<(() => void) | null>;
+      run: (value: any) => void;
+    }>;
+    service: MessageQueue;
+    abort?(): void;
+  };
+  fs: FileStore & {
+    abort?(): void;
+  };
+  cache: Omit<Cache, 'disconnect'> & {
+    abort(): void;
+  };
+  [k: string]: {
+    abort?(): void;
+  };
+}
+interface Connections {
+  rdb: Connection<any>;
+  tq: {
+    publish(queue: string, data: any): Promise<void>;
+    get<T>(queue: string): Promise<T | void>;
+    abort?(): void;
+  };
+  mq: {
+    publish(channel: string, data: any): Promise<void>;
+    subscribe(channel: string, subscriber: (data: any) => void): () => void;
+    abort?(): void;
+  };
+  fs: FileStore & {
+    abort?(): void;
+  };
+  cache: {
+    set(key: string, field: string, value: any): PromiseLike<void>;
+    get<T>(key: string, field: string): PromiseLike<T | void>;
+    exists(key: string, field: string): PromiseLike<boolean>;
+    del(key: string, field: string): PromiseLike<void>;
+    clear(key: string): PromiseLike<void>;
+    memoize<T>(key: string, field: string, exec: () => PromiseLike<T> | T): PromiseLike<T>;
+    abort?(): void;
+  };
+  [k: string]: {
+    abort?(): void;
+  };
+}
+/** 应用配置 */
+interface Hooks {
+  providers: { [K in keyof Providers]: Record<string, Provider<Providers[K]>> };
+  providerDefines: { [K in keyof ProvidersConverted]: {
+    label: string;
+    convert: (vla: Providers[K]) => MaybePromise<ProvidersConverted[K]>;
+    connect: (vla: Promise<ProvidersConverted[K]>) => Connections[K];
+    default: ProvidersConverted[K];
+  } };
+}
+declare namespace Hooks {
+  type providers = Hook.Define<Hooks['providers']>;
+  type providerDefines = Hook.Define<Hooks['providerDefines']>;
+}
+//#endregion
+export { Cache, Connections, FileStore, Hooks, MessageQueue, Provider, Providers, ProvidersConverted, TaskQueue, clear, connect, publishMessage, publishTask, stop, subscribeMessage, transaction, useConnection, useDatabase, waitTask };