@yydb/yyds 0.0.22 → 0.0.23

package/bin/yyds.mjs

@@ -1,14 +1,20 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
+
 import { loadYydsNative } from "../src/node/load.ts";
 import { parseStartOptions, runNodeStart } from "../src/node/runtime.ts";
 import { parseWebuiArgs, runWebui } from "../src/node/webui-cmd.ts";
 
 function usage() {
-    return "usage: yyds <init|start|status|stop|webui> ...";
+    return "usage: yyds <init|start|status|stop|webui|catalog> ...";
 }
 
 function startUsage() {
-    return "usage: yyds start --data-dir DIR --cluster-id ID --node-id ID [--redis-port PORT] [--pgsql-port PORT] [--mysql-port PORT] [--mongo-port PORT] [--wire-port PORT]";
+    return "usage: yyds start --data-dir DIR --cluster-id ID --node-id ID [--catalog-path FILE] [--redis-port PORT] [--pgsql-port PORT] [--mysql-port PORT] [--mongo-port PORT] [--wire-port PORT]";
+}
+
+function catalogUsage() {
+    return "usage: yyds catalog --catalog-path FILE --schema-file FILE [--schema-version NUMBER]";
 }
 
 function webuiUsage() {
@@ -20,6 +26,7 @@ function parseCommonArgs(command, args) {
         dataDir: "",
         clusterId: "",
         nodeId: "",
+        catalogPath: undefined,
         redisPort: 6379,
         pgsqlPort: undefined,
         mysqlPort: undefined,
@@ -43,6 +50,12 @@ function parseCommonArgs(command, args) {
                 options.nodeId = value;
                 index += 1;
                 break;
+            case "--catalog-path":
+                if (command !== "start")
+                    throw new Error(`option ${flag} is not valid for this command`);
+                options.catalogPath = value;
+                index += 1;
+                break;
             case "--redis-port":
                 if (command !== "start")
                     throw new Error(`option ${flag} is not valid for this command`);
@@ -84,6 +97,39 @@ function parseCommonArgs(command, args) {
     return options;
 }
 
+function runCatalog(native, args) {
+    let catalogPath = "";
+    let schemaFile = "";
+    let schemaVersion = 1;
+    for (let index = 0; index < args.length; index += 1) {
+        const flag = args[index];
+        const value = args[index + 1];
+        if (!value || value.startsWith("--")) throw new Error(`missing value for ${flag}\n${catalogUsage()}`);
+        switch (flag) {
+            case "--catalog-path":
+                catalogPath = value;
+                index += 1;
+                break;
+            case "--schema-file":
+                schemaFile = value;
+                index += 1;
+                break;
+            case "--schema-version": {
+                const parsed = Number(value);
+                if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`invalid schema version '${value}'`);
+                schemaVersion = parsed;
+                index += 1;
+                break;
+            }
+            default:
+                throw new Error(`unknown option '${flag}'\n${catalogUsage()}`);
+        }
+    }
+    if (!catalogPath || !schemaFile) throw new Error(catalogUsage());
+    native.catalogPublishSchema(catalogPath, schemaVersion, readFileSync(schemaFile, "utf8"));
+    console.log(`published schema version ${schemaVersion} into ${catalogPath}`);
+}
+
 async function main(args) {
     const command = args[0];
     const rest = args.slice(1);
@@ -94,6 +140,12 @@ async function main(args) {
     }
 
     const native = loadYydsNative();
+
+    if (command === "catalog") {
+        runCatalog(native, rest);
+        return;
+    }
+
     const options = parseCommonArgs(command, rest);
 
     switch (command) {
@@ -108,6 +160,7 @@ async function main(args) {
                 dataDir: options.dataDir,
                 clusterId: options.clusterId,
                 nodeId: options.nodeId,
+                catalogPath: options.catalogPath,
                 redisPort: options.redisPort,
                 pgsqlPort: options.pgsqlPort,
                 mysqlPort: options.mysqlPort,
@@ -139,7 +192,7 @@ async function main(args) {
             return;
         }
         default:
-            throw new Error(command ? `unknown command '${command}'` : `${usage()}\n${startUsage()}\n${webuiUsage()}`);
+            throw new Error(command ? `unknown command '${command}'` : `${usage()}\n${startUsage()}\n${webuiUsage()}\n${catalogUsage()}`);
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yydb/yyds",
-  "version": "0.0.22",
+  "version": "0.0.23",
   "description": "Node.js facade, CLI, and native bindings for local YYDS nodes.",
   "license": "MPL-2.0",
   "type": "module",
@@ -59,14 +59,14 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@yydb/yyds-win32-x64": "0.0.22",
-    "@yydb/yyds-linux-x64": "0.0.22",
-    "@yydb/yyds-darwin-x64": "0.0.22",
-    "@yydb/yyds-darwin-arm64": "0.0.22"
+    "@yydb/yyds-win32-x64": "0.0.23",
+    "@yydb/yyds-linux-x64": "0.0.23",
+    "@yydb/yyds-darwin-x64": "0.0.23",
+    "@yydb/yyds-darwin-arm64": "0.0.23"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",
-    "@yydb/yyds-webui": "0.0.22",
+    "@yydb/yyds-webui": "0.0.23",
     "typescript": "^5.9.2"
   },
   "engines": {

package/src/bindings.ts

@@ -14,7 +14,7 @@ export interface YydsBindings {
     ) => RedisServiceBinding;
     PgsqlServiceHandle: {
         new (lease: unknown, port: number): PgsqlServiceBinding;
-        start_with_executor(
+        startWithExecutor(
             lease: unknown,
             port: number,
             executor: unknown,
@@ -23,7 +23,7 @@ export interface YydsBindings {
     };
     MysqlServiceHandle: {
         new (lease: unknown, port: number): MysqlServiceBinding;
-        start_with_executor(
+        startWithExecutor(
             lease: unknown,
             port: number,
             executor: unknown,
@@ -36,6 +36,7 @@ export interface YydsBindings {
         executor: unknown,
     ) => MongoServiceBinding;
     WireServerHandle: new (port: number, executor: unknown) => WireServiceBinding;
+    catalogPublishSchema(catalogPath: string, schemaVersion: number, schemaDocument: string): void;
     nodeInit(dataDir: string, identity: unknown): void;
     nodeInspect(dataDir: string): NodeStatusBinding;
     nodeReadRuntimeStatus(dataDir: string): string | null;

package/src/node/runtime.ts

@@ -119,7 +119,7 @@ export async function runNodeStart(options: StartNodeOptions): Promise<void> {
         options.pgsqlPort === undefined
             ? undefined
             : hasRuntime
-                ? native.PgsqlServiceHandle.start_with_executor(
+                ? native.PgsqlServiceHandle.startWithExecutor(
                       lease,
                       options.pgsqlPort,
                       executor,
@@ -130,7 +130,7 @@ export async function runNodeStart(options: StartNodeOptions): Promise<void> {
         options.mysqlPort === undefined
             ? undefined
             : hasRuntime
-                ? native.MysqlServiceHandle.start_with_executor(
+                ? native.MysqlServiceHandle.startWithExecutor(
                       lease,
                       options.mysqlPort,
                       executor,