@labelgrid/core 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -8,6 +8,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 `@labelgrid/core` is primarily an internal shared client for the LabelGrid MCP
 server and CLI — there are no API-stability promises before 1.0.
 
+## [0.2.2] - 2026-08-20
+
+### Added
+
+- Catalog entities now declare whether their delete endpoint accepts a
+  replacement, allowing clients to expose reassignment only for writers and
+  publishers.
+- `LabelGridClient.delete()` accepts optional query parameters while preserving
+  the existing request URL byte-for-byte when none are supplied.
+
+### Changed
+
+- Writer and publisher delete guidance now names every reference that can block
+  deletion.
+
 ## [0.2.1] - 2026-08-05
 
 ### Changed

package/dist/api/http.d.ts

@@ -72,7 +72,12 @@ export declare class LabelGridClient {
         idempotency?: boolean;
         idempotencyKey?: string;
     }): Promise<ApiResult<T>>;
-    delete<T>(path: string): Promise<ApiResult<T>>;
+    /**
+     * A delete carries its parameters in the query string, never in a body: RFC
+     * 9110 gives a DELETE body no defined semantics and intermediaries drop it.
+     * Omitting `query` sends exactly the URL it always did.
+     */
+    delete<T>(path: string, query?: Record<string, unknown>): Promise<ApiResult<T>>;
     /**
      * Sends a multipart/form-data POST with a single file field plus optional
      * extra string fields. A missing/unreadable file yields a FILE_NOT_FOUND

package/dist/api/http.js

@@ -357,8 +357,13 @@ export class LabelGridClient {
             idempotencyKey: opts?.idempotencyKey,
         });
     }
-    delete(path) {
-        return this.send('DELETE', path);
+    /**
+     * A delete carries its parameters in the query string, never in a body: RFC
+     * 9110 gives a DELETE body no defined semantics and intermediaries drop it.
+     * Omitting `query` sends exactly the URL it always did.
+     */
+    delete(path, query) {
+        return this.send('DELETE', path, { query });
     }
     /**
      * Sends a multipart/form-data POST with a single file field plus optional

package/dist/entities.d.ts

@@ -23,5 +23,19 @@ export type EntitySpec = {
     fieldsDoc: string;
     /** One-line doc of the server-side delete refusals. */
     deleteNote: string;
+    /**
+     * Whether this entity's DELETE endpoint accepts `replace_with` — the id of the
+     * entity that takes over every credit held by the one being deleted, rewritten
+     * before the delete. Only the writer and publisher endpoints have it. Stated
+     * for every entity rather than defaulted, so a new entity cannot inherit an
+     * answer nobody gave.
+     */
+    acceptsDeleteReplacement: boolean;
 };
 export declare const ENTITIES: Record<EntityName, EntitySpec>;
+/**
+ * The entities whose DELETE accepts `replace_with`, derived from the registry so
+ * the tool schema, its description and its refusal message cannot disagree with
+ * the table or with each other.
+ */
+export declare const REPLACEMENT_ENTITIES: readonly EntityName[];

package/dist/entities.js

@@ -19,35 +19,47 @@ export const ENTITIES = {
         filtersDoc: 'label: no documented filters.',
         fieldsDoc: 'label — required: name, default_email; optional: support email, website/platform URLs, default copyright lines, isrc_base.',
         deleteNote: 'label: refused while the label still has releases — remove or reassign its releases first.',
+        acceptsDeleteReplacement: false,
     },
     artist: {
         path: '/artists',
         filtersDoc: 'artist: artist_name.',
         fieldsDoc: 'artist — required: artist_name; optional: full_name, email, location, bios, isni, default_language, platform profile URLs.',
         deleteNote: 'artist: refused while still referenced by releases or tracks.',
+        acceptsDeleteReplacement: false,
     },
     writer: {
         path: '/writers',
         filtersDoc: 'writer: name, ipi.',
         fieldsDoc: 'writer — required: first_name, last_name; optional: middle_name, display_credits, email, country, pro, ipi, isni, publisher_id (or publisher_name/publisher_pro/publisher_ipi).',
-        deleteNote: 'writer: refused while still referenced by tracks.',
+        deleteNote: 'writer: refused while still referenced by tracks or artists, unless replace_with reassigns those credits.',
+        acceptsDeleteReplacement: true,
     },
     publisher: {
         path: '/publishers',
         filtersDoc: 'publisher: name, ipi.',
         fieldsDoc: 'publisher — required: name; optional: ipi, pro, isni, controlled_publisher.',
-        deleteNote: 'publisher: refused while still referenced by writers.',
+        deleteNote: 'publisher: refused while still referenced by tracks or label default publishers, unless replace_with reassigns those credits.',
+        acceptsDeleteReplacement: true,
     },
     release: {
         path: '/releases',
         filtersDoc: 'release: label_id, is_live (1 = live only), barcode_number (UPC/EAN), cat.',
         fieldsDoc: 'release — required on create: content_type, label_id, artists, titles, cat (catalog number), artwork_ai_usage, primary_genre_id; many optional fields (dates, copyright lines, genres, per-outlet URLs).',
         deleteNote: 'release: only a never-submitted draft can be deleted.',
+        acceptsDeleteReplacement: false,
     },
     track: {
         path: '/tracks',
         filtersDoc: 'track: release_id, isrc.',
         fieldsDoc: 'track — required on create: release_id, disc, track_num, composition_type, artists, audio_ai_usage, composition_ai_usage, commercial_samples, audio_language, contributors, and recording_country (ISO 3166-1 alpha-2, e.g. "US"); optional: titles, isrc, iswc, writers, publishers, splits, and more.',
         deleteNote: 'track: refused once the release is no longer an editable draft.',
+        acceptsDeleteReplacement: false,
     },
 };
+/**
+ * The entities whose DELETE accepts `replace_with`, derived from the registry so
+ * the tool schema, its description and its refusal message cannot disagree with
+ * the table or with each other.
+ */
+export const REPLACEMENT_ENTITIES = ENTITY_NAMES.filter((name) => ENTITIES[name].acceptsDeleteReplacement);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@labelgrid/core",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Shared LabelGrid public-API client: HTTP transport, uploads, content types, the catalog-entity registry, and redacting logging",
   "type": "module",
   "keywords": ["labelgrid", "music-distribution", "api-client"],