@withpica/mcp-server 2.1.0

package/dist/tools/projects.js

@@ -0,0 +1,142 @@
+/**
+ * Projects Tools — group works into projects (albums, EPs, compilations, or any collection)
+ */
+import { formatSuccess, formatStructuredList } from "../utils/formatting.js";
+export class ProjectsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_projects_list",
+                    description: "List projects — albums, EPs, compilations, or any collection of works.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            limit: {
+                                type: "number",
+                                description: "Max results to return (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listProjects.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_get",
+                    description: "Get project details including linked works.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Project ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getProject.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_create",
+                    description: "Create a new project to organise your works — albums, EPs, compilations, or any collection.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            name: {
+                                type: "string",
+                                description: "Project name",
+                            },
+                            project_type: {
+                                type: "string",
+                                description: "Type of project (e.g. album, ep, compilation, single, mixtape)",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Optional project description",
+                            },
+                            work_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Optional: work IDs to add to the project",
+                            },
+                        },
+                        required: ["name"],
+                    },
+                },
+                executor: this.createProject.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_update",
+                    description: "Update project details — name, type, description, or linked works.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Project ID" },
+                            name: { type: "string", description: "Updated project name" },
+                            project_type: {
+                                type: "string",
+                                description: "Updated project type",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Updated description",
+                            },
+                            work_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Updated list of work IDs",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.updateProject.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_projects_delete",
+                    description: "Delete a project. Works linked to it are not deleted.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Project ID to delete" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.deleteProject.bind(this),
+            },
+        ];
+    }
+    async listProjects(args) {
+        const result = await this.pica.projects.list({
+            limit: args.limit,
+        });
+        const projects = Array.isArray(result) ? result : [];
+        return formatStructuredList(projects, "project");
+    }
+    async getProject(args) {
+        const project = await this.pica.projects.get(args.id);
+        return formatSuccess("Project retrieved", project);
+    }
+    async createProject(args) {
+        const { id, ...data } = args;
+        const project = await this.pica.projects.create(data);
+        return formatSuccess("Project created", project);
+    }
+    async updateProject(args) {
+        const { id, ...updates } = args;
+        const project = await this.pica.projects.update(id, updates);
+        return formatSuccess("Project updated", project);
+    }
+    async deleteProject(args) {
+        await this.pica.projects.delete(args.id);
+        return formatSuccess(`Project ${args.id} deleted`);
+    }
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

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

package/dist/tools/purchases.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Purchase Tools - MCP tools for buying Pica credits
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class PurchasesTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private purchaseCredits;
+}
+//# sourceMappingURL=purchases.d.ts.map

package/dist/tools/purchases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchases.d.ts","sourceRoot":"","sources":["../../src/tools/purchases.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YA4C3D,eAAe;CAkB9B"}

package/dist/tools/purchases.js

@@ -0,0 +1,65 @@
+/**
+ * Purchase Tools - MCP tools for buying Pica credits
+ */
+import { formatSuccess } from "../utils/formatting.js";
+export class PurchasesTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_credits_purchase",
+                    description: "Get a checkout link to purchase Pica credits. Returns a Stripe checkout URL the user can open to buy credits. " +
+                        "Packages: pica_10 (10 credits), pica_25 (25 credits, best value), pica_50 (50 credits), pica_100 (100 credits). " +
+                        "Currencies: GBP, USD, EUR, CAD, AUD, ZAR, NGN, KES, BRL, MXN. " +
+                        "→ then: pica_credits_balance (verify purchase landed)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            package_id: {
+                                type: "string",
+                                enum: ["pica_10", "pica_25", "pica_50", "pica_100"],
+                                description: "Credit package. pica_25 is most popular.",
+                            },
+                            currency: {
+                                type: "string",
+                                enum: [
+                                    "GBP",
+                                    "USD",
+                                    "EUR",
+                                    "CAD",
+                                    "AUD",
+                                    "ZAR",
+                                    "NGN",
+                                    "KES",
+                                    "BRL",
+                                    "MXN",
+                                ],
+                                description: "Payment currency (default: GBP). Emerging markets use PPP pricing.",
+                            },
+                        },
+                        required: ["package_id"],
+                    },
+                },
+                executor: this.purchaseCredits.bind(this),
+            },
+        ];
+    }
+    async purchaseCredits(args) {
+        const result = await this.pica.creditsBalance.purchase({
+            package_id: args.package_id,
+            currency: args.currency || "GBP",
+        });
+        const data = result.data || result;
+        const safeData = {
+            checkout_url: data.checkout_url,
+            package_id: args.package_id,
+            currency: args.currency || "GBP",
+        };
+        return formatSuccess(`Checkout link ready. Share this URL with the user to complete the purchase:\n${safeData.checkout_url}`, safeData);
+    }
+}
+//# sourceMappingURL=purchases.js.map

package/dist/tools/purchases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchases.js","sourceRoot":"","sources":["../../src/tools/purchases.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,uBAAuB;oBAC7B,WAAW,EACT,gHAAgH;wBAChH,kHAAkH;wBAClH,gEAAgE;wBAChE,uDAAuD;oBACzD,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,UAAU,EAAE;gCACV,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC;gCACnD,WAAW,EAAE,0CAA0C;6BACxD;4BACD,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE;oCACJ,KAAK;oCACL,KAAK;oCACL,KAAK;oCACL,KAAK;oCACL,KAAK;oCACL,KAAK;oCACL,KAAK;oCACL,KAAK;oCACL,KAAK;oCACL,KAAK;iCACN;gCACD,WAAW,EACT,oEAAoE;6BACvE;yBACF;wBACD,QAAQ,EAAE,CAAC,YAAY,CAAC;qBACzB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;aAC1C;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,IAAyB;QACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;YACrD,UAAU,EAAE,IAAI,CAAC,UAAoB;YACrC,QAAQ,EAAG,IAAI,CAAC,QAAmB,IAAI,KAAK;SAC7C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC;QACnC,MAAM,QAAQ,GAAG;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;SACjC,CAAC;QAEF,OAAO,aAAa,CAClB,gFAAgF,QAAQ,CAAC,YAAY,EAAE,EACvG,QAAQ,CACT,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/recordings.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Recordings Tools - MCP tools for managing recordings
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class RecordingsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * Get all recordings tools
+     */
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    /**
+     * List recordings
+     */
+    private listRecordings;
+    /**
+     * Get recording by ID
+     */
+    private getRecording;
+    /**
+     * Create recording
+     */
+    private createRecording;
+    /**
+     * Update recording
+     */
+    private updateRecording;
+    /**
+     * Delete recording
+     */
+    private deleteRecording;
+    /**
+     * Get recordings by work
+     */
+    private getRecordingsByWork;
+}
+//# sourceMappingURL=recordings.d.ts.map

package/dist/tools/recordings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordings.d.ts","sourceRoot":"","sources":["../../src/tools/recordings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA2OzE;;OAEG;YACW,cAAc;IAU5B;;OAEG;YACW,YAAY;IAY1B;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,eAAe;IAQ7B;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,mBAAmB;CASlC"}

package/dist/tools/recordings.js

@@ -0,0 +1,293 @@
+/**
+ * Recordings Tools - MCP tools for managing recordings
+ */
+import { formatAsText, formatSuccess, formatStructuredList, } from "../utils/formatting.js";
+export class RecordingsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    /**
+     * Get all recordings tools
+     */
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_recordings_list",
+                    description: "List recordings from PICA catalog",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            limit: {
+                                type: "number",
+                                description: "Maximum number of results to return (default: 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listRecordings.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_recordings_get",
+                    description: "Get details of a specific recording by ID",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Recording ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getRecording.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_recordings_create",
+                    description: "Create a new recording. Any field from the Recording schema can be passed — " +
+                        "the most commonly used fields are listed below. Additional fields " +
+                        "(e.g. mlc_recording_id, mlc_song_code, global_recording_id, global_release_id) " +
+                        "are also accepted. " +
+                        "→ then: pica_audio_presigned_upload (upload audio), pica_audio_analyze (extract features)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            title: {
+                                type: "string",
+                                description: "Recording title (required). Maps to recording_title in DB.",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "ID of the work this recording is of",
+                            },
+                            isrc: {
+                                type: "string",
+                                description: "International Standard Recording Code",
+                            },
+                            isrc_source: {
+                                type: "string",
+                                description: "Where the ISRC came from (e.g. 'spotify', 'mlc', 'manual', 'ppl')",
+                            },
+                            duration_seconds: {
+                                type: "number",
+                                description: "Duration in seconds",
+                            },
+                            artist_name: {
+                                type: "string",
+                                description: "Artist name for this recording",
+                            },
+                            version_type: {
+                                type: "string",
+                                description: "Recording version type (e.g. 'original', 'remix', 'live', 'acoustic', 'demo', 'instrumental')",
+                            },
+                            labels: {
+                                type: "string",
+                                description: "Record label(s), comma-separated if multiple",
+                            },
+                            ownership_percentage: {
+                                type: "number",
+                                description: "Ownership percentage (0-100)",
+                            },
+                            ppl_registered: {
+                                type: "boolean",
+                                description: "Whether registered with PPL",
+                            },
+                            ppl_recording_id: {
+                                type: "string",
+                                description: "PPL recording ID",
+                            },
+                            ai_disclosure: {
+                                type: "object",
+                                description: "AI disclosure object with composition, performance, production, mastering fields",
+                            },
+                            provenance_attestation: {
+                                type: "object",
+                                description: "Human creation proof with witness details",
+                            },
+                            training_rights: {
+                                type: "object",
+                                description: "B2B ML licensing compliance object",
+                            },
+                            musicbrainz_recording_id: {
+                                type: "string",
+                                description: "MusicBrainz recording ID",
+                            },
+                        },
+                        required: ["title"],
+                        additionalProperties: true,
+                    },
+                },
+                executor: this.createRecording.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_recordings_update",
+                    description: "Update an existing recording. Any field from the Recording schema can be passed — " +
+                        "the most commonly used fields are listed below. Additional fields are also accepted.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Recording ID (required)",
+                            },
+                            title: {
+                                type: "string",
+                                description: "Recording title. Maps to recording_title in DB.",
+                            },
+                            isrc: {
+                                type: "string",
+                                description: "International Standard Recording Code",
+                            },
+                            isrc_source: {
+                                type: "string",
+                                description: "Where the ISRC came from (e.g. 'spotify', 'mlc', 'manual', 'ppl')",
+                            },
+                            duration_seconds: {
+                                type: "number",
+                                description: "Duration in seconds",
+                            },
+                            artist_name: {
+                                type: "string",
+                                description: "Artist name for this recording",
+                            },
+                            version_type: {
+                                type: "string",
+                                description: "Recording version type (e.g. 'original', 'remix', 'live', 'acoustic', 'demo', 'instrumental')",
+                            },
+                            labels: {
+                                type: "string",
+                                description: "Record label(s), comma-separated if multiple",
+                            },
+                            ownership_percentage: {
+                                type: "number",
+                                description: "Ownership percentage (0-100)",
+                            },
+                            ppl_registered: {
+                                type: "boolean",
+                                description: "Whether registered with PPL",
+                            },
+                            ppl_recording_id: {
+                                type: "string",
+                                description: "PPL recording ID",
+                            },
+                            ai_disclosure: {
+                                type: "object",
+                                description: "AI disclosure object with composition, performance, production, mastering fields",
+                            },
+                            provenance_attestation: {
+                                type: "object",
+                                description: "Human creation proof with witness details",
+                            },
+                            training_rights: {
+                                type: "object",
+                                description: "B2B ML licensing compliance object",
+                            },
+                            musicbrainz_recording_id: {
+                                type: "string",
+                                description: "MusicBrainz recording ID",
+                            },
+                        },
+                        required: ["id"],
+                        additionalProperties: true,
+                    },
+                },
+                executor: this.updateRecording.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_recordings_delete",
+                    description: "Delete a recording",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Recording ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.deleteRecording.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_recordings_by_work",
+                    description: "Get all recordings of a specific work",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "Work ID",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.getRecordingsByWork.bind(this),
+            },
+        ];
+    }
+    /**
+     * List recordings
+     */
+    async listRecordings(args) {
+        const limit = args.limit || 50;
+        const recordings = await this.pica.recordings.list({ limit });
+        return formatStructuredList(recordings, "recording", {
+            total: recordings.length,
+            limit,
+        });
+    }
+    /**
+     * Get recording by ID
+     */
+    async getRecording(args) {
+        const recording = await this.pica.recordings.get(args.id);
+        // Enrich with ISRC prefix intelligence if ISRC is present
+        let prefix_intel = null;
+        if (recording.isrc) {
+            prefix_intel = await this.pica.recordings.prefixLookup(recording.isrc);
+        }
+        return formatAsText({ ...recording, prefix_intel });
+    }
+    /**
+     * Create recording
+     */
+    async createRecording(args) {
+        const recording = await this.pica.recordings.create(args);
+        return formatSuccess("Recording created successfully", recording);
+    }
+    /**
+     * Update recording
+     */
+    async updateRecording(args) {
+        const { id, ...updates } = args;
+        const recording = await this.pica.recordings.update(id, updates);
+        return formatSuccess("Recording updated successfully", recording);
+    }
+    /**
+     * Delete recording
+     */
+    async deleteRecording(args) {
+        await this.pica.recordings.delete(args.id);
+        return formatSuccess(`Recording ${args.id} deleted successfully`);
+    }
+    /**
+     * Get recordings by work
+     */
+    async getRecordingsByWork(args) {
+        const recordings = await this.pica.recordings.getByWork(args.work_id);
+        return formatStructuredList(recordings, "recording", {
+            work_id: args.work_id,
+            total: recordings.length,
+        });
+    }
+}
+//# sourceMappingURL=recordings.js.map

package/dist/tools/recordings.js.map

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

package/dist/tools/registration.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Registration Tools - MCP tools for checking registration status and coverage
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class RegistrationTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private registrationCoverage;
+    private workRegistrationStatus;
+}
+//# sourceMappingURL=registration.d.ts.map

package/dist/tools/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../src/tools/registration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAoC3D,oBAAoB;YAOpB,sBAAsB;CAQrC"}

package/dist/tools/registration.js

@@ -0,0 +1,52 @@
+/**
+ * Registration Tools - MCP tools for checking registration status and coverage
+ */
+import { formatAsText } from "../utils/formatting.js";
+export class RegistrationTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_registration_coverage",
+                    description: "Get registration coverage overview — shows what percentage of works are registered with PROs, MLC, etc. " +
+                        "→ then: pica_work_registration_status (check a specific work), pica_export_song_registration (export for submission)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.registrationCoverage.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_work_registration_status",
+                    description: "Get the registration cascade status for a specific work — which registrations are complete, pending, or missing",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to check registration status for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.workRegistrationStatus.bind(this),
+            },
+        ];
+    }
+    async registrationCoverage(_args) {
+        const result = await this.pica.registration.getCoverage();
+        return formatAsText(result);
+    }
+    async workRegistrationStatus(args) {
+        const result = await this.pica.registration.getWorkCascadeStatus(args.work_id);
+        return formatAsText(result);
+    }
+}
+//# sourceMappingURL=registration.js.map