@hot-updater/server 1.0.0-rc.1 → 1.0.0-rc.16

package/dist/plugins/api-keys/index.mjs

@@ -0,0 +1,47 @@
+import { authenticateApiKey, createApiKeyManagement, normalizeApiKeyHeaderName, provisionApiKey, registerApiKey } from "../../apiKeys.mjs";
+import { markBuiltIn } from "../builtIn.mjs";
+import { definePlugin } from "../definePlugin.mjs";
+import { createApiKeyModel } from "./model.mjs";
+import { apiKeysSchema } from "./schema.mjs";
+//#region src/plugins/api-keys/index.ts
+/**
+* Built-in API keys: protects client routes with keys whose SHA-256 digests
+* are stored, and manages them in-process.
+*/
+const apiKeys = (options = {}) => {
+	const headerName = normalizeApiKeyHeaderName(options.headerName ?? "x-api-key");
+	return markBuiltIn(definePlugin({
+		id: "apiKeys",
+		provides: { clientAuth: true },
+		schemaVersion: "1.0.0",
+		schema: apiKeysSchema,
+		init: ({ db }) => {
+			const model = createApiKeyModel(db);
+			return {
+				api: {
+					...createApiKeyManagement({ apiKeys: model }),
+					/** Registers a known plaintext key idempotently, for managed init. */
+					register: (input) => registerApiKey({
+						...input,
+						apiKeys: model
+					}),
+					/** Reuses a saved key or creates one, for managed init. */
+					provision: (input) => provisionApiKey({
+						...input,
+						apiKeys: model
+					})
+				},
+				clientAuth: {
+					varyHeaders: [headerName],
+					authenticate: (headers) => authenticateApiKey({
+						apiKeys: model,
+						headerName,
+						request: { headers }
+					})
+				}
+			};
+		}
+	}));
+};
+//#endregion
+export { apiKeys, apiKeysSchema, createApiKeyModel };

package/dist/plugins/api-keys/model.cjs

@@ -0,0 +1,58 @@
+const require_errors = require("../../database/errors.cjs");
+//#region src/plugins/api-keys/model.ts
+const toRow = (row) => ({
+	id: row.id,
+	hash: row.hash,
+	name: row.name,
+	prefix: row.prefix,
+	role: row.role,
+	created_at_ms: row.created_at_ms,
+	revoked_at_ms: row.revoked_at_ms
+});
+/** Today's `ApiKeyModel` on the engine: one unique read by hash, keyed writes. */
+const createApiKeyModel = (db) => ({
+	async create(row) {
+		try {
+			return await db.transaction(async (tx) => {
+				if (await tx.findOne("api_keys", { hash: row.hash }) !== null) return "existing";
+				tx.create("api_keys", row);
+				return "created";
+			});
+		} catch (error) {
+			if (error instanceof require_errors.DatabaseConstraintError && error.reason === "unique") return "existing";
+			throw error;
+		}
+	},
+	async findByHash(hash) {
+		const row = await db.findOne("api_keys", { hash });
+		return row === null ? null : toRow(row);
+	},
+	/** Every key, newest first, then by id; the whole list is the result. */
+	async list() {
+		const rows = [];
+		let cursor;
+		do {
+			const page = await db.findMany("api_keys", {
+				index: "byCreated",
+				where: {},
+				order: "desc",
+				limit: 500,
+				...cursor === void 0 ? {} : { cursor }
+			});
+			rows.push(...page.rows.map(toRow));
+			cursor = page.next;
+		} while (cursor !== void 0);
+		return rows.sort((left, right) => right.created_at_ms - left.created_at_ms || (left.id < right.id ? -1 : left.id > right.id ? 1 : 0));
+	},
+	revoke: ({ id, revokedAtMs }) => db.transaction(async (tx) => {
+		const row = await tx.findOne("api_keys", { id });
+		if (row === null) return null;
+		tx.update("api_keys", row, { revoked_at_ms: revokedAtMs });
+		return toRow({
+			...row,
+			revoked_at_ms: revokedAtMs
+		});
+	})
+});
+//#endregion
+exports.createApiKeyModel = createApiKeyModel;

package/dist/plugins/api-keys/model.d.cts

@@ -0,0 +1,8 @@
+import { HotUpdaterDatabase } from "../../database/database.cjs";
+import { ApiKeysSchema } from "./schema.cjs";
+import { ApiKeyModel } from "@hot-updater/plugin-core";
+//#region src/plugins/api-keys/model.d.ts
+/** Today's `ApiKeyModel` on the engine: one unique read by hash, keyed writes. */
+declare const createApiKeyModel: (db: HotUpdaterDatabase<ApiKeysSchema>) => ApiKeyModel;
+//#endregion
+export { createApiKeyModel };

package/dist/plugins/api-keys/model.d.mts

@@ -0,0 +1,8 @@
+import { HotUpdaterDatabase } from "../../database/database.mjs";
+import { ApiKeysSchema } from "./schema.mjs";
+import { ApiKeyModel } from "@hot-updater/plugin-core";
+//#region src/plugins/api-keys/model.d.ts
+/** Today's `ApiKeyModel` on the engine: one unique read by hash, keyed writes. */
+declare const createApiKeyModel: (db: HotUpdaterDatabase<ApiKeysSchema>) => ApiKeyModel;
+//#endregion
+export { createApiKeyModel };

package/dist/plugins/api-keys/model.mjs

@@ -0,0 +1,58 @@
+import { DatabaseConstraintError } from "../../database/errors.mjs";
+//#region src/plugins/api-keys/model.ts
+const toRow = (row) => ({
+	id: row.id,
+	hash: row.hash,
+	name: row.name,
+	prefix: row.prefix,
+	role: row.role,
+	created_at_ms: row.created_at_ms,
+	revoked_at_ms: row.revoked_at_ms
+});
+/** Today's `ApiKeyModel` on the engine: one unique read by hash, keyed writes. */
+const createApiKeyModel = (db) => ({
+	async create(row) {
+		try {
+			return await db.transaction(async (tx) => {
+				if (await tx.findOne("api_keys", { hash: row.hash }) !== null) return "existing";
+				tx.create("api_keys", row);
+				return "created";
+			});
+		} catch (error) {
+			if (error instanceof DatabaseConstraintError && error.reason === "unique") return "existing";
+			throw error;
+		}
+	},
+	async findByHash(hash) {
+		const row = await db.findOne("api_keys", { hash });
+		return row === null ? null : toRow(row);
+	},
+	/** Every key, newest first, then by id; the whole list is the result. */
+	async list() {
+		const rows = [];
+		let cursor;
+		do {
+			const page = await db.findMany("api_keys", {
+				index: "byCreated",
+				where: {},
+				order: "desc",
+				limit: 500,
+				...cursor === void 0 ? {} : { cursor }
+			});
+			rows.push(...page.rows.map(toRow));
+			cursor = page.next;
+		} while (cursor !== void 0);
+		return rows.sort((left, right) => right.created_at_ms - left.created_at_ms || (left.id < right.id ? -1 : left.id > right.id ? 1 : 0));
+	},
+	revoke: ({ id, revokedAtMs }) => db.transaction(async (tx) => {
+		const row = await tx.findOne("api_keys", { id });
+		if (row === null) return null;
+		tx.update("api_keys", row, { revoked_at_ms: revokedAtMs });
+		return toRow({
+			...row,
+			revoked_at_ms: revokedAtMs
+		});
+	})
+});
+//#endregion
+export { createApiKeyModel };

package/dist/plugins/api-keys/schema.cjs

@@ -0,0 +1,38 @@
+//#region src/plugins/api-keys/schema.ts
+/** v1's `api_keys` columns; the plaintext key is never stored, only its SHA-256 digest. */
+const apiKeysSchema = { api_keys: require("../../database/schema.cjs").defineTable({
+	id: {
+		type: "string",
+		maxLength: 255
+	},
+	hash: {
+		type: "string",
+		maxLength: 64,
+		unique: true
+	},
+	name: {
+		type: "string",
+		maxLength: 64
+	},
+	prefix: {
+		type: "string",
+		maxLength: 16
+	},
+	role: {
+		type: "string",
+		maxLength: 16
+	},
+	created_at_ms: { type: "integer" },
+	revoked_at_ms: {
+		type: "integer",
+		required: false
+	}
+}, {
+	key: ["id"],
+	indexes: { byCreated: {
+		eq: [],
+		sort: ["created_at_ms"]
+	} }
+}) };
+//#endregion
+exports.apiKeysSchema = apiKeysSchema;

package/dist/plugins/api-keys/schema.d.cts

@@ -0,0 +1,44 @@
+import { TableDefinition } from "../../database/schema.cjs";
+import "../index.cjs";
+//#region src/plugins/api-keys/schema.d.ts
+/** v1's `api_keys` columns; the plaintext key is never stored, only its SHA-256 digest. */
+declare const apiKeysSchema: {
+  readonly api_keys: TableDefinition<{
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly hash: {
+      readonly type: "string";
+      readonly maxLength: 64;
+      readonly unique: true;
+    };
+    readonly name: {
+      readonly type: "string";
+      readonly maxLength: 64;
+    };
+    readonly prefix: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly role: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly created_at_ms: {
+      readonly type: "integer";
+    };
+    readonly revoked_at_ms: {
+      readonly type: "integer";
+      readonly required: false;
+    };
+  }, {}, {
+    readonly byCreated: {
+      readonly eq: readonly [];
+      readonly sort: readonly ["created_at_ms"];
+    };
+  }, readonly ["id"]>;
+};
+type ApiKeysSchema = typeof apiKeysSchema;
+//#endregion
+export { ApiKeysSchema, apiKeysSchema };

package/dist/plugins/api-keys/schema.d.mts

@@ -0,0 +1,44 @@
+import { TableDefinition } from "../../database/schema.mjs";
+import "../index.mjs";
+//#region src/plugins/api-keys/schema.d.ts
+/** v1's `api_keys` columns; the plaintext key is never stored, only its SHA-256 digest. */
+declare const apiKeysSchema: {
+  readonly api_keys: TableDefinition<{
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly hash: {
+      readonly type: "string";
+      readonly maxLength: 64;
+      readonly unique: true;
+    };
+    readonly name: {
+      readonly type: "string";
+      readonly maxLength: 64;
+    };
+    readonly prefix: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly role: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly created_at_ms: {
+      readonly type: "integer";
+    };
+    readonly revoked_at_ms: {
+      readonly type: "integer";
+      readonly required: false;
+    };
+  }, {}, {
+    readonly byCreated: {
+      readonly eq: readonly [];
+      readonly sort: readonly ["created_at_ms"];
+    };
+  }, readonly ["id"]>;
+};
+type ApiKeysSchema = typeof apiKeysSchema;
+//#endregion
+export { ApiKeysSchema, apiKeysSchema };

package/dist/plugins/api-keys/schema.mjs

@@ -0,0 +1,39 @@
+import { defineTable } from "../../database/schema.mjs";
+//#region src/plugins/api-keys/schema.ts
+/** v1's `api_keys` columns; the plaintext key is never stored, only its SHA-256 digest. */
+const apiKeysSchema = { api_keys: defineTable({
+	id: {
+		type: "string",
+		maxLength: 255
+	},
+	hash: {
+		type: "string",
+		maxLength: 64,
+		unique: true
+	},
+	name: {
+		type: "string",
+		maxLength: 64
+	},
+	prefix: {
+		type: "string",
+		maxLength: 16
+	},
+	role: {
+		type: "string",
+		maxLength: 16
+	},
+	created_at_ms: { type: "integer" },
+	revoked_at_ms: {
+		type: "integer",
+		required: false
+	}
+}, {
+	key: ["id"],
+	indexes: { byCreated: {
+		eq: [],
+		sort: ["created_at_ms"]
+	} }
+}) };
+//#endregion
+export { apiKeysSchema };

package/dist/plugins/builtIn.cjs

@@ -0,0 +1,7 @@
+//#region src/plugins/builtIn.ts
+/** Marks built-in plugins, whose tables keep their names instead of taking the plugin id as a namespace. */
+const builtInPlugin = Symbol.for("@hot-updater/server/built-in-plugin");
+const markBuiltIn = (plugin) => Object.defineProperty(plugin, builtInPlugin, { value: true });
+//#endregion
+exports.builtInPlugin = builtInPlugin;
+exports.markBuiltIn = markBuiltIn;

package/dist/plugins/builtIn.mjs

@@ -0,0 +1,6 @@
+//#region src/plugins/builtIn.ts
+/** Marks built-in plugins, whose tables keep their names instead of taking the plugin id as a namespace. */
+const builtInPlugin = Symbol.for("@hot-updater/server/built-in-plugin");
+const markBuiltIn = (plugin) => Object.defineProperty(plugin, builtInPlugin, { value: true });
+//#endregion
+export { builtInPlugin, markBuiltIn };

package/dist/plugins/definePlugin.cjs

@@ -0,0 +1,5 @@
+//#region src/plugins/definePlugin.ts
+/** Declares a plugin; built-in and third-party plugins use the same contract. */
+const definePlugin = (plugin) => plugin;
+//#endregion
+exports.definePlugin = definePlugin;

package/dist/plugins/definePlugin.d.cts

@@ -0,0 +1,73 @@
+import { ModuleSchema } from "../database/schema.cjs";
+import { HotUpdaterDatabase } from "../database/database.cjs";
+import { CoreReads } from "../core/reads.cjs";
+//#region src/plugins/definePlugin.d.ts
+type PluginEndpointMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+interface PluginEndpoint {
+  readonly method: PluginEndpointMethod;
+  /** Relative to the handler's mount; `:name` segments become `params`. */
+  readonly path: string;
+  /**
+   * `"client"` mounts on `handlers.client` behind the client-route policy;
+   * `"admin"` mounts on `handlers.admin`, which the host protects.
+   */
+  readonly access: "client" | "admin";
+  readonly handler: (request: Request, params: Readonly<Record<string, string>>) => Promise<Response>;
+}
+/** The client-route policy a plugin provides, such as API keys. */
+interface ClientAuth {
+  /** Request headers the decision reads; core adds them to `Vary` on cacheable client responses. */
+  readonly varyHeaders: readonly string[];
+  /** Whether the request may use client routes; a throw answers 503. */
+  authenticate(headers: Headers): Promise<boolean>;
+}
+interface PluginInstance<Api = unknown> {
+  readonly api: Api;
+  readonly endpoints?: readonly PluginEndpoint[];
+  readonly clientAuth?: ClientAuth;
+}
+/** Core's reads: bundles, Releases, Catalogs, and channels, each through a declared index. Plugins never write core. */
+type CoreReader = CoreReads;
+interface PluginContext<S extends ModuleSchema> {
+  /** The plugin's own tables and aggregates. */
+  readonly db: HotUpdaterDatabase<S>;
+  readonly core: CoreReader;
+  now(): number;
+}
+interface PluginProvides {
+  readonly clientAuth?: true;
+}
+/** An instance whose `clientAuth` matches what the plugin declares it provides. */
+type InstanceFor<TProvides, TInstance> = TProvides extends {
+  readonly clientAuth: true;
+} ? TInstance & {
+  readonly clientAuth: ClientAuth;
+} : TInstance & {
+  readonly clientAuth?: "Declare provides: { clientAuth: true } to return clientAuth";
+};
+interface HotUpdaterPlugin<TId extends string = string, TSchema extends ModuleSchema = ModuleSchema, TInstance extends PluginInstance = PluginInstance, TProvides extends PluginProvides = PluginProvides> {
+  readonly id: TId;
+  /** Static, so the type system and startup can count client-route policies. */
+  readonly provides?: TProvides;
+  /** Stored under the settings key `schema.<id>`. */
+  readonly schemaVersion: string;
+  readonly schema: TSchema;
+  /** Called once at startup, synchronously. */
+  init(context: PluginContext<TSchema>): TInstance;
+  /** Only core modules carry a kind. */
+  readonly kind?: "Core is built in; it is not a plugin";
+}
+/** Declares a plugin; built-in and third-party plugins use the same contract. */
+declare const definePlugin: <const TId extends string, const TSchema extends ModuleSchema, TInstance extends PluginInstance, const TProvides extends PluginProvides = {}>(plugin: {
+  readonly id: TId;
+  readonly provides?: TProvides;
+  readonly schemaVersion: string;
+  readonly schema: TSchema;
+  init(context: PluginContext<TSchema>): InstanceFor<TProvides, TInstance>;
+}) => HotUpdaterPlugin<TId, TSchema, TInstance, TProvides>;
+/** Any plugin, whatever its schema and API. */
+type AnyHotUpdaterPlugin = HotUpdaterPlugin<string, any, any, any>;
+/** Each plugin's API by id. */
+type PluginApis<TPlugins extends readonly AnyHotUpdaterPlugin[]> = { readonly [TPlugin in TPlugins[number] as TPlugin["id"]]: ReturnType<TPlugin["init"]>["api"]; };
+//#endregion
+export { AnyHotUpdaterPlugin, ClientAuth, CoreReader, HotUpdaterPlugin, InstanceFor, PluginApis, PluginContext, PluginEndpoint, PluginEndpointMethod, PluginInstance, PluginProvides, definePlugin };

package/dist/plugins/definePlugin.d.mts

@@ -0,0 +1,73 @@
+import { ModuleSchema } from "../database/schema.mjs";
+import { HotUpdaterDatabase } from "../database/database.mjs";
+import { CoreReads } from "../core/reads.mjs";
+//#region src/plugins/definePlugin.d.ts
+type PluginEndpointMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+interface PluginEndpoint {
+  readonly method: PluginEndpointMethod;
+  /** Relative to the handler's mount; `:name` segments become `params`. */
+  readonly path: string;
+  /**
+   * `"client"` mounts on `handlers.client` behind the client-route policy;
+   * `"admin"` mounts on `handlers.admin`, which the host protects.
+   */
+  readonly access: "client" | "admin";
+  readonly handler: (request: Request, params: Readonly<Record<string, string>>) => Promise<Response>;
+}
+/** The client-route policy a plugin provides, such as API keys. */
+interface ClientAuth {
+  /** Request headers the decision reads; core adds them to `Vary` on cacheable client responses. */
+  readonly varyHeaders: readonly string[];
+  /** Whether the request may use client routes; a throw answers 503. */
+  authenticate(headers: Headers): Promise<boolean>;
+}
+interface PluginInstance<Api = unknown> {
+  readonly api: Api;
+  readonly endpoints?: readonly PluginEndpoint[];
+  readonly clientAuth?: ClientAuth;
+}
+/** Core's reads: bundles, Releases, Catalogs, and channels, each through a declared index. Plugins never write core. */
+type CoreReader = CoreReads;
+interface PluginContext<S extends ModuleSchema> {
+  /** The plugin's own tables and aggregates. */
+  readonly db: HotUpdaterDatabase<S>;
+  readonly core: CoreReader;
+  now(): number;
+}
+interface PluginProvides {
+  readonly clientAuth?: true;
+}
+/** An instance whose `clientAuth` matches what the plugin declares it provides. */
+type InstanceFor<TProvides, TInstance> = TProvides extends {
+  readonly clientAuth: true;
+} ? TInstance & {
+  readonly clientAuth: ClientAuth;
+} : TInstance & {
+  readonly clientAuth?: "Declare provides: { clientAuth: true } to return clientAuth";
+};
+interface HotUpdaterPlugin<TId extends string = string, TSchema extends ModuleSchema = ModuleSchema, TInstance extends PluginInstance = PluginInstance, TProvides extends PluginProvides = PluginProvides> {
+  readonly id: TId;
+  /** Static, so the type system and startup can count client-route policies. */
+  readonly provides?: TProvides;
+  /** Stored under the settings key `schema.<id>`. */
+  readonly schemaVersion: string;
+  readonly schema: TSchema;
+  /** Called once at startup, synchronously. */
+  init(context: PluginContext<TSchema>): TInstance;
+  /** Only core modules carry a kind. */
+  readonly kind?: "Core is built in; it is not a plugin";
+}
+/** Declares a plugin; built-in and third-party plugins use the same contract. */
+declare const definePlugin: <const TId extends string, const TSchema extends ModuleSchema, TInstance extends PluginInstance, const TProvides extends PluginProvides = {}>(plugin: {
+  readonly id: TId;
+  readonly provides?: TProvides;
+  readonly schemaVersion: string;
+  readonly schema: TSchema;
+  init(context: PluginContext<TSchema>): InstanceFor<TProvides, TInstance>;
+}) => HotUpdaterPlugin<TId, TSchema, TInstance, TProvides>;
+/** Any plugin, whatever its schema and API. */
+type AnyHotUpdaterPlugin = HotUpdaterPlugin<string, any, any, any>;
+/** Each plugin's API by id. */
+type PluginApis<TPlugins extends readonly AnyHotUpdaterPlugin[]> = { readonly [TPlugin in TPlugins[number] as TPlugin["id"]]: ReturnType<TPlugin["init"]>["api"]; };
+//#endregion
+export { AnyHotUpdaterPlugin, ClientAuth, CoreReader, HotUpdaterPlugin, InstanceFor, PluginApis, PluginContext, PluginEndpoint, PluginEndpointMethod, PluginInstance, PluginProvides, definePlugin };

package/dist/plugins/definePlugin.mjs

@@ -0,0 +1,5 @@
+//#region src/plugins/definePlugin.ts
+/** Declares a plugin; built-in and third-party plugins use the same contract. */
+const definePlugin = (plugin) => plugin;
+//#endregion
+export { definePlugin };

package/dist/plugins/index.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../database/errors.cjs");
+const require_cursor = require("../database/cursor.cjs");
+const require_engineReads = require("../database/engineReads.cjs");
+const require_schema = require("../database/schema.cjs");
+const require_definePlugin = require("./definePlugin.cjs");
+const require_assemblePlugins = require("../assembly/assemblePlugins.cjs");
+exports.DatabaseAmbiguousCommitError = require_errors.DatabaseAmbiguousCommitError;
+exports.DatabaseConflictError = require_errors.DatabaseConflictError;
+exports.DatabaseConstraintError = require_errors.DatabaseConstraintError;
+exports.DatabaseCursorError = require_cursor.DatabaseCursorError;
+exports.DatabaseQueryError = require_engineReads.DatabaseQueryError;
+exports.DatabaseTransactionError = require_errors.DatabaseTransactionError;
+exports.HotUpdaterConfigError = require_assemblePlugins.HotUpdaterConfigError;
+exports.defineAggregate = require_schema.defineAggregate;
+exports.definePlugin = require_definePlugin.definePlugin;
+exports.defineTable = require_schema.defineTable;

package/dist/plugins/index.d.cts

@@ -0,0 +1,9 @@
+import { FieldDefinition, FieldReference, FieldType, IndexDefinition, ReferenceAction } from "../database/definitions.cjs";
+import { AggregateDefinition, DerivedDefinition, ModuleSchema, TableDefinition, defineAggregate, defineTable } from "../database/schema.cjs";
+import { DatabaseCursorError } from "../database/cursor.cjs";
+import { DatabaseQueryError, Page } from "../database/engineReads.cjs";
+import { AggregateChanges, AggregateIdentity, AggregateRow, CreateRow, HotUpdaterDatabase, HotUpdaterTransaction, Lookup, ReadOptions, ReadRow, TableRow, UpdateSet } from "../database/database.cjs";
+import { ConstraintReason, DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseTransactionError } from "../database/errors.cjs";
+import { AnyHotUpdaterPlugin, ClientAuth, CoreReader, HotUpdaterPlugin, InstanceFor, PluginApis, PluginContext, PluginEndpoint, PluginEndpointMethod, PluginInstance, PluginProvides, definePlugin } from "./definePlugin.cjs";
+import { HotUpdaterConfigError } from "../assembly/assemblePlugins.cjs";
+export { type AggregateChanges, type AggregateDefinition, type AggregateIdentity, type AggregateRow, type AnyHotUpdaterPlugin, type ClientAuth, type ConstraintReason, type CoreReader, type CreateRow, DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseCursorError, DatabaseQueryError, DatabaseTransactionError, type DerivedDefinition, type FieldDefinition, type FieldReference, type FieldType, HotUpdaterConfigError, type HotUpdaterDatabase, type HotUpdaterPlugin, type HotUpdaterTransaction, type IndexDefinition, type InstanceFor, type Lookup, type ModuleSchema, type Page, type PluginApis, type PluginContext, type PluginEndpoint, type PluginEndpointMethod, type PluginInstance, type PluginProvides, type ReadOptions, type ReadRow, type ReferenceAction, type TableDefinition, type TableRow, type UpdateSet, defineAggregate, definePlugin, defineTable };

package/dist/plugins/index.d.mts

@@ -0,0 +1,9 @@
+import { FieldDefinition, FieldReference, FieldType, IndexDefinition, ReferenceAction } from "../database/definitions.mjs";
+import { AggregateDefinition, DerivedDefinition, ModuleSchema, TableDefinition, defineAggregate, defineTable } from "../database/schema.mjs";
+import { DatabaseCursorError } from "../database/cursor.mjs";
+import { DatabaseQueryError, Page } from "../database/engineReads.mjs";
+import { AggregateChanges, AggregateIdentity, AggregateRow, CreateRow, HotUpdaterDatabase, HotUpdaterTransaction, Lookup, ReadOptions, ReadRow, TableRow, UpdateSet } from "../database/database.mjs";
+import { ConstraintReason, DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseTransactionError } from "../database/errors.mjs";
+import { AnyHotUpdaterPlugin, ClientAuth, CoreReader, HotUpdaterPlugin, InstanceFor, PluginApis, PluginContext, PluginEndpoint, PluginEndpointMethod, PluginInstance, PluginProvides, definePlugin } from "./definePlugin.mjs";
+import { HotUpdaterConfigError } from "../assembly/assemblePlugins.mjs";
+export { type AggregateChanges, type AggregateDefinition, type AggregateIdentity, type AggregateRow, type AnyHotUpdaterPlugin, type ClientAuth, type ConstraintReason, type CoreReader, type CreateRow, DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseCursorError, DatabaseQueryError, DatabaseTransactionError, type DerivedDefinition, type FieldDefinition, type FieldReference, type FieldType, HotUpdaterConfigError, type HotUpdaterDatabase, type HotUpdaterPlugin, type HotUpdaterTransaction, type IndexDefinition, type InstanceFor, type Lookup, type ModuleSchema, type Page, type PluginApis, type PluginContext, type PluginEndpoint, type PluginEndpointMethod, type PluginInstance, type PluginProvides, type ReadOptions, type ReadRow, type ReferenceAction, type TableDefinition, type TableRow, type UpdateSet, defineAggregate, definePlugin, defineTable };

package/dist/plugins/index.mjs

@@ -0,0 +1,7 @@
+import { DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseTransactionError } from "../database/errors.mjs";
+import { DatabaseCursorError } from "../database/cursor.mjs";
+import { DatabaseQueryError } from "../database/engineReads.mjs";
+import { defineAggregate, defineTable } from "../database/schema.mjs";
+import { definePlugin } from "./definePlugin.mjs";
+import { HotUpdaterConfigError } from "../assembly/assemblePlugins.mjs";
+export { DatabaseAmbiguousCommitError, DatabaseConflictError, DatabaseConstraintError, DatabaseCursorError, DatabaseQueryError, DatabaseTransactionError, HotUpdaterConfigError, defineAggregate, definePlugin, defineTable };

package/dist/plugins/insights/index.cjs

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_provider = require("../../insights/provider.cjs");
+const require_builtIn = require("../builtIn.cjs");
+const require_definePlugin = require("../definePlugin.cjs");
+const require_routes = require("../../insights/routes.cjs");
+const require_model = require("./model.cjs");
+const require_schema = require("./schema.cjs");
+const require_recordEvent = require("./recordEvent.cjs");
+const require_reads = require("./reads.cjs");
+//#region src/plugins/insights/index.ts
+const createInsightsApi = (db, now) => ({
+	/** Records one validated event row; a repeated id changes nothing. */
+	recordEvent: (event) => require_recordEvent.recordEvent(db, event),
+	listEvents: (input) => require_reads.listEvents(db, input),
+	findLatestEvents: (input) => require_reads.findLatestEvents(db, input),
+	countLatestEvents: (input) => require_reads.countLatestEvents(db, input),
+	countEvents: (input) => require_reads.countEvents(db, input),
+	getReleaseActivity: (input) => require_reads.getReleaseActivity(db, input, now),
+	getAppUsage: (input) => require_reads.getAppUsage(db, input, now)
+});
+/**
+* Built-in Insights: bundle lifecycle events, each installation's latest
+* event, and the counters, gauges, and sketches its reads come from. It
+* serves `POST /events` to clients and the Insights reads to admins.
+*/
+const insights = () => require_builtIn.markBuiltIn(require_definePlugin.definePlugin({
+	id: "insights",
+	schemaVersion: "1.0.0",
+	schema: require_schema.insightsSchema,
+	init: ({ db, now }) => {
+		const api = createInsightsApi(db, now);
+		const routes = require_routes.createInsightsRouteHandlers(require_provider.createInsightsProvider(require_model.createInsightsModel(api)));
+		return {
+			api,
+			endpoints: require_routes.INSIGHTS_ROUTES.map(({ access, method, path, handler }) => ({
+				access,
+				method,
+				path,
+				handler: (request, params) => routes[handler](params, request)
+			}))
+		};
+	}
+}));
+//#endregion
+exports.createInsightsModel = require_model.createInsightsModel;
+exports.insights = insights;
+exports.insightsIdentity = require_recordEvent.insightsIdentity;
+exports.insightsSchema = require_schema.insightsSchema;