nolo-cli 0.8.0 → 0.9.0

package/chunk-U4TRT5V4.js

@@ -0,0 +1,246 @@
+import {
+  resolveNoloHome
+} from "./chunk-LM6IYQ3F.js";
+
+// packages/database-engine/cliAuthorityBrokerClient.ts
+import { createConnection } from "node:net";
+var DEFAULT_ITERATOR_PAGE_SIZE = 200;
+var CliAuthorityBrokerUnavailableError = class extends Error {
+  reason = "cli_authority_broker_unavailable";
+  status = 503;
+  endpoint;
+  constructor(endpoint, cause) {
+    super(`CLI authority broker unavailable at ${endpoint}. Start the local authority broker and retry.`);
+    this.name = "CliAuthorityBrokerUnavailableError";
+    this.endpoint = endpoint;
+    if (cause !== void 0) {
+      this.cause = cause;
+    }
+  }
+};
+var CliAuthorityBrokerProtocolError = class extends Error {
+  code;
+  retryable;
+  constructor(error) {
+    super(error.message);
+    this.name = "CliAuthorityBrokerProtocolError";
+    this.code = error.code;
+    this.retryable = error.retryable === true;
+  }
+};
+function isCliAuthorityBrokerUnavailableError(error) {
+  return error instanceof CliAuthorityBrokerUnavailableError || typeof error === "object" && error !== null && error.reason === "cli_authority_broker_unavailable" && error.status === 503;
+}
+function isCliAuthorityBrokerProtocolError(error) {
+  return error instanceof CliAuthorityBrokerProtocolError;
+}
+function resolveBrokerSocketTarget(endpoint) {
+  if (endpoint.startsWith("unix://")) {
+    return { kind: "unix", path: endpoint.slice("unix://".length) };
+  }
+  if (endpoint.startsWith("tcp://")) {
+    const url = new URL(endpoint);
+    return {
+      kind: "tcp",
+      host: url.hostname,
+      port: Number(url.port)
+    };
+  }
+  throw new Error(`Unsupported CLI authority broker endpoint: ${endpoint}`);
+}
+function createCliAuthorityBrokerSocketInvoker(options) {
+  const target = resolveBrokerSocketTarget(options.endpoint);
+  return async (request) => {
+    return await new Promise((resolve, reject) => {
+      const socket = target.kind === "unix" ? createConnection(target.path) : createConnection({ host: target.host, port: target.port });
+      let responseBuffer = "";
+      let settled = false;
+      const timeout = setTimeout(() => {
+        finish(() => {
+          socket.destroy();
+          reject(new Error(`CLI authority broker request at ${options.endpoint} timed out after 5000ms`));
+        });
+      }, 5e3);
+      const finish = (fn) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timeout);
+        fn();
+      };
+      socket.setEncoding("utf8");
+      socket.on("connect", () => {
+        socket.write(`${JSON.stringify(request)}
+`);
+      });
+      socket.on("data", (chunk) => {
+        responseBuffer += chunk;
+      });
+      socket.on("end", () => {
+        finish(() => {
+          const payload = responseBuffer.trim();
+          if (!payload) {
+            reject(new Error(`CLI authority broker at ${options.endpoint} returned no response`));
+            return;
+          }
+          try {
+            resolve(JSON.parse(payload));
+          } catch (error) {
+            reject(error);
+          }
+        });
+      });
+      socket.on("error", (error) => {
+        finish(() => reject(error));
+      });
+    });
+  };
+}
+async function invokeBrokerRequest(options, request) {
+  try {
+    const response = await options.invoke(request);
+    if (response.ok) return response.result;
+    if (response.error.code === "BROKER_UNAVAILABLE") {
+      throw new CliAuthorityBrokerUnavailableError(options.endpoint, response.error);
+    }
+    throw new CliAuthorityBrokerProtocolError(response.error);
+  } catch (error) {
+    if (isCliAuthorityBrokerUnavailableError(error)) throw error;
+    if (isCliAuthorityBrokerProtocolError(error)) throw error;
+    throw new CliAuthorityBrokerUnavailableError(options.endpoint, error);
+  }
+}
+function createCliAuthorityBrokerClient(options) {
+  const pageSize = options.iteratorPageSize ?? DEFAULT_ITERATOR_PAGE_SIZE;
+  return {
+    get location() {
+      return options.location ?? options.endpoint;
+    },
+    get status() {
+      return options.status ?? "broker";
+    },
+    async open() {
+      await invokeBrokerRequest(options, { type: "status" });
+    },
+    async close() {
+    },
+    async get(key) {
+      const result = await invokeBrokerRequest(options, { type: "get", key });
+      if (result.type !== "get") {
+        throw new Error(`CLI authority broker protocol mismatch for get at ${options.endpoint}`);
+      }
+      return result.value;
+    },
+    async put(key, value) {
+      await invokeBrokerRequest(options, { type: "put", key, value });
+    },
+    async del(key) {
+      await invokeBrokerRequest(options, { type: "del", key });
+    },
+    async batchWrite(ops) {
+      await invokeBrokerRequest(options, { type: "batchWrite", ops });
+    },
+    createBatch() {
+      const ops = [];
+      return {
+        put(key, value) {
+          ops.push({ type: "put", key, value });
+        },
+        del(key) {
+          ops.push({ type: "del", key });
+        },
+        async write() {
+          await invokeBrokerRequest(options, { type: "batchWrite", ops });
+        }
+      };
+    },
+    iterator(iteratorOptions = {}) {
+      return async function* iterate() {
+        let cursor = void 0;
+        while (true) {
+          const result = await invokeBrokerRequest(options, {
+            type: "iterator",
+            options: iteratorOptions,
+            cursor,
+            limit: pageSize
+          });
+          if (result.type !== "iterator") {
+            throw new Error(
+              `CLI authority broker protocol mismatch for iterator at ${options.endpoint}`
+            );
+          }
+          for (const entry of result.page.entries) {
+            yield entry;
+          }
+          if (result.page.done || !result.page.nextCursor) return;
+          cursor = result.page.nextCursor;
+        }
+      }();
+    }
+  };
+}
+
+// packages/database-engine/cliAuthorityStoreDriver.ts
+import path from "node:path";
+function readCliAuthorityDriver(env) {
+  const value = env.NOLO_CLI_AUTHORITY_DRIVER?.trim();
+  if (value === "broker") {
+    return { driver: "broker", invalidDriver: null };
+  }
+  return {
+    driver: "broker",
+    invalidDriver: value ? value : null
+  };
+}
+function resolveCliAuthorityRunDir(options = {}) {
+  return path.join(resolveNoloHome({
+    ...options,
+    env: options.env ?? {}
+  }), "run");
+}
+function hashString(value) {
+  let hash = 0;
+  for (let index = 0; index < value.length; index += 1) {
+    hash = (hash << 5) - hash + value.charCodeAt(index) | 0;
+  }
+  return Math.abs(hash);
+}
+function resolveCliAuthorityBrokerPort(options = {}) {
+  const envPort = options.env?.NOLO_CLI_AUTHORITY_BROKER_PORT?.trim();
+  if (envPort) {
+    const port = Number(envPort);
+    if (Number.isInteger(port) && port > 0 && port < 65536) return port;
+  }
+  const noloHome = resolveNoloHome({
+    ...options,
+    env: options.env ?? {}
+  });
+  return 47e3 + hashString(noloHome) % 2e3;
+}
+function resolveCliAuthorityStoreDriver(options = {}) {
+  return readCliAuthorityDriver(options.env ?? {}).driver;
+}
+function resolveCliAuthorityBrokerSocketPath(options) {
+  return path.join(resolveCliAuthorityRunDir(options), "authority-store-broker.sock");
+}
+function resolveCliAuthorityBrokerEndpoint(options) {
+  if (options.transport === "tcp") {
+    return `tcp://127.0.0.1:${resolveCliAuthorityBrokerPort(options)}`;
+  }
+  return `unix://${resolveCliAuthorityBrokerSocketPath(options)}`;
+}
+function resolveCliAuthorityBrokerMetadataPath(options) {
+  return path.join(resolveCliAuthorityRunDir(options), "authority-store-broker.json");
+}
+function resolveCliAuthorityBrokerHealthPath(options) {
+  return path.join(resolveCliAuthorityRunDir(options), "authority-store-broker.health.json");
+}
+
+export {
+  isCliAuthorityBrokerUnavailableError,
+  createCliAuthorityBrokerSocketInvoker,
+  createCliAuthorityBrokerClient,
+  resolveCliAuthorityStoreDriver,
+  resolveCliAuthorityBrokerEndpoint,
+  resolveCliAuthorityBrokerMetadataPath,
+  resolveCliAuthorityBrokerHealthPath
+};

package/chunk-U6VC4MU4.js

@@ -0,0 +1,8 @@
+// packages/core/optionalPositiveNumber.ts
+function asOptionalPositiveFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+
+export {
+  asOptionalPositiveFiniteNumber
+};

package/chunk-UAD2WT54.js

@@ -0,0 +1,64 @@
+// packages/create/space/spaceKeys.ts
+var SEPARATOR = "-";
+var SPACE_PREFIX = "space";
+var SPACE_PREFIX_WITH_SEPARATOR = `${SPACE_PREFIX}${SEPARATOR}`;
+var normalizeSpaceId = (spaceId) => {
+  if (!spaceId) return spaceId;
+  return spaceId.startsWith(SPACE_PREFIX_WITH_SEPARATOR) ? spaceId.slice(SPACE_PREFIX_WITH_SEPARATOR.length) : spaceId;
+};
+var createSpaceKey = {
+  // 空间基础信息的key
+  space: (spaceId) => {
+    return [SPACE_PREFIX, normalizeSpaceId(spaceId)].join(SEPARATOR);
+  },
+  // 空间成员的key
+  member: (userId, spaceId) => {
+    return [SPACE_PREFIX, "member", userId, normalizeSpaceId(spaceId)].join(
+      SEPARATOR
+    );
+  },
+  // 查询用户所在的所有空间的范围
+  memberRange: (userId) => {
+    return {
+      start: [SPACE_PREFIX, "member", userId, ""].join(SEPARATOR),
+      end: [SPACE_PREFIX, "member", userId, "\uFFFF"].join(SEPARATOR)
+    };
+  },
+  /**
+   * 预留：未来若出现“按用户、按空间、且必须跨设备同步”的空间级偏好，
+   * 统一使用这个 key family。当前产品主链不要依赖它。
+   */
+  setting: (userId, spaceId) => {
+    return [SPACE_PREFIX, "setting", userId, normalizeSpaceId(spaceId)].join(
+      SEPARATOR
+    );
+  },
+  /**
+   * 预留：未来如确实需要批量读取空间级远端偏好，再使用这个范围。
+   */
+  settingRange: (userId) => {
+    return {
+      start: [SPACE_PREFIX, "setting", userId, ""].join(SEPARATOR),
+      end: [SPACE_PREFIX, "setting", userId, "\uFFFF"].join(SEPARATOR)
+    };
+  },
+  // 从成员key中提取空间key
+  // 成员 key 格式: space-member-{userId}-{spaceId}
+  // userId 是单段（无连字符），spaceId 是 ULID（无连字符）
+  spaceFromMember: (memberKey) => {
+    const parts = memberKey.split(SEPARATOR);
+    if (parts.length < 4) return "";
+    const spaceId = parts[parts.length - 1];
+    return [SPACE_PREFIX, spaceId].join(SEPARATOR);
+  },
+  // 从成员key中提取空间ID
+  spaceIdFromMember: (memberKey) => {
+    const parts = memberKey.split(SEPARATOR);
+    return parts.length >= 4 ? parts[parts.length - 1] : "";
+  }
+};
+
+export {
+  normalizeSpaceId,
+  createSpaceKey
+};