feat: replace name-based model specifiers with IDs

src/commands/slice-add-variation.ts

@@ -16,7 +16,7 @@ const config = {
 		name: { description: "Name of the variation", required: true },
 	},
 	options: {
-		to: { type: "string", required: true, description: "Name of the slice" },
+		to: { type: "string", required: true, description: "ID of the slice" },
 		id: { type: "string", description: "Custom ID for the variation" },
 		repo: { type: "string", short: "r", description: "Repository domain" },
 	},
@@ -30,7 +30,7 @@ export default createCommand(config, async ({ positionals, values }) => {
 	const token = await getToken();
 	const host = await getHost();
 	const slices = await getSlices({ repo, token, host });
-	const slice = slices.find((s) => s.name === to);
+	const slice = slices.find((s) => s.id === to);
 
 	if (!slice) {
 		throw new CommandError(`Slice not found: ${to}`);

src/commands/slice-connect.ts

@@ -11,13 +11,13 @@ const config = {
 	name: "prismic slice connect",
 	description: "Connect a slice to a type's slice zone.",
 	positionals: {
-		name: { description: "Name of the slice", required: true },
+		id: { description: "ID of the slice", required: true },
 	},
 	options: {
 		to: {
 			type: "string",
 			required: true,
-			description: "Name of the content type",
+			description: "ID of the content type",
 		},
 		"slice-zone": {
 			type: "string",
@@ -28,7 +28,7 @@ const config = {
 } satisfies CommandConfig;
 
 export default createCommand(config, async ({ positionals, values }) => {
-	const [name] = positionals;
+	const [id] = positionals;
 	const { to, "slice-zone": sliceZone = "slices", repo = await getRepositoryName() } = values;
 
 	const adapter = await getAdapter();
@@ -37,13 +37,13 @@ export default createCommand(config, async ({ positionals, values }) => {
 	const apiConfig = { repo, token, host };
 
 	const slices = await getSlices(apiConfig);
-	const slice = slices.find((s) => s.name === name);
+	const slice = slices.find((s) => s.id === id);
 	if (!slice) {
-		throw new CommandError(`Slice not found: ${name}`);
+		throw new CommandError(`Slice not found: ${id}`);
 	}
 
 	const customTypes = await getCustomTypes(apiConfig);
-	const customType = customTypes.find((ct) => ct.label === to);
+	const customType = customTypes.find((ct) => ct.id === to);
 	if (!customType) {
 		throw new CommandError(`Type not found: ${to}`);
 	}
@@ -86,5 +86,5 @@ export default createCommand(config, async ({ positionals, values }) => {
 	}
 	await adapter.generateTypes();
 
-	console.info(`Connected slice "${name}" to "${to}"`);
+	console.info(`Connected slice "${id}" to "${to}"`);
 });

src/commands/slice-disconnect.ts

@@ -11,13 +11,13 @@ const config = {
 	name: "prismic slice disconnect",
 	description: "Disconnect a slice from a type's slice zone.",
 	positionals: {
-		name: { description: "Name of the slice", required: true },
+		id: { description: "ID of the slice", required: true },
 	},
 	options: {
 		from: {
 			type: "string",
 			required: true,
-			description: "Name of the content type",
+			description: "ID of the content type",
 		},
 		"slice-zone": {
 			type: "string",
@@ -28,7 +28,7 @@ const config = {
 } satisfies CommandConfig;
 
 export default createCommand(config, async ({ positionals, values }) => {
-	const [name] = positionals;
+	const [id] = positionals;
 	const { from, "slice-zone": sliceZone = "slices", repo = await getRepositoryName() } = values;
 
 	const adapter = await getAdapter();
@@ -37,13 +37,13 @@ export default createCommand(config, async ({ positionals, values }) => {
 	const apiConfig = { repo, token, host };
 
 	const slices = await getSlices(apiConfig);
-	const slice = slices.find((s) => s.name === name);
+	const slice = slices.find((s) => s.id === id);
 	if (!slice) {
-		throw new CommandError(`Slice not found: ${name}`);
+		throw new CommandError(`Slice not found: ${id}`);
 	}
 
 	const customTypes = await getCustomTypes(apiConfig);
-	const customType = customTypes.find((ct) => ct.label === from);
+	const customType = customTypes.find((ct) => ct.id === from);
 	if (!customType) {
 		throw new CommandError(`Type not found: ${from}`);
 	}
@@ -83,5 +83,5 @@ export default createCommand(config, async ({ positionals, values }) => {
 	}
 	await adapter.generateTypes();
 
-	console.info(`Disconnected slice "${name}" from "${from}"`);
+	console.info(`Disconnected slice "${id}" from "${from}"`);
 });

src/commands/slice-edit-variation.ts

@@ -11,33 +11,33 @@ const config = {
 	name: "prismic slice edit-variation",
 	description: "Edit a variation of a slice.",
 	positionals: {
-		name: { description: "Name of the variation", required: true },
+		id: { description: "ID of the variation", required: true },
 	},
 	options: {
-		"from-slice": { type: "string", required: true, description: "Name of the slice" },
+		"from-slice": { type: "string", required: true, description: "ID of the slice" },
 		name: { type: "string", short: "n", description: "New name for the variation" },
 		repo: { type: "string", short: "r", description: "Repository domain" },
 	},
 } satisfies CommandConfig;
 
 export default createCommand(config, async ({ positionals, values }) => {
-	const [currentName] = positionals;
-	const { "from-slice": sliceName, repo = await getRepositoryName() } = values;
+	const [id] = positionals;
+	const { "from-slice": sliceId, repo = await getRepositoryName() } = values;
 
 	const adapter = await getAdapter();
 	const token = await getToken();
 	const host = await getHost();
 	const slices = await getSlices({ repo, token, host });
-	const slice = slices.find((s) => s.name === sliceName);
+	const slice = slices.find((s) => s.id === sliceId);
 
 	if (!slice) {
-		throw new CommandError(`Slice not found: ${sliceName}`);
+		throw new CommandError(`Slice not found: ${sliceId}`);
 	}
 
-	const variation = slice.variations.find((v) => v.name === currentName);
+	const variation = slice.variations.find((v) => v.id === id);
 
 	if (!variation) {
-		throw new CommandError(`Variation "${currentName}" not found in slice "${sliceName}".`);
+		throw new CommandError(`Variation "${id}" not found in slice "${sliceId}".`);
 	}
 
 	if ("name" in values) variation.name = values.name!;
@@ -61,5 +61,5 @@ export default createCommand(config, async ({ positionals, values }) => {
 	}
 	await adapter.generateTypes();
 
-	console.info(`Variation updated: "${variation.name}" in slice "${sliceName}"`);
+	console.info(`Variation updated: "${id}" in slice "${sliceId}"`);
 });

src/commands/slice-edit.ts

@@ -11,7 +11,7 @@ const config = {
 	name: "prismic slice edit",
 	description: "Edit a slice.",
 	positionals: {
-		name: { description: "Name of the slice", required: true },
+		id: { description: "ID of the slice", required: true },
 	},
 	options: {
 		name: { type: "string", short: "n", description: "New name for the slice" },
@@ -20,17 +20,17 @@ const config = {
 } satisfies CommandConfig;
 
 export default createCommand(config, async ({ positionals, values }) => {
-	const [currentName] = positionals;
+	const [id] = positionals;
 	const { repo = await getRepositoryName() } = values;
 
 	const adapter = await getAdapter();
 	const token = await getToken();
 	const host = await getHost();
 	const slices = await getSlices({ repo, token, host });
-	const slice = slices.find((s) => s.name === currentName);
+	const slice = slices.find((s) => s.id === id);
 
 	if (!slice) {
-		throw new CommandError(`Slice not found: ${currentName}`);
+		throw new CommandError(`Slice not found: ${id}`);
 	}
 
 	const updatedSlice: SharedSlice = { ...slice };

src/commands/slice-remove-variation.ts

@@ -11,32 +11,32 @@ const config = {
 	name: "prismic slice remove-variation",
 	description: "Remove a variation from a slice.",
 	positionals: {
-		name: { description: "Name of the variation", required: true },
+		id: { description: "ID of the variation", required: true },
 	},
 	options: {
-		from: { type: "string", required: true, description: "Name of the slice" },
+		from: { type: "string", required: true, description: "ID of the slice" },
 		repo: { type: "string", short: "r", description: "Repository domain" },
 	},
 } satisfies CommandConfig;
 
 export default createCommand(config, async ({ positionals, values }) => {
-	const [name] = positionals;
+	const [id] = positionals;
 	const { from, repo = await getRepositoryName() } = values;
 
 	const adapter = await getAdapter();
 	const token = await getToken();
 	const host = await getHost();
 	const slices = await getSlices({ repo, token, host });
-	const slice = slices.find((s) => s.name === from);
+	const slice = slices.find((s) => s.id === from);
 
 	if (!slice) {
 		throw new CommandError(`Slice not found: ${from}`);
 	}
 
-	const variation = slice.variations.find((v) => v.name === name);
+	const variation = slice.variations.find((v) => v.id === id);
 
 	if (!variation) {
-		throw new CommandError(`Variation "${name}" not found in slice "${from}".`);
+		throw new CommandError(`Variation "${id}" not found in slice "${from}".`);
 	}
 
 	const updatedSlice: SharedSlice = {
@@ -61,5 +61,5 @@ export default createCommand(config, async ({ positionals, values }) => {
 	}
 	await adapter.generateTypes();
 
-	console.info(`Removed variation "${name}" from slice "${from}"`);
+	console.info(`Removed variation "${id}" from slice "${from}"`);
 });

src/commands/slice-remove.ts

@@ -9,25 +9,25 @@ const config = {
 	name: "prismic slice remove",
 	description: "Remove a slice.",
 	positionals: {
-		name: { description: "Name of the slice", required: true },
+		id: { description: "ID of the slice", required: true },
 	},
 	options: {
 		repo: { type: "string", short: "r", description: "Repository domain" },
 	},
 } satisfies CommandConfig;
 
 export default createCommand(config, async ({ positionals, values }) => {
-	const [name] = positionals;
+	const [id] = positionals;
 	const { repo = await getRepositoryName() } = values;
 
 	const adapter = await getAdapter();
 	const token = await getToken();
 	const host = await getHost();
 	const slices = await getSlices({ repo, token, host });
-	const slice = slices.find((s) => s.name === name);
+	const slice = slices.find((s) => s.id === id);
 
 	if (!slice) {
-		throw new CommandError(`Slice not found: ${name}`);
+		throw new CommandError(`Slice not found: ${id}`);
 	}
 
 	try {
@@ -45,5 +45,5 @@ export default createCommand(config, async ({ positionals, values }) => {
 	} catch {}
 	await adapter.generateTypes();
 
-	console.info(`Slice removed: "${name}" (id: ${slice.id})`);
+	console.info(`Slice removed: ${id}`);
 });

src/commands/slice-view.ts

@@ -8,7 +8,7 @@ const config = {
 	name: "prismic slice view",
 	description: "View details of a slice.",
 	positionals: {
-		name: { description: "Name of the slice", required: true },
+		id: { description: "ID of the slice", required: true },
 	},
 	options: {
 		json: { type: "boolean", description: "Output as JSON" },
@@ -17,16 +17,16 @@ const config = {
 } satisfies CommandConfig;
 
 export default createCommand(config, async ({ positionals, values }) => {
-	const [name] = positionals;
+	const [id] = positionals;
 	const { json, repo = await getRepositoryName() } = values;
 
 	const token = await getToken();
 	const host = await getHost();
 	const slices = await getSlices({ repo, token, host });
-	const slice = slices.find((slice) => slice.name === name);
+	const slice = slices.find((slice) => slice.id === id);
 
 	if (!slice) {
-		throw new CommandError(`Slice not found: ${name}`);
+		throw new CommandError(`Slice not found: ${id}`);
 	}
 
 	if (json) {

src/commands/type-add-tab.ts

@@ -12,7 +12,7 @@ const config = {
 		name: { description: "Name of the tab", required: true },
 	},
 	options: {
-		to: { type: "string", required: true, description: "Name of the content type" },
+		to: { type: "string", required: true, description: "ID of the content type" },
 		"with-slice-zone": { type: "boolean", description: "Add a slice zone to the tab" },
 		repo: { type: "string", short: "r", description: "Repository domain" },
 	},
@@ -26,7 +26,7 @@ export default createCommand(config, async ({ positionals, values }) => {
 	const token = await getToken();
 	const host = await getHost();
 	const customTypes = await getCustomTypes({ repo, token, host });
-	const type = customTypes.find((ct) => ct.label === to);
+	const type = customTypes.find((ct) => ct.id === to);
 
 	if (!type) {
 		throw new CommandError(`Type not found: ${to}`);

src/commands/type-edit-tab.ts

@@ -14,7 +14,7 @@ const config = {
 		name: { description: "Current name of the tab", required: true },
 	},
 	options: {
-		"from-type": { type: "string", required: true, description: "Name of the content type" },
+		"from-type": { type: "string", required: true, description: "ID of the content type" },
 		name: { type: "string", short: "n", description: "New name for the tab" },
 		"with-slice-zone": { type: "boolean", description: "Add a slice zone to the tab" },
 		"without-slice-zone": { type: "boolean", description: "Remove the slice zone from the tab" },
@@ -24,20 +24,20 @@ const config = {
 
 export default createCommand(config, async ({ positionals, values }) => {
 	const [currentName] = positionals;
-	const { "from-type": typeName, repo = await getRepositoryName() } = values;
+	const { "from-type": typeId, repo = await getRepositoryName() } = values;
 
 	const adapter = await getAdapter();
 	const token = await getToken();
 	const host = await getHost();
 	const customTypes = await getCustomTypes({ repo, token, host });
-	const type = customTypes.find((ct) => ct.label === typeName);
+	const type = customTypes.find((ct) => ct.id === typeId);
 
 	if (!type) {
-		throw new CommandError(`Type not found: ${typeName}`);
+		throw new CommandError(`Type not found: ${typeId}`);
 	}
 
 	if (!(currentName in type.json)) {
-		throw new CommandError(`Tab "${currentName}" not found in "${typeName}".`);
+		throw new CommandError(`Tab "${currentName}" not found in "${typeId}".`);
 	}
 
 	if ("with-slice-zone" in values && "without-slice-zone" in values) {
@@ -82,7 +82,7 @@ export default createCommand(config, async ({ positionals, values }) => {
 
 	if ("name" in values) {
 		if (values.name! in type.json) {
-			throw new CommandError(`Tab "${values.name}" already exists in "${typeName}".`);
+			throw new CommandError(`Tab "${values.name}" already exists in "${typeId}".`);
 		}
 
 		const newJson: CustomType["json"] = {};
@@ -109,5 +109,5 @@ export default createCommand(config, async ({ positionals, values }) => {
 	}
 	await adapter.generateTypes();
 
-	console.info(`Tab updated: "${currentName}" in "${typeName}"`);
+	console.info(`Tab updated: "${currentName}" in "${typeId}"`);
 });