naro-cli 0.19.1 → 0.21.0

package/dist/index.js

@@ -63,6 +63,7 @@ import {
   policiesForTypes,
   policiesLostByReset,
   projectPath,
+  promoteTargetUnsupported,
   promptForMissingEnv,
   pullEnv,
   quoteIdent,
@@ -96,7 +97,7 @@ import {
   usageMonthOf,
   userForAccessToken,
   writeProjectLink
-} from "./chunk-ZO2BEC46.js";
+} from "./chunk-FFPOVA7I.js";
 import "./chunk-K3NQKI34.js";
 
 // src/args.ts
@@ -195,7 +196,8 @@ var STRING_FLAGS = {
   "--search": "search",
   "--copy-env": "copyEnv",
   "--database": "database",
-  "--protection": "protection"
+  "--protection": "protection",
+  "--to": "to"
 };
 var SECRET_FLAGS = {
   "--api-key": "--api-key-stdin",
@@ -1185,16 +1187,16 @@ var DISABLE_QUESTION = "Turn the backend off? In up to about 90 seconds your app
 var OFF_ADVICE = "Turned off: your app's /_naro/* requests get 404. The data, users and keys are kept \u2014 `naro backend enable` turns it back on with the same keys.";
 var TURNING_OFF_ADVICE = "Turning it off did not finish: your app's /_naro/* requests may still be answered. Run `naro backend disable` again to finish it \u2014 the control plane also retries every few minutes.";
 var TURNING_OFF_NOW_ADVICE = "Turning off: another run is removing the routes right now. Check again in a minute with `naro backend`.";
-function leaseHeld(info, now) {
+function leaseHeld(info, now2) {
   if (info.leaseExpiresAt === null) return false;
   const until = Date.parse(info.leaseExpiresAt);
-  return !Number.isNaN(until) && until > now;
+  return !Number.isNaN(until) && until > now2;
 }
 function sentence(text) {
   const line = printable(text).trim();
   return /[.!?…]$/.test(line) ? line : `${line}.`;
 }
-function statusText(info, now) {
+function statusText(info, now2) {
   switch (info.status) {
     case "none":
       return "not provisioned";
@@ -1202,7 +1204,7 @@ function statusText(info, now) {
       return "ready";
     default: {
       const text = info.step ? `${info.status} (step: ${info.step})` : info.status;
-      return isStalledBackend(info, now) ? `${text}, stalled` : text;
+      return isStalledBackend(info, now2) ? `${text}, stalled` : text;
     }
   }
 }
@@ -1212,10 +1214,10 @@ function switchText(info) {
     return info.disabledAt ? `turning off (since ${printable(info.disabledAt)})` : "turning off";
   return info.disabledAt ? `off since ${printable(info.disabledAt)}` : "off";
 }
-function backendLines(info, now = Date.now()) {
+function backendLines(info, now2 = Date.now()) {
   const lines = [
     `Backend:     ${switchText(info)}`,
-    `Status:      ${statusText(info, now)}`,
+    `Status:      ${statusText(info, now2)}`,
     `URL:         ${info.url}`
   ];
   if (info.anonKey) lines.push(`Anon key:    ${info.anonKey}`);
@@ -1225,10 +1227,10 @@ function backendLines(info, now = Date.now()) {
     );
   return lines;
 }
-function adviceLines(info, now) {
+function adviceLines(info, now2) {
   if (!info.enabled && info.status !== "none") {
     if (!info.turningOff) return [OFF_ADVICE];
-    return [leaseHeld(info, now) ? TURNING_OFF_NOW_ADVICE : TURNING_OFF_ADVICE];
+    return [leaseHeld(info, now2) ? TURNING_OFF_NOW_ADVICE : TURNING_OFF_ADVICE];
   }
   switch (info.status) {
     case "none":
@@ -1239,7 +1241,7 @@ function adviceLines(info, now) {
         "Run `naro backend enable` again \u2014 it picks up where it stopped."
       ];
     case "provisioning":
-      return isStalledBackend(info, now) ? [
+      return isStalledBackend(info, now2) ? [
         "No run is working on it: the last one stopped part-way. Run `naro backend enable` to pick it up."
       ] : [
         "Provisioning is running. Check again in a minute with `naro backend`."
@@ -1256,10 +1258,10 @@ async function runBackendInfo(context) {
   const client = await context.client();
   const projectId = await context.resolveProjectId();
   const backend = await client.backend.info(projectId);
-  const now = Date.now();
+  const now2 = Date.now();
   context.output.result(
-    { projectId, backend, stalled: isStalledBackend(backend, now) },
-    [...backendLines(backend, now), ...adviceLines(backend, now)]
+    { projectId, backend, stalled: isStalledBackend(backend, now2) },
+    [...backendLines(backend, now2), ...adviceLines(backend, now2)]
   );
 }
 async function runBackendEnable(context) {
@@ -3184,10 +3186,10 @@ function truth(text) {
 var DECIMAL = /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/;
 function exactNumber(text) {
   if (!DECIMAL.test(text)) return text;
-  const number = Number(text);
-  if (!text.includes(".")) return Number.isSafeInteger(number) ? number : text;
+  const number2 = Number(text);
+  if (!text.includes(".")) return Number.isSafeInteger(number2) ? number2 : text;
   const trimmed = text.replace(/\.?0+$/, "");
-  return String(number) === trimmed ? number : text;
+  return String(number2) === trimmed ? number2 : text;
 }
 function quoteFilterValue(value) {
   const text = String(value);
@@ -3891,7 +3893,7 @@ async function runSchemaChange(context, operations, question) {
   const dryRun = context.flags.dryRun === true;
   if (question !== void 0 && !dryRun)
     await confirmOrAbort(context, question);
-  const sent = dryRun ? operations.map((operation) => {
+  const sent2 = dryRun ? operations.map((operation) => {
     if (operation.op !== "dropTable" && operation.op !== "dropColumn")
       return operation;
     const { confirm: _confirm, ...rest } = operation;
@@ -3909,7 +3911,7 @@ async function runSchemaChange(context, operations, question) {
     [...local, ...ledger.map((row) => row.name)],
     schemaMigrationTitle(operations[0] ?? {})
   );
-  const result = await client.db.schema(projectId, sent, {
+  const result = await client.db.schema(projectId, sent2, {
     ...dryRun ? { dryRun: true } : {},
     name
   });
@@ -5523,17 +5525,27 @@ async function runProjectInspect(context) {
 }
 
 // src/commands/promote.ts
-async function promoteAndWait(context, client, project, sourceDeploymentId, action) {
+var PROMOTE_USAGE = "Usage: naro promote <deployment-id> [--to <environment>]";
+var ROLLBACK_USAGE = "Usage: naro rollback [deployment-id]";
+var REBUILD_TIMEOUT_MS = 15 * 6e4;
+var REUPLOAD_TIMEOUT_MS = 5 * 6e4;
+async function promoteAndWait(context, client, project, sourceDeploymentId, action, target) {
   const promoted = await client.deployments.promote(
     project.id,
-    sourceDeploymentId
+    sourceDeploymentId,
+    target !== void 0 ? { target } : void 0
   );
+  const rebuild = promoted.mode === "rebuild";
   context.output.log(
-    `\u25B8 ${action === "promote" ? "promoting" : "rolling back to"} ${sourceDeploymentId}`
+    `\u25B8 ${action === "promote" ? "promoting" : "rolling back to"} ${sourceDeploymentId}${target !== void 0 ? ` to ${target} (${promoted.mode})` : ""}`
+  );
+  const detail = await client.deployments.wait(
+    promoted.id,
+    rebuild ? {
+      timeoutMs: REBUILD_TIMEOUT_MS,
+      onLog: (log) => context.output.log(formatBuildLog(log))
+    } : { timeoutMs: REUPLOAD_TIMEOUT_MS }
   );
-  const detail = await client.deployments.wait(promoted.id, {
-    timeoutMs: 5 * 6e4
-  });
   if (detail.deployment.status !== "READY") {
     throw new NaroError(
       detail.deployment.errorCode ?? "DEPLOY_FAILED",
@@ -5541,42 +5553,104 @@ async function promoteAndWait(context, client, project, sourceDeploymentId, acti
       { details: { deploymentId: promoted.id } }
     );
   }
+  const serving = target === void 0 || target === "production" ? "Production" : target;
   context.output.result(
     {
       deploymentId: promoted.id,
       sourceDeploymentId,
       projectId: project.id,
+      // Both say the mode the control plane answered (MCP's rollback does
+      // too). Only a promotion has a target: a rollback is production's.
+      ...action === "promote" ? { target: target ?? null } : {},
+      mode: promoted.mode,
       status: detail.deployment.status,
       url: detail.deployment.url
     },
     [
-      `\u2705 Production now serves ${sourceDeploymentId}`,
+      `\u2705 ${serving} now serves ${rebuild ? "a rebuild of " : ""}${sourceDeploymentId}`,
       "",
       detail.deployment.url ?? ""
     ]
   );
 }
+function promoteTarget(flags) {
+  if (flags.to === void 0) return void 0;
+  const target = flags.to.trim();
+  if (target === "" || target === "preview")
+    throw new NaroError(
+      "VALIDATION_FAILED",
+      "--to must be production or an environment name."
+    );
+  return target;
+}
+function refuseWhatIsNotRead(context, usage, envMessage) {
+  if (context.positionals.length > 1)
+    throw new NaroError("VALIDATION_FAILED", usage);
+  if (context.flags.env !== void 0)
+    throw new NaroError("VALIDATION_FAILED", envMessage);
+}
+async function previewPromotion(context, client, projectId, sourceDeploymentId, target) {
+  let check;
+  try {
+    check = await client.deployments.promoteCheck(
+      projectId,
+      sourceDeploymentId,
+      target
+    );
+  } catch (error) {
+    if (!isNaroError(error) || error.status !== 405) throw error;
+    if (target !== void 0 && target !== "production")
+      throw promoteTargetUnsupported(error);
+    return;
+  }
+  context.output.log(
+    check.mode === "rebuild" ? `\u25B8 rebuild: builds the same commit again with ${target ?? "production"}'s variables` : "\u25B8 reupload: publishes the stored build"
+  );
+  for (const warning of check.warnings)
+    for (const line of warningLines(warning)) context.output.log(line);
+}
 async function runPromote(context) {
-  const [deploymentId] = context.positionalOrThrow(
-    1,
-    "Usage: naro promote <deployment-id>"
+  const [deploymentId] = context.positionalOrThrow(1, PROMOTE_USAGE);
+  refuseWhatIsNotRead(
+    context,
+    PROMOTE_USAGE,
+    "--env is not an option of naro promote: use --to <environment>."
   );
+  const target = promoteTarget(context.flags);
   const client = await context.client();
   const projectId = await context.resolveProjectId();
   const project = await client.projects.get(projectId);
+  await previewPromotion(
+    context,
+    client,
+    projectId,
+    deploymentId,
+    target
+  );
   await confirmOrAbort(
     context,
-    `Promote ${String(deploymentId)} to production (${project.subdomain})?`
+    target === void 0 || target === "production" ? `Promote ${String(deploymentId)} to production (${project.subdomain})?` : `Promote ${String(deploymentId)} to ${target} (${project.subdomain}--${target})?`
   );
   await promoteAndWait(
     context,
     client,
     project,
     deploymentId,
-    "promote"
+    "promote",
+    target
   );
 }
 async function runRollback(context) {
+  if (context.flags.to !== void 0)
+    throw new NaroError(
+      "VALIDATION_FAILED",
+      "--to is for naro promote: naro rollback always rolls production back."
+    );
+  refuseWhatIsNotRead(
+    context,
+    ROLLBACK_USAGE,
+    "--env is not an option of naro rollback: naro rollback always rolls production back."
+  );
   const client = await context.client();
   const projectId = await context.resolveProjectId();
   const project = await client.projects.get(projectId);
@@ -5648,6 +5722,111 @@ async function runProtectionBypassRemove(context) {
   context.output.result({ projectId, ...state }, ["Bypass secret removed."]);
 }
 
+// src/commands/realtime.ts
+var ADD_USAGE = "Usage: naro realtime tables add <table>\u2026";
+var REMOVE_USAGE2 = "Usage: naro realtime tables remove <table>\u2026 [--yes]";
+var DATA_API_NOTE = "Changes made through the Data API are published; writes your app makes with env.DB are not.";
+var number = (value) => value.toLocaleString("en-US");
+function tableName(table3) {
+  const name = printable(table3.name);
+  return table3.exists ? name : `${name} (dropped)`;
+}
+function realtimeLines(info) {
+  if (!info.enabled)
+    return [
+      "Realtime: not enabled",
+      "Run `naro realtime enable` to turn it on (the project's backend must be on first)."
+    ];
+  const { live: live2 } = info;
+  return [
+    "Realtime: on (public channels: off)",
+    info.tables.length === 0 ? "Published tables: none \u2014 naro realtime tables add <table>" : `Published tables: ${info.tables.map(tableName).join(", ")}`,
+    live2 === null ? "Connections now: not known \u2014 the backend is off or not ready, or the hub did not answer" : `Connections now: ${number(live2.connections)} \xB7 channels ${number(live2.channels)} \xB7 presences ${number(live2.presences)}`
+  ];
+}
+async function enableRealtime(client, projectId) {
+  try {
+    return await client.realtime.enable(projectId);
+  } catch (error) {
+    if (isNaroError(error) && error.code === "TIMEOUT")
+      throw new NaroError(
+        "TIMEOUT",
+        "Turning Realtime on did not answer within 2 minutes. `naro realtime` shows where it got to, and `naro realtime enable` again picks up where it stopped.",
+        { cause: error }
+      );
+    throw error;
+  }
+}
+function tableNames2(context, usage) {
+  if (context.positionals.length === 0)
+    throw new NaroError("VALIDATION_FAILED", usage);
+  return context.positionals;
+}
+async function runRealtimeStatus(context) {
+  const client = await context.client();
+  const projectId = await context.resolveProjectId();
+  const realtime = await client.realtime.info(projectId);
+  context.output.result({ projectId, realtime }, realtimeLines(realtime));
+}
+async function runRealtimeEnable(context) {
+  const client = await context.client();
+  const projectId = await context.resolveProjectId();
+  const realtime = await enableRealtime(client, projectId);
+  context.output.result({ projectId, realtime }, [
+    "\u2705 Realtime is on. Publish a table with naro realtime tables add <table>.",
+    ...realtimeLines(realtime)
+  ]);
+}
+async function runRealtimeTablesList(context) {
+  const client = await context.client();
+  const projectId = await context.resolveProjectId();
+  const tables = await client.realtime.listTables(projectId);
+  context.output.result(
+    { projectId, tables },
+    tables.length === 0 ? [
+      "No published tables. `naro realtime tables add <table>` publishes one."
+    ] : tables.map(
+      (table3) => table3.exists ? `  ${printable(table3.name)}` : `  ${printable(table3.name)}  (dropped: no such table now)`
+    )
+  );
+}
+async function runRealtimeTablesAdd(context) {
+  const names = tableNames2(context, ADD_USAGE);
+  const client = await context.client();
+  const projectId = await context.resolveProjectId();
+  const tables = [];
+  for (const name of names) {
+    const published = await client.realtime.publishTable(projectId, name);
+    tables.push(published);
+    context.output.log(
+      `\u2705 ${printable(published.table)} now publishes its changes (within about 10 seconds).`
+    );
+    for (const warning of published.warnings)
+      if (warning !== DATA_API_NOTE)
+        context.output.log(`\u26A0 ${printable(warning)}`);
+  }
+  context.output.result({ projectId, tables }, [`\u26A0 ${DATA_API_NOTE}`]);
+}
+async function runRealtimeTablesRemove(context) {
+  const names = tableNames2(context, REMOVE_USAGE2);
+  const shown = names.map(printable).join(", ");
+  await confirmOrAbort(
+    context,
+    names.length === 1 ? `Stop publishing ${shown}? Subscribers stop receiving its changes within about 10 seconds.` : `Stop publishing ${shown}? Subscribers stop receiving their changes within about 10 seconds.`
+  );
+  const client = await context.client();
+  const projectId = await context.resolveProjectId();
+  const tables = [];
+  for (const name of names) {
+    const unpublished = await client.realtime.unpublishTable(projectId, name);
+    tables.push(unpublished);
+    context.output.log(
+      `\u2705 ${printable(unpublished.table)} no longer publishes its changes.`
+    );
+  }
+  context.output.result({ projectId, tables });
+}
+
 // src/commands/storage-units.ts
 var SIZE_MESSAGE = "--file-size-limit takes a whole number of bytes, or a size like 5MB (1000s) or 5MiB (1024s), or none.";
 var UNITS = {
@@ -5686,8 +5865,9 @@ function count(n, noun) {
 var CREATE_USAGE3 = "Usage: naro storage bucket create <name> [--public] [--file-size-limit <size>] [--allowed-mime-types <t,\u2026>]";
 var UPDATE_USAGE = "Usage: naro storage bucket update <name> [--public | --private] [--file-size-limit <size> | none] [--allowed-mime-types <t,\u2026> | any]";
 var EMPTY_USAGE = "Usage: naro storage bucket empty <name> [--yes]";
-var REMOVE_USAGE2 = "Usage: naro storage bucket remove <name> [--empty] [--yes]";
+var REMOVE_USAGE3 = "Usage: naro storage bucket remove <name> [--empty] [--yes]";
 var ENABLE_FIRST = "Storage is not enabled yet; enabling it first.";
+var DISABLE_QUESTION3 = "Turn Storage off for this project? Its Storage calls and file URLs answer 404 until naro storage enable; buckets and files are kept.";
 var NO_BUCKETS = "No buckets yet. `naro storage bucket create <name>` makes one.";
 var IDLE_PAGES = 3;
 function bucketLine(bucket) {
@@ -5708,6 +5888,12 @@ function utcClock(iso) {
   const at = new Date(iso);
   return Number.isNaN(at.getTime()) ? null : at.toISOString().slice(11, 16);
 }
+function utcMinute(iso) {
+  const at = new Date(iso);
+  if (Number.isNaN(at.getTime())) return printable(iso);
+  const text = at.toISOString();
+  return `${text.slice(0, 10)} ${text.slice(11, 16)} UTC`;
+}
 function warnedPercent(value, limit) {
   if (limit === null || !(limit > 0)) return null;
   const percent2 = Math.floor(value * 100 / limit);
@@ -5749,6 +5935,13 @@ function meterLines(info) {
   return lines;
 }
 function storageLines(info) {
+  if (info.disabledAt !== null)
+    return [
+      `Storage:     off since ${utcMinute(info.disabledAt)} \u2014 buckets and files are kept`,
+      "Run `naro storage enable` to turn it on again: the same buckets and files come back.",
+      info.buckets.length === 0 ? "Buckets:     none" : `Buckets:     ${String(info.buckets.length)}`,
+      ...info.buckets.map(bucketLine)
+    ];
   if (!info.enabled)
     return [
       "Storage:     off",
@@ -5777,6 +5970,19 @@ async function enableStorage(client, projectId) {
     throw error;
   }
 }
+async function disableStorage(client, projectId) {
+  try {
+    return await client.storage.disable(projectId);
+  } catch (error) {
+    if (isNaroError(error) && error.code === "TIMEOUT")
+      throw new NaroError(
+        "TIMEOUT",
+        "Turning Storage off did not answer within 2 minutes. `naro storage` shows where it got to, and `naro storage disable` again picks up where it stopped.",
+        { cause: error }
+      );
+    throw error;
+  }
+}
 function bucketName(context, usage) {
   if (context.positionals.length !== 1)
     throw new NaroError("VALIDATION_FAILED", usage);
@@ -5813,6 +6019,24 @@ async function runStorageEnable(context) {
     ...storageLines(storage)
   ]);
 }
+async function runStorageDisable(context) {
+  const client = await context.client();
+  const projectId = await context.resolveProjectId();
+  const current = await client.storage.info(projectId);
+  if (current.bucket === null) {
+    context.output.result({ projectId, storage: current }, [
+      "Storage is already off."
+    ]);
+    return;
+  }
+  if (current.disabledAt === null)
+    await confirmOrAbort(context, DISABLE_QUESTION3);
+  const storage = await disableStorage(client, projectId);
+  context.output.result({ projectId, storage }, [
+    "\u2705 Storage is off. Buckets and files are kept; naro storage enable turns it on again.",
+    ...storageLines(storage)
+  ]);
+}
 async function runStorageBucketList(context) {
   const client = await context.client();
   const projectId = await context.resolveProjectId();
@@ -5909,11 +6133,11 @@ async function runStorageBucketEmpty(context) {
   ]);
 }
 async function runStorageBucketRemove(context) {
-  const name = bucketName(context, REMOVE_USAGE2);
+  const name = bucketName(context, REMOVE_USAGE3);
   const empty = context.flags.empty === true;
   refuseSearch(
     context,
-    empty ? `bucket remove --empty deletes every object in the bucket before it removes the bucket. ${REMOVE_USAGE2}` : `bucket remove removes the whole bucket. ${REMOVE_USAGE2}`
+    empty ? `bucket remove --empty deletes every object in the bucket before it removes the bucket. ${REMOVE_USAGE3}` : `bucket remove removes the whole bucket. ${REMOVE_USAGE3}`
   );
   const client = await context.client();
   const projectId = await context.resolveProjectId();
@@ -6013,6 +6237,105 @@ function cryptoUnavailable() {
     message: "This runtime has no crypto.subtle, which signing in with a provider needs (https or localhost)."
   };
 }
+var SERVICE_KEY_OFF_SERVER_MESSAGE = "A Naro service key (naro_sk_\u2026) skips every policy, so createClient accepts it only on a server (Node, Deno, Bun, Cloudflare Workers, an edge runtime), never in a browser, a web worker or a React Native app. Use the anon key (naro_pk_\u2026) here and keep the service key on your server.";
+function websocketUnavailable() {
+  return {
+    code: "WEBSOCKET_UNAVAILABLE",
+    message: "This runtime has no WebSocket. Pass one to createClient({ realtime: { WebSocket } })."
+  };
+}
+function realtimeTimedOut(ms) {
+  const seconds = Math.max(1, Math.round(ms / 1e3));
+  return {
+    code: "TIMED_OUT",
+    message: `The Naro realtime server did not answer within ${String(seconds)} seconds.`
+  };
+}
+function realtimeClosed(code) {
+  return {
+    code: "NETWORK_ERROR",
+    message: `The realtime connection to the Naro backend closed (${String(code)}). It reconnects on its own.`,
+    details: { code }
+  };
+}
+function realtimeDisconnected() {
+  return {
+    code: "ABORTED",
+    message: "The realtime connection was closed by the app (it removed its last channel) before the Naro realtime server answered."
+  };
+}
+function realtimeStopped(code, reason) {
+  return {
+    code: reason === "" ? "NETWORK_ERROR" : reason,
+    message: `The realtime connection to the Naro backend closed (${String(code)}) and does not reconnect.`,
+    details: { code }
+  };
+}
+function socketRefused(error) {
+  return {
+    code: "NETWORK_ERROR",
+    message: "The realtime connection to the Naro backend could not be opened.",
+    details: { cause: error instanceof Error ? error.name : typeof error }
+  };
+}
+function invalidChannel(reason) {
+  return {
+    code: "INVALID_CHANNEL",
+    message: `The channel name is not valid: it ${reason}.`
+  };
+}
+function invalidChannelConfig(path, reason) {
+  return {
+    code: "INVALID_CHANNEL_CONFIG",
+    message: "The channel settings are not valid.",
+    details: { path, reason }
+  };
+}
+function serviceKeyOffServer() {
+  return {
+    code: "SERVICE_KEY_OFF_SERVER",
+    message: SERVICE_KEY_OFF_SERVER_MESSAGE
+  };
+}
+function notJoined(channel) {
+  return {
+    code: "NOT_JOINED",
+    message: `Join ${channel} before sending to it.`
+  };
+}
+function invalidBroadcast() {
+  return {
+    code: "INVALID_MESSAGE",
+    message: "The message is not a valid Naro realtime frame.",
+    details: { reason: "needs type broadcast" }
+  };
+}
+function invalidPresence() {
+  return {
+    code: "INVALID_MESSAGE",
+    message: "The message is not a valid Naro realtime frame.",
+    details: { reason: "needs a presence payload object" }
+  };
+}
+function frameTooLarge(limit) {
+  return {
+    code: "INVALID_MESSAGE",
+    message: "The message is not a valid Naro realtime frame.",
+    details: { reason: `is larger than ${String(limit)} bytes` }
+  };
+}
+function clientFlooding(perSecond) {
+  return {
+    code: "CLIENT_FLOODING",
+    message: `This connection is sending messages faster than a connection may (${String(perSecond)} a second), so this one was not sent. Send less often.`
+  };
+}
+function channelClosed() {
+  return {
+    code: "CHANNEL_CLOSED",
+    message: "The Naro realtime server closed this channel."
+  };
+}
 function describe(cause) {
   if (cause instanceof Error) return `${cause.name}: ${cause.message}`;
   return String(cause);
@@ -6035,9 +6358,9 @@ function errorFromBody(status, body) {
   if (status >= 200 && status < 300) return null;
   return invalidResponse(status);
 }
-var AUTH_PREFIX = "/auth/";
+var SESSION_PREFIXES = ["/auth/", "/realtime/"];
 function storeFor(config, path) {
-  return path.startsWith(AUTH_PREFIX) ? config.tokens : config.accessJwt ?? null;
+  return SESSION_PREFIXES.some((prefix) => path.startsWith(prefix)) ? config.tokens : config.accessJwt ?? null;
 }
 async function receive(config, options, init) {
   const controller = options.timeoutMs !== void 0 && typeof AbortController === "function" ? new AbortController() : null;
@@ -6189,7 +6512,9 @@ var RETRY_AFTER_CODES = /* @__PURE__ */ new Set([
   // Storage (original spec §13): one object written twice within a second
   // (`x-retry-after: 1`), and the daily operation limit (3-1d).
   "OBJECT_RATE_LIMITED",
-  "STORAGE_OPS_QUOTA_EXCEEDED"
+  "STORAGE_OPS_QUOTA_EXCEEDED",
+  // Realtime's REST broadcast over the project's message budget (x-retry-after: 1).
+  "TOO_MANY_MESSAGES"
 ]);
 function withRetryAfter(error, headers) {
   const header = headers.get("x-retry-after")?.trim() ?? "";
@@ -6768,7 +7093,7 @@ var MAX_FLOWS = 10;
 function isEntry(value) {
   return typeof value === "object" && value !== null && typeof value.verifier === "string" && typeof value.expiresAt === "number";
 }
-function live(text, now) {
+function live(text, now2) {
   if (text === null) return {};
   let parsed;
   try {
@@ -6779,7 +7104,7 @@ function live(text, now) {
   if (typeof parsed !== "object" || parsed === null) return {};
   const entries = {};
   for (const [flow, entry] of Object.entries(parsed))
-    if (isEntry(entry) && entry.expiresAt > now) entries[flow] = entry;
+    if (isEntry(entry) && entry.expiresAt > now2) entries[flow] = entry;
   return entries;
 }
 function pick(entries, oldest) {
@@ -6795,16 +7120,16 @@ function serialize(entries) {
 var FlowVerifiers = class {
   #store;
   #now;
-  constructor(store, now = Date.now) {
+  constructor(store, now2 = Date.now) {
     this.#store = store;
-    this.#now = now;
+    this.#now = now2;
   }
   /** Keeps `verifier` for the flow `flow`, for ten minutes. */
   async add(flow, verifier) {
-    const now = this.#now();
+    const now2 = this.#now();
     await this.#store.update((text) => {
-      const entries = live(text, now);
-      entries[flow] = { verifier, expiresAt: now + FLOW_TTL_MS };
+      const entries = live(text, now2);
+      entries[flow] = { verifier, expiresAt: now2 + FLOW_TTL_MS };
       while (Object.keys(entries).length > MAX_FLOWS) {
         const oldest = pick(entries, true);
         if (oldest === void 0) break;
@@ -6819,10 +7144,10 @@ var FlowVerifiers = class {
    * expired.
    */
   async take(flow) {
-    const now = this.#now();
+    const now2 = this.#now();
     let taken = null;
     await this.#store.update((text) => {
-      const entries = live(text, now);
+      const entries = live(text, now2);
       const id = flow ?? pick(entries, false);
       if (id !== void 0 && Object.hasOwn(entries, id)) {
         taken = entries[id]?.verifier ?? null;
@@ -6847,9 +7172,9 @@ function parse(text) {
 var RecoveryToken = class {
   #store;
   #now;
-  constructor(store, now = () => Date.now()) {
+  constructor(store, now2 = () => Date.now()) {
     this.#store = store;
-    this.#now = now;
+    this.#now = now2;
   }
   /** Keeps the token a recovery link brought, for 15 minutes. */
   async keep(token) {
@@ -6858,11 +7183,11 @@ var RecoveryToken = class {
   }
   /** The token, while it lasts; an expired or unreadable one is cleared. */
   async current() {
-    const now = this.#now();
+    const now2 = this.#now();
     let token = null;
     await this.#store.update((text) => {
       const kept = parse(text);
-      if (kept === null || kept.expiresAt <= now) return null;
+      if (kept === null || kept.expiresAt <= now2) return null;
       token = kept.token;
       return text;
     });
@@ -6922,6 +7247,8 @@ var TokenStore = class {
   #fallback = null;
   /** Settles when the last queued operation has finished. */
   #queue = Promise.resolve();
+  /** Called after each write; see `subscribe`. */
+  #listeners = /* @__PURE__ */ new Set();
   constructor(storage, key) {
     this.#storage = storage;
     this.#key = key;
@@ -6930,21 +7257,31 @@ var TokenStore = class {
     return this.#serial(() => this.#get());
   }
   set(token) {
-    return this.#serial(() => this.#set(token));
+    return this.#serial(async () => {
+      await this.#set(token);
+      this.#changed();
+    });
   }
   clear() {
-    return this.#serial(() => this.#clear());
+    return this.#serial(async () => {
+      await this.#clear();
+      this.#changed();
+    });
   }
   /**
-   * Clears only if the stored token is still the one that was rejected. A
-   * request that left with an old token can come back after the user signed
-   * in again; its INVALID_SESSION must not sign the new session out. The
-   * read and the removal are one operation: with an async storage, a sign-in
-   * that lands between them would otherwise be the token removed.
+   * Clears only if the stored token is still the one that was rejected, and
+   * says whether it did. A request that left with an old token can come back
+   * after the user signed in again; its INVALID_SESSION must not sign the
+   * new session out. The read and the removal are one operation: with an
+   * async storage, a sign-in that lands between them would otherwise be the
+   * token removed.
    */
   clearIf(token) {
     return this.#serial(async () => {
-      if (await this.#get() === token) await this.#clear();
+      if (await this.#get() !== token) return false;
+      await this.#clear();
+      this.#changed();
+      return true;
     });
   }
   /**
@@ -6957,17 +7294,42 @@ var TokenStore = class {
       const next = transform(await this.#get());
       if (next === null) await this.#clear();
       else await this.#set(next);
+      this.#changed();
     });
   }
   /** Stores `next` only if `expected` is still stored, as one operation. */
   replaceIf(expected, next) {
     return this.#serial(async () => {
-      if (await this.#get() === expected) await this.#set(next);
+      if (await this.#get() !== expected) return;
+      await this.#set(next);
+      this.#changed();
     });
   }
+  /**
+   * Calls `listener` after every write of the token — a sign-in, a
+   * sign-out, a renewed session, a cleared INVALID_SESSION — from inside the
+   * write's turn, so a `get()` it starts reads the value just written — or
+   * that of a write already queued behind it, which calls the listener
+   * again. The Realtime connection (Realtime 3-2d) uses it to tell the hub.
+   * What a listener throws is its own: the write has happened and stands.
+   */
+  subscribe(listener) {
+    this.#listeners.add(listener);
+    return () => {
+      this.#listeners.delete(listener);
+    };
+  }
+  #changed() {
+    for (const listener of Array.from(this.#listeners)) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  }
   /**
    * Runs `operation` once every earlier one has finished. The operations
-   * below never reject, and none of them calls a public method (that would
+   * below never reject, and none of them awaits a public method (that would
    * wait on itself).
    */
   #serial(operation) {
@@ -7368,10 +7730,10 @@ function truth2(text) {
 var DECIMAL3 = /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/;
 function exactNumber2(text) {
   if (!DECIMAL3.test(text)) return text;
-  const number = Number(text);
-  if (!text.includes(".")) return Number.isSafeInteger(number) ? number : text;
+  const number2 = Number(text);
+  if (!text.includes(".")) return Number.isSafeInteger(number2) ? number2 : text;
   const trimmed = text.replace(/\.?0+$/, "");
-  return String(number) === trimmed ? number : text;
+  return String(number2) === trimmed ? number2 : text;
 }
 function keyword2(text, at) {
   const word = text.toLowerCase();
@@ -7773,54 +8135,2107 @@ var TableBuilder = class {
     });
   }
 };
-function fail(error) {
-  return { data: null, error };
+var BACKOFF_STEPS_MS = [1e3, 2e3, 5e3, 1e4];
+var RATE_LIMITED_MIN_MS = 5e3;
+var IP_LIMIT_WAIT_MS = 6e4;
+var RESTART_JITTER_MS = 1e4;
+var UNOPENED_SLOWDOWN_AFTER = 6;
+var UNOPENED_DELAY_MS = 6e4;
+var STOP_CODES = /* @__PURE__ */ new Set([
+  1e3,
+  4e3,
+  4001,
+  4003,
+  4004,
+  4410
+]);
+function closeAction(code, reason) {
+  if (STOP_CODES.has(code)) return { kind: "stop" };
+  if (code === 4401) return { kind: "session" };
+  if (code === 4503) return { kind: "restart" };
+  if (code === 4029)
+    return reason === "IP_RATE_LIMITED" ? { kind: "wait", ms: IP_LIMIT_WAIT_MS } : { kind: "retry", minMs: RATE_LIMITED_MIN_MS };
+  return { kind: "retry", minMs: 0 };
+}
+function backoffMs(attempt22, random) {
+  const step = BACKOFF_STEPS_MS[Math.min(attempt22, BACKOFF_STEPS_MS.length - 1)] ?? 1e4;
+  return Math.round(step * (0.5 + random()));
+}
+function delayAfter(action, state, random) {
+  if (action.kind === "restart")
+    return Math.floor(random() * RESTART_JITTER_MS);
+  if (action.kind === "wait")
+    return action.ms + Math.floor(random() * RESTART_JITTER_MS);
+  const base = state.unopened >= UNOPENED_SLOWDOWN_AFTER ? Math.round(UNOPENED_DELAY_MS * (0.5 + random())) : backoffMs(state.attempt, random);
+  return Math.max(action.kind === "retry" ? action.minMs : 0, base);
+}
+function entryOf(meta) {
+  if (!isRecord(meta) || typeof meta.phx_ref !== "string") return null;
+  const { phx_ref: ref, naro_user_id: user, ...state } = meta;
+  return {
+    ...state,
+    presence_ref: ref,
+    naro_user_id: typeof user === "string" ? user : null
+  };
 }
-var isUploadResult = (value) => isRecord(value) && typeof value.id === "string" && typeof value.path === "string" && typeof value.fullPath === "string";
-function dataOf2(status, body, guard) {
-  if (isRecord(body) && Object.hasOwn(body, "data") && guard(body.data))
-    return { data: body.data, error: null };
-  return fail(invalidResponse(status));
+function entriesOf(value) {
+  const read = /* @__PURE__ */ new Map();
+  if (!isRecord(value)) return read;
+  for (const [key, item] of Object.entries(value)) {
+    if (!isRecord(item) || !Array.isArray(item.metas)) continue;
+    const entries = item.metas.map(entryOf).filter((entry) => entry !== null);
+    if (entries.length > 0) read.set(key, entries);
+  }
+  return read;
 }
-async function readJson(response, guard) {
-  let text;
+function without(entries, gone) {
+  return entries.filter(
+    (entry) => !gone.some((left) => left.presence_ref === entry.presence_ref)
+  );
+}
+function copies(entries) {
+  return entries.map((entry) => ({ ...entry }));
+}
+var Presence = class {
+  #state = /* @__PURE__ */ new Map();
+  /** A presence_state came for the current join: diffs apply only after it. */
+  #synced = false;
+  state() {
+    return Object.fromEntries(
+      [...this.#state].map(([key, entries]) => [key, copies(entries)])
+    );
+  }
+  /** A new join, or the connection dropped: what is here stays until its presence_state. */
+  unsync() {
+    this.#synced = false;
+  }
+  clear() {
+    this.#state = /* @__PURE__ */ new Map();
+    this.#synced = false;
+  }
+  /**
+   * No presence_state will say what is here any more (a join that may not
+   * read presence, one refused, the server's close, a stop — plan 정정
+   * (k)): each key leaves, then sync — said only when someone was here. A
+   * diff waits for the next presence_state.
+   */
+  leaveAll(emit) {
+    if (this.#state.size > 0) this.applyState({}, emit);
+    this.#synced = false;
+  }
+  applyState(payload, emit) {
+    const before = this.#state;
+    const next = entriesOf(payload);
+    this.#state = next;
+    this.#synced = true;
+    for (const [key, entries] of next) {
+      const held = before.get(key) ?? [];
+      const added = without(entries, held);
+      if (added.length > 0) emit.join(key, copies(added), copies(held));
+    }
+    for (const [key, entries] of before) {
+      const left = without(entries, next.get(key) ?? []);
+      if (left.length > 0)
+        emit.leave(key, copies(left), copies(next.get(key) ?? []));
+    }
+    emit.sync();
+  }
+  applyDiff(payload, emit) {
+    if (!this.#synced || !isRecord(payload)) return;
+    for (const [key, added] of entriesOf(payload.joins)) {
+      const held = this.#state.get(key) ?? [];
+      this.#state.set(key, [...without(held, added), ...added]);
+      emit.join(key, copies(added), copies(held));
+    }
+    for (const [key, left] of entriesOf(payload.leaves)) {
+      const current = without(this.#state.get(key) ?? [], left);
+      if (current.length > 0) this.#state.set(key, current);
+      else this.#state.delete(key);
+      emit.leave(key, copies(left), copies(current));
+    }
+    emit.sync();
+  }
+};
+var REALTIME_PROTOCOL_VERSION = "1.0.0";
+var PHOENIX_TOPIC = "phoenix";
+var REALTIME_TOPIC_PREFIX = "realtime:";
+var HEARTBEAT_REQUEST = '{"topic":"phoenix","event":"heartbeat","payload":{},"ref":"hb"}';
+var HEARTBEAT_REF = "hb";
+var MAX_CHANNEL_NAME_LENGTH = 128;
+var CONNECTION_FRAMES_PER_SECOND = 10;
+var CONNECTION_FRAME_BURST = 120;
+var WARNED_CODES = /* @__PURE__ */ new Set([
+  "TOO_MANY_JOINS",
+  "TOO_MANY_MESSAGES",
+  "TOO_MANY_PRESENCE_MESSAGES"
+]);
+var FLOOD_WINDOW_MS = 6e4;
+var MAX_CHANGE_CHANNELS_PER_TABLE = 4;
+var CHANGE_CHANNELS_REASON = `would put more than ${String(MAX_CHANGE_CHANNELS_PER_TABLE)} channels of this connection on one table's changes (* counts for every table): add the subscription to a channel it already has`;
+function readServerFrame(data) {
+  if (typeof data !== "string") return null;
+  let value;
   try {
-    text = await response.text();
-  } catch (error) {
-    return fail(networkError(error));
+    value = JSON.parse(data);
+  } catch {
+    return null;
   }
-  let body;
+  if (!isRecord(value)) return null;
+  const { topic, event, payload, ref } = value;
+  const joinRef = value.join_ref;
+  if (typeof topic !== "string" || typeof event !== "string") return null;
+  if (!isRecord(payload)) return null;
+  return {
+    topic,
+    event,
+    payload,
+    ref: typeof ref === "string" ? ref : null,
+    joinRef: typeof joinRef === "string" ? joinRef : null
+  };
+}
+function frameLimitOf(reason) {
+  if (typeof reason !== "string") return null;
+  const match = /^is larger than (\d+) bytes$/.exec(reason);
+  return match === null ? null : Number(match[1]);
+}
+function utf8Length(text) {
+  let bytes = 0;
+  for (let index = 0; index < text.length; index++) {
+    const unit = text.charCodeAt(index);
+    if (unit < 128) bytes += 1;
+    else if (unit < 2048) bytes += 2;
+    else if (unit >= 55296 && unit <= 56319 && index + 1 < text.length) {
+      const next = text.charCodeAt(index + 1);
+      if (next >= 56320 && next <= 57343) {
+        bytes += 4;
+        index++;
+      } else bytes += 3;
+    } else bytes += 3;
+  }
+  return bytes;
+}
+function clientFrame(topic, event, payload, ref, joinRef) {
+  return JSON.stringify(
+    joinRef === void 0 ? { topic, event, payload, ref } : { topic, event, payload, ref, join_ref: joinRef }
+  );
+}
+function atMostCodePoints(text, max) {
+  if (text.length <= max) return true;
+  return text.length <= max * 2 && [...text].length <= max;
+}
+function hasControlCharacter(text) {
+  for (let i = 0; i < text.length; i += 1) {
+    const code = text.charCodeAt(i);
+    if (code <= 31 || code >= 127 && code <= 159) return true;
+  }
+  return false;
+}
+function hasBidiControl(text) {
+  for (let i = 0; i < text.length; i += 1) {
+    const code = text.charCodeAt(i);
+    if (code === 1564 || code === 8206 || code === 8207 || code >= 8234 && code <= 8238 || code >= 8294 && code <= 8297)
+      return true;
+  }
+  return false;
+}
+function channelNameProblem(name) {
+  if (name === "") return "is empty";
+  if (!atMostCodePoints(name, MAX_CHANNEL_NAME_LENGTH))
+    return `is longer than ${String(MAX_CHANNEL_NAME_LENGTH)} characters`;
+  if (hasControlCharacter(name)) return "has a control character";
+  if (hasBidiControl(name)) return "has a bidirectional control character";
+  return void 0;
+}
+function socketUrl(baseUrl, apiKey) {
+  const url = new URL("/_naro/v1/realtime/websocket", baseUrl);
+  url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
+  return `${url.href}?apikey=${encodeURIComponent(apiKey)}&vsn=${REALTIME_PROTOCOL_VERSION}`;
+}
+var HEARTBEAT_MS = 25e3;
+var TIMEOUT_MS = 1e4;
+var PACED_BURST = CONNECTION_FRAME_BURST - 20;
+var SDK_WARNING_ROOM = 6;
+var ignore = () => void 0;
+function now() {
+  return typeof performance === "undefined" ? Date.now() : performance.now();
+}
+function detach(ws) {
+  ws.onopen = null;
+  ws.onmessage = null;
+  ws.onclose = null;
+  ws.onerror = ignore;
+}
+function closeQuietly(ws, code) {
   try {
-    body = JSON.parse(text);
+    ws.close(code);
   } catch {
-    return fail(invalidResponse(response.status));
   }
-  return dataOf2(response.status, body, guard);
 }
-var ROUTE = "/storage/upload/multipart";
-var UPLOAD_TOKEN_HEADER = "x-naro-upload-token";
-var CONCURRENCY = 4;
-var ATTEMPTS = 4;
-var BACKOFF_MS = [1e3, 2e3, 4e3];
-var UPLOAD_ID = /^[\w-][\w.-]*$/;
-var positive = (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0;
-var planFor = (size) => (value) => isRecord(value) && typeof value.uploadId === "string" && UPLOAD_ID.test(value.uploadId) && positive(value.partSize) && positive(value.partCount) && (value.partCount - 1) * value.partSize < size && value.partCount * value.partSize >= size;
-var partAnswer = (n) => (value) => isRecord(value) && value.partNumber === n && typeof value.etag === "string" && value.etag !== "";
-var retryable = (error, status) => error.code === "NETWORK_ERROR" || error.code === "OBJECT_RATE_LIMITED" || status !== null && status >= 500 && error.code !== "STORAGE_QUOTA_EXCEEDED";
-function waitAfter(error, attempt22) {
-  const after = isRecord(error.details) ? error.details.retryAfter : void 0;
-  if (typeof after === "number") return after * 1e3;
-  if (error.code === "OBJECT_RATE_LIMITED") return 1e3;
-  return BACKOFF_MS[attempt22 - 1] ?? 4e3;
+function safely(callback) {
+  try {
+    callback();
+  } catch (error) {
+    queueMicrotask(() => {
+      throw error;
+    });
+  }
 }
-var sleepFor = (ms, signal) => new Promise((done) => {
-  if (signal?.aborted) {
-    done();
-    return;
+function replyOf(payload) {
+  if (payload.status === "ok") {
+    const { response } = payload;
+    return {
+      ok: true,
+      response: typeof response === "object" && response !== null && !Array.isArray(response) ? response : {}
+    };
   }
-  const end = () => {
-    clearTimeout(timer);
-    signal?.removeEventListener("abort", end);
+  return {
+    ok: false,
+    error: asError(payload.response) ?? invalidResponse(101),
+    lost: false
+  };
+}
+var RealtimeSocket = class {
+  #config;
+  #heartbeatMs;
+  #timeoutMs;
+  #ws = null;
+  #state = "idle";
+  #generation = 0;
+  /** Drops since the hub last answered: the next wait's step (결정 7). */
+  #attempt = 0;
+  /** Tries in a row that never opened (결정 9). */
+  #unopened = 0;
+  /** When the wait the last close or stop set ends: no connect() opens before it. */
+  #resumeAt = 0;
+  /**
+   * The last close was 4008 (CLIENT_FLOODING), and no heartbeat was
+   * answered since: a channel's word that the hub answered does not start
+   * the backoff over — a connection that floods again must not come back
+   * every second (PR #328 review).
+   */
+  #flooded = false;
+  /**
+   * The frames waiting their turn on this connection, in the order they
+   * go: the first `#ahead` before the app's (`#enqueue`).
+   */
+  #queue = [];
+  /** How many at the front of `#queue` go before the app's frames: the SDK's own and the identity's, and the app's an identity frame must not pass. */
+  #ahead = 0;
+  /** The app's frames in `#queue`: not in flight yet, so no room is kept for them (`#hasRoom`). */
+  #appQueued = 0;
+  /** The budget this connection has left (`PACED_BURST` at the open), as of `#tokensAt`. */
+  #tokens = 0;
+  #tokensAt = 0;
+  #paceTimer;
+  /** When the hub refused a frame on this connection with a warning (`WARNED_CODES`), oldest first. */
+  #warnings = [];
+  /** The SDK's own frames waiting for room, by who sends them, in the order they asked (`whenRoom()`). */
+  #roomWaiters = /* @__PURE__ */ new Map();
+  /** Due when the oldest warning leaves the window, while a frame waits for room. */
+  #roomTimer;
+  #draining = false;
+  #ref = 0;
+  #retryTimer;
+  #openTimer;
+  #heartbeat;
+  #heartbeatPending = false;
+  /** The connection-level `system` frame since the open: why it is about to close. */
+  #said = null;
+  /**
+   * The size limit the hub named when it refused a frame on this
+   * connection (`#refusedOverLimit`): a frame over it is answered so without
+   * being sent. Forgotten with the connection — the next hub's plan may
+   * differ.
+   */
+  #frameLimit = null;
+  #replies = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.#config = config;
+    this.#heartbeatMs = config.options.heartbeatIntervalMs ?? HEARTBEAT_MS;
+    this.#timeoutMs = config.options.timeoutMs ?? TIMEOUT_MS;
+  }
+  get generation() {
+    return this.#generation;
+  }
+  get timeoutMs() {
+    return this.#timeoutMs;
+  }
+  isOpen() {
+    return this.#state === "open";
+  }
+  nextRef() {
+    this.#ref += 1;
+    return String(this.#ref);
+  }
+  /**
+   * Opens unless a connection is open, opening or due — once the wait the
+   * last close or stop set is over. After the app's own close the counts
+   * start over; after a stop they go on, as after a drop.
+   */
+  connect() {
+    if (this.#state !== "idle" && this.#state !== "stopped") return;
+    if (this.#state === "idle") {
+      this.#attempt = 0;
+      this.#unopened = 0;
+    }
+    const wait = this.#resumeAt - now();
+    if (wait <= 0) return this.#open();
+    this.#state = "waiting";
+    this.#retryTimer = setTimeout(() => {
+      this.#retryTimer = void 0;
+      if (this.#state === "waiting") this.#open();
+    }, wait);
+  }
+  /** The last channel went: close for good, with no event. */
+  disconnect() {
+    const ws = this.#ws;
+    this.#ws = null;
+    this.#clearTimers();
+    this.#state = "idle";
+    this.#said = null;
+    this.#failReplies(realtimeDisconnected());
+    if (ws !== null) {
+      detach(ws);
+      closeQuietly(ws, 1e3);
+    }
+  }
+  /**
+   * Lets go of the open connection and comes back as after a drop (1006),
+   * the channels told: for a connection that holds an identity the app no
+   * longer means and cannot change (identity.ts). Nothing unless open.
+   */
+  reconnect() {
+    const ws = this.#ws;
+    if (ws === null || this.#state !== "open") return;
+    detach(ws);
+    closeQuietly(ws, 1e3);
+    this.#closed(ws, 1006, "", null);
+  }
+  /**
+   * The hub answered this connection: the next drop waits from the first
+   * step — unless the last close was 4008 and no heartbeat was answered
+   * since (`#flooded`).
+   */
+  served() {
+    if (!this.#flooded) this.#attempt = 0;
+  }
+  /**
+   * A frame, in its `turn` (the app's unless said), and the `phx_reply`
+   * with its `ref` within `timeoutMs` of when it went — or, for one over the
+   * size limit the hub named on this connection, that refusal at once and
+   * nothing sent; for an app's frame but a leave that would not go within
+   * `timeoutMs`, CLIENT_FLOODING at once and nothing sent.
+   */
+  request(topic, event, payload, options = {}) {
+    const ref = options.ref ?? this.nextRef();
+    const turn = options.turn ?? "app";
+    return new Promise((resolve7) => {
+      const lost = {
+        ok: false,
+        error: realtimeClosed(1006),
+        lost: true
+      };
+      if (!this.isOpen()) return resolve7(lost);
+      let text;
+      try {
+        text = clientFrame(topic, event, payload, ref, options.joinRef);
+      } catch {
+        return resolve7(lost);
+      }
+      const bytes = utf8Length(text);
+      const limit = this.#frameLimit;
+      if (limit !== null && bytes > limit)
+        return resolve7({ ok: false, error: frameTooLarge(limit), lost: false });
+      if (turn === "app" && event !== "phx_leave" && !this.#goesInTime())
+        return resolve7({
+          ok: false,
+          error: clientFlooding(CONNECTION_FRAMES_PER_SECOND),
+          lost: false
+        });
+      this.#replies.set(ref, { resolve: resolve7, timer: void 0, bytes, turn });
+      this.#enqueue({ text, bytes, ref, turn, presence: event === "presence" });
+    });
+  }
+  /**
+   * Whether an app's frame behind every frame waiting would go within
+   * `timeoutMs`: past the budget left, the hub takes
+   * `CONNECTION_FRAMES_PER_SECOND` a second. The SDK's own frames that come
+   * later go before it, a few at most (`whenRoom()`).
+   */
+  #goesInTime() {
+    this.#refill();
+    const over = this.#queue.length + 1 - this.#tokens;
+    return over <= CONNECTION_FRAMES_PER_SECOND * this.#timeoutMs / 1e3;
+  }
+  /**
+   * Runs `go` once a frame the SDK sends of its own accord may go: at once
+   * when nothing waits before it and there is room — the warnings of the
+   * last minute and the requests in flight fewer than `SDK_WARNING_ROOM`
+   * (the app's frames still waiting their turn are not in flight yet, and
+   * go after the SDK's), or the warnings fewer and none of the SDK's own
+   * unanswered — or else when there is, in the order asked. The
+   * frame itself is sent with `turn: "sdk"`. `key` names the sender:
+   * asked again before it ran, it keeps its place and runs the newer `go`,
+   * which reads its own state again then. Nothing while the connection is
+   * not open, and forgotten with it: the sender tries again when it is live.
+   */
+  whenRoom(key, go) {
+    if (this.#state !== "open") return;
+    if (this.#roomWaiters.size === 0 && this.#hasRoom()) return go();
+    this.#roomWaiters.set(key, go);
+    this.#armRoom();
+  }
+  /**
+   * Room for one more frame of the SDK's own (`whenRoom()`): the requests
+   * that count are those sent and not answered, and the SDK's own still to
+   * go — not the app's waiting their turn, which the SDK's go before (PR
+   * #328 re-review). And while none of the SDK's own is unanswered, one
+   * goes whatever the app has in flight, if the warnings leave room (PR #328
+   * re-review 2): an app sending 10 a second over a link of 0.7 s or more
+   * always has six in flight, and a second channel's join would wait,
+   * untold, for as long as it sends. A refusal of the app's is a warning
+   * when it comes, so the SDK adds one at most.
+   */
+  #hasRoom() {
+    if (this.#state !== "open") return false;
+    const since = now() - FLOOD_WINDOW_MS;
+    this.#warnings = this.#warnings.filter((at) => at > since);
+    const warnings = this.#warnings.length;
+    if (warnings >= SDK_WARNING_ROOM) return false;
+    const inFlight2 = this.#replies.size - this.#appQueued;
+    return warnings + inFlight2 < SDK_WARNING_ROOM || !this.#sdkUnanswered();
+  }
+  /** Whether a request of the SDK's own or the identity's waits for its answer, sent or still to go. */
+  #sdkUnanswered() {
+    for (const waiter of this.#replies.values())
+      if (waiter.turn !== "app") return true;
+    return false;
+  }
+  /** The frames waiting for room go while there is: after an answer, a time-out, and when a warning leaves the window. */
+  #drainRoom() {
+    if (this.#draining) return;
+    this.#draining = true;
+    try {
+      for (const [key, go] of this.#roomWaiters) {
+        if (!this.#hasRoom()) break;
+        this.#roomWaiters.delete(key);
+        safely(go);
+      }
+    } finally {
+      this.#draining = false;
+    }
+    this.#armRoom();
+  }
+  /** While a frame waits for room the warnings hold, look again when the oldest leaves the window. */
+  #armRoom() {
+    clearTimeout(this.#roomTimer);
+    this.#roomTimer = void 0;
+    const oldest = this.#warnings[0];
+    if (this.#roomWaiters.size === 0 || oldest === void 0) return;
+    this.#roomTimer = setTimeout(
+      () => {
+        this.#roomTimer = void 0;
+        this.#drainRoom();
+      },
+      Math.max(1, oldest + FLOOD_WINDOW_MS - now() + 1)
+    );
+  }
+  /**
+   * Puts `frame` in its turn and sends what may go. The app's go last; the
+   * SDK's own and the identity's after the others before the app's. An
+   * identity frame goes after the app's presence frames still to go, with
+   * whatever waits before them: the hub reads a presence as the user it
+   * holds when the frame comes, and would hold the last user's state for the
+   * new one.
+   */
+  #enqueue(frame) {
+    if (frame.turn === "app") {
+      this.#queue.push(frame);
+      this.#appQueued += 1;
+    } else {
+      if (frame.turn === "identity") this.#ahead = this.#pastPresence();
+      this.#queue.splice(this.#ahead, 0, frame);
+      this.#ahead += 1;
+    }
+    this.#flush();
+  }
+  /** Just past the app's last presence frame still to go — `#ahead` when none is. */
+  #pastPresence() {
+    for (let index = this.#queue.length - 1; index >= this.#ahead; index -= 1)
+      if (this.#queue[index]?.presence === true) return index + 1;
+    return this.#ahead;
+  }
+  /** The next frame to go, out of `#queue`. */
+  #next() {
+    const frame = this.#queue.shift();
+    if (frame === void 0) return void 0;
+    if (this.#ahead > 0) this.#ahead -= 1;
+    if (frame.turn === "app") this.#appQueued -= 1;
+    return frame;
+  }
+  /** `ref`'s frame out of `#queue`, if it is still there: answered before it went. */
+  #unqueue(ref) {
+    const index = this.#queue.findIndex((frame2) => frame2.ref === ref);
+    if (index === -1) return;
+    const [frame] = this.#queue.splice(index, 1);
+    if (index < this.#ahead) this.#ahead -= 1;
+    if (frame?.turn === "app") this.#appQueued -= 1;
+  }
+  /**
+   * Sends the frames waiting their turn while the budget has room, in their
+   * turn, and comes back when the next one is due. One whose frame the
+   * socket cannot send is lost now — its close event follows.
+   */
+  #flush() {
+    const ws = this.#ws;
+    if (ws === null || this.#state !== "open") return;
+    this.#refill();
+    while (this.#queue.length > 0 && this.#tokens >= 1) {
+      const frame = this.#next();
+      const waiter = this.#replies.get(frame.ref);
+      if (waiter === void 0) continue;
+      const limit = this.#frameLimit;
+      if (limit !== null && frame.bytes > limit) {
+        this.#answer(frame.ref, {
+          ok: false,
+          error: frameTooLarge(limit),
+          lost: false
+        });
+        continue;
+      }
+      try {
+        ws.send(frame.text);
+      } catch {
+        this.#answer(frame.ref, {
+          ok: false,
+          error: realtimeClosed(1006),
+          lost: true
+        });
+        continue;
+      }
+      this.#tokens -= 1;
+      waiter.timer = this.#timeOut(frame.ref, waiter);
+    }
+    if (this.#queue.length === 0 || this.#paceTimer !== void 0) return;
+    const due = Math.ceil(
+      (1 - this.#tokens) * 1e3 / CONNECTION_FRAMES_PER_SECOND
+    );
+    this.#paceTimer = setTimeout(
+      () => {
+        this.#paceTimer = void 0;
+        this.#flush();
+      },
+      Math.max(1, due)
+    );
+  }
+  /** The budget refilled for the time since it was last looked at, as the hub's bucket refills. */
+  #refill() {
+    const at = now();
+    if (at <= this.#tokensAt) return;
+    this.#tokens = Math.min(
+      PACED_BURST,
+      this.#tokens + (at - this.#tokensAt) / 1e3 * CONNECTION_FRAMES_PER_SECOND
+    );
+    this.#tokensAt = at;
+  }
+  /**
+   * `ref`'s request hears `reply`, now: one fewer in flight — or, answered
+   * before its frame went (over a size limit the hub named), one fewer to
+   * go, and nothing sent.
+   */
+  #answer(ref, reply) {
+    const waiter = this.#replies.get(ref);
+    if (waiter === void 0) return;
+    this.#replies.delete(ref);
+    clearTimeout(waiter.timer);
+    if (waiter.timer === void 0) this.#unqueue(ref);
+    waiter.resolve(reply);
+    this.#drainRoom();
+  }
+  /** TIMED_OUT for `ref`'s request `timeoutMs` after its frame went. */
+  #timeOut(ref, waiter) {
+    return setTimeout(() => {
+      if (this.#replies.get(ref) !== waiter) return;
+      this.#answer(ref, {
+        ok: false,
+        error: realtimeTimedOut(this.#timeoutMs),
+        lost: false
+      });
+    }, this.#timeoutMs);
+  }
+  #open() {
+    const Impl = this.#config.options.WebSocket ?? globalThis.WebSocket;
+    if (typeof Impl !== "function")
+      return this.#stop(websocketUnavailable(), true);
+    if (this.#config.service && !isKnownServer())
+      return this.#stop(serviceKeyOffServer(), true);
+    let ws;
+    try {
+      ws = new Impl(
+        socketUrl(this.#config.baseUrl, this.#config.apiKey)
+      );
+    } catch (error) {
+      return this.#stop(socketRefused(error), true);
+    }
+    this.#generation += 1;
+    this.#ws = ws;
+    this.#state = "connecting";
+    this.#said = null;
+    this.#frameLimit = null;
+    ws.onopen = () => this.#opened(ws);
+    ws.onmessage = (event) => this.#message(ws, event.data);
+    ws.onclose = (event) => this.#closed(ws, event.code, event.reason ?? "", null);
+    ws.onerror = ignore;
+    this.#openTimer = setTimeout(
+      () => this.#closed(ws, 1006, "", this.#timeoutMs),
+      this.#timeoutMs
+    );
+  }
+  #opened(ws) {
+    if (this.#ws !== ws || this.#state !== "connecting") return;
+    clearTimeout(this.#openTimer);
+    this.#openTimer = void 0;
+    this.#state = "open";
+    this.#unopened = 0;
+    this.#heartbeatPending = false;
+    this.#queue = [];
+    this.#ahead = 0;
+    this.#appQueued = 0;
+    this.#tokens = PACED_BURST;
+    this.#tokensAt = now();
+    this.#warnings = [];
+    this.#heartbeat = setInterval(() => this.#beat(ws), this.#heartbeatMs);
+    safely(() => this.#config.events.opened());
+  }
+  #beat(ws) {
+    if (this.#ws !== ws) return;
+    if (this.#heartbeatPending)
+      return this.#closed(ws, 1e3, "", this.#heartbeatMs);
+    this.#heartbeatPending = true;
+    try {
+      ws.send(HEARTBEAT_REQUEST);
+    } catch {
+    }
+  }
+  #message(ws, data) {
+    if (this.#ws !== ws) return;
+    const frame = readServerFrame(data);
+    if (frame === null) return;
+    if (frame.event === "phx_reply" && frame.ref !== null) {
+      if (frame.ref === HEARTBEAT_REF) {
+        this.#heartbeatPending = false;
+        this.#flooded = false;
+        this.#attempt = 0;
+        return;
+      }
+      const reply = replyOf(frame.payload);
+      if (!reply.ok && WARNED_CODES.has(reply.error.code))
+        this.#warnings.push(now());
+      if (this.#replies.has(frame.ref)) {
+        this.#answer(frame.ref, reply);
+        return;
+      }
+    }
+    if (frame.topic === PHOENIX_TOPIC) {
+      if (frame.event === "system") this.#said = asError(frame.payload);
+      else if (frame.event === "phx_reply" && frame.ref === null)
+        this.#refusedOverLimit(frame.payload);
+      return;
+    }
+    safely(() => this.#config.events.frame(frame));
+  }
+  /**
+   * The hub refused a frame over its size limit before reading it (final
+   * review A M3, plan 정정 (m)): it names no `ref`, so no request waits for
+   * it by name — it waited `timeoutMs` and answered TIMED_OUT. But the hub
+   * refuses every frame over the limit, and only those, before anything
+   * else: each request waiting whose frame is over it is one refused so, and
+   * hears it now. The limit stays for the connection.
+   */
+  #refusedOverLimit(payload) {
+    if (payload.status !== "error") return;
+    const error = asError(payload.response);
+    if (error?.code !== "INVALID_MESSAGE" || !isRecord(error.details)) return;
+    const limit = frameLimitOf(error.details.reason);
+    if (limit === null) return;
+    this.#frameLimit = limit;
+    for (const [ref, waiter] of this.#replies)
+      if (waiter.bytes > limit)
+        this.#answer(ref, {
+          ok: false,
+          error: frameTooLarge(limit),
+          lost: false
+        });
+  }
+  /**
+   * `ws` ended: its close event (`waitedMs` null), or a heartbeat or an open
+   * that had no answer in `waitedMs` — then it is let go at once, its
+   * handlers first, since a dead TCP connection can take minutes to report
+   * its close (결정 11).
+   */
+  #closed(ws, code, reason, waitedMs) {
+    if (this.#ws !== ws) return;
+    const wasOpen = this.#state === "open";
+    const timedOut = waitedMs !== null;
+    detach(ws);
+    this.#ws = null;
+    this.#clearTimers();
+    if (timedOut) closeQuietly(ws, 1e3);
+    if (!wasOpen) this.#unopened += 1;
+    const said = this.#said;
+    this.#said = null;
+    if (!timedOut && code === 4008) this.#flooded = true;
+    const action = timedOut ? { kind: "retry", minMs: 0 } : closeAction(code, said?.code ?? reason);
+    if (action.kind === "stop")
+      return this.#stop(said ?? realtimeStopped(code, reason));
+    const error = timedOut ? realtimeTimedOut(waitedMs) : said ?? realtimeClosed(code);
+    this.#failReplies(error);
+    this.#state = "waiting";
+    const delay = delayAfter(
+      action,
+      { attempt: this.#attempt, unopened: this.#unopened },
+      Math.random
+    );
+    if (action.kind !== "restart" && action.kind !== "wait") this.#attempt += 1;
+    this.#wait(action.kind === "session", delay);
+    safely(
+      () => this.#config.events.dropped(
+        error,
+        timedOut ? "TIMED_OUT" : "CHANNEL_ERROR"
+      )
+    );
+  }
+  /**
+   * The next try, `delay` from now — after a 4401, from when its
+   * conditional delete is done, or from `timeoutMs` on if it is not: an
+   * app's `auth.storage` that never answers must not keep the connection
+   * away for good.
+   */
+  #wait(session, delay) {
+    const generation = this.#generation;
+    this.#resumeAt = now() + delay;
+    let due = false;
+    const schedule = () => {
+      if (due || this.#state !== "waiting" || this.#generation !== generation)
+        return;
+      due = true;
+      this.#resumeAt = now() + delay;
+      clearTimeout(this.#retryTimer);
+      this.#retryTimer = setTimeout(() => {
+        this.#retryTimer = void 0;
+        if (this.#state === "waiting") this.#open();
+      }, delay);
+    };
+    if (!session) return schedule();
+    this.#retryTimer = setTimeout(schedule, this.#timeoutMs);
+    safely(() => {
+      void this.#config.events.sessionRefused().then(schedule, schedule);
+    });
+  }
+  /**
+   * Stopped until a connect(), which waits as after a drop: the stop counts
+   * as one (`unopened` when no socket was made — the runtime cannot open).
+   */
+  #stop(error, unopened = false) {
+    this.#clearTimers();
+    this.#state = "stopped";
+    this.#failReplies(error);
+    if (unopened) this.#unopened += 1;
+    this.#resumeAt = now() + delayAfter(
+      { kind: "retry", minMs: 0 },
+      { attempt: this.#attempt, unopened: this.#unopened },
+      Math.random
+    );
+    this.#attempt += 1;
+    safely(() => this.#config.events.stopped(error));
+  }
+  /** Every request still waiting hears `error`, as lost with the connection. */
+  #failReplies(error) {
+    const waiting = [...this.#replies.values()];
+    this.#replies.clear();
+    for (const waiter of waiting) {
+      clearTimeout(waiter.timer);
+      waiter.resolve({ ok: false, error, lost: true });
+    }
+  }
+  /** Every timer of the connection, and the frames still to go with it. */
+  #clearTimers() {
+    clearTimeout(this.#retryTimer);
+    clearTimeout(this.#openTimer);
+    clearInterval(this.#heartbeat);
+    clearTimeout(this.#paceTimer);
+    clearTimeout(this.#roomTimer);
+    this.#retryTimer = void 0;
+    this.#openTimer = void 0;
+    this.#heartbeat = void 0;
+    this.#paceTimer = void 0;
+    this.#roomTimer = void 0;
+    this.#queue = [];
+    this.#ahead = 0;
+    this.#appQueued = 0;
+    this.#roomWaiters.clear();
+  }
+};
+function sent(reply) {
+  return reply.ok ? { data: null, error: null, lost: false } : { data: null, error: reply.error, lost: reply.lost };
+}
+function unsent(error) {
+  return { data: null, error, lost: false };
+}
+function jsonObject(value) {
+  try {
+    const copy = JSON.parse(JSON.stringify(value));
+    return isRecord(copy) ? copy : null;
+  } catch {
+    return null;
+  }
+}
+function presenceReadDenied(response) {
+  const { access } = response;
+  return isRecord(access) && isRecord(access.presence) && access.presence.read === false;
+}
+function tablesOf(changes) {
+  return changes.map((binding) => binding.filter.table ?? "*");
+}
+var JOIN_RETRY_CODES = /* @__PURE__ */ new Set([
+  "TOO_MANY_JOINS",
+  "INTERNAL_ERROR",
+  "TIMED_OUT"
+]);
+var RETRACK_RETRY_CODES = /* @__PURE__ */ new Set([
+  "TOO_MANY_PRESENCE_MESSAGES",
+  "TOO_MANY_MESSAGES",
+  "TOO_MANY_JOINS",
+  "INTERNAL_ERROR",
+  "TIMED_OUT"
+]);
+var RETRACK_WARNED_RESENDS = 3;
+var LATE_LISTENER = "naro-js: postgres_changes and presence listeners added after subscribe() count from the channel's next join; call unsubscribe() and subscribe() again to add them now.";
+function isDevelopment() {
+  const env = globalThis.process?.env;
+  return env?.NODE_ENV !== "production";
+}
+function warnInDevelopment(message) {
+  if (isDevelopment()) console.warn(message);
+}
+function isJson(value) {
+  try {
+    JSON.stringify(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function changeSpec(filter) {
+  const {
+    event,
+    schema,
+    table: table3,
+    filter: text,
+    ...rest
+  } = filter;
+  return {
+    ...rest,
+    event,
+    ...schema === void 0 ? {} : { schema },
+    ...table3 === void 0 ? {} : { table: table3 },
+    ...text === void 0 || text === "" ? {} : { filter: text }
+  };
+}
+function changePayload(data) {
+  return {
+    schema: "public",
+    table: typeof data.table === "string" ? data.table : "",
+    commit_timestamp: typeof data.commit_timestamp === "string" ? data.commit_timestamp : "",
+    eventType: data.type,
+    new: isRecord(data.record) ? data.record : {},
+    old: isRecord(data.old_record) ? data.old_record : {},
+    errors: Array.isArray(data.errors) ? data.errors.filter((item) => typeof item === "string") : null
+  };
+}
+function systemMessage(payload) {
+  const { extension, code, message, channel } = payload;
+  return {
+    status: payload.status === "ok" ? "ok" : "error",
+    extension: typeof extension === "string" ? extension : "system",
+    code: typeof code === "string" ? code : "",
+    message: typeof message === "string" ? message : "",
+    channel: typeof channel === "string" ? channel : null
+  };
+}
+var RealtimeChannel = class {
+  name;
+  topic;
+  isPrivate;
+  options;
+  #context;
+  #bindings = [];
+  #presence = new Presence();
+  #state = "closed";
+  /** subscribe() was called and unsubscribe() was not: join it on every connection. */
+  #wanted = false;
+  /** The join sent and not left or replaced since — set when it is sent, before its answer. */
+  #joinRef = null;
+  /** The tables that join's row subscriptions are on (`*` for every table): its leave holds them. */
+  #joinTables = [];
+  /**
+   * The join was refused a cap a leave owed on the connection still holds
+   * a place under (`ChannelContext.owesLeaveOn`): it waits for that leave
+   * rather than knock again (PR #328 review). Null otherwise.
+   */
+  #capWait = null;
+  #onStatus = null;
+  /** The app already heard of this trouble; reset at SUBSCRIBED. */
+  #told = false;
+  #attempt = 0;
+  #retry;
+  /** The `system` error sent before a `phx_close` (protocol.ts `closeChannel`). */
+  #closeError = null;
+  /** The last state tracked, and the token the hub had then (결정 17). */
+  #tracked = null;
+  /** Bumped when what is tracked is let go of: a track answered after that does not bring it back. */
+  #letGo = 0;
+  /** Bumped by the app's track() and untrack(): one in the SUBSCRIBED callback says what the join holds. */
+  #presenceCalls = 0;
+  /** A track sent again and refused for now goes again when this is due (`#retrack`). */
+  #retrackTimer;
+  /**
+   * The app's presence calls and broadcasts waiting for the connection to
+   * be live, in the order it made them (`#inTurn`): each sends, or answers
+   * that its join went, when called.
+   */
+  #waiting = [];
+  /** Inside subscribe(): a stop is told a microtask later (`#toldStop`). */
+  #subscribing = false;
+  /** Who waits for room on the connection (`whenRoom()`): this channel's join, and its track sent again. */
+  #joinTurn = {};
+  #retrackTurn = {};
+  /**
+   * Frames of the join in flight that came before its answer was handled
+   * (final review A M1, plan 정정 (m)): Node's `ws` and undici hand over
+   * the frames of one read in one callback, while the answer's handler runs
+   * a microtask later — a change right behind the `ok` had no subscription
+   * id yet. They are heard once the `ok` is (after SUBSCRIBED, as in a
+   * browser, which runs a task per message), and dropped with a refusal.
+   */
+  #early = [];
+  /** @internal `naro.channel()` makes channels. */
+  constructor(name, options, context) {
+    this.name = name;
+    this.topic = `${REALTIME_TOPIC_PREFIX}${name}`;
+    this.isPrivate = options.config?.private === true;
+    this.options = options;
+    this.#context = context;
+  }
+  get state() {
+    return this.#state;
+  }
+  /** @internal The join sent and not left or replaced since (client.ts routes by it). */
+  get joinRef() {
+    return this.#joinRef;
+  }
+  on(type, filter, callback) {
+    const listener = callback;
+    const spec = isRecord(filter) ? filter : {};
+    if ((type === "postgres_changes" || type === "presence") && this.#wanted)
+      warnInDevelopment(LATE_LISTENER);
+    if (type === "postgres_changes")
+      this.#bindings.push({
+        type,
+        filter: spec,
+        callback: listener,
+        id: null
+      });
+    else if (type === "broadcast" || type === "presence")
+      this.#bindings.push({
+        type,
+        event: String(spec.event),
+        callback: listener
+      });
+    else if (type === "system")
+      this.#bindings.push({ type, callback: listener });
+    return this;
+  }
+  subscribe(callback) {
+    if (callback !== void 0) this.#onStatus = callback;
+    if (this.#wanted) return this;
+    const problem = this.#nameError();
+    if (problem !== null) {
+      this.#state = "errored";
+      queueMicrotask(() => this.#status("CHANNEL_ERROR", problem));
+      return this;
+    }
+    this.#wanted = true;
+    this.#state = "joining";
+    this.#attempt = 0;
+    this.#told = false;
+    this.#capWait = null;
+    this.#clearRetry();
+    this.#subscribing = true;
+    try {
+      this.#context.connect();
+      this.#joinIfDue();
+    } finally {
+      this.#subscribing = false;
+    }
+    return this;
+  }
+  async unsubscribe() {
+    const ref = this.#joinRef;
+    const held = this.#state === "joined" || this.#state === "joining";
+    this.#wanted = false;
+    this.#clearRetry();
+    this.#letGoOfTrack();
+    this.#joinRef = null;
+    this.#state = "leaving";
+    this.#releaseWaiting();
+    let error = null;
+    if (held && ref !== null) {
+      const reply = await this.#context.leave(this, ref, this.#joinTables);
+      if (!reply.ok && !reply.lost && reply.error.code !== "NOT_JOINED")
+        error = reply.error;
+    }
+    if (this.#state === "leaving") {
+      this.#state = "closed";
+      this.#presence.clear();
+      this.#status("CLOSED");
+    }
+    return { data: null, error };
+  }
+  /**
+   * Broadcasts `message` on the join, or over HTTP before it: the server's
+   * answer, `lost` when the connection went before it (RealtimeSendResult).
+   */
+  async send(message) {
+    if (!isRecord(message) || message.type !== "broadcast")
+      return unsent(invalidBroadcast());
+    const problem = this.#nameError();
+    if (problem !== null) return unsent(problem);
+    const { event, payload } = message;
+    if (!isJson({ event, payload }))
+      return unsent(invalidQuery("", "is not JSON"));
+    const joinRef = this.#joinRef;
+    if (this.#state === "joined" && joinRef !== null) {
+      const reply = await this.#inTurn(
+        joinRef,
+        !this.#context.live(),
+        () => this.#context.socket.request(
+          this.topic,
+          "broadcast",
+          { type: "broadcast", event, payload },
+          { joinRef }
+        )
+      );
+      if (reply !== null) return sent(reply);
+    }
+    await this.#context.auth.ready();
+    const result = await call(this.#context.http, {
+      method: "POST",
+      path: "/realtime/broadcast",
+      body: {
+        messages: [
+          { topic: this.topic, event, payload, private: this.isPrivate }
+        ]
+      },
+      withToken: true
+    });
+    return unsent(result.error);
+  }
+  /**
+   * Tracks `state` as this connection's presence here (original spec
+   * §11.1): the hub's answer. Only on a join — before it, NOT_JOINED, and
+   * nothing is kept for later (결정 18). It goes as its JSON reads back, and
+   * that copy, not the app's object, is what a later join sends again.
+   * While who the connection is is not settled (a new token in flight, a
+   * retry), it waits until it is (정정 (k)): the hub may yet refuse the new
+   * token for now and keep the last user, whose presence it would be.
+   */
+  async track(state) {
+    const problem = this.#nameError();
+    if (problem !== null) return unsent(problem);
+    const joinRef = this.#joinRef;
+    if (this.#state !== "joined" || joinRef === null)
+      return unsent(notJoined(this.name));
+    const payload = jsonObject(state);
+    if (payload === null) return unsent(invalidPresence());
+    this.#presenceCalls += 1;
+    this.#clearRetrack();
+    const letGo = this.#letGo;
+    const reply = await this.#inTurn(
+      joinRef,
+      !this.#context.live(),
+      () => this.#sendTrack(payload, joinRef, letGo, true)
+    );
+    if (reply === null) {
+      if (letGo === this.#letGo) this.#letGoOfTrack();
+      return unsent(notJoined(this.name));
+    }
+    return sent(reply);
+  }
+  /**
+   * Takes this connection's presence off the channel: the hub's answer, or
+   * none when not joined. After the app's tracks that wait, if any.
+   */
+  async untrack() {
+    this.#presenceCalls += 1;
+    this.#letGoOfTrack();
+    const joinRef = this.#joinRef;
+    if (this.#state !== "joined" || joinRef === null) return unsent(null);
+    const reply = await this.#inTurn(
+      joinRef,
+      false,
+      () => this.#context.socket.request(
+        this.topic,
+        "presence",
+        { type: "presence", event: "untrack" },
+        { joinRef }
+      )
+    );
+    return reply === null ? unsent(null) : sent(reply);
+  }
+  /** The presences of the channel, by key (결정 16): a copy. */
+  presenceState() {
+    return this.#presence.state();
+  }
+  /**
+   * @internal
+   * The connection is live, or a leave owed is done (client.ts): join if
+   * the app wants it and the channel holds no join and waits for no retry.
+   * Called whenever either happens, for every channel, so a channel joined
+   * or joining stays as it is.
+   */
+  rejoin() {
+    if (this.#context.live()) this.#releaseWaiting();
+    this.#joinIfDue();
+  }
+  /**
+   * @internal
+   * A leave of this name and privacy owed on the connection was refused, or
+   * not answered in time, and goes again (client.ts): a join waiting on it
+   * tells the app once a wait, as a refused join tried again does (결정 14,
+   * 정정 (j)), and waits on.
+   */
+  leaveRefused(error) {
+    if (this.#wanted && this.#joinRef === null)
+      this.#tell(
+        error.code === "TIMED_OUT" ? "TIMED_OUT" : "CHANNEL_ERROR",
+        error
+      );
+  }
+  /** @internal The connection dropped and comes back: tell the app once, rejoin when live. */
+  dropped(error, status) {
+    if (!this.#wanted) return;
+    this.#clearRetry();
+    this.#capWait = null;
+    this.#joinRef = null;
+    this.#state = "joining";
+    this.#releaseWaiting();
+    this.#presence.unsync();
+    this.#tell(status, error);
+  }
+  /** @internal The connection stopped for good: the app must subscribe() again. */
+  stopped(error) {
+    if (this.#wanted) this.#stop(error);
+  }
+  /** @internal A frame of this channel's join (client.ts routes by join_ref). */
+  receive(frame) {
+    if (this.#state === "joining") {
+      this.#early.push(frame);
+      return;
+    }
+    switch (frame.event) {
+      case "postgres_changes":
+        return this.#change(frame.payload);
+      case "broadcast":
+        return this.#broadcast(frame.payload);
+      case "presence_state":
+        return this.#presence.applyState(frame.payload, this.#presenceEmit);
+      case "presence_diff":
+        return this.#presence.applyDiff(frame.payload, this.#presenceEmit);
+      case "system":
+        return this.#system(frame.payload);
+      case "phx_close":
+        return this.#serverClosed();
+      default:
+        return;
+    }
+  }
+  /**
+   * INVALID_CHANNEL for a name the hub would refuse, before anything is
+   * sent — and before any error of ours quotes the name.
+   */
+  #nameError() {
+    const problem = channelNameProblem(this.name);
+    return problem === void 0 ? null : invalidChannel(problem);
+  }
+  #config(changes) {
+    const config = this.options.config ?? {};
+    const presence = config.presence ?? {};
+    const key = presence.key ?? "";
+    const listens = this.#bindings.some(
+      (binding) => binding.type === "presence"
+    );
+    return {
+      ...config,
+      // ack is always on the wire, so send() always ends in the hub's answer (결정 6).
+      broadcast: {
+        ...config.broadcast,
+        self: config.broadcast?.self ?? false,
+        ack: true
+      },
+      presence: {
+        ...presence,
+        key,
+        enabled: listens || presence.enabled === true || key !== ""
+      },
+      postgres_changes: changes.map((binding) => changeSpec(binding.filter)),
+      private: this.isPrivate
+    };
+  }
+  /**
+   * Joins when due — once there is room on the connection for a frame the
+   * SDK sends of its own accord (`whenRoom()`, PR #328 review), and still
+   * due then.
+   */
+  #joinIfDue() {
+    if (!this.#dueToJoin()) return;
+    this.#context.socket.whenRoom(this.#joinTurn, () => {
+      if (this.#dueToJoin()) this.#join();
+    });
+  }
+  #dueToJoin() {
+    return this.#wanted && this.#joinRef === null && this.#retry === void 0 && this.#context.live() && !this.#context.owesLeave(this) && !this.#heldByCap();
+  }
+  /** A cap refused the last join, and a leave owed still holds the place it needs. */
+  #heldByCap() {
+    const wait = this.#capWait;
+    if (wait === null) return false;
+    if (this.#context.owesLeaveOn(wait.table)) return true;
+    this.#capWait = null;
+    return false;
+  }
+  /**
+   * The cap `error` names, when a leave owed on the connection holds a place
+   * under it (PR #328 review): the hub still counts that join — 100
+   * channels a connection (TOO_MANY_CHANNELS), or 4 on one table's changes
+   * (INVALID_CHANNEL_CONFIG with the hub's `changeChannels` reason at
+   * `config.postgres_changes[<i>].table`, the table of `changes[i]`) — and
+   * lets go of it once the leave goes through. Null for any other refusal.
+   */
+  #capHeld(error, changes) {
+    if (error.code === "TOO_MANY_CHANNELS")
+      return this.#context.owesLeaveOn(null) ? { table: null } : null;
+    if (error.code !== "INVALID_CHANNEL_CONFIG" || !isRecord(error.details))
+      return null;
+    const { path, reason } = error.details;
+    if (reason !== CHANGE_CHANNELS_REASON || typeof path !== "string")
+      return null;
+    const index = /^config\.postgres_changes\[(\d+)\]\.table$/.exec(path)?.[1];
+    const binding = index === void 0 ? void 0 : changes[Number(index)];
+    if (binding === void 0) return null;
+    const table3 = binding.filter.table ?? "*";
+    return this.#context.owesLeaveOn(table3) ? { table: table3 } : null;
+  }
+  #join() {
+    const changes = this.#bindings.filter(
+      (b) => b.type === "postgres_changes"
+    );
+    const config = this.#config(changes);
+    if (!isJson(config))
+      return this.#stop(invalidChannelConfig("config", "is not JSON"));
+    const socket = this.#context.socket;
+    const ref = socket.nextRef();
+    this.#joinRef = ref;
+    this.#joinTables = tablesOf(changes);
+    this.#capWait = null;
+    this.#state = "joining";
+    this.#closeError = null;
+    this.#early = [];
+    this.#presence.unsync();
+    for (const binding of changes) binding.id = null;
+    void socket.request(
+      this.topic,
+      "phx_join",
+      { config },
+      { joinRef: ref, ref, turn: "sdk" }
+    ).then((reply) => this.#joined(ref, changes, reply));
+  }
+  #joined(ref, changes, reply) {
+    if (this.#joinRef !== ref) return;
+    const early = this.#early;
+    this.#early = [];
+    if (reply.ok) {
+      const ids = Array.isArray(reply.response.postgres_changes) ? reply.response.postgres_changes : [];
+      changes.forEach((binding, index) => {
+        const entry = ids[index];
+        binding.id = isRecord(entry) && typeof entry.id === "number" ? entry.id : null;
+      });
+      this.#state = "joined";
+      this.#attempt = 0;
+      this.#told = false;
+      this.#context.socket.served();
+      const calls = this.#presenceCalls;
+      this.#status("SUBSCRIBED");
+      if (this.#presenceCalls === calls) this.#retrack(ref);
+      if (this.#joinRef === ref && presenceReadDenied(reply.response))
+        this.#presence.leaveAll(this.#presenceEmit);
+      for (const frame of early) {
+        if (this.#joinRef !== ref || this.#state !== "joined") break;
+        this.receive(frame);
+      }
+      return;
+    }
+    if (reply.lost) {
+      this.#joinRef = null;
+      return;
+    }
+    const { error } = reply;
+    this.#joinRef = null;
+    const capHeld = this.#capHeld(error, changes);
+    if (capHeld !== null) {
+      this.#capWait = capHeld;
+      this.#state = "joining";
+      this.#tell("CHANNEL_ERROR", error);
+      return;
+    }
+    const meetsOld = error.code === "ALREADY_JOINED" && this.#context.owesLeave(this);
+    if (!JOIN_RETRY_CODES.has(error.code) && !meetsOld) {
+      this.#wanted = false;
+      this.#state = "errored";
+      this.#presence.leaveAll(this.#presenceEmit);
+      this.#status("CHANNEL_ERROR", error);
+      return;
+    }
+    if (error.code === "TIMED_OUT")
+      void this.#context.leave(this, ref, tablesOf(changes));
+    this.#tell(
+      error.code === "TIMED_OUT" ? "TIMED_OUT" : "CHANNEL_ERROR",
+      error
+    );
+    this.#state = "joining";
+    const delay = backoffMs(this.#attempt, Math.random);
+    this.#attempt += 1;
+    this.#retry = setTimeout(() => {
+      this.#retry = void 0;
+      this.#joinIfDue();
+    }, delay);
+  }
+  #change(payload) {
+    const ids = Array.isArray(payload.ids) ? payload.ids : [];
+    if (!isRecord(payload.data)) return;
+    const change2 = changePayload(payload.data);
+    for (const binding of this.#bindings)
+      if (binding.type === "postgres_changes" && binding.id !== null && ids.includes(binding.id))
+        safely(() => binding.callback(change2));
+  }
+  #broadcast(payload) {
+    const { event } = payload;
+    if (typeof event !== "string") return;
+    const message = {
+      type: "broadcast",
+      event,
+      payload: isRecord(payload.payload) ? payload.payload : {}
+    };
+    for (const binding of this.#bindings)
+      if (binding.type === "broadcast" && binding.event === event)
+        safely(() => binding.callback(message));
+  }
+  #system(payload) {
+    const message = systemMessage(payload);
+    if (message.status === "error" && message.extension === "system")
+      this.#closeError = asError(payload);
+    for (const binding of this.#bindings)
+      if (binding.type === "system") safely(() => binding.callback(message));
+  }
+  /** The hub closed this join (lost access, its state full): stop until subscribe(). */
+  #serverClosed() {
+    this.#clearRetry();
+    this.#joinRef = null;
+    this.#wanted = false;
+    this.#state = "errored";
+    this.#letGoOfTrack();
+    this.#releaseWaiting();
+    this.#presence.leaveAll(this.#presenceEmit);
+    this.#status("CHANNEL_ERROR", this.#closeError ?? channelClosed());
+  }
+  /** The listeners' payloads, as supabase-js's: each says which event it is (정정 (k)). */
+  #presenceEmit = {
+    join: (key, newPresences, currentPresences) => {
+      const payload = {
+        event: "join",
+        key,
+        newPresences,
+        currentPresences
+      };
+      this.#presenceCall("join", payload);
+    },
+    leave: (key, leftPresences, currentPresences) => {
+      const payload = {
+        event: "leave",
+        key,
+        leftPresences,
+        currentPresences
+      };
+      this.#presenceCall("leave", payload);
+    },
+    sync: () => this.#presenceCall("sync", void 0)
+  };
+  #presenceCall(event, value) {
+    for (const binding of this.#bindings)
+      if (binding.type === "presence" && binding.event === event)
+        safely(() => binding.callback(value));
+  }
+  /**
+   * One track frame on the join `joinRef`. Its `ok` makes `state` the one
+   * tracked, with the token the hub judged it for — the one it holds once
+   * the identity frames sent before it are handled (`heldToken()`, 정정 (j))
+   * — unless what was tracked was let go of since `letGo` (the app's call,
+   * or now): the hub had that untrack or leave after it. The app's own call
+   * (`app`) is kept as well when no answer came — the connection went with
+   * it, or none in time: the hub may hold it, and it is the state the app
+   * last asked for, so the next join sends it rather than the one before
+   * (PR #328 review). The app's call waits its turn behind the app's frames,
+   * and may be refused for it (CLIENT_FLOODING, nothing kept); one sent
+   * again goes in the SDK's (PR #328 re-review).
+   */
+  #sendTrack(state, joinRef, letGo = this.#letGo, app = false) {
+    const token = this.#context.identity.heldToken();
+    return this.#context.socket.request(
+      this.topic,
+      "presence",
+      { type: "presence", event: "track", payload: state },
+      { joinRef, turn: app ? "app" : "sdk" }
+    ).then((reply) => {
+      const kept = reply.ok || app && (reply.lost || reply.error.code === "TIMED_OUT");
+      if (kept && letGo === this.#letGo) this.#tracked = { state, token };
+      return reply;
+    });
+  }
+  /**
+   * After a join comes back, the last state goes again (original spec §11.1)
+   * — only as the same session: the hub drops a presence when its user
+   * changes (3-2a P10), and a new token here may be someone else (결정 17).
+   * Who the hub reads it as is the token it will hold when the frame comes
+   * (`heldToken()`): a sign-in whose token went after the join would make
+   * the last user's state the new one's. And while who the connection is
+   * is not settled (a store read, a retry), it is let go of (정정 (j)).
+   * A refusal for now (`RETRACK_RETRY_CODES`) sends it again on this join
+   * after the channel backoff, checked as above each time, until the app
+   * tracks or untracks, the channel leaves, or the join goes — after one
+   * the hub warned the connection for, three times at most, and then it
+   * waits for the next join (`WARNED_CODES`); any other refusal lets go of
+   * it; a connection lost before the answer keeps it for the next join.
+   * Each send, the first too, waits its turn for room in the connection's
+   * warnings (`whenRoom()`, PR #328 review).
+   */
+  #retrack(joinRef) {
+    const tracked = this.#tracked;
+    if (tracked === null) return;
+    const calls = this.#presenceCalls;
+    const current = () => this.#tracked === tracked && this.#joinRef === joinRef && this.#presenceCalls === calls;
+    const go = (attempt22, warned) => {
+      if (!current()) return;
+      this.#context.socket.whenRoom(this.#retrackTurn, () => {
+        send2(attempt22, warned);
+      });
+    };
+    const send2 = (attempt22, warned) => {
+      if (!current()) return;
+      if (!this.#context.live() || tracked.token !== this.#context.identity.heldToken())
+        return this.#letGoOfTrack();
+      void this.#sendTrack(tracked.state, joinRef).then((reply) => {
+        if (reply.ok || reply.lost || this.#tracked !== tracked) return;
+        const { code } = reply.error;
+        if (!RETRACK_RETRY_CODES.has(code)) {
+          this.#tracked = null;
+          return;
+        }
+        if (!current()) return;
+        const warning = WARNED_CODES.has(code) ? 1 : 0;
+        if (warned + warning > RETRACK_WARNED_RESENDS) return;
+        const delay = backoffMs(attempt22, Math.random);
+        this.#retrackTimer = setTimeout(() => {
+          this.#retrackTimer = void 0;
+          go(attempt22 + 1, warned + warning);
+        }, delay);
+      });
+    };
+    go(0, 0);
+  }
+  /**
+   * `send` now — or, when `wait` (a track or a broadcast while the
+   * connection is not live) or an earlier call of the app's waits, at
+   * `#releaseWaiting()`, in the order the app made them: the hub must have
+   * them in that order. Null when the join went before its turn: nothing
+   * was sent.
+   */
+  #inTurn(joinRef, wait, send2) {
+    if (!wait && this.#waiting.length === 0) return send2();
+    return new Promise((resolve7) => {
+      this.#waiting.push(
+        () => resolve7(this.#joinRef === joinRef ? send2() : null)
+      );
+    });
+  }
+  /**
+   * The calls that waited go now, in order and all in this turn — a call
+   * made after them must not go first. Called when the connection is live
+   * again, and when the join goes (they answer that it went).
+   */
+  #releaseWaiting() {
+    const waiting = this.#waiting;
+    this.#waiting = [];
+    for (const go of waiting) go();
+  }
+  /** Nothing is tracked from now on, whatever answer comes for a track sent before. */
+  #letGoOfTrack() {
+    this.#tracked = null;
+    this.#letGo += 1;
+    this.#clearRetrack();
+  }
+  #clearRetrack() {
+    clearTimeout(this.#retrackTimer);
+    this.#retrackTimer = void 0;
+  }
+  /**
+   * Stops until subscribe(): no join, no retry, and the app hears `error`.
+   * No presence_state comes until then, so what the app saw goes, as for a
+   * join refused or the server's close (정정 (k)); what was tracked stays,
+   * for a join of the same session after subscribe().
+   */
+  #stop(error) {
+    this.#clearRetry();
+    this.#joinRef = null;
+    this.#wanted = false;
+    this.#state = "errored";
+    this.#releaseWaiting();
+    this.#presence.leaveAll(this.#presenceEmit);
+    this.#toldStop(error);
+  }
+  /**
+   * CHANNEL_ERROR for a stop. Inside subscribe() it comes a microtask later,
+   * as for an invalid name: in `const ch = naro.channel(…).subscribe(cb)`,
+   * `cb` may read `ch`, which is not set until subscribe() returns.
+   */
+  #toldStop(error) {
+    if (this.#subscribing)
+      queueMicrotask(() => this.#status("CHANNEL_ERROR", error));
+    else this.#status("CHANNEL_ERROR", error);
+  }
+  #tell(status, error) {
+    if (this.#told) return;
+    this.#told = true;
+    this.#status(status, error);
+  }
+  #status(status, error) {
+    const callback = this.#onStatus;
+    if (callback !== null) safely(() => callback(status, error));
+  }
+  /** No join retry waits — nor a track sent again on a join that is going. */
+  #clearRetry() {
+    clearTimeout(this.#retry);
+    this.#retry = void 0;
+    this.#clearRetrack();
+  }
+};
+var RETRY_CODES = /* @__PURE__ */ new Set([
+  "TOO_MANY_JOINS",
+  "TIMED_OUT",
+  "INTERNAL_ERROR"
+]);
+function rejudgeWaitMs(privateChannels) {
+  return Math.max(1, Math.ceil(privateChannels / 2)) * 1e3;
+}
+var Identity = class {
+  #config;
+  /** The token the hub answered `ok` for on this connection; null is anon. */
+  #confirmed = null;
+  /**
+   * The last frame sent, until its own reply; null when none is in flight.
+   * Matched by the object, not the token: an older frame of the same token
+   * answered meanwhile is not this one.
+   */
+  #inFlight = null;
+  /**
+   * The frame the hub answered INVALID_SESSION: the 4401 that follows is
+   * about its token. An object, since that token is null when the frame was
+   * a sign-out — a refusal still, and not "nothing refused".
+   */
+  #refused = null;
+  /**
+   * A frame got no answer in time (TIMED_OUT), and no `ok` came since: the
+   * hub may have taken it late, so what it holds is not known, and a read
+   * with no frame in flight tells the stored token even when it is
+   * `heldToken()` (정정 (k)). An `ok` says what it holds — replies come in
+   * the order the frames went, so it is about a later frame.
+   */
+  #unsure = false;
+  /** Bumped when a connection ends: a reply about an earlier one changes nothing. */
+  #epoch = 0;
+  #attempt = 0;
+  #retry;
+  /** The socket's generation opened() was called for; null once it ended. */
+  #connection = null;
+  /** changed() calls of this connection still reading the store. */
+  #reading = 0;
+  /** onLive was called, and the connection has been live since. */
+  #announced = false;
+  constructor(config) {
+    this.#config = config;
+  }
+  /** The token the hub took on this connection; null for anon or before its answer. */
+  confirmed() {
+    return this.#confirmed;
+  }
+  /**
+   * The token the hub will hold once what was sent is handled — the last
+   * frame in flight, or else the one it took: the hub handles the
+   * connection's frames in order, so a frame sent now is judged for it.
+   * A frame in flight may yet be refused; the hub then keeps `confirmed()`.
+   */
+  heldToken() {
+    return this.#inFlight === null ? this.#confirmed : this.#inFlight.token;
+  }
+  /**
+   * Nothing about who the connection is is pending — no read, no frame in
+   * flight, no retry, no refusal: a join sent now is judged for the identity
+   * the hub settled on, the stored one unless it refused that for good on
+   * this connection (결정 24).
+   */
+  isLive() {
+    const socket = this.#config.socket();
+    return this.#connection === socket.generation && socket.isOpen() && this.#reading === 0 && this.#inFlight === null && this.#retry === void 0 && this.#refused === null;
+  }
+  /**
+   * A new connection: anon until told. Resolves once the stored token is
+   * sent, or found to need no frame; `onLive` says when the hub took it.
+   */
+  async opened() {
+    this.closed();
+    this.#connection = this.#config.socket().generation;
+    await this.changed();
+  }
+  /** The stored token may have changed: tell the open connection what is new. */
+  async changed() {
+    if (this.#config.service) return this.#settle();
+    const epoch = this.#epoch;
+    this.#reading += 1;
+    this.#announced = false;
+    try {
+      await this.#config.ready();
+    } catch {
+    }
+    const token = await this.#config.tokens.get();
+    if (epoch === this.#epoch) this.#reading -= 1;
+    if (this.#config.socket().isOpen()) {
+      const unknown = this.#unsure && this.#inFlight === null;
+      if (unknown || token !== this.heldToken()) this.#send(token);
+    }
+    this.#settle();
+  }
+  /**
+   * A 4401: forget the stored session only if the hub answered
+   * INVALID_SESSION to it by name, and it is still stored — a sign-in since
+   * then keeps its new token (결정 3). A 4401 with no such answer clears
+   * nothing (plan 2026-10-28 정정): the hub keeps the expiry it read when it
+   * took the token (known-issues #183) while the backend's sign-in slides
+   * the session's under the same token, so a tab open for days is closed
+   * with a session that is still good. The next connection tells the token
+   * again, and hears INVALID_SESSION — and clears it — if it really is
+   * dead. The access JWT goes with the session it was minted for, so only
+   * when that session went.
+   */
+  async refused() {
+    const epoch = this.#epoch;
+    const early = this.#refused;
+    await Promise.resolve();
+    const refusal = this.#epoch === epoch ? this.#refused : early;
+    this.closed();
+    if (refusal === null || refusal.token === null) return;
+    if (await this.#config.tokens.clearIf(refusal.token))
+      await this.#config.accessJwt?.clear();
+  }
+  /** The connection is gone: what it was told is forgotten. */
+  closed() {
+    clearTimeout(this.#retry);
+    this.#retry = void 0;
+    this.#epoch += 1;
+    this.#confirmed = null;
+    this.#inFlight = null;
+    this.#refused = null;
+    this.#unsure = false;
+    this.#attempt = 0;
+    this.#connection = null;
+    this.#reading = 0;
+    this.#announced = false;
+  }
+  /** Live, and not said yet since it last was not: say it. */
+  #settle() {
+    if (this.#announced || !this.isLive()) return;
+    this.#announced = true;
+    safely(() => this.#config.onLive());
+  }
+  #send(token) {
+    clearTimeout(this.#retry);
+    this.#retry = void 0;
+    const sent2 = { token };
+    this.#inFlight = sent2;
+    const epoch = this.#epoch;
+    void this.#config.socket().request(
+      PHOENIX_TOPIC,
+      "access_token",
+      { access_token: token },
+      { turn: "identity" }
+    ).then((reply) => {
+      if (epoch === this.#epoch) this.#heard(sent2, reply);
+    });
+  }
+  #heard(sent2, reply) {
+    if (this.#inFlight === sent2) this.#inFlight = null;
+    if (reply.ok) {
+      this.#confirmed = sent2.token;
+      this.#unsure = false;
+      this.#attempt = 0;
+      return this.#settle();
+    }
+    if (reply.lost) return;
+    if (reply.error.code === "TIMED_OUT") this.#unsure = true;
+    if (reply.error.code === "INVALID_SESSION") {
+      this.#refused = sent2;
+      return;
+    }
+    if (this.#inFlight !== null) return;
+    if (!RETRY_CODES.has(reply.error.code)) {
+      if (this.#confirmed !== null && sent2.token !== this.#confirmed) {
+        this.closed();
+        this.#config.socket().reconnect();
+        return;
+      }
+      return this.#settle();
+    }
+    this.#later(
+      reply.error.code === "TOO_MANY_JOINS" ? rejudgeWaitMs(this.#config.privateChannels()) : 0
+    );
+  }
+  /**
+   * Reads the store again after the backoff (at least `minMs`), once there
+   * is room on the connection for a frame the SDK sends of its own accord
+   * (`whenRoom()`, PR #328 review). `#retry` stays set until then: the
+   * connection is not live while it waits.
+   */
+  #later(minMs) {
+    clearTimeout(this.#retry);
+    const delay = Math.max(minMs, backoffMs(this.#attempt, Math.random));
+    this.#attempt += 1;
+    const epoch = this.#epoch;
+    this.#retry = setTimeout(() => {
+      this.#config.socket().whenRoom(this, () => {
+        if (epoch !== this.#epoch) return;
+        this.#retry = void 0;
+        void this.changed();
+      });
+    }, delay);
+  }
+};
+var LEAVE_RETRY_CODES = /* @__PURE__ */ new Set([
+  "TOO_MANY_JOINS",
+  "INTERNAL_ERROR",
+  "CONNECTION_STATE_TOO_LARGE",
+  "TIMED_OUT"
+]);
+function sameSettings(a, b) {
+  if (a === b) return true;
+  try {
+    return JSON.stringify(a) === JSON.stringify(b);
+  } catch {
+    return false;
+  }
+}
+function sameJoin(a, b) {
+  return a.name === b.name && a.isPrivate === b.isPrivate;
+}
+function foldTable(table3) {
+  return table3.replaceAll(/[A-Z]/g, (letter) => letter.toLowerCase());
+}
+var RealtimeClient = class {
+  #http;
+  #socket;
+  #identity;
+  #context;
+  #channels = [];
+  /** The leaves owed on the open connection (정정 (i)); forgotten with it. */
+  #owed = /* @__PURE__ */ new Set();
+  #onStorage = null;
+  constructor(input) {
+    const { http, auth, service, options } = input;
+    this.#http = http;
+    this.#socket = new RealtimeSocket({
+      baseUrl: http.baseUrl,
+      apiKey: http.apiKey,
+      service,
+      options,
+      events: {
+        // Not awaited, and not live yet: onLive says when the hub took it.
+        opened: () => {
+          this.#watchStorage();
+          void this.#identity.opened();
+        },
+        frame: (frame) => this.#route(frame),
+        // Only the leaves and the channels: the identity is closed by the
+        // next opened() (the 4401's refused() reads it after this turn —
+        // 정정 (f)).
+        dropped: (error, status) => {
+          this.#forgetLeaves();
+          this.#each((channel) => channel.dropped(error, status));
+        },
+        stopped: (error) => this.#stopped(error),
+        sessionRefused: () => this.#identity.refused()
+      }
+    });
+    this.#identity = new Identity({
+      tokens: http.tokens,
+      accessJwt: http.accessJwt,
+      service,
+      socket: () => this.#socket,
+      privateChannels: () => this.#channels.filter(
+        (channel) => channel.isPrivate && channel.state === "joined"
+      ).length,
+      onLive: () => this.#each((channel) => channel.rejoin()),
+      // A sign-in the page URL carries goes before any join (final review A I1).
+      ready: () => auth.ready()
+    });
+    this.#context = {
+      socket: this.#socket,
+      identity: this.#identity,
+      http,
+      auth,
+      connect: () => this.#socket.connect(),
+      live: () => this.#identity.isLive(),
+      leave: (channel, joinRef, tables) => this.#leave(channel, joinRef, tables),
+      owesLeave: (channel) => this.#owesLeave(channel),
+      owesLeaveOn: (table3) => this.#owesLeaveOn(table3)
+    };
+    http.tokens.subscribe(() => void this.#identity.changed());
+  }
+  channel(name, options = {}) {
+    const settings = isRecord(options) ? options : {};
+    const isPrivate = settings.config?.private === true;
+    const found = this.#channels.find(
+      (c) => c.name === name && c.isPrivate === isPrivate
+    );
+    if (found !== void 0) {
+      if (!sameSettings(found.options, settings))
+        warnInDevelopment(
+          `naro-js: channel(${JSON.stringify(name)}) already exists with other settings; it keeps the first ones until removeChannel().`
+        );
+      return found;
+    }
+    const channel = new RealtimeChannel(
+      name,
+      settings,
+      this.#context
+    );
+    this.#channels.push(channel);
+    return channel;
+  }
+  getChannels() {
+    return [...this.#channels];
+  }
+  async removeChannel(channel) {
+    this.#channels = this.#channels.filter((c) => c !== channel);
+    return this.#closeIfLast(await channel.unsubscribe());
+  }
+  async removeAllChannels() {
+    const channels = this.#channels;
+    this.#channels = [];
+    const results = await Promise.all(
+      channels.map((channel) => channel.unsubscribe())
+    );
+    return this.#closeIfLast({
+      data: null,
+      error: results.find((result) => result.error !== null)?.error ?? null
+    });
+  }
+  /**
+   * No channel left (the app may have added one meanwhile): the connection
+   * closes. That is the strongest leave — the hub forgets every join with
+   * its connection — so a leave's refusal no longer stands (정정 (j)).
+   */
+  #closeIfLast(result) {
+    if (this.#channels.length > 0) return result;
+    this.#disconnect();
+    return { data: null, error: null };
+  }
+  /**
+   * Each channel in turn, over a copy (a callback may add or remove one);
+   * what one throws does not keep the next from hearing (결정 22).
+   */
+  #each(action) {
+    for (const channel of Array.from(this.#channels))
+      safely(() => action(channel));
+  }
+  #route(frame) {
+    if (frame.topic === PHOENIX_TOPIC || frame.joinRef === null) return;
+    const channel = this.#channels.find(
+      (c) => c.joinRef === frame.joinRef && c.topic === frame.topic
+    );
+    channel?.receive(frame);
+  }
+  #stopped(error) {
+    this.#identity.closed();
+    this.#forgetLeaves();
+    this.#unwatchStorage();
+    this.#each((channel) => channel.stopped(error));
+  }
+  #disconnect() {
+    this.#socket.disconnect();
+    this.#identity.closed();
+    this.#forgetLeaves();
+    this.#unwatchStorage();
+  }
+  #leave(channel, joinRef, tables) {
+    const owed = {
+      channel,
+      joinRef,
+      tables,
+      attempt: 0,
+      timer: void 0
+    };
+    this.#owed.add(owed);
+    return this.#sendLeave(owed, "app");
+  }
+  /**
+   * One `phx_leave` of `owed`; its answer decides whether it is done,
+   * whoever else awaits it. The first goes in the app's turn, after the
+   * frames the app sent on the join before it (and is never refused for
+   * it); one tried again, in the SDK's (PR #328 re-review).
+   */
+  #sendLeave(owed, turn) {
+    const { channel, joinRef } = owed;
+    const reply = this.#socket.request(
+      channel.topic,
+      "phx_leave",
+      {},
+      { joinRef, turn }
+    );
+    void reply.then((answer) => this.#leaveAnswered(owed, answer));
+    return reply;
+  }
+  #leaveAnswered(owed, reply) {
+    if (!this.#owed.has(owed)) return;
+    if (!reply.ok && !reply.lost && LEAVE_RETRY_CODES.has(reply.error.code)) {
+      const delay = backoffMs(owed.attempt, Math.random);
+      owed.attempt += 1;
+      owed.timer = setTimeout(() => {
+        owed.timer = void 0;
+        this.#socket.whenRoom(owed, () => {
+          if (this.#owed.has(owed)) void this.#sendLeave(owed, "sdk");
+        });
+      }, delay);
+      const { error } = reply;
+      this.#each((channel) => {
+        if (sameJoin(channel, owed.channel)) channel.leaveRefused(error);
+      });
+      return;
+    }
+    this.#owed.delete(owed);
+    this.#each((channel) => channel.rejoin());
+  }
+  #owesLeave(channel) {
+    for (const owed of this.#owed)
+      if (sameJoin(owed.channel, channel)) return true;
+    return false;
+  }
+  /** `ChannelContext.owesLeaveOn`: the hub's caps count the joins whose leaves are owed. */
+  #owesLeaveOn(table3) {
+    for (const owed of this.#owed) {
+      if (table3 === null) return true;
+      const key = foldTable(table3);
+      if (owed.tables.some(
+        (held) => held === "*" || key === "*" || foldTable(held) === key
+      ))
+        return true;
+    }
+    return false;
+  }
+  #forgetLeaves() {
+    for (const owed of this.#owed) clearTimeout(owed.timer);
+    this.#owed.clear();
+  }
+  /**
+   * Another tab signing in or out writes the same localStorage key: read the
+   * store again while the connection lives (결정 5) — from its first open to
+   * a stop or the last channel's removal, drops included. Reading again
+   * sends nothing unless the stored token is not what the hub has, so a
+   * storage of the app's own (`auth.storage`), whose writes this event
+   * never reports, costs a read at most.
+   */
+  #watchStorage() {
+    const target = globalThis;
+    if (this.#onStorage !== null || !isBrowser() || typeof target.addEventListener !== "function")
+      return;
+    const key = storageKey(this.#http.baseUrl);
+    this.#onStorage = (event) => {
+      if (event.key === key || event.key === null)
+        void this.#identity.changed();
+    };
+    target.addEventListener("storage", this.#onStorage);
+  }
+  #unwatchStorage() {
+    const target = globalThis;
+    if (this.#onStorage === null) return;
+    target.removeEventListener?.("storage", this.#onStorage);
+    this.#onStorage = null;
+  }
+};
+function fail(error) {
+  return { data: null, error };
+}
+var isUploadResult = (value) => isRecord(value) && typeof value.id === "string" && typeof value.path === "string" && typeof value.fullPath === "string";
+function dataOf2(status, body, guard) {
+  if (isRecord(body) && Object.hasOwn(body, "data") && guard(body.data))
+    return { data: body.data, error: null };
+  return fail(invalidResponse(status));
+}
+async function readJson(response, guard) {
+  let text;
+  try {
+    text = await response.text();
+  } catch (error) {
+    return fail(networkError(error));
+  }
+  let body;
+  try {
+    body = JSON.parse(text);
+  } catch {
+    return fail(invalidResponse(response.status));
+  }
+  return dataOf2(response.status, body, guard);
+}
+var ROUTE = "/storage/upload/multipart";
+var UPLOAD_TOKEN_HEADER = "x-naro-upload-token";
+var CONCURRENCY = 4;
+var ATTEMPTS = 4;
+var BACKOFF_MS = [1e3, 2e3, 4e3];
+var UPLOAD_ID = /^[\w-][\w.-]*$/;
+var positive = (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+var planFor = (size) => (value) => isRecord(value) && typeof value.uploadId === "string" && UPLOAD_ID.test(value.uploadId) && positive(value.partSize) && positive(value.partCount) && (value.partCount - 1) * value.partSize < size && value.partCount * value.partSize >= size;
+var partAnswer = (n) => (value) => isRecord(value) && value.partNumber === n && typeof value.etag === "string" && value.etag !== "";
+var retryable = (error, status) => error.code === "NETWORK_ERROR" || error.code === "OBJECT_RATE_LIMITED" || status !== null && status >= 500 && error.code !== "STORAGE_QUOTA_EXCEEDED";
+function waitAfter(error, attempt22) {
+  const after = isRecord(error.details) ? error.details.retryAfter : void 0;
+  if (typeof after === "number") return after * 1e3;
+  if (error.code === "OBJECT_RATE_LIMITED") return 1e3;
+  return BACKOFF_MS[attempt22 - 1] ?? 4e3;
+}
+var sleepFor = (ms, signal) => new Promise((done) => {
+  if (signal?.aborted) {
+    done();
+    return;
+  }
+  const end = () => {
+    clearTimeout(timer);
+    signal?.removeEventListener("abort", end);
     done();
   };
   const timer = setTimeout(end, ms);
@@ -7882,7 +10297,7 @@ async function uploadInParts(a) {
     failure.error ??= uploadAborted();
   };
   const tryPart = async (n, bytes) => {
-    const sent = await send(a.http, {
+    const sent2 = await send(a.http, {
       method: "PUT",
       path: `${base}/${String(n)}`,
       headers: { "content-type": "application/octet-stream", ...signed },
@@ -7890,10 +10305,10 @@ async function uploadInParts(a) {
       withToken,
       signal
     });
-    if (sent.error !== null) return sent;
-    const read = await readJson(sent.response, partAnswer(n));
+    if (sent2.error !== null) return sent2;
+    const read = await readJson(sent2.response, partAnswer(n));
     if (read.error !== null)
-      return { error: read.error, status: sent.response.status };
+      return { error: read.error, status: sent2.response.status };
     return { etag: read.data.etag };
   };
   const sendPart = async (n) => {
@@ -8180,7 +10595,7 @@ var StorageFileApi = class {
       "cache-control": cache
     };
     if (upsert) headers["x-upsert"] = "true";
-    const sent = await send(this.#http, {
+    const sent2 = await send(this.#http, {
       method,
       path: target.path,
       headers,
@@ -8189,8 +10604,8 @@ var StorageFileApi = class {
       // The fetch stops with the body: the worker undoes its claim at once.
       signal
     });
-    if (sent.error !== null) return fail(sent.error);
-    return readJson(sent.response, isUploadResult);
+    if (sent2.error !== null) return fail(sent2.error);
+    return readJson(sent2.response, isUploadResult);
   }
   /**
    * A new object; with `upsert: true`, one of the same name is replaced.
@@ -8215,14 +10630,14 @@ var StorageFileApi = class {
     const target = this.#objectPath("", path);
     if (!target.ok) return fail(target.error);
     await this.#auth.ready();
-    const sent = await send(this.#http, {
+    const sent2 = await send(this.#http, {
       method: "GET",
       path: target.path,
       withToken: true
     });
-    if (sent.error !== null) return fail(sent.error);
+    if (sent2.error !== null) return fail(sent2.error);
     try {
-      return { data: await sent.response.blob(), error: null };
+      return { data: await sent2.response.blob(), error: null };
     } catch (error) {
       return fail(networkError(error));
     }
@@ -8487,7 +10902,7 @@ var StorageFileApi = class {
    * is the permission. A failure's cause never carries the token.
    */
   async #putSigned(path, token, payload, cache, signal) {
-    const sent = await send(this.#http, {
+    const sent2 = await send(this.#http, {
       method: "PUT",
       path: `${path}?token=${encodeURIComponent(token)}`,
       headers: { "content-type": payload.type, "cache-control": cache },
@@ -8495,8 +10910,8 @@ var StorageFileApi = class {
       withToken: false,
       signal
     });
-    if (sent.error !== null) return fail(withoutToken(sent.error, token));
-    const read = await readJson(sent.response, isUploadResult);
+    if (sent2.error !== null) return fail(withoutToken(sent2.error, token));
+    const read = await readJson(sent2.response, isUploadResult);
     return read.error === null ? read : fail(withoutToken(read.error, token));
   }
   /**
@@ -8536,10 +10951,36 @@ var CONFIG_MESSAGES = {
   urlNotOrigin: "createClient needs the project url alone, like https://my-app.naro.sh: no path, no ? or #, no user:password@. Naro serves its API at /_naro/v1 on that origin.",
   key: "createClient needs an anonKey (or, on a server, a serviceKey).",
   bothKeys: "Pass createClient an anonKey or a serviceKey, not both.",
-  serviceKeyOffServer: "A Naro service key (naro_sk_\u2026) skips every policy, so createClient accepts it only on a server (Node, Deno, Bun, Cloudflare Workers, an edge runtime), never in a browser, a web worker or a React Native app. Use the anon key (naro_pk_\u2026) here and keep the service key on your server.",
-  fetch: "This runtime has no fetch. Pass one to createClient({ fetch })."
+  serviceKeyOffServer: SERVICE_KEY_OFF_SERVER_MESSAGE,
+  fetch: "This runtime has no fetch. Pass one to createClient({ fetch }).",
+  realtime: "createClient's realtime options take a WebSocket class, and heartbeatIntervalMs and timeoutMs in whole milliseconds from 1 to 2147483647."
 };
 var SERVICE_KEY_PREFIX = "naro_sk_";
+var MAX_TIMER_MS = 2147483647;
+function isMilliseconds(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0 && value <= MAX_TIMER_MS;
+}
+function realtimeOptionsOf(value) {
+  if (value === void 0) return {};
+  if (!isRecord(value)) throw new Error(CONFIG_MESSAGES.realtime);
+  const { WebSocket, heartbeatIntervalMs, timeoutMs } = value;
+  const options = {};
+  if (WebSocket !== void 0) {
+    if (typeof WebSocket !== "function")
+      throw new Error(CONFIG_MESSAGES.realtime);
+    options.WebSocket = WebSocket;
+  }
+  if (heartbeatIntervalMs !== void 0) {
+    if (!isMilliseconds(heartbeatIntervalMs))
+      throw new Error(CONFIG_MESSAGES.realtime);
+    options.heartbeatIntervalMs = heartbeatIntervalMs;
+  }
+  if (timeoutMs !== void 0) {
+    if (!isMilliseconds(timeoutMs)) throw new Error(CONFIG_MESSAGES.realtime);
+    options.timeoutMs = timeoutMs;
+  }
+  return options;
+}
 function baseUrlOf(url) {
   if (typeof url !== "string") throw new Error(CONFIG_MESSAGES.url);
   const trimmed = url.trim();
@@ -8596,11 +11037,19 @@ var NaroClient2 = class {
    */
   storage;
   #run;
+  #newRealtime;
+  /**
+   * Made by the first channel(), not by the constructor: it listens to every
+   * write of the session token (to tell an open connection who signed in),
+   * which an app that never uses Realtime should not pay for.
+   */
+  #realtime;
   constructor(options) {
     const baseUrl = baseUrlOf(options.url);
     const { key: apiKey, service } = apiKeyOf(options);
     if (options.fetch === void 0 && typeof globalThis.fetch !== "function")
       throw new Error(CONFIG_MESSAGES.fetch);
+    const realtime = realtimeOptionsOf(options.realtime);
     const storage = options.auth?.storage ?? defaultStorage();
     const http = {
       baseUrl,
@@ -8622,11 +11071,46 @@ var NaroClient2 = class {
     });
     this.#run = queryRunner(http, this.auth);
     this.storage = new StorageClient(http, this.auth);
+    this.#newRealtime = () => new RealtimeClient({
+      http,
+      auth: this.auth,
+      service,
+      options: realtime
+    });
   }
   /** Start a query on `table`: `.select()`, `.insert()`, `.update()` or `.delete()`. */
   from(table3) {
     return new TableBuilder(this.#run, table3);
   }
+  /**
+   * A Realtime channel (original spec §15): `.on()` listeners, then
+   * `.subscribe()`. The same name and privacy give the same channel until
+   * `removeChannel`. Nothing connects until the first `subscribe()`.
+   */
+  channel(name, options) {
+    return this.#client().channel(name, options);
+  }
+  /** The channels made with `channel()` and not yet removed. */
+  getChannels() {
+    return this.#realtime?.getChannels() ?? [];
+  }
+  /**
+   * Leaves the channel and forgets it, so `channel()` of its name makes a new
+   * one; the connection closes with the last channel.
+   */
+  removeChannel(channel) {
+    return this.#client().removeChannel(channel);
+  }
+  /** `removeChannel()` for every channel; the connection closes. */
+  removeAllChannels() {
+    if (this.#realtime === void 0)
+      return Promise.resolve({ data: null, error: null });
+    return this.#realtime.removeAllChannels();
+  }
+  #client() {
+    this.#realtime ??= this.#newRealtime();
+    return this.#realtime;
+  }
 };
 function createClient(options) {
   return new NaroClient2(options);
@@ -8639,6 +11123,7 @@ var MV_USAGE = "Usage: naro storage mv naro://<bucket>/<from> naro://<bucket>/<t
 var RM_USAGE = "Usage: naro storage rm naro://<bucket>/<path>\u2026 [--recursive] [--yes]";
 var LS_USAGE = "Usage: naro storage ls [naro://<bucket>[/<prefix>]] [--recursive] [--search <text>]";
 var BACKEND_OFF_MESSAGE = "The backend is turned off for this project. Turn it on with `naro backend enable` first.";
+var STORAGE_OFF_MESSAGE = "Storage is turned off for this project. Turn it on with `naro storage enable` first.";
 var STORAGE_OUTDATED_MESSAGE = "The project backend is older than this Storage command. Run `naro backend enable` to update it, then try again.";
 var OLD_SEARCH_REASON = "search is not supported yet";
 function isOldSearchRefusal(error) {
@@ -8731,6 +11216,9 @@ async function objects(context) {
       "This project has no backend yet. Run `naro backend enable`, then `naro storage enable`."
     );
   if (!backend.enabled) throw new NaroError("BACKEND_OFF", BACKEND_OFF_MESSAGE);
+  const state = await client.storage.info(projectId);
+  if (state.disabledAt !== null)
+    throw new NaroError("STORAGE_OFF", STORAGE_OFF_MESSAGE);
   let serviceKey = process.env.NARO_SERVICE_KEY?.trim() ?? "";
   if (serviceKey !== "" && !ONE_KEY.test(serviceKey))
     throw new NaroError(
@@ -8935,17 +11423,17 @@ function progressReporter(output, total) {
   let lastLength = 0;
   let open = false;
   return {
-    report(sent) {
-      const percent2 = Math.floor(sent / total * 100);
-      const line = `\u2191 ${binarySize(sent)} / ${binarySize(total)} (${String(percent2)}%)`;
+    report(sent2) {
+      const percent2 = Math.floor(sent2 / total * 100);
+      const line = `\u2191 ${binarySize(sent2)} / ${binarySize(total)} (${String(percent2)}%)`;
       if (tty) {
-        open = sent !== total;
+        open = sent2 !== total;
         output.progress(`\r${line.padEnd(lastLength)}${open ? "" : "\n"}`);
         lastLength = line.length;
         return;
       }
       const tenth = Math.floor(percent2 / 10);
-      if (tenth === lastTenth && sent !== total) return;
+      if (tenth === lastTenth && sent2 !== total) return;
       lastTenth = tenth;
       output.progress(`${line}
 `);
@@ -9600,6 +12088,8 @@ Usage:
   naro storage [status]              Naro Storage: on or off, limits, what is stored, today's operations, the buckets
   naro storage enable                Turn Storage on: the project's R2 bucket, bound to its backend
                                      (safe to re-run; applies a plan change's limits)
+  naro storage disable [--yes]       Turn Storage off and keep its files: its calls and file URLs answer 404
+                                     until naro storage enable binds the same bucket again (asks first)
   naro storage bucket list           The buckets: public or private, objects, bytes, limits
   naro storage bucket create <name> [--public] [--file-size-limit <size>] [--allowed-mime-types <t,\u2026>]
                                      <size>: bytes, 5MB (1000s) or 5MiB (1024s); turns Storage on first if needed
@@ -9624,7 +12114,17 @@ Usage:
                                      Remove objects; --recursive removes what is under a folder (asks first):
                                      <path>/ is the folder alone, <path> also an object of that name
 
-  naro promote <deployment-id>       Publish a build to production
+  naro realtime [status]             Naro Realtime: on or not, published tables, connections now
+  naro realtime enable               Turn Realtime on: the project's hub, bound to its backend
+  naro realtime tables [list]        The tables whose Data API writes reach subscribers
+  naro realtime tables add <table>\u2026  Publish tables' changes (within about 10 seconds)
+  naro realtime tables remove <table>\u2026 [--yes]
+                                     Stop publishing tables' changes (asks first)
+
+  naro promote <deployment-id> [--to <environment>]
+                                     Publish a build to production, or to an environment with --to; it says what it will do, then asks.
+                                     A build moving between an environment and another surface is built again from its commit with the
+                                     target's variables, which takes up to 15 minutes; any other build is published as stored.
   naro rollback [deployment-id]      Roll production back to the previous build
 
 Global options:
@@ -9648,6 +12148,7 @@ Global options:
   --device <d>    Only this device: desktop, mobile or tablet (naro analytics, naro insights)
   --browser <b>   Only this browser: chrome, edge, firefox, opera, safari or other (naro analytics, naro insights)
   --os <o>        Only this operating system: android, ios, linux, macos, windows or other (naro analytics, naro insights)
+  --to <environment>  production (the default) or an environment name: where naro promote publishes the build (naro promote)
   --env <e>       production or preview (naro logs, naro insights: production by default; naro env pull, naro deploy: preview by default, or an environment name)
   --branch <b>    naro environments create, set: the branch whose pushes deploy to that environment. naro deploy: the default
                   branch of a project this deploy creates or updates (the deploy's own branch follows where it goes)
@@ -9792,6 +12293,8 @@ function routeStorage(words) {
       return words.length <= 1 ? { handler: runStorageStatus, positionals: [] } : null;
     case "enable":
       return words.length === 1 ? { handler: runStorageEnable, positionals: [] } : null;
+    case "disable":
+      return words.length === 1 ? { handler: runStorageDisable, positionals: [] } : null;
     case "bucket":
     case "buckets":
       switch (action) {
@@ -9836,7 +12339,48 @@ function routeStorage(words) {
       return null;
   }
 }
+function routeRealtime(words) {
+  const [sub, action] = words;
+  switch (sub) {
+    case void 0:
+    case "status":
+      return words.length <= 1 ? { handler: runRealtimeStatus, positionals: [] } : null;
+    case "enable":
+      return words.length === 1 ? { handler: runRealtimeEnable, positionals: [] } : null;
+    case "tables":
+      switch (action) {
+        case void 0:
+        case "list":
+        case "ls":
+          return words.length <= 2 ? { handler: runRealtimeTablesList, positionals: [] } : null;
+        case "add":
+          return {
+            handler: runRealtimeTablesAdd,
+            positionals: words.slice(2)
+          };
+        case "remove":
+        case "rm":
+          return {
+            handler: runRealtimeTablesRemove,
+            positionals: words.slice(2)
+          };
+        default:
+          return null;
+      }
+    default:
+      return null;
+  }
+}
+async function refuseTo() {
+  throw new NaroError("VALIDATION_FAILED", "--to is only for naro promote.");
+}
 function route(parsed) {
+  const routed = routeCommand(parsed);
+  if (routed && parsed.flags.to !== void 0 && parsed.command !== "promote" && parsed.command !== "rollback")
+    return { handler: refuseTo, positionals: routed.positionals };
+  return routed;
+}
+function routeCommand(parsed) {
   const { command, positionals } = parsed;
   const sub = positionals[0];
   switch (command) {
@@ -10077,6 +12621,8 @@ function route(parsed) {
       }
     case "storage":
       return routeStorage(positionals);
+    case "realtime":
+      return routeRealtime(positionals);
     case "policy":
       switch (sub) {
         case void 0: