kintone-migrator 0.11.0 → 0.12.0

package/README.md

@@ -178,12 +178,17 @@ Applies seed data (records) to a kintone app using upsert (insert or update base
 kintone-migrator seed
 kintone-migrator seed -s my-seed.yaml
 
+# Clean apply: delete all existing records, then apply seed data
+kintone-migrator seed --clean
+kintone-migrator seed --clean --yes
+
 # Capture records from a kintone app
 kintone-migrator seed --capture --key-field customer_code
 kintone-migrator seed --capture --key-field customer_code -s seeds/customer.yaml
 
 # Multi-app mode
 kintone-migrator seed --all
+kintone-migrator seed --clean --all --yes
 kintone-migrator seed --capture --key-field code --all
 kintone-migrator seed --app customer
 ```
@@ -193,8 +198,10 @@ kintone-migrator seed --app customer
 | CLI Argument | Description |
 |---------|------|
 | `--capture` | Capture mode: fetch records from kintone and save to seed file |
+| `--clean` | Delete all existing records before applying seed data. Cannot be used with `--capture`. Prompts for confirmation unless `--yes` is specified. |
 | `--key-field`, `-k` | Key field code for upsert (required for `--capture`) |
 | `--seed-file`, `-s` | Seed file path (default: `seed.yaml`) |
+| `--yes`, `-y` | Skip confirmation prompts (for `--clean` mode) |
 
 ### `customize`
 

package/dist/index.mjs

@@ -845,6 +845,25 @@ var KintoneRecordManager = class {
 			throw new SystemError(SystemErrorCode.ExternalApiError, "Failed to update records", error);
 		}
 	}
+	async deleteAllRecords() {
+		try {
+			const records = await this.client.record.getAllRecords({
+				app: this.appId,
+				fields: ["$id"]
+			});
+			if (records.length === 0) return { deletedCount: 0 };
+			const validated = records.map((r) => toKintoneRecordForResponse(r));
+			await this.client.record.deleteAllRecords({
+				app: this.appId,
+				records: validated.map((r) => ({ id: Number(r.$id.value) }))
+			});
+			return { deletedCount: records.length };
+		} catch (error) {
+			if (isBusinessRuleError(error)) throw error;
+			if (error instanceof SystemError) throw error;
+			throw new SystemError(SystemErrorCode.ExternalApiError, "Failed to delete all records", error);
+		}
+	}
 };
 
 //#endregion
@@ -3643,10 +3662,22 @@ const UpsertPlanner = { plan: (key, seedRecords, existingRecords) => {
 
 //#endregion
 //#region src/core/application/seedData/upsertSeed.ts
-async function upsertSeed({ container }) {
+async function upsertSeed({ container, input }) {
 	const result = await container.seedStorage.get();
 	if (!result.exists) throw new ValidationError(ValidationErrorCode.InvalidInput, "Seed file not found");
 	const seedData = SeedParser.parse(result.content);
+	if (input.clean) {
+		const { deletedCount } = await container.recordManager.deleteAllRecords();
+		const kintoneRecords = seedData.records.map(RecordConverter.toKintoneRecord);
+		if (kintoneRecords.length > 0) await container.recordManager.addRecords(kintoneRecords);
+		return {
+			added: seedData.records.length,
+			updated: 0,
+			unchanged: 0,
+			deleted: deletedCount,
+			total: seedData.records.length
+		};
+	}
 	if (seedData.key === null) {
 		const kintoneRecords = seedData.records.map(RecordConverter.toKintoneRecord);
 		if (kintoneRecords.length > 0) await container.recordManager.addRecords(kintoneRecords);
@@ -3654,6 +3685,7 @@ async function upsertSeed({ container }) {
 			added: seedData.records.length,
 			updated: 0,
 			unchanged: 0,
+			deleted: 0,
 			total: seedData.records.length
 		};
 	}
@@ -3674,6 +3706,7 @@ async function upsertSeed({ container }) {
 		added: plan.toAdd.length,
 		updated: plan.toUpdate.length,
 		unchanged: plan.unchanged,
+		deleted: 0,
 		total: plan.toAdd.length + plan.toUpdate.length + plan.unchanged
 	};
 }
@@ -3683,10 +3716,15 @@ async function upsertSeed({ container }) {
 const seedArgs = {
 	...kintoneArgs,
 	...multiAppArgs,
+	...confirmArgs,
 	capture: {
 		type: "boolean",
 		description: "Capture records from kintone app to seed file"
 	},
+	clean: {
+		type: "boolean",
+		description: "Delete all existing records before applying seed data (clean apply)"
+	},
 	"key-field": {
 		type: "string",
 		short: "k",
@@ -3699,7 +3737,11 @@ const seedArgs = {
 	}
 };
 function resolveSeedMode(values) {
-	if (values.capture !== true) return { type: "upsert" };
+	if (values.capture === true && values.clean === true) throw new ValidationError(ValidationErrorCode.InvalidInput, "--capture and --clean cannot be used together");
+	if (values.capture !== true) return {
+		type: "upsert",
+		clean: values.clean === true
+	};
 	const keyField = values["key-field"];
 	if (!keyField) throw new ValidationError(ValidationErrorCode.InvalidInput, "--key-field is required when using --capture mode");
 	return {
@@ -3732,18 +3774,33 @@ function resolveSeedAppConfig(app, projectConfig, cliValues) {
 }
 function printUpsertResult(result) {
 	const parts = [
+		result.deleted > 0 ? pc.red(`-${result.deleted} deleted`) : null,
 		result.added > 0 ? pc.green(`+${result.added} added`) : null,
 		result.updated > 0 ? pc.yellow(`~${result.updated} updated`) : null,
 		result.unchanged > 0 ? `${result.unchanged} unchanged` : null
 	].filter(Boolean).join(pc.dim("  |  "));
 	p.log.info(`Records: ${parts} (${result.total} total)`);
 }
-async function runUpsert(config) {
+async function confirmClean(skipConfirm) {
+	p.log.warn(`${pc.bold(pc.red("WARNING:"))} This will delete ALL existing records before applying seed data.`);
+	if (!skipConfirm) {
+		const shouldContinue = await p.confirm({ message: "Are you sure you want to clean and re-apply seed data?" });
+		if (p.isCancel(shouldContinue) || !shouldContinue) {
+			p.cancel("Clean seed cancelled.");
+			process.exit(0);
+		}
+	}
+}
+async function runUpsert(config, clean, skipConfirm) {
+	if (clean) await confirmClean(skipConfirm);
 	const container = createSeedCliContainer(config);
 	const s = p.spinner();
-	s.start("Applying seed data...");
-	const result = await upsertSeed({ container });
-	s.stop("Seed data applied.");
+	s.start(clean ? "Cleaning and applying seed data..." : "Applying seed data...");
+	const result = await upsertSeed({
+		container,
+		input: { clean }
+	});
+	s.stop(clean ? "Clean seed applied." : "Seed data applied.");
 	printUpsertResult(result);
 }
 async function runSeedCapture(config, keyField) {
@@ -3762,9 +3819,9 @@ async function runSeedCapture(config, keyField) {
 	p.log.success(`Seed saved to: ${pc.cyan(config.seedFilePath)} (${result.recordCount} records)`);
 	if (result.hasExistingSeed) p.log.warn("Existing seed file was overwritten.");
 }
-async function runSeedOperation(config, mode) {
+async function runSeedOperation(config, mode, skipConfirm) {
 	if (mode.type === "capture") await runSeedCapture(config, mode.keyField);
-	else await runUpsert(config);
+	else await runUpsert(config, mode.clean, skipConfirm);
 }
 var seed_default = define({
 	name: "seed",
@@ -3774,18 +3831,20 @@ var seed_default = define({
 		try {
 			const values = ctx.values;
 			const mode = resolveSeedMode(values);
+			const skipConfirm = values.yes === true;
 			await routeMultiApp(values, {
 				singleLegacy: async () => {
-					await runSeedOperation(resolveSeedConfig(values), mode);
+					await runSeedOperation(resolveSeedConfig(values), mode, skipConfirm);
 				},
 				singleApp: async (app, projectConfig) => {
-					await runSeedOperation(resolveSeedAppConfig(app, projectConfig, values), mode);
+					await runSeedOperation(resolveSeedAppConfig(app, projectConfig, values), mode, skipConfirm);
 				},
 				multiApp: async (plan, projectConfig) => {
+					if (mode.type === "upsert" && mode.clean) await confirmClean(skipConfirm);
 					await runMultiAppWithFailCheck(plan, async (app) => {
 						const config = resolveSeedAppConfig(app, projectConfig, values);
 						printAppHeader(app.name, app.appId);
-						await runSeedOperation(config, mode);
+						await runSeedOperation(config, mode, true);
 					}, mode.type === "capture" ? "All captures completed successfully." : "All seed applications completed successfully.");
 				}
 			});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kintone-migrator",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "kintone form schema migration tool",
   "license": "MIT",
   "author": "Hikaru Otabe",