@shan8851/companies-house-cli 0.1.0

package/dist/commands/shared.js

@@ -0,0 +1,86 @@
+import { CommanderError, InvalidArgumentError } from "commander";
+import { createCompaniesHouseClient } from "../lib/companiesHouseClient.js";
+import { resolveCliConfig } from "../lib/config.js";
+import { CliHandledError, toCliError } from "../lib/errors.js";
+export const createDefaultRuntimeDependencies = () => ({
+    cwd: process.cwd(),
+    env: process.env,
+    fetchImplementation: fetch,
+    writeStderr: (text) => {
+        process.stderr.write(text);
+    },
+    writeStdout: (text) => {
+        process.stdout.write(text);
+    }
+});
+export const parsePositiveInteger = (value) => {
+    const parsedValue = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsedValue) || parsedValue <= 0) {
+        throw new InvalidArgumentError("Expected a positive integer.");
+    }
+    return parsedValue;
+};
+export const parseNonNegativeInteger = (value) => {
+    const parsedValue = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsedValue) || parsedValue < 0) {
+        throw new InvalidArgumentError("Expected a non-negative integer.");
+    }
+    return parsedValue;
+};
+export const addListOptions = (command) => command
+    .option("--items-per-page <number>", "Items to fetch per page.", parsePositiveInteger)
+    .option("--start-index <number>", "Zero-based start index.", parseNonNegativeInteger, 0)
+    .option("--all", "Fetch all available pages.");
+export const resolveListOptions = (options) => {
+    if ((options.all ?? false) && (options.startIndex ?? 0) !== 0) {
+        throw new CommanderError(1, "command.invalidOption", "--all cannot be combined with a non-zero --start-index.");
+    }
+    return {
+        all: options.all ?? false,
+        ...(options.itemsPerPage !== undefined ? { itemsPerPage: options.itemsPerPage } : {}),
+        startIndex: options.startIndex ?? 0
+    };
+};
+export const resolveOutputMode = (command) => {
+    const globalOptions = command.optsWithGlobals();
+    return globalOptions.json ? "json" : "human";
+};
+export const executeCommand = async ({ command, dependencies, execute, renderHuman }) => {
+    const outputMode = resolveOutputMode(command);
+    try {
+        const config = resolveCliConfig({
+            cwd: dependencies.cwd,
+            env: dependencies.env
+        });
+        const client = createCompaniesHouseClient({
+            apiKey: config.apiKey,
+            baseUrl: config.baseUrl,
+            fetchImplementation: dependencies.fetchImplementation
+        });
+        const envelope = await execute({
+            client
+        });
+        if (outputMode === "json") {
+            dependencies.writeStdout(`${JSON.stringify(envelope, null, 2)}\n`);
+            return;
+        }
+        dependencies.writeStdout(`${renderHuman(envelope)}\n`);
+    }
+    catch (error) {
+        const cliError = toCliError(error);
+        if (outputMode === "json") {
+            dependencies.writeStderr(`${JSON.stringify({
+                error: {
+                    code: cliError.code,
+                    message: cliError.message,
+                    statusCode: cliError.statusCode ?? null
+                }
+            }, null, 2)}\n`);
+        }
+        else {
+            dependencies.writeStderr(`Error: ${cliError.message}\n`);
+        }
+        throw new CliHandledError();
+    }
+};
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

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

package/dist/lib/companiesHouseClient.d.ts

@@ -0,0 +1,50 @@
+import type { ChargeListApiResponse, CompanyInsolvencyApiResponse, CompanyProfileApiResponse, CompanySearchApiResponse, FilingHistoryApiResponse, OfficerAppointmentListApiResponse, OfficerListApiResponse, OfficerSearchApiResponse, PscListApiResponse } from "../types/api.js";
+export interface CompaniesHouseClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    fetchImplementation: typeof fetch;
+}
+export interface PaginatedApiRequest {
+    itemsPerPage?: number;
+    startIndex?: number;
+}
+export interface SearchCompaniesRequest extends PaginatedApiRequest {
+    query: string;
+    restrictions?: string;
+}
+export interface ListOfficersRequest extends PaginatedApiRequest {
+    companyNumber: string;
+    orderBy?: string;
+    registerType?: string;
+    registerView?: string;
+}
+export interface ListFilingsRequest extends PaginatedApiRequest {
+    category?: string;
+    companyNumber: string;
+}
+export interface ListPscRequest extends PaginatedApiRequest {
+    companyNumber: string;
+    registerView?: string;
+}
+export interface SearchOfficersRequest extends PaginatedApiRequest {
+    query: string;
+}
+export interface ListOfficerAppointmentsRequest extends PaginatedApiRequest {
+    officerId: string;
+}
+export interface ListChargesRequest extends PaginatedApiRequest {
+    companyNumber: string;
+}
+export interface CompaniesHouseClient {
+    getCompanyProfile: (companyNumber: string) => Promise<CompanyProfileApiResponse>;
+    getInsolvency: (companyNumber: string) => Promise<CompanyInsolvencyApiResponse | null>;
+    listCharges: (request: ListChargesRequest) => Promise<ChargeListApiResponse>;
+    listFilings: (request: ListFilingsRequest) => Promise<FilingHistoryApiResponse>;
+    listOfficerAppointments: (request: ListOfficerAppointmentsRequest) => Promise<OfficerAppointmentListApiResponse>;
+    listOfficers: (request: ListOfficersRequest) => Promise<OfficerListApiResponse>;
+    listPsc: (request: ListPscRequest) => Promise<PscListApiResponse>;
+    searchCompanies: (request: SearchCompaniesRequest) => Promise<CompanySearchApiResponse>;
+    searchOfficers: (request: SearchOfficersRequest) => Promise<OfficerSearchApiResponse>;
+}
+export declare const createCompaniesHouseClient: ({ apiKey, baseUrl, fetchImplementation }: CompaniesHouseClientOptions) => CompaniesHouseClient;
+//# sourceMappingURL=companiesHouseClient.d.ts.map

package/dist/lib/companiesHouseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companiesHouseClient.d.ts","sourceRoot":"","sources":["../../src/lib/companiesHouseClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,iCAAiC,EACjC,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAOzB,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,OAAO,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,8BAA+B,SAAQ,mBAAmB;IACzE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,aAAa,EAAE,MAAM,CAAC;CACvB;AA0ED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACjF,aAAa,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IACvF,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC7E,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAChF,uBAAuB,EAAE,CACvB,OAAO,EAAE,8BAA8B,KACpC,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAChD,YAAY,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAChF,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClE,eAAe,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACxF,cAAc,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACvF;AAED,eAAO,MAAM,0BAA0B,GAAI,0CAIxC,2BAA2B,KAAG,oBAoIhC,CAAC"}

package/dist/lib/companiesHouseClient.js

@@ -0,0 +1,119 @@
+import { CompaniesHouseCliError } from "./errors.js";
+const USER_AGENT = "companies-house-cli/0.1.0";
+const safeParseJson = (text) => {
+    if (text.trim().length === 0) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+};
+const buildUrl = (baseUrl, path, query) => {
+    const normalizedBaseUrl = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+    const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
+    const url = new URL(normalizedPath, normalizedBaseUrl);
+    Object.entries(query).forEach(([key, value]) => {
+        if (value === undefined || value === "") {
+            return;
+        }
+        url.searchParams.set(key, String(value));
+    });
+    return url;
+};
+const createApiError = (statusCode, url, responseBody) => {
+    if (statusCode === 401) {
+        return new CompaniesHouseCliError("Companies House rejected the request. Check that COMPANIES_HOUSE_API_KEY is valid for the public data API.", "unauthorized", statusCode);
+    }
+    if (statusCode === 404) {
+        return new CompaniesHouseCliError("The requested Companies House resource was not found.", "not_found", statusCode);
+    }
+    if (statusCode === 429) {
+        return new CompaniesHouseCliError("Companies House rate-limited the request. Wait a moment and try again.", "rate_limited", statusCode);
+    }
+    const message = typeof responseBody === "object" &&
+        responseBody !== null &&
+        "error" in responseBody &&
+        typeof responseBody.error === "string"
+        ? responseBody.error
+        : `Companies House returned HTTP ${statusCode} for ${url}.`;
+    return new CompaniesHouseCliError(message, "api_error", statusCode);
+};
+export const createCompaniesHouseClient = ({ apiKey, baseUrl, fetchImplementation }) => {
+    const authorizationHeader = `Basic ${Buffer.from(`${apiKey}:`).toString("base64")}`;
+    const requestJson = async (path, query, options) => {
+        const url = buildUrl(baseUrl, path, query);
+        let response;
+        try {
+            response = await fetchImplementation(url, {
+                headers: {
+                    Accept: "application/json",
+                    Authorization: authorizationHeader,
+                    "User-Agent": USER_AGENT
+                }
+            });
+        }
+        catch (error) {
+            throw new CompaniesHouseCliError(error instanceof Error
+                ? `Failed to reach Companies House: ${error.message}`
+                : "Failed to reach Companies House.", "network_error");
+        }
+        const responseText = await response.text();
+        const responseBody = safeParseJson(responseText);
+        if (response.status === 404 && options?.allowNotFound) {
+            return null;
+        }
+        if (!response.ok) {
+            throw createApiError(response.status, url.toString(), responseBody);
+        }
+        if (typeof responseBody !== "object" || responseBody === null) {
+            throw new CompaniesHouseCliError(`Companies House returned an invalid JSON payload for ${url.toString()}.`, "invalid_response");
+        }
+        return responseBody;
+    };
+    return {
+        getCompanyProfile: async (companyNumber) => (await requestJson(`/company/${companyNumber}`, {})),
+        getInsolvency: async (companyNumber) => await requestJson(`/company/${companyNumber}/insolvency`, {}, {
+            allowNotFound: true
+        }),
+        listCharges: async ({ companyNumber, itemsPerPage, startIndex }) => (await requestJson(`/company/${companyNumber}/charges`, {
+            items_per_page: itemsPerPage,
+            start_index: startIndex
+        })),
+        listFilings: async ({ category, companyNumber, itemsPerPage, startIndex }) => (await requestJson(`/company/${companyNumber}/filing-history`, {
+            category,
+            items_per_page: itemsPerPage,
+            start_index: startIndex
+        })),
+        listOfficerAppointments: async ({ officerId, itemsPerPage, startIndex }) => (await requestJson(`/officers/${officerId}/appointments`, {
+            items_per_page: itemsPerPage,
+            start_index: startIndex
+        })),
+        listOfficers: async ({ companyNumber, itemsPerPage, orderBy, registerType, registerView, startIndex }) => (await requestJson(`/company/${companyNumber}/officers`, {
+            items_per_page: itemsPerPage,
+            order_by: orderBy,
+            register_type: registerType,
+            register_view: registerView,
+            start_index: startIndex
+        })),
+        listPsc: async ({ companyNumber, itemsPerPage, registerView, startIndex }) => (await requestJson(`/company/${companyNumber}/persons-with-significant-control`, {
+            items_per_page: itemsPerPage,
+            register_view: registerView,
+            start_index: startIndex
+        })),
+        searchCompanies: async ({ itemsPerPage, query, restrictions, startIndex }) => (await requestJson("/search/companies", {
+            items_per_page: itemsPerPage,
+            q: query,
+            restrictions,
+            start_index: startIndex
+        })),
+        searchOfficers: async ({ itemsPerPage, query, startIndex }) => (await requestJson("/search/officers", {
+            items_per_page: itemsPerPage,
+            q: query,
+            start_index: startIndex
+        }))
+    };
+};
+//# sourceMappingURL=companiesHouseClient.js.map

package/dist/lib/companiesHouseClient.js.map

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

package/dist/lib/companyNumber.d.ts

@@ -0,0 +1,2 @@
+export declare const normalizeCompanyNumber: (companyNumber: string) => string;
+//# sourceMappingURL=companyNumber.d.ts.map

package/dist/lib/companyNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companyNumber.d.ts","sourceRoot":"","sources":["../../src/lib/companyNumber.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,GAAI,eAAe,MAAM,KAAG,MAM9D,CAAC"}

package/dist/lib/companyNumber.js

@@ -0,0 +1,8 @@
+const SHORT_NUMERIC_COMPANY_NUMBER_PATTERN = /^\d{1,7}$/;
+export const normalizeCompanyNumber = (companyNumber) => {
+    const trimmedCompanyNumber = companyNumber.trim();
+    return SHORT_NUMERIC_COMPANY_NUMBER_PATTERN.test(trimmedCompanyNumber)
+        ? trimmedCompanyNumber.padStart(8, "0")
+        : trimmedCompanyNumber;
+};
+//# sourceMappingURL=companyNumber.js.map

package/dist/lib/companyNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companyNumber.js","sourceRoot":"","sources":["../../src/lib/companyNumber.ts"],"names":[],"mappings":"AAAA,MAAM,oCAAoC,GAAG,WAAW,CAAC;AAEzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,aAAqB,EAAU,EAAE;IACtE,MAAM,oBAAoB,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IAElD,OAAO,oCAAoC,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACpE,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;QACvC,CAAC,CAAC,oBAAoB,CAAC;AAC3B,CAAC,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,10 @@
+export interface CliConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+export interface ResolveCliConfigOptions {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}
+export declare const resolveCliConfig: ({ cwd, env }: ResolveCliConfigOptions) => CliConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAkBD,eAAO,MAAM,gBAAgB,GAAI,cAG9B,uBAAuB,KAAG,SAkB5B,CAAC"}

package/dist/lib/config.js

@@ -0,0 +1,33 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { parse } from "dotenv";
+import { z } from "zod";
+import { CompaniesHouseCliError } from "./errors.js";
+const configSchema = z.object({
+    apiKey: z.string().trim().min(1)
+});
+const COMPANIES_HOUSE_BASE_URL = "https://api.company-information.service.gov.uk";
+const readApiKeyFromDotEnv = (cwd) => {
+    const dotEnvPath = resolve(cwd, ".env");
+    if (!existsSync(dotEnvPath)) {
+        return undefined;
+    }
+    const dotEnvContents = readFileSync(dotEnvPath, "utf8");
+    const parsedDotEnv = parse(dotEnvContents);
+    const apiKey = parsedDotEnv.COMPANIES_HOUSE_API_KEY;
+    return typeof apiKey === "string" && apiKey.trim().length > 0 ? apiKey.trim() : undefined;
+};
+export const resolveCliConfig = ({ cwd, env }) => {
+    const apiKey = env.COMPANIES_HOUSE_API_KEY?.trim() || readApiKeyFromDotEnv(cwd);
+    const parsedConfig = configSchema.safeParse({
+        apiKey
+    });
+    if (!parsedConfig.success) {
+        throw new CompaniesHouseCliError("Missing COMPANIES_HOUSE_API_KEY. Set it in your environment or add it to a local .env file.", "missing_api_key");
+    }
+    return {
+        apiKey: parsedConfig.data.apiKey,
+        baseUrl: COMPANIES_HOUSE_BASE_URL
+    };
+};
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AAYH,MAAM,wBAAwB,GAAG,gDAAgD,CAAC;AAElF,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAsB,EAAE;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAExC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,cAAc,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,uBAAuB,CAAC;IAEpD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5F,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,GAAG,EACH,GAAG,EACqB,EAAa,EAAE;IACvC,MAAM,MAAM,GAAG,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAEhF,MAAM,YAAY,GAAG,YAAY,CAAC,SAAS,CAAC;QAC1C,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,sBAAsB,CAC9B,6FAA6F,EAC7F,iBAAiB,CAClB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM;QAChC,OAAO,EAAE,wBAAwB;KAClC,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,10 @@
+export declare class CompaniesHouseCliError extends Error {
+    readonly code: string;
+    readonly statusCode: number | undefined;
+    constructor(message: string, code: string, statusCode?: number);
+}
+export declare class CliHandledError extends Error {
+    constructor();
+}
+export declare const toCliError: (error: unknown) => CompaniesHouseCliError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAMtE;AAED,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAED,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,sBAa3C,CAAC"}

package/dist/lib/errors.js

@@ -0,0 +1,26 @@
+export class CompaniesHouseCliError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode) {
+        super(message);
+        this.name = "CompaniesHouseCliError";
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+}
+export class CliHandledError extends Error {
+    constructor() {
+        super("CLI error already handled");
+        this.name = "CliHandledError";
+    }
+}
+export const toCliError = (error) => {
+    if (error instanceof CompaniesHouseCliError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new CompaniesHouseCliError(error.message, "unexpected_error");
+    }
+    return new CompaniesHouseCliError("An unexpected error occurred.", "unexpected_error");
+};
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,UAAU,CAAqB;IAE/C,YAAmB,OAAe,EAAE,IAAY,EAAE,UAAmB;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAA0B,EAAE;IACnE,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,sBAAsB,CAC/B,KAAK,CAAC,OAAO,EACb,kBAAkB,CACnB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,sBAAsB,CAAC,+BAA+B,EAAE,kBAAkB,CAAC,CAAC;AACzF,CAAC,CAAC"}

package/dist/lib/formatting.d.ts

@@ -0,0 +1,19 @@
+import type { NormalizedAddress, NormalizedDateOfBirth } from "../types/normalized.js";
+export declare const formatAddress: (address: NormalizedAddress | null) => string | null;
+export declare const formatDateOfBirth: (dateOfBirth: NormalizedDateOfBirth | null) => string | null;
+export declare const formatBoolean: (value: boolean | null, labels: {
+    false: string;
+    true: string;
+}) => string | null;
+export declare const formatList: (values: string[]) => string | null;
+export declare const renderKeyValueRows: (rows: Array<{
+    label: string;
+    value: string | null;
+}>) => string[];
+export declare const renderSection: (title: string, lines: string[]) => string | null;
+export declare const joinSections: (sections: Array<string | null>) => string;
+export declare const renderNumberedBlocks: (items: string[], renderItem: (item: string, index: number) => string[]) => string[];
+export declare const withFallback: (value: string | null, fallback: string) => string;
+export declare const compactRowValues: (...values: Array<string | null>) => string | null;
+export declare const renderPaginationSummary: (returnedCount: number, totalResults: number | null, fetchedAll: boolean) => string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/lib/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/lib/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAKhC,eAAO,MAAM,aAAa,GAAI,SAAS,iBAAiB,GAAG,IAAI,KAAG,MAAM,GAAG,IAC/C,CAAC;AAE7B,eAAO,MAAM,iBAAiB,GAAI,aAAa,qBAAqB,GAAG,IAAI,KAAG,MAAM,GAAG,IACvD,CAAC;AAEjC,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,GAAG,IAAI,EACrB,QAAQ;IACN,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,KACA,MAAM,GAAG,IAMX,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,KAAG,MAAM,GAAG,IACT,CAAC;AAE/C,eAAO,MAAM,kBAAkB,GAC7B,MAAM,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC,KACD,MAAM,EAGsC,CAAC;AAEhD,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,KAAG,MAAM,GAAG,IAMvE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,UAAU,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAG,MACkB,CAAC;AAEjF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,EAAE,EACf,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,KACpD,MAAM,EAUL,CAAC;AAEL,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,GAAG,IAAI,EAAE,UAAU,MAAM,KAAG,MACnD,CAAC;AAEpB,eAAO,MAAM,gBAAgB,GAAI,GAAG,QAAQ,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAG,MAAM,GAAG,IAI3E,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,eAAe,MAAM,EACrB,cAAc,MAAM,GAAG,IAAI,EAC3B,YAAY,OAAO,KAClB,MAOwC,CAAC"}

package/dist/lib/formatting.js

@@ -0,0 +1,41 @@
+const compactStrings = (values) => values.filter((value) => typeof value === "string" && value.length > 0);
+export const formatAddress = (address) => address?.formatted ?? null;
+export const formatDateOfBirth = (dateOfBirth) => dateOfBirth?.formatted ?? null;
+export const formatBoolean = (value, labels) => {
+    if (value === null) {
+        return null;
+    }
+    return value ? labels.true : labels.false;
+};
+export const formatList = (values) => values.length > 0 ? values.join(", ") : null;
+export const renderKeyValueRows = (rows) => rows
+    .filter((row) => row.value !== null)
+    .map((row) => `${row.label}: ${row.value}`);
+export const renderSection = (title, lines) => {
+    if (lines.length === 0) {
+        return null;
+    }
+    return [title, ...lines].join("\n");
+};
+export const joinSections = (sections) => sections.filter((section) => section !== null).join("\n\n");
+export const renderNumberedBlocks = (items, renderItem) => items.flatMap((item, index) => {
+    const lines = renderItem(item, index);
+    const [firstLine, ...restLines] = lines;
+    if (!firstLine) {
+        return [];
+    }
+    return [`${index + 1}. ${firstLine}`, ...restLines.map((line) => `   ${line}`)];
+});
+export const withFallback = (value, fallback) => value ?? fallback;
+export const compactRowValues = (...values) => {
+    const presentValues = compactStrings(values);
+    return presentValues.length > 0 ? presentValues.join(" | ") : null;
+};
+export const renderPaginationSummary = (returnedCount, totalResults, fetchedAll) => totalResults !== null
+    ? fetchedAll
+        ? `Fetched ${returnedCount} of ${totalResults} results.`
+        : `Showing ${returnedCount} of ${totalResults} results.`
+    : fetchedAll
+        ? `Fetched ${returnedCount} results.`
+        : `Showing ${returnedCount} results.`;
+//# sourceMappingURL=formatting.js.map

package/dist/lib/formatting.js.map

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

package/dist/lib/normalizers.d.ts

@@ -0,0 +1,22 @@
+import type { AddressApi, ChargeApiItem, CompanyInsolvencyApiResponse, CompanyProfileApiResponse, CompanySearchApiItem, FilingHistoryApiItem, InsolvencyCaseApi, OfficerApiItem, OfficerAppointmentApiItem, OfficerSearchApiItem, PscApiItem } from "../types/api.js";
+import type { NormalizedAddress, NormalizedCharge, NormalizedCompanyProfile, NormalizedCompanySearchResult, NormalizedDateOfBirth, NormalizedFiling, NormalizedInsolvencyCase, NormalizedOfficer, NormalizedOfficerAppointment, NormalizedPersonSearchResult, NormalizedPsc } from "../types/normalized.js";
+export declare const normalizeAddress: (address: AddressApi | undefined) => NormalizedAddress | null;
+export declare const normalizeDateOfBirth: (dateOfBirth: {
+    day?: number;
+    month?: number;
+    year?: number;
+} | undefined) => NormalizedDateOfBirth | null;
+export declare const normalizeCompanySearchResult: (item: CompanySearchApiItem) => NormalizedCompanySearchResult;
+export declare const normalizeCompanyProfile: (profile: CompanyProfileApiResponse) => NormalizedCompanyProfile;
+export declare const normalizeOfficer: (item: OfficerApiItem) => NormalizedOfficer;
+export declare const normalizeFiling: (item: FilingHistoryApiItem, options?: {
+    includeLinks?: boolean;
+}) => NormalizedFiling;
+export declare const normalizePsc: (item: PscApiItem) => NormalizedPsc;
+export declare const extractOfficerId: (selfLink: string | undefined) => string | null;
+export declare const normalizeOfficerAppointment: (item: OfficerAppointmentApiItem) => NormalizedOfficerAppointment;
+export declare const normalizePersonSearchResult: (item: OfficerSearchApiItem, appointments: NormalizedOfficerAppointment[]) => NormalizedPersonSearchResult;
+export declare const normalizeCharge: (item: ChargeApiItem) => NormalizedCharge;
+export declare const normalizeInsolvencyCase: (insolvencyCase: InsolvencyCaseApi) => NormalizedInsolvencyCase;
+export declare const normalizeInsolvencyCases: (insolvency: CompanyInsolvencyApiResponse | null) => NormalizedInsolvencyCase[];
+//# sourceMappingURL=normalizers.d.ts.map

package/dist/lib/normalizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizers.d.ts","sourceRoot":"","sources":["../../src/lib/normalizers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,4BAA4B,EAC5B,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EAEjB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,UAAU,EACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,EACjB,4BAA4B,EAC5B,4BAA4B,EAC5B,aAAa,EACd,MAAM,wBAAwB,CAAC;AAgBhC,eAAO,MAAM,gBAAgB,GAAI,SAAS,UAAU,GAAG,SAAS,KAAG,iBAAiB,GAAG,IAkCtF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,aACI;IACE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACD,SAAS,KACZ,qBAAqB,GAAG,IAoB1B,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,MAAM,oBAAoB,KACzB,6BAWD,CAAC;AAEH,eAAO,MAAM,uBAAuB,GAClC,SAAS,yBAAyB,KACjC,wBA8BD,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAAI,MAAM,cAAc,KAAG,iBAatD,CAAC;AA0BH,eAAO,MAAM,eAAe,GAC1B,MAAM,oBAAoB,EAC1B,UAAU;IACR,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,KACA,gBAkBF,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,UAAU,KAAG,aAuB9C,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,IAQxE,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,MAAM,yBAAyB,KAC9B,4BAaD,CAAC;AAEH,eAAO,MAAM,2BAA2B,GACtC,MAAM,oBAAoB,EAC1B,cAAc,4BAA4B,EAAE,KAC3C,4BASD,CAAC;AAEH,eAAO,MAAM,eAAe,GAAI,MAAM,aAAa,KAAG,gBAiBpD,CAAC;AAYH,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,iBAAiB,KAChC,wBAWD,CAAC;AAEH,eAAO,MAAM,wBAAwB,GACnC,YAAY,4BAA4B,GAAG,IAAI,KAC9C,wBAAwB,EAA2D,CAAC"}