okengine 0.6.0 → 0.6.1

package/src/release/official-plugins.ts

@@ -0,0 +1,46 @@
+/**
+ * Official `okengine/plugins` named exports measured for CI budgets.
+ * Categories match `site/content/docs/plugins/index.mdx`.
+ * Keep in sync with the docs catalogue — landing + budgets both read this.
+ */
+
+/** Docs / landing category for an official plugin. */
+export type PluginBudgetCategory = "auth" | "security" | "ops" | "perf";
+
+/** One official plugin entry measured as `export:./plugins/<name>`. */
+export type OfficialPluginBudget = {
+  /** Named export from `okengine/plugins`. */
+  readonly name: string;
+  /** Basename under `src/plugins/` (e.g. `magic-link.ts`). */
+  readonly file: string;
+  /** Docs category. */
+  readonly category: PluginBudgetCategory;
+};
+
+/** Category display order (docs index). */
+export const PLUGIN_BUDGET_CATEGORIES: readonly PluginBudgetCategory[] = [
+  "auth",
+  "security",
+  "ops",
+  "perf",
+] as const;
+
+/**
+ * Canonical official plugins — membership, file mapping, and grouping.
+ * Order within a category is docs order; landing may re-sort by size.
+ */
+export const OFFICIAL_PLUGIN_BUDGETS: readonly OfficialPluginBudget[] = [
+  { name: "username", file: "username.ts", category: "auth" },
+  { name: "anonymous", file: "anonymous.ts", category: "auth" },
+  { name: "magicLink", file: "magic-link.ts", category: "auth" },
+  { name: "emailOtp", file: "email-otp.ts", category: "auth" },
+  { name: "phoneNumber", file: "phone-number.ts", category: "auth" },
+  { name: "twoFactor", file: "two-factor.ts", category: "auth" },
+  { name: "passkey", file: "passkey.ts", category: "auth" },
+  { name: "headers", file: "headers.ts", category: "security" },
+  { name: "cors", file: "cors.ts", category: "security" },
+  { name: "csrf", file: "csrf.ts", category: "security" },
+  { name: "ipAllowlist", file: "ip-allowlist.ts", category: "security" },
+  { name: "maintenanceMode", file: "maintenance-mode.ts", category: "ops" },
+  { name: "compression", file: "compression.ts", category: "perf" },
+] as const;

package/src/release/readme.test.ts

@@ -36,6 +36,26 @@ describe("budgets markdown", () => {
           group: "exports",
           ok: true,
         },
+        {
+          id: "export:./plugins/cors",
+          label: "cors",
+          value: 2048,
+          limit: 2304,
+          unit: "bytes",
+          gate: "regression",
+          group: "plugins",
+          ok: true,
+        },
+        {
+          id: "export:./plugins/username",
+          label: "username",
+          value: 3072,
+          limit: 3328,
+          unit: "bytes",
+          gate: "regression",
+          group: "plugins",
+          ok: true,
+        },
         {
           id: "export:./drivers/postgres",
           label: "postgres",
@@ -52,10 +72,18 @@ describe("budgets markdown", () => {
     expect(md.startsWith("# Budgets\n")).toBe(true);
     expect(md).toContain("## Core");
     expect(md).toContain("## Exports");
+    expect(md).toContain("## Plugins");
+    expect(md).toContain("### Auth");
+    expect(md).toContain("### Security");
     expect(md).toContain("## Drivers");
-    expect(md).toContain("| channel |");
-    expect(md).toContain("| postgres |");
+    expect(md).toMatch(/\|\s*channel\s*\|/);
+    expect(md).toMatch(/\|\s*cors\s*\|/);
+    expect(md).toMatch(/\|\s*username\s*\|/);
+    expect(md).toMatch(/\|\s*postgres\s*\|/);
     expect(md).toContain("[`budgets.json`](budgets.json)");
     expect(md).not.toContain("./channel");
+    // oxfmt-aligned separators (not compact `|---|---|---|`) so Format stays green
+    expect(md).not.toContain("|---|---|---|");
+    expect(md).toMatch(/\| -{3,} \| -{3,} \| -{3,} \|/);
   });
 });