supabee 0.2.0

package/dist/lib/step-command.js

@@ -0,0 +1,52 @@
+import { runSubcommandMode } from './command-mode.js';
+import { parseStepCommandArgs, printStepCommandHelp, resolveStepPaths, } from './command-contract.js';
+import { sectionWithNote, title } from './ui.js';
+function printStepDetails(commandDisplayName, step, note, detailLines) {
+    console.log(sectionWithNote(title(`${commandDisplayName} ${step}`), note));
+    for (const line of detailLines) {
+        console.log(line);
+    }
+    console.log('');
+}
+export async function runStepCommand(args, definition) {
+    const { commandName, commandDisplayName, detailNote, buildDefaults, buildStepConfig, getDetailLines, actions } = definition;
+    const { subcommand, options, isUnknownSubcommand } = parseStepCommandArgs(args);
+    if (options.help) {
+        printStepCommandHelp(commandName);
+        return;
+    }
+    if (isUnknownSubcommand) {
+        console.error(`Unsupported ${commandName} command: ${subcommand}`);
+        process.exit(1);
+    }
+    const defaults = buildDefaults(options);
+    const resolveDetailNote = (step) => (typeof detailNote === 'function' ? detailNote(step) : detailNote);
+    const resolveDetailLines = (step, config) => (typeof getDetailLines === 'function' ? getDetailLines(step, config) : getDetailLines) ?? [];
+    const resolveStepConfig = (step) => {
+        if (buildStepConfig)
+            return buildStepConfig({ step, defaults, options, subcommand });
+        const stepPaths = resolveStepPaths({ defaults, options, subcommand, step });
+        return {
+            ...defaults,
+            ...stepPaths,
+        };
+    };
+    await runSubcommandMode(commandName, subcommand, {
+        split: async () => {
+            const config = resolveStepConfig('split');
+            printStepDetails(commandDisplayName, 'split', resolveDetailNote('split'), resolveDetailLines('split', config));
+            return actions.split({ config, options, defaults, subcommand });
+        },
+        reconstruct: async () => {
+            const config = resolveStepConfig('reconstruct');
+            printStepDetails(commandDisplayName, 'reconstruct', resolveDetailNote('reconstruct'), resolveDetailLines('reconstruct', config));
+            return actions.reconstruct({ config, options, defaults, subcommand });
+        },
+        validate: async () => {
+            const config = resolveStepConfig('validate');
+            printStepDetails(commandDisplayName, 'validate', resolveDetailNote('validate'), resolveDetailLines('validate', config));
+            return actions.validate({ config, options, defaults, subcommand });
+        },
+    });
+}
+//# sourceMappingURL=step-command.js.map

package/dist/lib/step-command.js.map

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

package/dist/lib/ui.d.ts

@@ -0,0 +1,13 @@
+export declare function section(title: string): string;
+export declare function sectionWithNote(title: string, note: string): string;
+export declare function info(message: string): string;
+export declare function ok(message: string): string;
+export declare function warn(message: string): string;
+export declare function error(message: string): string;
+export declare function title(message: string): string;
+export declare function pass(message: string): string;
+export declare function fail(message: string): string;
+export declare function note(message: string): string;
+export declare function recommended(message: string): string;
+export declare function diffRemove(message: string): string;
+export declare function diffAdd(message: string): string;

package/dist/lib/ui.js

@@ -0,0 +1,76 @@
+import process from 'node:process';
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+const COLORS = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    white: '\x1b[37m',
+};
+function paint(text, color) {
+    if (!useColor)
+        return text;
+    return `${COLORS[color]}${text}${COLORS.reset}`;
+}
+function style(text, ...styles) {
+    if (!useColor)
+        return text;
+    return `${styles.map((name) => COLORS[name]).join('')}${text}${COLORS.reset}`;
+}
+function formatLabel(label, color) {
+    return style(`[${label}]`, 'bold', color);
+}
+function line(char = '-', width = 54) {
+    return char.repeat(width);
+}
+export function section(title) {
+    const header = style(` ${title} `, 'bold', 'white');
+    if (!useColor) {
+        return `\n${line('=')}\n${header}\n${line('=')}`;
+    }
+    return `\n${paint(line('-'), 'dim')}\n${header}\n${paint(line('-'), 'dim')}`;
+}
+export function sectionWithNote(title, note) {
+    const header = style(` ${title} `, 'bold', 'white');
+    if (!useColor) {
+        return `\n${line('=')}\n${header}\n${note}\n${line('=')}`;
+    }
+    return `\n${paint(line('-'), 'dim')}\n${header}\n${note}\n${paint(line('-'), 'dim')}`;
+}
+export function info(message) {
+    return useColor ? paint(message, 'dim') : message;
+}
+export function ok(message) {
+    return `${formatLabel('SUCCESS', 'green')} ${message}`;
+}
+export function warn(message) {
+    return `${formatLabel('WARN', 'yellow')} ${message}`;
+}
+export function error(message) {
+    return `${formatLabel('ERROR', 'red')} ${message}`;
+}
+export function title(message) {
+    return useColor ? style(`[${message}]`, 'bold', 'cyan') : `[${message}]`;
+}
+export function pass(message) {
+    return useColor ? `${paint('✓', 'green')} ${message}` : `✓ ${message}`;
+}
+export function fail(message) {
+    return useColor ? `${paint('x', 'red')} ${message}` : `x ${message}`;
+}
+export function note(message) {
+    return `${formatLabel('NOTE', 'yellow')} ${message}`;
+}
+export function recommended(message) {
+    return useColor ? paint(message, 'yellow') : message;
+}
+export function diffRemove(message) {
+    return useColor ? `${paint('-', 'red')} ${paint(message, 'red')}` : `- ${message}`;
+}
+export function diffAdd(message) {
+    return useColor ? `${paint('+', 'green')} ${paint(message, 'green')}` : `+ ${message}`;
+}
+//# sourceMappingURL=ui.js.map

package/dist/lib/ui.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "supabee",
+  "version": "0.2.0",
+  "description": "CLI tools for local Supabase schema/data workflows",
+  "license": "MIT",
+  "author": "Kai Ho Chak",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kaihochak/supabee.git"
+  },
+  "homepage": "https://github.com/kaihochak/supabee",
+  "bugs": {
+    "url": "https://github.com/kaihochak/supabee/issues"
+  },
+  "keywords": [
+    "supabase",
+    "database",
+    "schema",
+    "sql",
+    "cli",
+    "devtools",
+    "local"
+  ],
+  "type": "module",
+  "bin": {
+    "supabee": "dist/index.js",
+    "supabase-splitter": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "supabase-splitter.config.example.json",
+    "supabee.config.example.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node dist/index.js --help",
+    "pack:check": "npm run build && npm_config_cache=.npm-cache npm pack --dry-run"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "typescript": "^5.9.3"
+  }
+}

package/supabase-splitter.config.example.json

@@ -0,0 +1,29 @@
+{
+  "schema": {
+    "input": "supabase/schemas/prod-schemas.sql",
+    "output": "supabase/schemas/split",
+    "reconstructed": "supabase/schemas/reconstructed-schemas.sql",
+    "keepFiles": []
+  },
+  "data": {
+    "input": "supabase/seeds/prod-data.sql",
+    "output": "supabase/seeds/split",
+    "reconstructed": "supabase/seeds/reconstructed-data.sql",
+    "maxLinesPerFile": 2000,
+    "maxStatementsPerFile": 20,
+    "maxRowsPerInsert": 200,
+    "tableRules": {},
+    "keepFiles": [
+      "800_refresh_materialized_view.sql"
+    ],
+    "ignoreInReconstruct": [
+      "800_refresh_materialized_view.sql"
+    ]
+  },
+  "init": {
+    "seedSqlPaths": [
+      "./seeds/split/*.sql",
+      "./seeds/institutions/seeding_sql/*/*.seed.sql"
+    ]
+  }
+}

package/supabee.config.example.json

@@ -0,0 +1,29 @@
+{
+  "schema": {
+    "input": "supabase/schemas/prod-schemas.sql",
+    "output": "supabase/schemas/split",
+    "reconstructed": "supabase/schemas/reconstructed-schemas.sql",
+    "keepFiles": []
+  },
+  "data": {
+    "input": "supabase/seeds/prod-data.sql",
+    "output": "supabase/seeds/split",
+    "reconstructed": "supabase/seeds/reconstructed-data.sql",
+    "maxLinesPerFile": 2000,
+    "maxStatementsPerFile": 20,
+    "maxRowsPerInsert": 200,
+    "tableRules": {},
+    "keepFiles": [
+      "800_refresh_materialized_view.sql"
+    ],
+    "ignoreInReconstruct": [
+      "800_refresh_materialized_view.sql"
+    ]
+  },
+  "init": {
+    "seedSqlPaths": [
+      "./seeds/split/*.sql",
+      "./seeds/institutions/seeding_sql/*/*.seed.sql"
+    ]
+  }
+}