ysk-server-core 1.0.0

package/dist/hosting/db-cluster/plan-redis-replica.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Redis replica (+ optional Sentinel plan) — pure planners.
+ */
+import type { ClusterPlan, DbCluster, DbClusterMember } from './types.js';
+export declare function renderRedisMasterConf(c: DbCluster): string;
+export declare function renderRedisReplicaConf(c: DbCluster, m: DbClusterMember): string;
+export declare function renderRedisSentinelConf(c: DbCluster, m: DbClusterMember): string;
+export declare function renderRedisPlanMd(c: DbCluster): string;
+export declare function planRedisReplica(c: DbCluster): ClusterPlan;
+//# sourceMappingURL=plan-redis-replica.d.ts.map

package/dist/hosting/db-cluster/plan-redis-replica.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-redis-replica.d.ts","sourceRoot":"","sources":["../../../src/hosting/db-cluster/plan-redis-replica.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAmB,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAmB3F,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAY1D;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,GAAG,MAAM,CAe/E;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,GAAG,MAAM,CAkBhF;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CA4BtD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,GAAG,WAAW,CA+F1D"}

package/dist/hosting/db-cluster/plan-redis-replica.js

@@ -0,0 +1,184 @@
+import { tl } from 'ysk-server-shared';
+function master(c) {
+    return (c.members.find((m) => m.role === 'master' || m.role === 'primary') ??
+        c.members.find((m) => m.access === 'local') ??
+        c.members[0]);
+}
+function replicas(c) {
+    const m = master(c);
+    return c.members.filter((x) => x.id !== m?.id && x.role !== 'sentinel');
+}
+function sentinels(c) {
+    return c.members.filter((m) => m.role === 'sentinel');
+}
+export function renderRedisMasterConf(c) {
+    const port = Number(c.params.port) || 6379;
+    return `# YSK Server managed — Redis master
+# cluster: ${c.id} (${c.name})
+
+bind 0.0.0.0
+port ${port}
+protected-mode yes
+# requirepass CHANGE_ME
+# masterauth CHANGE_ME
+appendonly yes
+`;
+}
+export function renderRedisReplicaConf(c, m) {
+    const mast = master(c);
+    const port = Number(c.params.port) || 6379;
+    const mhost = mast?.host ?? 'MASTER_HOST';
+    const mport = mast?.port ?? port;
+    return `# YSK Server managed — Redis replica
+# this=${m.host} · master=${mhost}
+
+bind 0.0.0.0
+port ${port}
+replicaof ${mhost} ${mport}
+# masterauth CHANGE_ME
+# requirepass CHANGE_ME
+appendonly yes
+`;
+}
+export function renderRedisSentinelConf(c, m) {
+    const mast = master(c);
+    const name = String(c.params.sentinelName || c.name || 'ysk-redis').replace(/[^a-zA-Z0-9_-]/g, '-');
+    const mhost = mast?.host ?? 'MASTER_HOST';
+    const mport = mast?.port ?? 6379;
+    const quorum = Number(c.params.quorum) || Math.max(1, Math.floor(sentinels(c).length / 2) + 1);
+    return `# YSK Server managed — Redis Sentinel
+# this=${m.host}
+
+port ${m.port || 26379}
+sentinel monitor ${name} ${mhost} ${mport} ${quorum}
+sentinel down-after-milliseconds ${name} 5000
+sentinel failover-timeout ${name} 60000
+# sentinel auth-pass ${name} CHANGE_ME
+`;
+}
+export function renderRedisPlanMd(c) {
+    const m = master(c);
+    return [
+        `# Redis ${c.kind} plan — ${c.name}`,
+        ``,
+        `- id: \`${c.id}\``,
+        `- master: ${m?.host ?? '—'}`,
+        `- replicas: ${replicas(c).map((x) => x.host).join(', ') || '—'}`,
+        c.kind === 'redis-sentinel'
+            ? `- sentinels: ${sentinels(c).map((x) => x.host).join(', ') || '—'}`
+            : '',
+        ``,
+        `## Order`,
+        `1. Install redis-server on all nodes`,
+        `2. Master: apply conf → systemctl restart redis-server`,
+        `3. Replica: apply replicaof conf → restart`,
+        `4. Probe: INFO replication`,
+        c.kind === 'redis-sentinel'
+            ? `5. Sentinel nodes: install sentinel conf → redis-sentinel / systemctl`
+            : '',
+        ``,
+        `## Honesty`,
+        `- Plan ≠ replication linked`,
+        `- Passwords only as CHANGE_ME placeholders`,
+        ``,
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+export function planRedisReplica(c) {
+    if (c.engine !== 'redis' || (c.kind !== 'redis-replica' && c.kind !== 'redis-sentinel')) {
+        return {
+            ok: false,
+            dryRun: true,
+            clusterId: c.id,
+            kind: c.kind,
+            engine: c.engine,
+            steps: [],
+            files: [],
+            notes: [tl('notes.auto.n0572')],
+            requiresExecute: true,
+            requiresRoot: true
+        };
+    }
+    const m = master(c);
+    if (!m) {
+        return {
+            ok: false,
+            dryRun: true,
+            clusterId: c.id,
+            kind: c.kind,
+            engine: c.engine,
+            steps: [],
+            files: [],
+            notes: [tl('notes.auto.n1565')],
+            requiresExecute: true,
+            requiresRoot: true
+        };
+    }
+    const notes = [tl('notes.auto.n0033'), `master=${m.host}`];
+    const steps = [];
+    const files = [
+        { relativePath: 'conf/99-ysk-redis-master.conf', body: renderRedisMasterConf(c) },
+        { relativePath: 'plan.md', body: renderRedisPlanMd(c) },
+    ];
+    steps.push({
+        id: 'conf-master',
+        memberId: m.id,
+        title: `Master conf（${m.host}）`,
+        kind: 'conf',
+        body: renderRedisMasterConf(c),
+        risk: 'write-panel'
+    });
+    for (const r of replicas(c)) {
+        const conf = renderRedisReplicaConf(c, r);
+        const safe = r.host.replace(/[^a-zA-Z0-9._-]/g, '_');
+        files.push({ relativePath: `conf/peers/${safe}-replica.conf`, body: conf });
+        steps.push({
+            id: `conf-replica-${r.id}`,
+            memberId: r.id,
+            title: `Replica conf ${r.host}`,
+            kind: 'conf',
+            body: conf,
+            risk: 'write-panel'
+        });
+    }
+    if (c.kind === 'redis-sentinel') {
+        if (!sentinels(c).length) {
+            notes.push(tl('notes.auto.n0427'));
+        }
+        for (const s of sentinels(c)) {
+            const conf = renderRedisSentinelConf(c, s);
+            const safe = s.host.replace(/[^a-zA-Z0-9._-]/g, '_');
+            files.push({ relativePath: `conf/peers/${safe}-sentinel.conf`, body: conf });
+            steps.push({
+                id: `conf-sentinel-${s.id}`,
+                memberId: s.id,
+                title: `Sentinel conf ${s.host}`,
+                kind: 'conf',
+                body: conf,
+                risk: 'write-panel'
+            });
+        }
+    }
+    steps.push({
+        id: 'probe',
+        title: tl('notes.auto.n0886'),
+        kind: 'probe',
+        risk: 'read'
+    });
+    if (!replicas(c).length)
+        notes.push(tl('notes.auto.n0034'));
+    return {
+        ok: true,
+        dryRun: true,
+        clusterId: c.id,
+        kind: c.kind,
+        engine: c.engine,
+        steps,
+        files,
+        notes,
+        requiresExecute: true,
+        requiresRoot: true
+    };
+}
+//# sourceMappingURL=plan-redis-replica.js.map

package/dist/hosting/db-cluster/plan-redis-replica.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-redis-replica.js","sourceRoot":"","sources":["../../../src/hosting/db-cluster/plan-redis-replica.ts"],"names":[],"mappings":"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"}

package/dist/hosting/db-cluster/plan.d.ts

@@ -0,0 +1,15 @@
+import type { JsonStore } from '../../db/store.js';
+import type { ClusterPlan, DbCluster } from './types.js';
+export declare function planDbCluster(cluster: DbCluster): ClusterPlan;
+/** Plan + mark status planned; optionally persist files under dataDir/clusters/{id}/ */
+export declare function planAndMaterializeDbCluster(input: {
+    db: JsonStore;
+    dataDir: string;
+    clusterId: string;
+    /** write files to dataDir (default true) */
+    writeArtifacts?: boolean;
+}): {
+    cluster: DbCluster;
+    plan: ClusterPlan;
+};
+//# sourceMappingURL=plan.d.ts.map

package/dist/hosting/db-cluster/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/hosting/db-cluster/plan.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,CAyB7D;AAED,wFAAwF;AACxF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CA0B5C"}

package/dist/hosting/db-cluster/plan.js

@@ -0,0 +1,59 @@
+import { tl } from 'ysk-server-shared';
+/**
+ * Route cluster planning by kind; write artifacts under dataDir (optional).
+ */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { planMariadbGalera } from './plan-mariadb-galera.js';
+import { planMysqlReplica } from './plan-mysql-replica.js';
+import { planPostgresReplica } from './plan-postgres-replica.js';
+import { planRedisReplica } from './plan-redis-replica.js';
+import { getDbCluster, updateDbCluster } from './store.js';
+export function planDbCluster(cluster) {
+    if (cluster.kind === 'mariadb-galera') {
+        return planMariadbGalera(cluster);
+    }
+    if (cluster.kind === 'mysql-replica') {
+        return planMysqlReplica(cluster);
+    }
+    if (cluster.kind === 'postgres-replica') {
+        return planPostgresReplica(cluster);
+    }
+    if (cluster.kind === 'redis-replica' || cluster.kind === 'redis-sentinel') {
+        return planRedisReplica(cluster);
+    }
+    return {
+        ok: false,
+        dryRun: true,
+        clusterId: cluster.id,
+        kind: cluster.kind,
+        engine: cluster.engine,
+        steps: [],
+        files: [],
+        notes: [tl('notes.auto.t0580', { v0: (cluster.kind) })],
+        requiresExecute: true,
+        requiresRoot: true,
+    };
+}
+/** Plan + mark status planned; optionally persist files under dataDir/clusters/{id}/ */
+export function planAndMaterializeDbCluster(input) {
+    const cluster = getDbCluster(input.db, input.clusterId);
+    const plan = planDbCluster(cluster);
+    const artifactDir = join(input.dataDir, 'clusters', cluster.id);
+    if (input.writeArtifacts !== false && plan.ok) {
+        for (const f of plan.files) {
+            const path = join(artifactDir, f.relativePath);
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, f.body, 'utf8');
+        }
+        mkdirSync(artifactDir, { recursive: true });
+        writeFileSync(join(artifactDir, 'cluster.json'), JSON.stringify({ ...cluster, status: 'planned' }, null, 2) + '\n', 'utf8');
+    }
+    const next = updateDbCluster(input.db, cluster.id, {
+        status: plan.ok ? 'planned' : cluster.status,
+        artifactDir: plan.ok ? artifactDir : cluster.artifactDir,
+        notes: plan.notes,
+    });
+    return { cluster: next, plan };
+}
+//# sourceMappingURL=plan.js.map

package/dist/hosting/db-cluster/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/hosting/db-cluster/plan.ts"],"names":[],"mappings":"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"}

package/dist/hosting/db-cluster/probe.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Probe DB cluster health (local node first). Honest — never invent healthy.
+ */
+import type { HostExecutor } from '../../host/executor.js';
+import type { JsonStore } from '../../db/store.js';
+import type { DbCluster } from './types.js';
+export interface ClusterProbeResult {
+    ok: boolean;
+    cluster: DbCluster;
+    facts: Record<string, string>;
+    notes: string[];
+    localOk: boolean;
+}
+/** Parse SHOW STATUS LIKE 'wsrep%' tabular output */
+export declare function parseWsrepStatus(stdout: string): Record<string, string>;
+export declare function evaluateGaleraHealth(facts: Record<string, string>, memberCount: number): {
+    ok: boolean;
+    notes: string[];
+};
+/** Parse SHOW MASTER STATUS / SHOW BINARY LOG STATUS */
+export declare function parseMasterStatus(stdout: string): Record<string, string>;
+/** Parse SHOW REPLICA STATUS / SHOW SLAVE STATUS */
+export declare function parseReplicaStatus(stdout: string): Record<string, string>;
+export declare function evaluateMysqlReplicaLocal(role: string, facts: Record<string, string>): {
+    ok: boolean;
+    notes: string[];
+};
+/**
+ * Probe local node; update registry.
+ * Peer probes via SSH out of scope (notes only).
+ */
+export declare function probeDbCluster(input: {
+    db: JsonStore;
+    host: HostExecutor;
+    clusterId: string;
+}): Promise<ClusterProbeResult>;
+//# sourceMappingURL=probe.d.ts.map

package/dist/hosting/db-cluster/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/hosting/db-cluster/probe.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EACV,SAAS,EAIV,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBvE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,WAAW,EAAE,MAAM,GAClB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAuClC;AA0BD,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBxE;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBzE;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAyBlC;AAkBD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+P9B"}