kintone-migrator 0.20.0 → 0.20.2

package/README.md

@@ -217,22 +217,29 @@ All commands support `--app <name>` and `--all` for [multi-app mode](#multi-app-
 Initializes a project from a kintone space. Fetches all apps in the specified space, generates a `kintone-migrator.yaml` config file with `files` object format, and captures all domain configurations for each app.
 
 ```bash
-kintone-migrator init <spaceId>
-kintone-migrator init <spaceId> --yes    # Skip confirmation prompts
+kintone-migrator init --space-id 1
+kintone-migrator init -s 1 --yes          # Skip confirmation prompts
+kintone-migrator init -s 1 --dry-run      # Preview without writing files
+kintone-migrator init -s 1 -o ./myproject  # Output to a specific directory
 ```
 
 | Option | Description |
 |---|---|
-| `<spaceId>` | kintone space ID (required argument) |
+| `--space-id`, `-s` | kintone space ID (required, must be numeric) |
 | `--domain`, `-d` | kintone domain |
 | `--api-token`, `-t` | API token |
 | `--username`, `-u` | Username |
 | `--password`, `-p` | Password |
 | `--guest-space-id`, `-g` | Guest space ID |
-| `--output`, `-o` | Output config file path (default: `kintone-migrator.yaml`) |
+| `--output`, `-o` | Output directory |
 | `--yes`, `-y` | Skip confirmation prompts |
+| `--dry-run`, `-n` | Preview what would be created without writing any files |
 
-The generated config uses the `files` object format with all domain file paths pre-configured. For each app, schema, view, settings, notification, report, action, process, field-acl, app-acl, record-acl, admin-notes, and plugin configurations are captured.
+The generated config uses the `files` object format with all domain file paths pre-configured. For each app, schema, seed, customize, view, settings, notification, report, action, process, field-acl, app-acl, record-acl, admin-notes, and plugin configurations are captured.
+
+App names in the generated config are resolved with the following priority: app code > app name > `app-{appId}`. Duplicate names are automatically suffixed (e.g., `-2`, `-3`). File paths follow the `<appName>/<domain>.yaml` convention (e.g., `customer/schema.yaml`).
+
+Authentication settings are intentionally omitted from the generated config to avoid committing credentials to version control. Set `KINTONE_API_TOKEN` or `KINTONE_USERNAME` + `KINTONE_PASSWORD` environment variables, or add `auth` to the config file manually.
 
 ### `schema` -- Form Schema Management
 

package/dist/index.mjs

@@ -1202,15 +1202,103 @@ var KintoneFormConfigurator = class {
 	}
 };
 
+//#endregion
+//#region src/core/adapters/kintone/recordConverter.ts
+const SYSTEM_FIELDS = new Set([
+	"$id",
+	"$revision",
+	"RECORD_NUMBER",
+	"CREATOR",
+	"CREATED_TIME",
+	"MODIFIER",
+	"UPDATED_TIME",
+	"STATUS",
+	"STATUS_ASSIGNEE",
+	"CATEGORY"
+]);
+const SYSTEM_FIELD_TYPES$1 = new Set([
+	"RECORD_NUMBER",
+	"__ID__",
+	"__REVISION__",
+	"CREATOR",
+	"CREATED_TIME",
+	"MODIFIER",
+	"UPDATED_TIME",
+	"STATUS",
+	"STATUS_ASSIGNEE",
+	"CATEGORY"
+]);
+function isSubtableRowArray(value) {
+	if (!Array.isArray(value)) return false;
+	if (value.length === 0) return false;
+	const first = value[0];
+	return typeof first === "object" && first !== null && !("code" in first && Object.keys(first).length === 1);
+}
+function toKintoneFieldValue(value) {
+	if (typeof value === "string") return { value };
+	if (Array.isArray(value)) {
+		if (value.length === 0) return { value: [] };
+		const first = value[0];
+		if (typeof first === "string") return { value };
+		if (typeof first === "object" && first !== null && "code" in first && !isSubtableRowArray(value)) return { value };
+		return { value: value.map((row) => {
+			const kintoneRow = {};
+			for (const [k, cellValue] of Object.entries(row)) kintoneRow[k] = { value: cellValue };
+			return { value: kintoneRow };
+		}) };
+	}
+	return { value };
+}
+function fromKintoneFieldValue(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return String(value);
+	if (Array.isArray(value)) {
+		if (value.length === 0) return [];
+		const first = value[0];
+		if (typeof first === "string") return value;
+		if (typeof first === "object" && first !== null) {
+			if ("code" in first && !("value" in first)) return value.filter(hasCode).map((u) => ({ code: u.code }));
+			if ("value" in first) return value.filter(isKintoneSubtableRow).map((row) => {
+				const cells = row.value;
+				const flat = {};
+				for (const [k, cell] of Object.entries(cells)) {
+					if (SYSTEM_FIELDS.has(k)) continue;
+					if (Array.isArray(cell.value)) flat[k] = cell.value.map(String);
+					else flat[k] = cell.value === null || cell.value === void 0 ? "" : String(cell.value);
+				}
+				return flat;
+			});
+		}
+		return value.map(String);
+	}
+	return String(value);
+}
+function toKintoneRecord(record) {
+	const kintoneRecord = {};
+	for (const [fieldCode, fieldValue] of Object.entries(record)) {
+		if (SYSTEM_FIELDS.has(fieldCode)) continue;
+		kintoneRecord[fieldCode] = toKintoneFieldValue(fieldValue);
+	}
+	return kintoneRecord;
+}
+function fromKintoneRecord(record) {
+	const seedRecord = {};
+	for (const [fieldCode, cell] of Object.entries(record)) {
+		if (SYSTEM_FIELDS.has(fieldCode)) continue;
+		const fieldType = hasOptionalType(cell) ? cell.type : void 0;
+		if (fieldType !== void 0 && SYSTEM_FIELD_TYPES$1.has(fieldType)) continue;
+		seedRecord[fieldCode] = fromKintoneFieldValue(cell.value);
+	}
+	return seedRecord;
+}
+
 //#endregion
 //#region src/core/adapters/kintone/recordManager.ts
-function toKintoneRecordForResponse(record) {
+function extractId(record) {
 	const $id = record.$id;
 	if (!$id || typeof $id.value !== "string") throw new SystemError(SystemErrorCode.ExternalApiError, "Record missing $id field from kintone API response");
-	return record;
-}
-function toSdkRecord(record) {
-	return record;
+	return $id.value;
 }
 var KintoneRecordManager = class {
 	constructor(client, appId) {
@@ -1222,7 +1310,13 @@ var KintoneRecordManager = class {
 			return (await this.client.record.getAllRecords({
 				app: this.appId,
 				...condition !== void 0 ? { condition } : {}
-			})).map((r) => toKintoneRecordForResponse(r));
+			})).map((r) => {
+				const raw = r;
+				return {
+					id: extractId(r),
+					record: fromKintoneRecord(raw)
+				};
+			});
 		} catch (error) {
 			if (isBusinessRuleError(error)) throw error;
 			if (error instanceof SystemError) throw error;
@@ -1234,7 +1328,7 @@ var KintoneRecordManager = class {
 		try {
 			await this.client.record.addAllRecords({
 				app: this.appId,
-				records: records.map(toSdkRecord)
+				records: records.map(toKintoneRecord)
 			});
 		} catch (error) {
 			if (isBusinessRuleError(error)) throw error;
@@ -1249,7 +1343,7 @@ var KintoneRecordManager = class {
 				app: this.appId,
 				records: records.map((r) => ({
 					id: Number(r.id),
-					record: toSdkRecord(r.record)
+					record: toKintoneRecord(r.record)
 				}))
 			});
 		} catch (error) {
@@ -1265,10 +1359,10 @@ var KintoneRecordManager = class {
 				fields: ["$id"]
 			});
 			if (records.length === 0) return { deletedCount: 0 };
-			const validated = records.map((r) => toKintoneRecordForResponse(r));
+			const ids = records.map((r) => ({ id: Number(extractId(r)) }));
 			await this.client.record.deleteAllRecords({
 				app: this.appId,
-				records: validated.map((r) => ({ id: Number(r.$id.value) }))
+				records: ids
 			});
 			return { deletedCount: records.length };
 		} catch (error) {
@@ -5852,99 +5946,6 @@ async function saveReport({ container, input }) {
 	await container.reportStorage.update(input.configText);
 }
 
-//#endregion
-//#region src/core/domain/seedData/services/recordConverter.ts
-const SYSTEM_FIELDS = new Set([
-	"$id",
-	"$revision",
-	"RECORD_NUMBER",
-	"CREATOR",
-	"CREATED_TIME",
-	"MODIFIER",
-	"UPDATED_TIME",
-	"STATUS",
-	"STATUS_ASSIGNEE",
-	"CATEGORY"
-]);
-const SYSTEM_FIELD_TYPES$1 = new Set([
-	"RECORD_NUMBER",
-	"__ID__",
-	"__REVISION__",
-	"CREATOR",
-	"CREATED_TIME",
-	"MODIFIER",
-	"UPDATED_TIME",
-	"STATUS",
-	"STATUS_ASSIGNEE",
-	"CATEGORY"
-]);
-function isSubtableRowArray(value) {
-	if (!Array.isArray(value)) return false;
-	if (value.length === 0) return false;
-	const first = value[0];
-	return typeof first === "object" && first !== null && !("code" in first && Object.keys(first).length === 1);
-}
-function toKintoneFieldValue(value) {
-	if (typeof value === "string") return { value };
-	if (Array.isArray(value)) {
-		if (value.length === 0) return { value: [] };
-		const first = value[0];
-		if (typeof first === "string") return { value };
-		if (typeof first === "object" && first !== null && "code" in first && !isSubtableRowArray(value)) return { value };
-		return { value: value.map((row) => {
-			const kintoneRow = {};
-			for (const [k, cellValue] of Object.entries(row)) kintoneRow[k] = { value: cellValue };
-			return { value: kintoneRow };
-		}) };
-	}
-	return { value };
-}
-function fromKintoneFieldValue(value) {
-	if (value === null || value === void 0) return "";
-	if (typeof value === "string") return value;
-	if (typeof value === "number") return String(value);
-	if (Array.isArray(value)) {
-		if (value.length === 0) return [];
-		const first = value[0];
-		if (typeof first === "string") return value;
-		if (typeof first === "object" && first !== null) {
-			if ("code" in first && !("value" in first)) return value.filter(hasCode).map((u) => ({ code: u.code }));
-			if ("value" in first) return value.filter(isKintoneSubtableRow).map((row) => {
-				const cells = row.value;
-				const flat = {};
-				for (const [k, cell] of Object.entries(cells)) {
-					if (SYSTEM_FIELDS.has(k)) continue;
-					if (Array.isArray(cell.value)) flat[k] = cell.value.map(String);
-					else flat[k] = cell.value === null || cell.value === void 0 ? "" : String(cell.value);
-				}
-				return flat;
-			});
-		}
-		return value.map(String);
-	}
-	return String(value);
-}
-const RecordConverter = {
-	toKintoneRecord: (record) => {
-		const kintoneRecord = {};
-		for (const [fieldCode, fieldValue] of Object.entries(record)) {
-			if (SYSTEM_FIELDS.has(fieldCode)) continue;
-			kintoneRecord[fieldCode] = toKintoneFieldValue(fieldValue);
-		}
-		return kintoneRecord;
-	},
-	fromKintoneRecord: (record) => {
-		const seedRecord = {};
-		for (const [fieldCode, cell] of Object.entries(record)) {
-			if (SYSTEM_FIELDS.has(fieldCode)) continue;
-			const fieldType = hasOptionalType(cell) ? cell.type : void 0;
-			if (fieldType !== void 0 && SYSTEM_FIELD_TYPES$1.has(fieldType)) continue;
-			seedRecord[fieldCode] = fromKintoneFieldValue(cell.value);
-		}
-		return seedRecord;
-	}
-};
-
 //#endregion
 //#region src/core/domain/seedData/services/seedSerializer.ts
 const SeedSerializer = { serialize: (seedData) => {
@@ -5974,7 +5975,7 @@ const UpsertKey = { create: (key) => {
 //#region src/core/application/seedData/captureSeed.ts
 async function captureSeed({ container, input }) {
 	const key = input.keyField ? UpsertKey.create(input.keyField) : null;
-	const records = (await container.recordManager.getAllRecords()).map(RecordConverter.fromKintoneRecord);
+	const records = (await container.recordManager.getAllRecords()).map(({ record }) => record);
 	const seedText = SeedSerializer.serialize({
 		key,
 		records
@@ -6290,7 +6291,7 @@ var init_default = define({
 			const auth = resolveAuth(apiToken, username, password);
 			const guestSpaceId = values["guest-space-id"] ?? process.env.KINTONE_GUEST_SPACE_ID;
 			const output = values.output;
-			const configPath = output ? join(output, DEFAULT_CONFIG_PATH) : DEFAULT_CONFIG_PATH;
+			const configPath = DEFAULT_CONFIG_PATH;
 			const skipConfirm = values.yes ?? false;
 			const dryRun = values["dry-run"] ?? false;
 			const { spaceReader, projectConfigStorage } = createInitCliContainer({
@@ -9392,13 +9393,11 @@ function recordsEqual(seed, existing, keyField) {
 const UpsertPlanner = { plan: (key, seedRecords, existingRecords) => {
 	const keyField = key;
 	const existingMap = /* @__PURE__ */ new Map();
-	for (const kintoneRecord of existingRecords) {
-		const id = kintoneRecord.$id.value;
-		const converted = RecordConverter.fromKintoneRecord(kintoneRecord);
-		const keyValue = converted[keyField];
+	for (const { id, record } of existingRecords) {
+		const keyValue = record[keyField];
 		if (typeof keyValue === "string") existingMap.set(keyValue, {
 			id,
-			record: converted
+			record
 		});
 	}
 	const toAdd = [];
@@ -9430,8 +9429,7 @@ async function upsertSeed({ container, input }) {
 	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);
+		if (seedData.records.length > 0) await container.recordManager.addRecords(seedData.records);
 		return {
 			added: seedData.records.length,
 			updated: 0,
@@ -9441,8 +9439,7 @@ async function upsertSeed({ container, input }) {
 		};
 	}
 	if (seedData.key === null) {
-		const kintoneRecords = seedData.records.map(RecordConverter.toKintoneRecord);
-		if (kintoneRecords.length > 0) await container.recordManager.addRecords(kintoneRecords);
+		if (seedData.records.length > 0) await container.recordManager.addRecords(seedData.records);
 		return {
 			added: seedData.records.length,
 			updated: 0,
@@ -9453,17 +9450,8 @@ async function upsertSeed({ container, input }) {
 	}
 	const existingRecords = await container.recordManager.getAllRecords();
 	const plan = UpsertPlanner.plan(seedData.key, seedData.records, existingRecords);
-	if (plan.toAdd.length > 0) {
-		const kintoneRecords = plan.toAdd.map(RecordConverter.toKintoneRecord);
-		await container.recordManager.addRecords(kintoneRecords);
-	}
-	if (plan.toUpdate.length > 0) {
-		const kintoneUpdates = plan.toUpdate.map((item) => ({
-			id: item.id,
-			record: RecordConverter.toKintoneRecord(item.record)
-		}));
-		await container.recordManager.updateRecords(kintoneUpdates);
-	}
+	if (plan.toAdd.length > 0) await container.recordManager.addRecords(plan.toAdd);
+	if (plan.toUpdate.length > 0) await container.recordManager.updateRecords(plan.toUpdate);
 	return {
 		added: plan.toAdd.length,
 		updated: plan.toUpdate.length,