@shan8851/companies-house-cli 0.1.0

package/dist/commands/insolvencyCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insolvencyCommand.d.ts","sourceRoot":"","sources":["../../src/commands/insolvencyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA+B3D,eAAO,MAAM,yBAAyB,GACpC,SAAS,OAAO,EAChB,cAAc,mBAAmB,KAChC,IA4BF,CAAC"}

package/dist/commands/insolvencyCommand.js

@@ -0,0 +1,48 @@
+import { normalizeCompanyNumber } from "../lib/companyNumber.js";
+import { renderKeyValueRows } from "../lib/formatting.js";
+import { normalizeInsolvencyCases } from "../lib/normalizers.js";
+import { executeCommand } from "./shared.js";
+const renderInsolvencyHuman = (envelope) => {
+    if (envelope.data.cases.length === 0) {
+        return envelope.data.status
+            ? `No insolvency cases found.\nStatus: ${envelope.data.status}`
+            : "No insolvency cases found.";
+    }
+    const caseLines = envelope.data.cases.flatMap((insolvencyCase, index) => [
+        `${index + 1}. ${insolvencyCase.type ?? "Unknown case type"} | ${insolvencyCase.number ?? "No case number"}`,
+        ...renderKeyValueRows(insolvencyCase.caseDates.map((caseDate, caseDateIndex) => ({
+            label: `   Date ${caseDateIndex + 1}`,
+            value: `${caseDate.type ?? "unknown"}: ${caseDate.date ?? "unknown"}`
+        }))),
+        ...insolvencyCase.practitioners.map((practitioner, practitionerIndex) => `   Practitioner ${practitionerIndex + 1}: ${practitioner.name ?? "Unknown"} | ${practitioner.role ?? "role unknown"}`)
+    ]);
+    return [`Status: ${envelope.data.status ?? "unknown"}`, ...caseLines].join("\n");
+};
+export const registerInsolvencyCommand = (program, dependencies) => {
+    program
+        .command("insolvency <companyNumber>")
+        .description("Show insolvency information for a company.")
+        .action(async (companyNumber, _options, command) => {
+        const normalizedCompanyNumber = normalizeCompanyNumber(companyNumber);
+        await executeCommand({
+            command,
+            commandName: "insolvency",
+            dependencies,
+            execute: async ({ client }) => {
+                const insolvency = await client.getInsolvency(normalizedCompanyNumber);
+                return {
+                    command: "insolvency",
+                    data: {
+                        cases: normalizeInsolvencyCases(insolvency),
+                        status: insolvency?.status ?? null
+                    },
+                    input: {
+                        companyNumber: normalizedCompanyNumber
+                    }
+                };
+            },
+            renderHuman: renderInsolvencyHuman
+        });
+    });
+};
+//# sourceMappingURL=insolvencyCommand.js.map

package/dist/commands/insolvencyCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insolvencyCommand.js","sourceRoot":"","sources":["../../src/commands/insolvencyCommand.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,qBAAqB,GAAG,CAAC,QAA4B,EAAU,EAAE;IACrE,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM;YACzB,CAAC,CAAC,uCAAuC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE;YAC/D,CAAC,CAAC,4BAA4B,CAAC;IACnC,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,KAAK,EAAE,EAAE,CAAC;QACvE,GAAG,KAAK,GAAG,CAAC,KAAK,cAAc,CAAC,IAAI,IAAI,mBAAmB,MACzD,cAAc,CAAC,MAAM,IAAI,gBAC3B,EAAE;QACF,GAAG,kBAAkB,CACnB,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;YACzD,KAAK,EAAE,WAAW,aAAa,GAAG,CAAC,EAAE;YACrC,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,SAAS,KAAK,QAAQ,CAAC,IAAI,IAAI,SAAS,EAAE;SACtE,CAAC,CAAC,CACJ;QACD,GAAG,cAAc,CAAC,aAAa,CAAC,GAAG,CACjC,CAAC,YAAY,EAAE,iBAAiB,EAAE,EAAE,CAClC,mBAAmB,iBAAiB,GAAG,CAAC,KACtC,YAAY,CAAC,IAAI,IAAI,SACvB,MAAM,YAAY,CAAC,IAAI,IAAI,cAAc,EAAE,CAC9C;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,OAAgB,EAChB,YAAiC,EAC3B,EAAE;IACR,OAAO;SACJ,OAAO,CAAC,4BAA4B,CAAC;SACrC,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,aAAqB,EAAE,QAAgB,EAAE,OAAgB,EAAE,EAAE;QAC1E,MAAM,uBAAuB,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAEtE,MAAM,cAAc,CAAC;YACnB,OAAO;YACP,WAAW,EAAE,YAAY;YACzB,YAAY;YACZ,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC5B,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAC;gBAEvE,OAAO;oBACL,OAAO,EAAE,YAAY;oBACrB,IAAI,EAAE;wBACJ,KAAK,EAAE,wBAAwB,CAAC,UAAU,CAAC;wBAC3C,MAAM,EAAE,UAAU,EAAE,MAAM,IAAI,IAAI;qBACnC;oBACD,KAAK,EAAE;wBACL,aAAa,EAAE,uBAAuB;qBACvC;iBAC2B,CAAC;YACjC,CAAC;YACD,WAAW,EAAE,qBAAqB;SACnC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/commands/officersCommand.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { RuntimeDependencies } from "../types/cli.js";
+export declare const registerOfficersCommand: (program: Command, dependencies: RuntimeDependencies) => void;
+//# sourceMappingURL=officersCommand.d.ts.map

package/dist/commands/officersCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"officersCommand.d.ts","sourceRoot":"","sources":["../../src/commands/officersCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA6E3D,eAAO,MAAM,uBAAuB,GAClC,SAAS,OAAO,EAChB,cAAc,mBAAmB,KAChC,IAiFF,CAAC"}

package/dist/commands/officersCommand.js

@@ -0,0 +1,133 @@
+import { formatDateOfBirth, renderKeyValueRows, renderPaginationSummary } from "../lib/formatting.js";
+import { normalizeCompanyNumber } from "../lib/companyNumber.js";
+import { normalizeOfficer } from "../lib/normalizers.js";
+import { fetchPaginatedItems } from "../lib/pagination.js";
+import { addListOptions, executeCommand, resolveListOptions } from "./shared.js";
+const renderOfficersHuman = (envelope) => {
+    const summaryLines = [
+        renderPaginationSummary(envelope.pagination?.returnedCount ?? envelope.data.officers.length, envelope.pagination?.totalResults ?? null, envelope.pagination?.fetchedAll ?? false),
+        ...renderKeyValueRows([
+            {
+                label: "Active officers",
+                value: envelope.data.summary.activeCount !== null
+                    ? String(envelope.data.summary.activeCount)
+                    : null
+            },
+            {
+                label: "Resigned officers",
+                value: envelope.data.summary.resignedCount !== null
+                    ? String(envelope.data.summary.resignedCount)
+                    : null
+            }
+        ])
+    ];
+    const officerLines = envelope.data.officers.length === 0
+        ? ["No officers found."]
+        : envelope.data.officers.flatMap((officer, index) => [
+            `${index + 1}. ${officer.name ?? "Unknown officer"} | ${officer.officerRole ?? "role unknown"}`,
+            ...renderKeyValueRows([
+                {
+                    label: "   Appointed",
+                    value: officer.appointedOn
+                },
+                {
+                    label: "   Resigned",
+                    value: officer.resignedOn
+                },
+                {
+                    label: "   Occupation",
+                    value: officer.occupation
+                },
+                {
+                    label: "   Nationality",
+                    value: officer.nationality
+                },
+                {
+                    label: "   Date of birth",
+                    value: formatDateOfBirth(officer.dateOfBirth)
+                },
+                {
+                    label: "   Address",
+                    value: officer.address?.formatted ?? officer.principalOfficeAddress?.formatted ?? null
+                }
+            ])
+        ]);
+    return [...summaryLines, "", ...officerLines].join("\n");
+};
+export const registerOfficersCommand = (program, dependencies) => {
+    addListOptions(program
+        .command("officers <companyNumber>")
+        .description("List company officers.")
+        .option("--order-by <orderBy>", "Sort order to request from Companies House.")
+        .option("--register-type <registerType>", "Register type filter.")
+        .option("--register-view <registerView>", "Register view filter.")).action(async (companyNumber, options, command) => {
+        const normalizedCompanyNumber = normalizeCompanyNumber(companyNumber);
+        await executeCommand({
+            command,
+            commandName: "officers",
+            dependencies,
+            execute: async ({ client }) => {
+                const listOptions = resolveListOptions(options);
+                const firstPageSummary = await client.listOfficers({
+                    companyNumber: normalizedCompanyNumber,
+                    itemsPerPage: (listOptions.all ?? false)
+                        ? listOptions.itemsPerPage ?? 100
+                        : listOptions.itemsPerPage ?? 10,
+                    startIndex: listOptions.startIndex ?? 0,
+                    ...(options.orderBy !== undefined ? { orderBy: options.orderBy } : {}),
+                    ...(options.registerType !== undefined
+                        ? { registerType: options.registerType }
+                        : {}),
+                    ...(options.registerView !== undefined
+                        ? { registerView: options.registerView }
+                        : {})
+                });
+                const paginatedItems = listOptions.all
+                    ? await fetchPaginatedItems({
+                        fetchPage: ({ itemsPerPage, startIndex }) => client.listOfficers({
+                            companyNumber: normalizedCompanyNumber,
+                            itemsPerPage,
+                            startIndex,
+                            ...(options.orderBy !== undefined ? { orderBy: options.orderBy } : {}),
+                            ...(options.registerType !== undefined
+                                ? { registerType: options.registerType }
+                                : {}),
+                            ...(options.registerView !== undefined
+                                ? { registerView: options.registerView }
+                                : {})
+                        }),
+                        options: listOptions
+                    })
+                    : {
+                        items: firstPageSummary.items ?? [],
+                        pagination: {
+                            fetchedAll: false,
+                            itemsPerPage: listOptions.itemsPerPage ?? 10,
+                            returnedCount: firstPageSummary.items?.length ?? 0,
+                            startIndex: listOptions.startIndex ?? 0,
+                            totalResults: firstPageSummary.total_results ?? null
+                        }
+                    };
+                return {
+                    command: "officers",
+                    data: {
+                        officers: paginatedItems.items.map(normalizeOfficer),
+                        summary: {
+                            activeCount: firstPageSummary.active_count ?? null,
+                            resignedCount: firstPageSummary.resigned_count ?? null
+                        }
+                    },
+                    input: {
+                        companyNumber: normalizedCompanyNumber,
+                        orderBy: options.orderBy ?? null,
+                        registerType: options.registerType ?? null,
+                        registerView: options.registerView ?? null
+                    },
+                    pagination: paginatedItems.pagination
+                };
+            },
+            renderHuman: renderOfficersHuman
+        });
+    });
+};
+//# sourceMappingURL=officersCommand.js.map

package/dist/commands/officersCommand.js.map

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

package/dist/commands/pscCommand.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { RuntimeDependencies } from "../types/cli.js";
+export declare const registerPscCommand: (program: Command, dependencies: RuntimeDependencies) => void;
+//# sourceMappingURL=pscCommand.d.ts.map

package/dist/commands/pscCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pscCommand.d.ts","sourceRoot":"","sources":["../../src/commands/pscCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA+E3D,eAAO,MAAM,kBAAkB,GAC7B,SAAS,OAAO,EAChB,cAAc,mBAAmB,KAChC,IAqEF,CAAC"}

package/dist/commands/pscCommand.js

@@ -0,0 +1,125 @@
+import { normalizeCompanyNumber } from "../lib/companyNumber.js";
+import { formatDateOfBirth, formatList, renderKeyValueRows, renderPaginationSummary } from "../lib/formatting.js";
+import { normalizePsc } from "../lib/normalizers.js";
+import { fetchPaginatedItems } from "../lib/pagination.js";
+import { addListOptions, executeCommand, resolveListOptions } from "./shared.js";
+const renderPscHuman = (envelope) => {
+    const summaryLines = [
+        renderPaginationSummary(envelope.pagination?.returnedCount ?? envelope.data.psc.length, envelope.pagination?.totalResults ?? null, envelope.pagination?.fetchedAll ?? false),
+        ...renderKeyValueRows([
+            {
+                label: "Active PSC entries",
+                value: envelope.data.summary.activeCount !== null
+                    ? String(envelope.data.summary.activeCount)
+                    : null
+            },
+            {
+                label: "Ceased PSC entries",
+                value: envelope.data.summary.ceasedCount !== null
+                    ? String(envelope.data.summary.ceasedCount)
+                    : null
+            }
+        ])
+    ];
+    const pscLines = envelope.data.psc.length === 0
+        ? ["No persons with significant control found."]
+        : envelope.data.psc.flatMap((psc, index) => [
+            `${index + 1}. ${psc.name ?? psc.description ?? "Unknown PSC"} | ${psc.kind ?? "kind unknown"}`,
+            ...renderKeyValueRows([
+                {
+                    label: "   Notified",
+                    value: psc.notifiedOn
+                },
+                {
+                    label: "   Ceased",
+                    value: psc.ceasedOn
+                },
+                {
+                    label: "   Nationality",
+                    value: psc.nationality
+                },
+                {
+                    label: "   Country of residence",
+                    value: psc.countryOfResidence
+                },
+                {
+                    label: "   Date of birth",
+                    value: formatDateOfBirth(psc.dateOfBirth)
+                },
+                {
+                    label: "   Address",
+                    value: psc.address?.formatted ?? psc.principalOfficeAddress?.formatted ?? null
+                },
+                {
+                    label: "   Natures of control",
+                    value: formatList(psc.naturesOfControl)
+                }
+            ])
+        ]);
+    return [...summaryLines, "", ...pscLines].join("\n");
+};
+export const registerPscCommand = (program, dependencies) => {
+    addListOptions(program
+        .command("psc <companyNumber>")
+        .description("List persons with significant control for a company.")
+        .option("--register-view <registerView>", "Register view filter.")).action(async (companyNumber, options, command) => {
+        const normalizedCompanyNumber = normalizeCompanyNumber(companyNumber);
+        await executeCommand({
+            command,
+            commandName: "psc",
+            dependencies,
+            execute: async ({ client }) => {
+                const listOptions = resolveListOptions(options);
+                const firstPageSummary = await client.listPsc({
+                    companyNumber: normalizedCompanyNumber,
+                    itemsPerPage: (listOptions.all ?? false)
+                        ? listOptions.itemsPerPage ?? 100
+                        : listOptions.itemsPerPage ?? 10,
+                    startIndex: listOptions.startIndex ?? 0,
+                    ...(options.registerView !== undefined
+                        ? { registerView: options.registerView }
+                        : {})
+                });
+                const paginatedItems = listOptions.all
+                    ? await fetchPaginatedItems({
+                        fetchPage: ({ itemsPerPage, startIndex }) => client.listPsc({
+                            companyNumber: normalizedCompanyNumber,
+                            itemsPerPage,
+                            startIndex,
+                            ...(options.registerView !== undefined
+                                ? { registerView: options.registerView }
+                                : {})
+                        }),
+                        options: listOptions
+                    })
+                    : {
+                        items: firstPageSummary.items ?? [],
+                        pagination: {
+                            fetchedAll: false,
+                            itemsPerPage: listOptions.itemsPerPage ?? 10,
+                            returnedCount: firstPageSummary.items?.length ?? 0,
+                            startIndex: listOptions.startIndex ?? 0,
+                            totalResults: firstPageSummary.total_results ?? null
+                        }
+                    };
+                return {
+                    command: "psc",
+                    data: {
+                        psc: paginatedItems.items.map(normalizePsc),
+                        summary: {
+                            activeCount: firstPageSummary.active_count ?? null,
+                            ceasedCount: firstPageSummary.ceased_count ?? null
+                        }
+                    },
+                    input: {
+                        companyNumber: normalizedCompanyNumber,
+                        registerView: options.registerView ?? null
+                    },
+                    pagination: paginatedItems.pagination
+                };
+            },
+            renderHuman: renderPscHuman
+        });
+    });
+};
+//# sourceMappingURL=pscCommand.js.map

package/dist/commands/pscCommand.js.map

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

package/dist/commands/searchCompaniesCommand.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { RuntimeDependencies } from "../types/cli.js";
+export declare const registerSearchCompaniesCommand: (program: Command, dependencies: RuntimeDependencies) => void;
+//# sourceMappingURL=searchCompaniesCommand.d.ts.map

package/dist/commands/searchCompaniesCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCompaniesCommand.d.ts","sourceRoot":"","sources":["../../src/commands/searchCompaniesCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAuD3D,eAAO,MAAM,8BAA8B,GACzC,SAAS,OAAO,EAChB,cAAc,mBAAmB,KAChC,IA+CF,CAAC"}

package/dist/commands/searchCompaniesCommand.js

@@ -0,0 +1,76 @@
+import { renderPaginationSummary, renderKeyValueRows } from "../lib/formatting.js";
+import { normalizeCompanySearchResult } from "../lib/normalizers.js";
+import { fetchPaginatedItems } from "../lib/pagination.js";
+import { addListOptions, executeCommand, resolveListOptions } from "./shared.js";
+const renderSearchCompaniesHuman = (envelope) => {
+    const companyLines = envelope.data.companies.length === 0
+        ? ["No companies found."]
+        : envelope.data.companies.flatMap((company, index) => [
+            `${index + 1}. ${company.name ?? "Unknown company"} (${company.companyNumber ?? "unknown"})`,
+            ...renderKeyValueRows([
+                {
+                    label: "   Status",
+                    value: company.companyStatus
+                },
+                {
+                    label: "   Type",
+                    value: company.companyType
+                },
+                {
+                    label: "   Created",
+                    value: company.dateOfCreation
+                },
+                {
+                    label: "   Address",
+                    value: company.address?.formatted ?? null
+                },
+                {
+                    label: "   Description",
+                    value: company.description
+                }
+            ])
+        ]);
+    const summary = envelope.pagination
+        ? renderPaginationSummary(envelope.pagination.returnedCount, envelope.pagination.totalResults, envelope.pagination.fetchedAll)
+        : null;
+    return [summary, ...companyLines].filter((line) => line !== null).join("\n");
+};
+export const registerSearchCompaniesCommand = (program, dependencies) => {
+    addListOptions(program
+        .command("search <query>")
+        .description("Search companies by name.")
+        .option("--restrictions <restrictions>", "Search restrictions to pass through to Companies House.")).action(async (query, options, command) => {
+        await executeCommand({
+            command,
+            commandName: "search",
+            dependencies,
+            execute: async ({ client }) => {
+                const listOptions = resolveListOptions(options);
+                const result = await fetchPaginatedItems({
+                    fetchPage: ({ itemsPerPage, startIndex }) => client.searchCompanies({
+                        itemsPerPage,
+                        query,
+                        startIndex,
+                        ...(options.restrictions !== undefined
+                            ? { restrictions: options.restrictions }
+                            : {})
+                    }),
+                    options: listOptions
+                });
+                return {
+                    command: "search",
+                    data: {
+                        companies: result.items.map(normalizeCompanySearchResult)
+                    },
+                    input: {
+                        query,
+                        restrictions: options.restrictions ?? null
+                    },
+                    pagination: result.pagination
+                };
+            },
+            renderHuman: renderSearchCompaniesHuman
+        });
+    });
+};
+//# sourceMappingURL=searchCompaniesCommand.js.map

package/dist/commands/searchCompaniesCommand.js.map

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

package/dist/commands/searchPeopleCommand.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { RuntimeDependencies } from "../types/cli.js";
+export declare const registerSearchPeopleCommand: (program: Command, dependencies: RuntimeDependencies) => void;
+//# sourceMappingURL=searchPeopleCommand.d.ts.map

package/dist/commands/searchPeopleCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchPeopleCommand.d.ts","sourceRoot":"","sources":["../../src/commands/searchPeopleCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAwE3D,eAAO,MAAM,2BAA2B,GACtC,SAAS,OAAO,EAChB,cAAc,mBAAmB,KAChC,IAoFF,CAAC"}

package/dist/commands/searchPeopleCommand.js

@@ -0,0 +1,103 @@
+import { formatDateOfBirth, renderKeyValueRows, renderPaginationSummary } from "../lib/formatting.js";
+import { extractOfficerId, normalizeOfficerAppointment, normalizePersonSearchResult } from "../lib/normalizers.js";
+import { fetchPaginatedItems } from "../lib/pagination.js";
+import { addListOptions, executeCommand, parsePositiveInteger, resolveListOptions } from "./shared.js";
+const DEFAULT_MATCH_LIMIT = 10;
+const renderSearchPeopleHuman = (envelope) => {
+    const summary = renderPaginationSummary(envelope.data.results.length, envelope.data.totalSearchHits, envelope.pagination?.fetchedAll ?? false);
+    const resultLines = envelope.data.results.length === 0
+        ? ["No matching people found."]
+        : envelope.data.results.flatMap((result, index) => {
+            const appointmentLines = result.appointments.length === 0
+                ? ["   Appointments: none found"]
+                : result.appointments.map((appointment, appointmentIndex) => `   Appointment ${appointmentIndex + 1}: ${appointment.companyName ?? "Unknown company"} (${appointment.companyNumber ?? "unknown"}) | ${appointment.officerRole ?? "role unknown"} | appointed ${appointment.appointedOn ?? "unknown"}`);
+            return [
+                `${index + 1}. ${result.name ?? "Unknown person"}`,
+                ...renderKeyValueRows([
+                    {
+                        label: "   Officer ID",
+                        value: result.officerId
+                    },
+                    {
+                        label: "   Date of birth",
+                        value: formatDateOfBirth(result.dateOfBirth)
+                    },
+                    {
+                        label: "   Appointment count",
+                        value: result.appointmentCount !== null ? String(result.appointmentCount) : null
+                    },
+                    {
+                        label: "   Address",
+                        value: result.address?.formatted ?? null
+                    },
+                    {
+                        label: "   Description",
+                        value: result.description
+                    }
+                ]),
+                ...appointmentLines
+            ];
+        });
+    return [summary, ...resultLines].join("\n");
+};
+export const registerSearchPeopleCommand = (program, dependencies) => {
+    addListOptions(program
+        .command("search-person <query>")
+        .description("Search officers and resolve their company appointments.")
+        .option("--match-limit <number>", "Number of officer matches to enrich with appointments.", parsePositiveInteger, DEFAULT_MATCH_LIMIT)).action(async (query, options, command) => {
+        await executeCommand({
+            command,
+            commandName: "search-person",
+            dependencies,
+            execute: async ({ client }) => {
+                const listOptions = resolveListOptions(options);
+                const searchResults = await fetchPaginatedItems({
+                    fetchPage: ({ itemsPerPage, startIndex }) => client.searchOfficers({
+                        itemsPerPage,
+                        query,
+                        startIndex
+                    }),
+                    options: listOptions
+                });
+                const matchLimit = options.matchLimit ?? DEFAULT_MATCH_LIMIT;
+                const officerMatchesToEnrich = searchResults.items.slice(0, matchLimit);
+                const enrichedResults = await Promise.all(officerMatchesToEnrich.map(async (officerSearchResult) => {
+                    const selfLink = typeof officerSearchResult.links?.self === "string"
+                        ? officerSearchResult.links.self
+                        : undefined;
+                    const officerId = extractOfficerId(selfLink);
+                    if (!officerId) {
+                        return normalizePersonSearchResult(officerSearchResult, []);
+                    }
+                    const appointments = await fetchPaginatedItems({
+                        fetchPage: ({ itemsPerPage, startIndex }) => client.listOfficerAppointments({
+                            itemsPerPage,
+                            officerId,
+                            startIndex
+                        }),
+                        options: {
+                            all: true,
+                            itemsPerPage: 100,
+                            startIndex: 0
+                        }
+                    });
+                    return normalizePersonSearchResult(officerSearchResult, appointments.items.map(normalizeOfficerAppointment));
+                }));
+                return {
+                    command: "search-person",
+                    data: {
+                        results: enrichedResults,
+                        totalSearchHits: searchResults.pagination.totalResults
+                    },
+                    input: {
+                        matchLimit,
+                        query
+                    },
+                    pagination: searchResults.pagination
+                };
+            },
+            renderHuman: renderSearchPeopleHuman
+        });
+    });
+};
+//# sourceMappingURL=searchPeopleCommand.js.map

package/dist/commands/searchPeopleCommand.js.map

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

package/dist/commands/shared.d.ts

@@ -0,0 +1,21 @@
+import type { Command } from "commander";
+import { type CompaniesHouseClient } from "../lib/companiesHouseClient.js";
+import type { CommandEnvelope, ListCommandOptions, OutputMode, RuntimeDependencies } from "../types/cli.js";
+export declare const createDefaultRuntimeDependencies: () => RuntimeDependencies;
+export declare const parsePositiveInteger: (value: string) => number;
+export declare const parseNonNegativeInteger: (value: string) => number;
+export declare const addListOptions: (command: Command) => Command;
+export declare const resolveListOptions: (options: ListCommandOptions) => ListCommandOptions;
+export declare const resolveOutputMode: (command: Command) => OutputMode;
+export interface CommandExecutionContext {
+    client: CompaniesHouseClient;
+}
+export interface ExecuteCommandOptions<TInput, TData> {
+    command: Command;
+    commandName: string;
+    dependencies: RuntimeDependencies;
+    execute: (context: CommandExecutionContext) => Promise<CommandEnvelope<TInput, TData>>;
+    renderHuman: (envelope: CommandEnvelope<TInput, TData>) => string;
+}
+export declare const executeCommand: <TInput, TData>({ command, dependencies, execute, renderHuman }: ExecuteCommandOptions<TInput, TData>) => Promise<void>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,gCAAgC,QAAO,mBAUlD,CAAC;AAEH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAQpD,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,KAAG,MAQvD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,KAAG,OAIA,CAAC;AAEnD,eAAO,MAAM,kBAAkB,GAAI,SAAS,kBAAkB,KAAG,kBAchE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,UAMpD,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM,EAAE,KAAK;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACvF,WAAW,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,MAAM,CAAC;CACnE;AAED,eAAO,MAAM,cAAc,GAAU,MAAM,EAAE,KAAK,EAAE,iDAKjD,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,KAAG,OAAO,CAAC,IAAI,CA8CrD,CAAC"}