@yydb/yyds 0.0.12 → 0.0.14

package/bin/yyds.mjs

@@ -3,11 +3,20 @@ import { loadYydsNative } from "../src/node/load.ts";
 import { parseStartOptions, runNodeStart } from "../src/node/runtime.ts";
 
 function usage() {
-    return "usage: yyds <init|start|status|stop> --data-dir DIR [--cluster-id ID --node-id ID] [--redis-port PORT] [--pgsql-port PORT] [--mysql-port PORT] [--wire-port PORT]";
+    return "usage: yyds <init|start|status|stop> --data-dir DIR [--cluster-id ID --node-id ID] [--redis-port PORT] [--pgsql-port PORT] [--mysql-port PORT] [--mongo-port PORT] [--wire-port PORT]";
 }
 
 function parseCommonArgs(command, args) {
-    const options = { dataDir: "", clusterId: "", nodeId: "", redisPort: 6379, pgsqlPort: undefined, mysqlPort: undefined, wirePort: undefined };
+    const options = {
+        dataDir: "",
+        clusterId: "",
+        nodeId: "",
+        redisPort: 6379,
+        pgsqlPort: undefined,
+        mysqlPort: undefined,
+        mongoPort: undefined,
+        wirePort: undefined,
+    };
     for (let index = 0; index < args.length; index += 1) {
         const flag = args[index];
         const value = args[index + 1];
@@ -26,22 +35,32 @@ function parseCommonArgs(command, args) {
                 index += 1;
                 break;
             case "--redis-port":
-                if (command !== "start") throw new Error(`option ${flag} is not valid for this command`);
+                if (command !== "start")
+                    throw new Error(`option ${flag} is not valid for this command`);
                 options.redisPort = Number(value);
                 index += 1;
                 break;
             case "--pgsql-port":
-                if (command !== "start") throw new Error(`option ${flag} is not valid for this command`);
+                if (command !== "start")
+                    throw new Error(`option ${flag} is not valid for this command`);
                 options.pgsqlPort = Number(value);
                 index += 1;
                 break;
             case "--mysql-port":
-                if (command !== "start") throw new Error(`option ${flag} is not valid for this command`);
+                if (command !== "start")
+                    throw new Error(`option ${flag} is not valid for this command`);
                 options.mysqlPort = Number(value);
                 index += 1;
                 break;
+            case "--mongo-port":
+                if (command !== "start")
+                    throw new Error(`option ${flag} is not valid for this command`);
+                options.mongoPort = Number(value);
+                index += 1;
+                break;
             case "--wire-port":
-                if (command !== "start") throw new Error(`option ${flag} is not valid for this command`);
+                if (command !== "start")
+                    throw new Error(`option ${flag} is not valid for this command`);
                 options.wirePort = Number(value);
                 index += 1;
                 break;
@@ -77,18 +96,21 @@ async function main(args) {
                 redisPort: options.redisPort,
                 pgsqlPort: options.pgsqlPort,
                 mysqlPort: options.mysqlPort,
+                mongoPort: options.mongoPort,
                 wirePort: options.wirePort,
             });
             return;
         case "status": {
             const snapshot = native.nodeInspect(options.dataDir);
-            console.log(JSON.stringify({
-                directory: snapshot.directory,
-                identity: JSON.parse(snapshot.identity),
-                ownership: snapshot.ownership,
-                runtime: snapshot.runtime ? JSON.parse(snapshot.runtime) : null,
-                health: snapshot.health,
-            }));
+            console.log(
+                JSON.stringify({
+                    directory: snapshot.directory,
+                    identity: JSON.parse(snapshot.identity),
+                    ownership: snapshot.ownership,
+                    runtime: snapshot.runtime ? JSON.parse(snapshot.runtime) : null,
+                    health: snapshot.health,
+                }),
+            );
             return;
         }
         case "stop": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yydb/yyds",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "Node.js facade, CLI, and native bindings for local YYDS nodes.",
   "license": "MPL-2.0",
   "type": "module",
@@ -28,7 +28,7 @@
     }
   },
   "bin": {
-    "yyds": "./bin/yyds.mjs"
+    "yyds": "bin/yyds.mjs"
   },
   "files": [
     "bin",
@@ -41,9 +41,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/yy-database/yyds.git",
-    "directory": "projects/packages/yyds"
+    "directory": "projects/yyds.ts/packages/yyds"
   },
-  "homepage": "https://github.com/yy-database/yyds/tree/dev/projects/packages/yyds#readme",
+  "homepage": "https://github.com/yy-database/yyds/tree/dev/projects/yyds.ts/packages/yyds#readme",
   "bugs": {
     "url": "https://github.com/yy-database/yyds/issues"
   },
@@ -57,10 +57,10 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@yydb/yyds-win32-x64": "0.0.12",
-    "@yydb/yyds-linux-x64": "0.0.12",
-    "@yydb/yyds-darwin-x64": "0.0.12",
-    "@yydb/yyds-darwin-arm64": "0.0.12"
+    "@yydb/yyds-win32-x64": "0.0.14",
+    "@yydb/yyds-linux-x64": "0.0.14",
+    "@yydb/yyds-darwin-x64": "0.0.14",
+    "@yydb/yyds-darwin-arm64": "0.0.14"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",

package/readme.md

@@ -34,6 +34,6 @@ yyds stop --data-dir ./node-data
 
 ## Related packages
 
-- [`@yydb/redis`](https://github.com/yy-database/yyds/tree/dev/projects/packages/redis) — Redis protocol disguise
-- [`@yydb/mysql`](https://github.com/yy-database/yyds/tree/dev/projects/packages/mysql) — MySQL protocol disguise
-- [`@yydb/postgresql`](https://github.com/yy-database/yyds/tree/dev/projects/packages/postgresql) — PostgreSQL protocol disguise
+- [`@yydb/redis`](https://github.com/yy-database/yyds/tree/dev/projects/yyds.ts/packages/redis) �?Redis protocol disguise
+- [`@yydb/mysql`](https://github.com/yy-database/yyds/tree/dev/projects/yyds.ts/packages/mysql) �?MySQL protocol disguise
+- [`@yydb/postgresql`](https://github.com/yy-database/yyds/tree/dev/projects/yyds.ts/packages/postgresql) �?PostgreSQL protocol disguise

package/src/bindings.ts

@@ -7,9 +7,18 @@ export interface YydsBindings {
         acquire(dataDir: string, identity: unknown): unknown;
     };
     LocalExecutorHandle: new (dataDir: string) => unknown;
-    RedisServiceHandle: new (lease: unknown, port: number, executor: unknown) => RedisServiceBinding;
+    RedisServiceHandle: new (
+        lease: unknown,
+        port: number,
+        executor: unknown,
+    ) => RedisServiceBinding;
     PgsqlServiceHandle: new (lease: unknown, port: number) => PgsqlServiceBinding;
     MysqlServiceHandle: new (lease: unknown, port: number) => MysqlServiceBinding;
+    MongoServiceHandle: new (
+        lease: unknown,
+        port: number,
+        executor: unknown,
+    ) => MongoServiceBinding;
     WireServerHandle: new (port: number, executor: unknown) => WireServiceBinding;
     nodeInit(dataDir: string, identity: unknown): void;
     nodeInspect(dataDir: string): NodeStatusBinding;
@@ -30,6 +39,7 @@ export interface ServiceBinding {
 export type RedisServiceBinding = ServiceBinding;
 export type PgsqlServiceBinding = ServiceBinding;
 export type MysqlServiceBinding = ServiceBinding;
+export type MongoServiceBinding = ServiceBinding;
 export type WireServiceBinding = ServiceBinding;
 
 export interface NodeStatusBinding {

package/src/node/index.ts

@@ -7,16 +7,6 @@
 export type { YydsBindings, NodeStatusBinding, ServiceBinding } from "../bindings.ts";
 export type { YydsProtocol } from "./cluster.ts";
 export { launchYydsServer, yydsStartArguments } from "./cluster.ts";
-export { isYydsNativeInstalled, loadYydsNative, loadYydsSqliteNative } from "./load.ts";
+export { isYydsNativeInstalled, loadYydsNative } from "./load.ts";
 export type { StartNodeOptions } from "./runtime.ts";
 export { parseStartOptions, runNodeStart } from "./runtime.ts";
-export type {
-    SqliteDatabaseBinding,
-    SqliteDecodedRow,
-    SqliteReadLimits,
-    SqliteRecordValue,
-    SqliteSchemaObject,
-    SqliteSnapshotBinding,
-    SqliteTableRow,
-    YydsSqliteBindings,
-} from "./sqlite-bindings.ts";

package/src/node/load.ts

@@ -2,7 +2,6 @@ import { createRequire } from "node:module";
 
 import type { YydsBindings } from "../bindings.ts";
 import { resolvePlatformPackage } from "./platform-packages.ts";
-import type { YydsSqliteBindings } from "./sqlite-bindings.ts";
 
 const require = createRequire(import.meta.url);
 
@@ -17,25 +16,6 @@ export function loadYydsNative(): YydsBindings {
     return binding as unknown as YydsBindings;
 }
 
-/** Load the independent SQLite snapshot reader, not a YYDS execution session. */
-export function loadYydsSqliteNative(): YydsSqliteBindings {
-    const binding = bindingModule();
-    if (typeof binding.SqliteSnapshot !== "function") {
-        throw new Error("Native addon lacks the SQLite snapshot reader. Rebuild the native package.");
-    }
-    if (typeof binding.SqliteDatabase !== "function") {
-        throw new Error("Native addon lacks the SqliteDatabase class. Rebuild the native package.");
-    }
-    if (typeof binding.decodeRecord !== "function") {
-        throw new Error("Native addon lacks decodeRecord. Rebuild the native package.");
-    }
-    return {
-        SqliteSnapshot: binding.SqliteSnapshot as YydsSqliteBindings["SqliteSnapshot"],
-        SqliteDatabase: binding.SqliteDatabase as unknown as YydsSqliteBindings["SqliteDatabase"],
-        decodeRecord: binding.decodeRecord as YydsSqliteBindings["decodeRecord"],
-    };
-}
-
 /** Whether the current platform optional dependency is installed. */
 export function isYydsNativeInstalled(): boolean {
     try {

package/src/node/runtime.ts

@@ -12,6 +12,7 @@ export interface StartNodeOptions {
     redisPort?: number;
     pgsqlPort?: number;
     mysqlPort?: number;
+    mongoPort?: number;
     wirePort?: number;
 }
 
@@ -33,7 +34,8 @@ export function parseStartOptions(protocol: YydsProtocol, args: string[]): Start
         const argument = args[index];
         if (["--port", "-p", "-P"].includes(argument)) {
             const value = Number(args[++index]);
-            if (!Number.isInteger(value) || value < 0) throw new Error(`missing port after ${argument}`);
+            if (!Number.isInteger(value) || value < 0)
+                throw new Error(`missing port after ${argument}`);
             if (protocol === "redis") options.redisPort = value;
             if (protocol === "mysql") options.mysqlPort = value;
             if (protocol === "postgresql") options.pgsqlPort = value;
@@ -63,6 +65,10 @@ export function parseStartOptions(protocol: YydsProtocol, args: string[]): Start
             options.mysqlPort = Number(args[++index]);
             continue;
         }
+        if (argument === "--mongo-port") {
+            options.mongoPort = Number(args[++index]);
+            continue;
+        }
         if (argument === "--wire-port") {
             options.wirePort = Number(args[++index]);
             continue;
@@ -89,10 +95,27 @@ export async function runNodeStart(options: StartNodeOptions): Promise<void> {
     const identity = new native.NodeIdentityHandle(options.clusterId, options.nodeId);
     const lease = native.NodeLeaseHandle.acquire(options.dataDir, identity);
     const executor = new native.LocalExecutorHandle(options.dataDir);
-    const redis = new native.RedisServiceHandle(lease, options.redisPort ?? DEFAULT_REDIS_PORT, executor);
-    const pgsql = options.pgsqlPort === undefined ? undefined : new native.PgsqlServiceHandle(lease, options.pgsqlPort);
-    const mysql = options.mysqlPort === undefined ? undefined : new native.MysqlServiceHandle(lease, options.mysqlPort);
-    const wire = options.wirePort === undefined ? undefined : new native.WireServerHandle(options.wirePort, executor);
+    const redis = new native.RedisServiceHandle(
+        lease,
+        options.redisPort ?? DEFAULT_REDIS_PORT,
+        executor,
+    );
+    const pgsql =
+        options.pgsqlPort === undefined
+            ? undefined
+            : new native.PgsqlServiceHandle(lease, options.pgsqlPort);
+    const mysql =
+        options.mysqlPort === undefined
+            ? undefined
+            : new native.MysqlServiceHandle(lease, options.mysqlPort);
+    const mongo =
+        options.mongoPort === undefined
+            ? undefined
+            : new native.MongoServiceHandle(lease, options.mongoPort, executor);
+    const wire =
+        options.wirePort === undefined
+            ? undefined
+            : new native.WireServerHandle(options.wirePort, executor);
 
     const runtime = {
         version: 1,
@@ -107,7 +130,7 @@ export async function runNodeStart(options: StartNodeOptions): Promise<void> {
     native.nodeWriteRuntimeStatus(options.dataDir, JSON.stringify(runtime));
 
     process.stdout.write(
-        `yyds running pid=${runtime.pid} redis=${runtime.redisAddress} pgsql=${runtime.pgsqlAddress ?? "null"} mysql=${runtime.mysqlAddress ?? "null"} wire=${runtime.wireAddress ?? "null"}\n`,
+        `yyds running pid=${runtime.pid} redis=${runtime.redisAddress} pgsql=${runtime.pgsqlAddress ?? "null"} mysql=${runtime.mysqlAddress ?? "null"} mongo=${mongo?.address() ?? "null"} wire=${runtime.wireAddress ?? "null"}\n`,
     );
 
     while (true) {
@@ -115,6 +138,7 @@ export async function runNodeStart(options: StartNodeOptions): Promise<void> {
         if (redis.isFinished()) break;
         if (pgsql?.isFinished()) break;
         if (mysql?.isFinished()) break;
+        if (mongo?.isFinished()) break;
         if (wire?.isFinished()) break;
         await sleep(50);
     }
@@ -122,6 +146,7 @@ export async function runNodeStart(options: StartNodeOptions): Promise<void> {
     redis.stop();
     pgsql?.stop();
     mysql?.stop();
+    mongo?.stop();
     wire?.stop();
     native.nodeClearRuntimeArtifacts(options.dataDir, runtime.generation);
 }

package/src/node/sqlite-bindings.ts

@@ -1,70 +0,0 @@
-/** Bounds apply independently to each schema or table scan. */
-export interface SqliteReadLimits {
-    maxPages?: number;
-    maxRows?: number;
-    maxPayloadBytes?: number;
-    maxTotalPayloadBytes?: number;
-}
-
-/** SQL source is opaque. No CREATE statement is parsed or executed. */
-export interface SqliteSchemaObject {
-    kind: "table" | "index" | "view" | "trigger";
-    name: string;
-    tableName: string;
-    rootPage?: number;
-    sql?: string;
-}
-
-/** Raw storage values, not SQL results or INTEGER PRIMARY KEY expansion. */
-export interface SqliteTableRow {
-    rowid: bigint;
-    payload: Buffer;
-}
-
-/** One decoded SQLite storage-class field. Exactly one `value*` is populated. */
-export interface SqliteRecordValue {
-    kind: "null" | "integer" | "real" | "text" | "blob";
-    valueInteger?: bigint;
-    valueReal?: number;
-    valueText?: string;
-    valueBlob?: Buffer;
-}
-
-/** A decoded SQLite row with storage-class typed columns. */
-export interface SqliteDecodedRow {
-    rowid: bigint;
-    columns: SqliteRecordValue[];
-}
-
-/** Binding surface for SqliteSnapshot (read-only main-file buffer). */
-export interface SqliteSnapshotBinding {
-    schema(limits?: SqliteReadLimits): SqliteSchemaObject[];
-    table(name: string, limits?: SqliteReadLimits): SqliteTableRow[];
-    tableDecoded(name: string, limits?: SqliteReadLimits): SqliteDecodedRow[];
-    sqliteVersion(): string;
-    encoding(): string;
-    ping(): number;
-    pages(): Buffer;
-}
-
-/** Binding surface for SqliteDatabase (file-backed or in-memory handle). */
-export interface SqliteDatabaseBinding {
-    path(): string | null;
-    ping(): number;
-    sqliteVersion(): string;
-    encoding(): string;
-    schema(limits?: SqliteReadLimits): SqliteSchemaObject[];
-    table(name: string, limits?: SqliteReadLimits): SqliteDecodedRow[];
-    tableRaw(name: string, limits?: SqliteReadLimits): SqliteTableRow[];
-    pages(): Buffer;
-}
-
-/** Combined SQLite native addon surface. */
-export interface YydsSqliteBindings {
-    SqliteSnapshot: new (bytes: Buffer, maxSnapshotBytes?: number) => SqliteSnapshotBinding;
-    SqliteDatabase: {
-        openInMemory(): SqliteDatabaseBinding;
-        open(path: string): SqliteDatabaseBinding;
-    };
-    decodeRecord(payload: Buffer, encoding?: string): SqliteRecordValue[];
-}