@hot-updater/cloudflare 1.0.0-rc.17 → 1.0.0-rc.18

package/dist/iac/index.cjs

@@ -109,10 +109,10 @@ const createD1Database = (runner) => {
 //#region src/d1Schema.ts
 /**
 * D1's schema: the guard table batch writes need, then the shared SQL
-* schema, settings last. Every statement can run again, so a migration for a
-* server's plugin tables repeats the built-in ones.
+* schema of core and the target's plugins, settings last. Every statement can
+* run again, so a migration for a server's plugin tables repeats core's.
 */
-const d1SchemaStatements = ({ schema, settings } = _hot_updater_server_database.builtInTarget) => [...(0, _hot_updater_server_database.createTableStatements)("sqlite", [_hot_updater_server_database.WRITE_GUARD_TABLE]), ...(0, _hot_updater_server_db.generateEngineSql)("sqlite", schema, settings)];
+const d1SchemaStatements = ({ schema, settings } = _hot_updater_server_database.coreTarget) => [...(0, _hot_updater_server_database.createTableStatements)("sqlite", [_hot_updater_server_database.WRITE_GUARD_TABLE]), ...(0, _hot_updater_server_db.generateEngineSql)("sqlite", schema, settings)];
 /** The schema as a D1 migration, which `wrangler d1 migrations apply` runs. */
 const d1SchemaSql = (target) => `-- HotUpdater.schema\n\n${d1SchemaStatements(target).map((statement) => `${statement};`).join("\n\n")}\n`;
 //#endregion
@@ -151,8 +151,8 @@ const d1Database = (config) => {
 			query: async (statement) => (await execute([statement]))[0],
 			batch: execute
 		}),
-		generateSchema: ((version, _name, target = _hot_updater_server_database.builtInTarget) => {
-			if (version !== "latest" && version !== _hot_updater_server_database.builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+		generateSchema: ((version, _name, target = _hot_updater_server_database.coreTarget) => {
+			if (version !== "latest" && version !== _hot_updater_server_database.coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
 			const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/\D/g, "").slice(0, 14);
 			return {
 				code: d1SchemaSql(target),
@@ -11427,23 +11427,6 @@ const getConfigScaffold = (build) => {
 };
 //#endregion
 //#region iac/index.ts
-const SOURCE_TEMPLATE = `// add this to your App.tsx
-import { HotUpdater } from "@hot-updater/react-native";
-
-function App() {
-  return null; // Replace with your app root
-}
-
-HotUpdater.init({
-  baseURL: "%%source%%",
-  requestHeaders: {
-    "x-api-key": %%apiKey%%,
-  },
-});
-
-// Call HotUpdater.checkForUpdate({ updateStrategy: "appVersion" })
-// when your app is ready to check.
-export default App;`;
 const deployWorker = async (apiToken, accountId, { credentialSource, d1DatabaseId, d1DatabaseName, nonInteractive, r2BucketName, workerName }) => {
 	const cwd = (0, _hot_updater_cli_tools.getCwd)();
 	const cloudflarePackagePath = require.resolve("@hot-updater/cloudflare/package.json", { paths: [cwd] });
@@ -11827,13 +11810,13 @@ const runInit = async ({ build, envFile }) => {
 		cloudflareApiToken: apiToken,
 		databaseId: selectedD1DatabaseId
 	});
-	let apiKey;
+	let credential;
 	try {
-		apiKey = (await (0, _hot_updater_server_db.createDatabasePluginApis)(database, plugins).apiKeys.provision({
-			existingApiKey: initInputEnv.HOT_UPDATER_API_KEY,
+		credential = await (0, _hot_updater_server_db.provisionClientCredential)(database, plugins, {
+			env: initInputEnv,
 			name: "Cloudflare init"
-		})).apiKey;
-		await (0, _hot_updater_cli_tools.makeEnv)({ HOT_UPDATER_API_KEY: apiKey });
+		});
+		if (credential !== void 0) await (0, _hot_updater_cli_tools.makeEnv)({ [credential.env]: credential.value });
 	} finally {
 		await database.dispose?.();
 	}
@@ -11843,12 +11826,11 @@ const runInit = async ({ build, envFile }) => {
 	else if (configWriteResult.status === "merged") _hot_updater_cli_tools.p.log.success("Updated 'hot-updater.config.ts' file with Cloudflare settings.");
 	else _hot_updater_cli_tools.p.log.warn(`Kept existing 'hot-updater.config.ts' unchanged: ${configWriteResult.reason}`);
 	await (0, _hot_updater_cli_tools.generateHotUpdaterPlugins)("@hot-updater/cloudflare");
-	if (subdomains.subdomain) _hot_updater_cli_tools.p.note((0, _hot_updater_cli_tools.transformTemplate)(SOURCE_TEMPLATE, {
-		apiKey: JSON.stringify(apiKey),
-		source: `https://${workerName}.${subdomains.subdomain}.workers.dev`
-	}));
-	_hot_updater_cli_tools.p.note((0, _hot_updater_cli_tools.formatApiKeyNote)(apiKey), "API Key");
-	_hot_updater_cli_tools.p.log.message("Store this API key separately in a secure place.");
+	(0, _hot_updater_cli_tools.printAppSetup)({
+		...subdomains.subdomain ? { baseURL: `https://${workerName}.${subdomains.subdomain}.workers.dev` } : {},
+		...credential === void 0 ? {} : { credential },
+		clientPlugins: (0, _hot_updater_server_db.clientPluginsOf)(plugins)
+	});
 	_hot_updater_cli_tools.p.log.message(`Next step: ${(0, _hot_updater_cli_tools.link)("https://hot-updater.dev/docs/managed/cloudflare#step-4-add-hotupdater-to-your-project")}`);
 	_hot_updater_cli_tools.p.log.success("Done! 🎉");
 };

package/dist/iac/index.mjs

@@ -2,10 +2,10 @@ import { createRequire } from "node:module";
 import crypto from "crypto";
 import fs from "fs/promises";
 import path from "path";
-import { ConfigBuilder, InitError, LegacyInfrastructureError, assertInfrastructureGenerationAtUrl, assertInitInputs, assertInitProviderInputs, confirmInitInputPersistence, copyDirToTmp, createHotUpdaterConfigScaffoldFromBuilder, formatApiKeyNote, generateHotUpdaterPlugins, getCwd, getHotUpdaterInitInputEnv, getInitProviderEnvVars, getInitProviderTextPromptValues, link, makeEnv, p, readHotUpdaterInitEnv, resolveInitProviderInput, transformTemplate, writeHotUpdaterConfig } from "@hot-updater/cli-tools";
-import { createDatabasePluginApis, generateEngineSql } from "@hot-updater/server/db";
+import { ConfigBuilder, InitError, LegacyInfrastructureError, assertInfrastructureGenerationAtUrl, assertInitInputs, assertInitProviderInputs, confirmInitInputPersistence, copyDirToTmp, createHotUpdaterConfigScaffoldFromBuilder, generateHotUpdaterPlugins, getCwd, getHotUpdaterInitInputEnv, getInitProviderEnvVars, getInitProviderTextPromptValues, link, makeEnv, p, printAppSetup, readHotUpdaterInitEnv, resolveInitProviderInput, transformTemplate, writeHotUpdaterConfig } from "@hot-updater/cli-tools";
+import { clientPluginsOf, generateEngineSql, provisionClientCredential } from "@hot-updater/server/db";
 import Cloudflare$1, { Cloudflare } from "cloudflare";
-import { WRITE_GUARD_TABLE, builtInSettings, builtInTarget, createEngineDatabase, createSqlAdapter, createTableStatements } from "@hot-updater/server/database";
+import { WRITE_GUARD_TABLE, coreSettings, coreTarget, createEngineDatabase, createSqlAdapter, createTableStatements } from "@hot-updater/server/database";
 import { apiKeys } from "@hot-updater/server/plugins/api-keys";
 import { insights } from "@hot-updater/server/plugins/insights";
 import { fileURLToPath } from "node:url";
@@ -101,10 +101,10 @@ const createD1Database = (runner) => {
 //#region src/d1Schema.ts
 /**
 * D1's schema: the guard table batch writes need, then the shared SQL
-* schema, settings last. Every statement can run again, so a migration for a
-* server's plugin tables repeats the built-in ones.
+* schema of core and the target's plugins, settings last. Every statement can
+* run again, so a migration for a server's plugin tables repeats core's.
 */
-const d1SchemaStatements = ({ schema, settings } = builtInTarget) => [...createTableStatements("sqlite", [WRITE_GUARD_TABLE]), ...generateEngineSql("sqlite", schema, settings)];
+const d1SchemaStatements = ({ schema, settings } = coreTarget) => [...createTableStatements("sqlite", [WRITE_GUARD_TABLE]), ...generateEngineSql("sqlite", schema, settings)];
 /** The schema as a D1 migration, which `wrangler d1 migrations apply` runs. */
 const d1SchemaSql = (target) => `-- HotUpdater.schema\n\n${d1SchemaStatements(target).map((statement) => `${statement};`).join("\n\n")}\n`;
 //#endregion
@@ -143,8 +143,8 @@ const d1Database = (config) => {
 			query: async (statement) => (await execute([statement]))[0],
 			batch: execute
 		}),
-		generateSchema: ((version, _name, target = builtInTarget) => {
-			if (version !== "latest" && version !== builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+		generateSchema: ((version, _name, target = coreTarget) => {
+			if (version !== "latest" && version !== coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
 			const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/\D/g, "").slice(0, 14);
 			return {
 				code: d1SchemaSql(target),
@@ -11419,23 +11419,6 @@ const getConfigScaffold = (build) => {
 };
 //#endregion
 //#region iac/index.ts
-const SOURCE_TEMPLATE = `// add this to your App.tsx
-import { HotUpdater } from "@hot-updater/react-native";
-
-function App() {
-  return null; // Replace with your app root
-}
-
-HotUpdater.init({
-  baseURL: "%%source%%",
-  requestHeaders: {
-    "x-api-key": %%apiKey%%,
-  },
-});
-
-// Call HotUpdater.checkForUpdate({ updateStrategy: "appVersion" })
-// when your app is ready to check.
-export default App;`;
 const deployWorker = async (apiToken, accountId, { credentialSource, d1DatabaseId, d1DatabaseName, nonInteractive, r2BucketName, workerName }) => {
 	const cwd = getCwd();
 	const cloudflarePackagePath = __require.resolve("@hot-updater/cloudflare/package.json", { paths: [cwd] });
@@ -11819,13 +11802,13 @@ const runInit = async ({ build, envFile }) => {
 		cloudflareApiToken: apiToken,
 		databaseId: selectedD1DatabaseId
 	});
-	let apiKey;
+	let credential;
 	try {
-		apiKey = (await createDatabasePluginApis(database, plugins).apiKeys.provision({
-			existingApiKey: initInputEnv.HOT_UPDATER_API_KEY,
+		credential = await provisionClientCredential(database, plugins, {
+			env: initInputEnv,
 			name: "Cloudflare init"
-		})).apiKey;
-		await makeEnv({ HOT_UPDATER_API_KEY: apiKey });
+		});
+		if (credential !== void 0) await makeEnv({ [credential.env]: credential.value });
 	} finally {
 		await database.dispose?.();
 	}
@@ -11835,12 +11818,11 @@ const runInit = async ({ build, envFile }) => {
 	else if (configWriteResult.status === "merged") p.log.success("Updated 'hot-updater.config.ts' file with Cloudflare settings.");
 	else p.log.warn(`Kept existing 'hot-updater.config.ts' unchanged: ${configWriteResult.reason}`);
 	await generateHotUpdaterPlugins("@hot-updater/cloudflare");
-	if (subdomains.subdomain) p.note(transformTemplate(SOURCE_TEMPLATE, {
-		apiKey: JSON.stringify(apiKey),
-		source: `https://${workerName}.${subdomains.subdomain}.workers.dev`
-	}));
-	p.note(formatApiKeyNote(apiKey), "API Key");
-	p.log.message("Store this API key separately in a secure place.");
+	printAppSetup({
+		...subdomains.subdomain ? { baseURL: `https://${workerName}.${subdomains.subdomain}.workers.dev` } : {},
+		...credential === void 0 ? {} : { credential },
+		clientPlugins: clientPluginsOf(plugins)
+	});
 	p.log.message(`Next step: ${link("https://hot-updater.dev/docs/managed/cloudflare#step-4-add-hotupdater-to-your-project")}`);
 	p.log.success("Done! 🎉");
 };

package/dist/index.cjs

@@ -81,10 +81,10 @@ const createD1Database = (runner) => {
 //#region src/d1Schema.ts
 /**
 * D1's schema: the guard table batch writes need, then the shared SQL
-* schema, settings last. Every statement can run again, so a migration for a
-* server's plugin tables repeats the built-in ones.
+* schema of core and the target's plugins, settings last. Every statement can
+* run again, so a migration for a server's plugin tables repeats core's.
 */
-const d1SchemaStatements = ({ schema, settings } = _hot_updater_server_database.builtInTarget) => [...(0, _hot_updater_server_database.createTableStatements)("sqlite", [_hot_updater_server_database.WRITE_GUARD_TABLE]), ...(0, _hot_updater_server_db.generateEngineSql)("sqlite", schema, settings)];
+const d1SchemaStatements = ({ schema, settings } = _hot_updater_server_database.coreTarget) => [...(0, _hot_updater_server_database.createTableStatements)("sqlite", [_hot_updater_server_database.WRITE_GUARD_TABLE]), ...(0, _hot_updater_server_db.generateEngineSql)("sqlite", schema, settings)];
 /** The schema as a D1 migration, which `wrangler d1 migrations apply` runs. */
 const d1SchemaSql = (target) => `-- HotUpdater.schema\n\n${d1SchemaStatements(target).map((statement) => `${statement};`).join("\n\n")}\n`;
 //#endregion
@@ -123,8 +123,8 @@ const d1Database = (config) => {
 			query: async (statement) => (await execute([statement]))[0],
 			batch: execute
 		}),
-		generateSchema: ((version, _name, target = _hot_updater_server_database.builtInTarget) => {
-			if (version !== "latest" && version !== _hot_updater_server_database.builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+		generateSchema: ((version, _name, target = _hot_updater_server_database.coreTarget) => {
+			if (version !== "latest" && version !== _hot_updater_server_database.coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
 			const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/\D/g, "").slice(0, 14);
 			return {
 				code: d1SchemaSql(target),

package/dist/index.d.cts

@@ -171,12 +171,7 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
     readonly received_at_ms: {
       readonly type: "integer";
     };
-    readonly current_release_id: {
-      readonly type: "string";
-      readonly maxLength: 36;
-      readonly required: false;
-    };
-  }, {}, {
+  }, Readonly<Record<string, import("@hot-updater/server/database").FieldType>>, {
     readonly byUser: {
       readonly eq: readonly ["user_id"];
       readonly sort: readonly ["install_id"];
@@ -190,7 +185,7 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
     readonly bucket_start_ms: {
       readonly type: "integer";
     };
-  }, "downloads" | "launches" | "failed_launches", {
+  }, "downloads" | "launches" | "failed_launches" | "failed_updates" | "patch_downloads" | "patch_fallbacks", {
     readonly window: {
       readonly eq: readonly ["identity"];
       readonly sort: readonly ["bucket_start_ms"];
@@ -209,7 +204,63 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
       readonly eq: readonly ["identity"];
       readonly sort: readonly ["bucket_start_ms"];
     };
-  }, "launch_users" | "activity_users", readonly ["identity", "bucket_start_ms"]>;
+  }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_overview_daily: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "launches" | "failed_launches" | "failed_updates" | "patch_downloads" | "patch_fallbacks", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches_daily: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_overview_lifetime: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "launches" | "failed_launches" | "failed_updates" | "patch_downloads" | "patch_fallbacks", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches_lifetime: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "failed_users", readonly ["identity", "bucket_start_ms"]>;
   readonly insights_distribution: import("@hot-updater/server/database").AggregateDefinition<{
     readonly channel: {
       readonly type: "string";
@@ -292,22 +343,52 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["platform", "channel", "type", "bundle_ref", "bucket_start_ms"]>;
+  readonly insights_failures: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly stage: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly reason: {
+      readonly type: "string";
+      readonly maxLength: 64;
+    };
+    readonly detail: {
+      readonly type: "string";
+      readonly maxLength: 160;
+    };
+  }, "events", {
+    readonly byScope: {
+      readonly eq: readonly ["platform", "channel"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "bucket_start_ms", "release_id", "stage", "reason", "detail"]>;
 }, {
   api: {
-    recordEvent: (event: import("@hot-updater/plugin-core").BundleEventRow) => Promise<void>;
-    listEvents: (input: import("@hot-updater/plugin-core").InsightsListEventsInput) => Promise<readonly import("@hot-updater/plugin-core").BundleEventRow[]>;
-    findLatestEvents: (input: import("@hot-updater/plugin-core").InsightsFindLatestEventsInput) => Promise<readonly import("@hot-updater/plugin-core").BundleEventRow[]>;
-    countLatestEvents: (input: import("@hot-updater/plugin-core").InsightsCountLatestEventsInput) => Promise<number>;
-    countEvents: (input: import("@hot-updater/plugin-core").InsightsCountEventsInput) => Promise<number>;
-    getReleaseActivity: (input: import("@hot-updater/plugin-core").InsightsGetReleaseActivityInput) => Promise<import("@hot-updater/plugin-core").InsightsGetReleaseActivityResult>;
-    getAppUsage: (input: import("@hot-updater/plugin-core").InsightsGetAppUsageInput) => Promise<import("@hot-updater/plugin-core").InsightsGetAppUsageResult>;
+    retention: import("@hot-updater/server/plugins/insights").InsightsRetention;
+    recordEvent: (event: import("@hot-updater/server/plugins/insights").BundleEventRow) => Promise<void>;
+    listEvents: (input: import("@hot-updater/server/plugins/insights").InsightsListEventsInput) => Promise<readonly import("@hot-updater/server/plugins/insights").BundleEventRow[]>;
+    findLatestEvents: (input: import("@hot-updater/server/plugins/insights").InsightsFindLatestEventsInput) => Promise<readonly import("@hot-updater/server/plugins/insights").BundleEventRow[]>;
+    countLatestEvents: (input: import("@hot-updater/server/plugins/insights").InsightsCountLatestEventsInput) => Promise<number>;
+    countEvents: (input: import("@hot-updater/server/plugins/insights").InsightsCountEventsInput) => Promise<number>;
+    getReleaseActivity: (input: import("@hot-updater/server/plugins/insights").InsightsGetReleaseActivityInput) => Promise<import("@hot-updater/server/plugins/insights").InsightsGetReleaseActivityResult>;
+    getAppUsage: (input: import("@hot-updater/server/plugins/insights").InsightsGetAppUsageInput) => Promise<import("@hot-updater/server/plugins/insights").InsightsGetAppUsageResult>;
+    getUpdateFailures: (input: import("@hot-updater/server/plugins/insights").InsightsUpdateFailuresInput) => Promise<import("@hot-updater/server/plugins/insights").InsightsUpdateFailures>;
   };
-  endpoints: {
-    access: "client" | "admin";
-    method: "POST" | "GET";
-    path: "/events" | "/overview" | "/installations" | "/installations/:installId/events" | "/installations/:installId";
-    handler: (request: Request, params: Readonly<Record<string, string>>) => Promise<Response>;
-  }[];
+  endpoints: import("@hot-updater/server/plugins").PluginEndpoint[];
 }, {}>, import("@hot-updater/server/plugins").HotUpdaterPlugin<"apiKeys", {
   readonly api_keys: import("@hot-updater/server/database").TableDefinition<{
     readonly id: {
@@ -350,21 +431,21 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
       readonly apiKey: string;
       readonly name: string;
       readonly createdAtMs?: number;
-    }) => Promise<import("@hot-updater/server").CreatedApiKey>;
+    }) => Promise<import("@hot-updater/server/plugins/api-keys").CreatedApiKey>;
     provision: (input: {
       readonly existingApiKey?: string;
       readonly name: string;
-    }) => Promise<import("@hot-updater/server").CreatedApiKey>;
+    }) => Promise<import("@hot-updater/server/plugins/api-keys").CreatedApiKey>;
     create(input: {
       readonly name: string;
     }): Promise<{
       readonly apiKey: string;
-      readonly record: import("@hot-updater/server").ApiKeyMetadata;
+      readonly record: import("@hot-updater/server/plugins/api-keys").ApiKeyMetadata;
     }>;
-    list(): Promise<readonly import("@hot-updater/server").ApiKeyMetadata[]>;
+    list(): Promise<readonly import("@hot-updater/server/plugins/api-keys").ApiKeyMetadata[]>;
     revoke(input: {
       readonly id: string;
-    }): Promise<import("@hot-updater/server").ApiKeyMetadata | null>;
+    }): Promise<import("@hot-updater/server/plugins/api-keys").ApiKeyMetadata | null>;
   };
   clientAuth: {
     varyHeaders: string[];

package/dist/index.d.mts

@@ -171,12 +171,7 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
     readonly received_at_ms: {
       readonly type: "integer";
     };
-    readonly current_release_id: {
-      readonly type: "string";
-      readonly maxLength: 36;
-      readonly required: false;
-    };
-  }, {}, {
+  }, Readonly<Record<string, import("@hot-updater/server/database").FieldType>>, {
     readonly byUser: {
       readonly eq: readonly ["user_id"];
       readonly sort: readonly ["install_id"];
@@ -190,7 +185,7 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
     readonly bucket_start_ms: {
       readonly type: "integer";
     };
-  }, "downloads" | "launches" | "failed_launches", {
+  }, "downloads" | "launches" | "failed_launches" | "failed_updates" | "patch_downloads" | "patch_fallbacks", {
     readonly window: {
       readonly eq: readonly ["identity"];
       readonly sort: readonly ["bucket_start_ms"];
@@ -209,7 +204,63 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
       readonly eq: readonly ["identity"];
       readonly sort: readonly ["bucket_start_ms"];
     };
-  }, "launch_users" | "activity_users", readonly ["identity", "bucket_start_ms"]>;
+  }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_overview_daily: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "launches" | "failed_launches" | "failed_updates" | "patch_downloads" | "patch_fallbacks", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches_daily: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_overview_lifetime: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "launches" | "failed_launches" | "failed_updates" | "patch_downloads" | "patch_fallbacks", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches_lifetime: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "failed_users", readonly ["identity", "bucket_start_ms"]>;
   readonly insights_distribution: import("@hot-updater/server/database").AggregateDefinition<{
     readonly channel: {
       readonly type: "string";
@@ -292,22 +343,52 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["platform", "channel", "type", "bundle_ref", "bucket_start_ms"]>;
+  readonly insights_failures: import("@hot-updater/server/database").AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly stage: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly reason: {
+      readonly type: "string";
+      readonly maxLength: 64;
+    };
+    readonly detail: {
+      readonly type: "string";
+      readonly maxLength: 160;
+    };
+  }, "events", {
+    readonly byScope: {
+      readonly eq: readonly ["platform", "channel"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "bucket_start_ms", "release_id", "stage", "reason", "detail"]>;
 }, {
   api: {
-    recordEvent: (event: import("@hot-updater/plugin-core").BundleEventRow) => Promise<void>;
-    listEvents: (input: import("@hot-updater/plugin-core").InsightsListEventsInput) => Promise<readonly import("@hot-updater/plugin-core").BundleEventRow[]>;
-    findLatestEvents: (input: import("@hot-updater/plugin-core").InsightsFindLatestEventsInput) => Promise<readonly import("@hot-updater/plugin-core").BundleEventRow[]>;
-    countLatestEvents: (input: import("@hot-updater/plugin-core").InsightsCountLatestEventsInput) => Promise<number>;
-    countEvents: (input: import("@hot-updater/plugin-core").InsightsCountEventsInput) => Promise<number>;
-    getReleaseActivity: (input: import("@hot-updater/plugin-core").InsightsGetReleaseActivityInput) => Promise<import("@hot-updater/plugin-core").InsightsGetReleaseActivityResult>;
-    getAppUsage: (input: import("@hot-updater/plugin-core").InsightsGetAppUsageInput) => Promise<import("@hot-updater/plugin-core").InsightsGetAppUsageResult>;
+    retention: import("@hot-updater/server/plugins/insights").InsightsRetention;
+    recordEvent: (event: import("@hot-updater/server/plugins/insights").BundleEventRow) => Promise<void>;
+    listEvents: (input: import("@hot-updater/server/plugins/insights").InsightsListEventsInput) => Promise<readonly import("@hot-updater/server/plugins/insights").BundleEventRow[]>;
+    findLatestEvents: (input: import("@hot-updater/server/plugins/insights").InsightsFindLatestEventsInput) => Promise<readonly import("@hot-updater/server/plugins/insights").BundleEventRow[]>;
+    countLatestEvents: (input: import("@hot-updater/server/plugins/insights").InsightsCountLatestEventsInput) => Promise<number>;
+    countEvents: (input: import("@hot-updater/server/plugins/insights").InsightsCountEventsInput) => Promise<number>;
+    getReleaseActivity: (input: import("@hot-updater/server/plugins/insights").InsightsGetReleaseActivityInput) => Promise<import("@hot-updater/server/plugins/insights").InsightsGetReleaseActivityResult>;
+    getAppUsage: (input: import("@hot-updater/server/plugins/insights").InsightsGetAppUsageInput) => Promise<import("@hot-updater/server/plugins/insights").InsightsGetAppUsageResult>;
+    getUpdateFailures: (input: import("@hot-updater/server/plugins/insights").InsightsUpdateFailuresInput) => Promise<import("@hot-updater/server/plugins/insights").InsightsUpdateFailures>;
   };
-  endpoints: {
-    access: "client" | "admin";
-    method: "POST" | "GET";
-    path: "/events" | "/overview" | "/installations" | "/installations/:installId/events" | "/installations/:installId";
-    handler: (request: Request, params: Readonly<Record<string, string>>) => Promise<Response>;
-  }[];
+  endpoints: import("@hot-updater/server/plugins").PluginEndpoint[];
 }, {}>, import("@hot-updater/server/plugins").HotUpdaterPlugin<"apiKeys", {
   readonly api_keys: import("@hot-updater/server/database").TableDefinition<{
     readonly id: {
@@ -350,21 +431,21 @@ declare const plugins: readonly [import("@hot-updater/server/plugins").HotUpdate
       readonly apiKey: string;
       readonly name: string;
       readonly createdAtMs?: number;
-    }) => Promise<import("@hot-updater/server").CreatedApiKey>;
+    }) => Promise<import("@hot-updater/server/plugins/api-keys").CreatedApiKey>;
     provision: (input: {
       readonly existingApiKey?: string;
       readonly name: string;
-    }) => Promise<import("@hot-updater/server").CreatedApiKey>;
+    }) => Promise<import("@hot-updater/server/plugins/api-keys").CreatedApiKey>;
     create(input: {
       readonly name: string;
     }): Promise<{
       readonly apiKey: string;
-      readonly record: import("@hot-updater/server").ApiKeyMetadata;
+      readonly record: import("@hot-updater/server/plugins/api-keys").ApiKeyMetadata;
     }>;
-    list(): Promise<readonly import("@hot-updater/server").ApiKeyMetadata[]>;
+    list(): Promise<readonly import("@hot-updater/server/plugins/api-keys").ApiKeyMetadata[]>;
     revoke(input: {
       readonly id: string;
-    }): Promise<import("@hot-updater/server").ApiKeyMetadata | null>;
+    }): Promise<import("@hot-updater/server/plugins/api-keys").ApiKeyMetadata | null>;
   };
   clientAuth: {
     varyHeaders: string[];

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { WRITE_GUARD_TABLE, builtInSettings, builtInTarget, createEngineDatabase, createSqlAdapter, createTableStatements } from "@hot-updater/server/database";
+import { WRITE_GUARD_TABLE, coreSettings, coreTarget, createEngineDatabase, createSqlAdapter, createTableStatements } from "@hot-updater/server/database";
 import Cloudflare from "cloudflare";
 import { generateEngineSql } from "@hot-updater/server/db";
 import { DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, S3Client } from "@aws-sdk/client-s3";
@@ -57,10 +57,10 @@ const createD1Database = (runner) => {
 //#region src/d1Schema.ts
 /**
 * D1's schema: the guard table batch writes need, then the shared SQL
-* schema, settings last. Every statement can run again, so a migration for a
-* server's plugin tables repeats the built-in ones.
+* schema of core and the target's plugins, settings last. Every statement can
+* run again, so a migration for a server's plugin tables repeats core's.
 */
-const d1SchemaStatements = ({ schema, settings } = builtInTarget) => [...createTableStatements("sqlite", [WRITE_GUARD_TABLE]), ...generateEngineSql("sqlite", schema, settings)];
+const d1SchemaStatements = ({ schema, settings } = coreTarget) => [...createTableStatements("sqlite", [WRITE_GUARD_TABLE]), ...generateEngineSql("sqlite", schema, settings)];
 /** The schema as a D1 migration, which `wrangler d1 migrations apply` runs. */
 const d1SchemaSql = (target) => `-- HotUpdater.schema\n\n${d1SchemaStatements(target).map((statement) => `${statement};`).join("\n\n")}\n`;
 //#endregion
@@ -99,8 +99,8 @@ const d1Database = (config) => {
 			query: async (statement) => (await execute([statement]))[0],
 			batch: execute
 		}),
-		generateSchema: ((version, _name, target = builtInTarget) => {
-			if (version !== "latest" && version !== builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+		generateSchema: ((version, _name, target = coreTarget) => {
+			if (version !== "latest" && version !== coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
 			const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/\D/g, "").slice(0, 14);
 			return {
 				code: d1SchemaSql(target),