@calltelemetry/cli 0.15.1 → 1.0.0

package/dist/lib/openapi.js

@@ -0,0 +1,325 @@
+/**
+ * Runtime OpenAPI helpers for appliance APIs.
+ *
+ * The appliance serves the spec generated during its build at `/api/openapi`
+ * (and `/api/openapi.json`). The CLI reads that spec from the running release
+ * instead of bundling a snapshot, so SFTP commands follow whatever routes and
+ * request shapes the installed appliance actually exposes.
+ */
+export const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete'];
+const ORG_PREFIX = '/api/org/{org_id}/';
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normalizePath(path) {
+    const trimmed = path.trim();
+    if (!trimmed)
+        return '/';
+    return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+}
+export function shortPath(path) {
+    if (path.startsWith(ORG_PREFIX))
+        return path.slice(ORG_PREFIX.length);
+    if (path.startsWith('/api/'))
+        return path.slice(5);
+    return path.replace(/^\//, '');
+}
+/** Resolve `$ref` and merge `allOf` branches into one schema. */
+export function resolveSchema(doc, schema, seen = new Set()) {
+    if (!schema)
+        return undefined;
+    if (schema.$ref) {
+        if (seen.has(schema.$ref))
+            return schema;
+        seen.add(schema.$ref);
+        const ref = schema.$ref;
+        if (ref.startsWith('#/components/schemas/')) {
+            const name = ref.slice('#/components/schemas/'.length);
+            const target = doc.components?.schemas?.[name];
+            if (!target)
+                return schema;
+            return resolveSchema(doc, target, seen);
+        }
+        return schema;
+    }
+    if (schema.allOf && schema.allOf.length > 0) {
+        const merged = {
+            type: 'object',
+            properties: {},
+            required: [],
+        };
+        for (const branch of schema.allOf) {
+            const resolved = resolveSchema(doc, branch, new Set(seen));
+            if (!resolved)
+                continue;
+            if (resolved.type && !merged.type)
+                merged.type = resolved.type;
+            Object.assign(merged.properties, resolved.properties ?? {});
+            if (resolved.required)
+                merged.required.push(...resolved.required);
+            if (resolved.additionalProperties !== undefined) {
+                merged.additionalProperties = resolved.additionalProperties;
+            }
+        }
+        // Keep any sibling keywords from the outer schema.
+        if (schema.properties)
+            Object.assign(merged.properties, schema.properties);
+        if (schema.required)
+            merged.required.push(...schema.required);
+        if (schema.description)
+            merged.description = schema.description;
+        return merged;
+    }
+    return schema;
+}
+function pathTemplateToRegex(path) {
+    const names = [];
+    const escaped = path.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = escaped.replace(/\\\{([^}]+)\\\}/g, (_match, name) => {
+        names.push(name);
+        return '([^/]+)';
+    });
+    return { regex: new RegExp(`^${pattern}$`), names };
+}
+/** Find the best matching path template, including concrete paths with IDs. */
+function findPathTemplate(doc, candidatePath) {
+    const paths = doc.paths ?? {};
+    if (paths[candidatePath])
+        return { template: candidatePath, extractedParams: {} };
+    for (const template of Object.keys(paths)) {
+        const { regex, names } = pathTemplateToRegex(template);
+        const match = regex.exec(candidatePath);
+        if (!match)
+            continue;
+        const extractedParams = {};
+        names.forEach((name, index) => {
+            extractedParams[name] = decodeURIComponent(match[index + 1] ?? '');
+        });
+        return { template, extractedParams };
+    }
+    return null;
+}
+function parseMethodPrefix(ref) {
+    const match = ref.trim().match(/^(GET|POST|PUT|PATCH|DELETE)\s+(.+)$/i);
+    if (!match)
+        return { rest: ref.trim() };
+    const method = match[1].toLowerCase();
+    return { method, rest: match[2].trim() };
+}
+/**
+ * Resolve an operation reference.
+ *
+ * Accepts:
+ *   `sftp_action_accounts/{id}/quota`
+ *   `GET sftp_action_accounts/{id}/quota`
+ *   `GET /api/org/{org_id}/sftp_action_accounts/{id}/quota`
+ *   `sftp_action_accounts/12/quota` (concrete IDs)
+ */
+export function getOperation(doc, ref) {
+    const { method: explicitMethod, rest } = parseMethodPrefix(ref);
+    const candidates = new Set();
+    const normalized = normalizePath(rest);
+    candidates.add(normalized);
+    if (!normalized.startsWith('/api/')) {
+        candidates.add(`/api/${normalized.replace(/^\//, '')}`);
+        candidates.add(`${ORG_PREFIX}${normalized.replace(/^\//, '')}`);
+    }
+    else if (normalized.startsWith('/api/org/') && !normalized.startsWith(ORG_PREFIX)) {
+        // Concrete org ID: /api/org/2/sftp_action_accounts
+        const withoutOrg = normalized.replace(/^\/api\/org\/[^/]+\//, '');
+        candidates.add(`${ORG_PREFIX}${withoutOrg}`);
+    }
+    let match = null;
+    for (const candidate of candidates) {
+        match = findPathTemplate(doc, candidate);
+        if (match)
+            break;
+    }
+    if (!match) {
+        throw new Error(`Operation not found in the appliance OpenAPI spec: ${rest}`);
+    }
+    const pathItem = doc.paths?.[match.template] ?? {};
+    const methods = HTTP_METHODS.filter(candidate => pathItem[candidate] !== undefined);
+    let method = explicitMethod;
+    if (!method) {
+        if (methods.length === 1) {
+            method = methods[0];
+        }
+        else {
+            throw new Error(`Operation "${shortPath(match.template)}" supports multiple methods (${methods
+                .map(m => m.toUpperCase())
+                .join(', ')}). Specify one, e.g. "GET ${shortPath(match.template)}".`);
+        }
+    }
+    const operation = pathItem[method];
+    if (!operation) {
+        throw new Error(`Method ${method.toUpperCase()} is not available for "${shortPath(match.template)}" ` +
+            `on this appliance release (available: ${methods.map(m => m.toUpperCase()).join(', ') || 'none'}).`);
+    }
+    const pathParameters = pathItem.parameters ?? [];
+    const mergedOperation = pathParameters.length > 0
+        ? {
+            ...operation,
+            parameters: [...pathParameters, ...(operation.parameters ?? [])],
+        }
+        : operation;
+    return {
+        path: match.template,
+        shortPath: shortPath(match.template),
+        method,
+        operation: mergedOperation,
+        extractedParams: match.extractedParams,
+    };
+}
+export function hasOperation(doc, ref) {
+    try {
+        getOperation(doc, ref);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function listOperations(doc, options = {}) {
+    const entries = [];
+    const needle = options.contains?.toLowerCase();
+    for (const [path, operations] of Object.entries(doc.paths ?? {})) {
+        if (needle && !path.toLowerCase().includes(needle))
+            continue;
+        for (const method of HTTP_METHODS) {
+            const operation = operations?.[method];
+            if (!operation)
+                continue;
+            entries.push({
+                path,
+                shortPath: shortPath(path),
+                method,
+                operationId: operation.operationId,
+                summary: operation.summary ?? operation.operationId ?? '',
+                tags: operation.tags ?? [],
+                hasBody: operation.requestBody !== undefined,
+            });
+        }
+    }
+    return entries.sort((a, b) => a.shortPath.localeCompare(b.shortPath) || a.method.localeCompare(b.method));
+}
+export function operationPathParams(operation) {
+    return (operation.parameters ?? []).filter(p => p.in === 'path');
+}
+/** Every `{name}` placeholder in a path template, in order. */
+export function pathPlaceholders(path) {
+    return Array.from(path.matchAll(/\{([^}]+)\}/g), match => match[1]);
+}
+export function operationQueryParams(operation) {
+    return (operation.parameters ?? []).filter(p => p.in === 'query');
+}
+export function operationBodyContentType(operation) {
+    const content = operation.requestBody?.content;
+    if (!content)
+        return null;
+    for (const contentType of ['application/json', 'multipart/form-data']) {
+        if (content[contentType]) {
+            return { contentType, schema: content[contentType]?.schema };
+        }
+    }
+    const first = Object.keys(content)[0];
+    if (!first)
+        return null;
+    return { contentType: first, schema: content[first]?.schema };
+}
+export function operationBodySchema(doc, operation) {
+    const body = operationBodyContentType(operation);
+    return resolveSchema(doc, body?.schema);
+}
+function typeMatches(type, value) {
+    if (!type)
+        return true;
+    switch (type) {
+        case 'object':
+            return isObject(value);
+        case 'array':
+            return Array.isArray(value);
+        case 'string':
+            return typeof value === 'string';
+        case 'integer':
+            return typeof value === 'number' && Number.isInteger(value);
+        case 'number':
+            return typeof value === 'number' && Number.isFinite(value);
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'null':
+            return value === null;
+        default:
+            return true;
+    }
+}
+/**
+ * Validate a value against an OpenAPI schema. Returns human-readable errors.
+ * Intentionally permissive for constructs the CLI cannot usefully check.
+ */
+export function validateAgainstSchema(doc, schema, value, path = 'body', depth = 0) {
+    if (!schema || depth > 20)
+        return [];
+    const resolved = resolveSchema(doc, schema);
+    if (!resolved)
+        return [];
+    if (value === null || value === undefined) {
+        return [];
+    }
+    const errors = [];
+    if (resolved.oneOf && resolved.oneOf.length > 0) {
+        const branches = resolved.oneOf.map(branch => validateAgainstSchema(doc, branch, value, path, depth + 1));
+        if (!branches.some(branchErrors => branchErrors.length === 0)) {
+            errors.push(`${path} does not match any allowed shape`);
+        }
+        return errors;
+    }
+    if (resolved.anyOf && resolved.anyOf.length > 0) {
+        const branches = resolved.anyOf.map(branch => validateAgainstSchema(doc, branch, value, path, depth + 1));
+        if (!branches.some(branchErrors => branchErrors.length === 0)) {
+            errors.push(`${path} does not match any allowed shape`);
+        }
+        return errors;
+    }
+    if (resolved.type && !typeMatches(resolved.type, value)) {
+        errors.push(`${path} must be of type ${resolved.type}`);
+        return errors;
+    }
+    if (resolved.enum && !resolved.enum.some(option => option === value)) {
+        errors.push(`${path} must be one of: ${resolved.enum.map(v => JSON.stringify(v)).join(', ')}`);
+    }
+    if (resolved.type === 'object' || resolved.properties) {
+        if (!isObject(value))
+            return errors;
+        for (const requiredKey of resolved.required ?? []) {
+            if (value[requiredKey] === undefined || value[requiredKey] === null) {
+                errors.push(`${path}.${requiredKey} is required`);
+            }
+        }
+        for (const [key, propertySchema] of Object.entries(resolved.properties ?? {})) {
+            if (value[key] === undefined)
+                continue;
+            errors.push(...validateAgainstSchema(doc, propertySchema, value[key], `${path}.${key}`, depth + 1));
+        }
+    }
+    if (resolved.type === 'array' && Array.isArray(value) && resolved.items) {
+        value.forEach((item, index) => {
+            errors.push(...validateAgainstSchema(doc, resolved.items, item, `${path}[${index}]`, depth + 1));
+        });
+    }
+    return errors;
+}
+/** Compact one-line description of a schema's fields, used in errors/help output. */
+export function describeSchema(doc, schema) {
+    const resolved = resolveSchema(doc, schema);
+    if (!resolved)
+        return 'no body';
+    if (resolved.type === 'object' || resolved.properties) {
+        const required = new Set(resolved.required ?? []);
+        return Object.keys(resolved.properties ?? {})
+            .map(key => `${key}${required.has(key) ? '!' : ''}`)
+            .join(', ');
+    }
+    return resolved.type ?? 'unknown';
+}
+//# sourceMappingURL=openapi.js.map

package/dist/lib/openapi.js.map

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

package/dist/lib/sftp.d.ts

@@ -0,0 +1,231 @@
+/**
+ * SFTP Action Account domain helpers.
+ *
+ * Paths and response envelopes here match the appliance OpenAPI contract
+ * (`sftp_action_accounts`, `sftp_monitoring`, `sftp_storage`, ...). Every
+ * command checks the live spec first so a missing route on an older release
+ * produces an actionable message instead of a raw 404.
+ */
+import { ApplianceApi } from './appliance-api.js';
+import { type OpenApiDocument, type ResolvedOperation } from './openapi.js';
+export interface SftpAction {
+    type: string;
+    target?: string | null;
+    params?: Record<string, unknown> | null;
+}
+export interface SftpAccount {
+    id: number;
+    org_id: number;
+    username: string;
+    enabled: boolean;
+    home?: string;
+    description?: string | null;
+    on_success_actions?: SftpAction[] | null;
+    on_failure_actions?: SftpAction[] | null;
+    quota_used_bytes?: number | null;
+    quota_limit_gb?: number | string | null;
+    last_quota_calculated_at?: string | null;
+    upload_monitoring_enabled?: boolean;
+    expected_schedule?: string | null;
+    expected_next_upload_at?: string | null;
+    last_upload_at?: string | null;
+    missed_upload_count?: number;
+    alert_on_missed_uploads?: boolean;
+    inserted_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+export interface SftpQuota {
+    quota_used_bytes?: number | null;
+    quota_limit_gb?: number | string | null;
+    quota_percentage?: number | null;
+    over_quota?: boolean;
+    last_calculated_at?: string | null;
+}
+export interface SftpStorageStatus {
+    total_used_bytes?: number;
+    total_limit_gb?: number | string | null;
+    account_count?: number;
+    accounts_over_quota?: number;
+}
+export interface SftpRun {
+    id: number;
+    action_account_id?: number;
+    username?: string;
+    status?: string;
+    type?: string;
+    event?: string;
+    file?: string | null;
+    result?: unknown;
+    inserted_at?: string;
+    updated_at?: string;
+}
+export interface SftpActivity {
+    id: number;
+    action?: string;
+    status?: string;
+    actor_ip?: string | null;
+    target_type?: string | null;
+    target_id?: string | null;
+    error_message?: string | null;
+    metadata?: Record<string, unknown> | null;
+    inserted_at?: string;
+}
+export interface SftpFileEntry {
+    name: string;
+    path: string;
+    type: 'file' | 'directory' | string;
+    size?: number | null;
+    modified_at?: string | null;
+}
+export interface SftpMonitoringConfig {
+    enabled?: boolean;
+    schedule?: {
+        type?: string;
+        hour?: number | null;
+        minute?: number | null;
+        day_of_week?: number | null;
+        day_of_month?: number | null;
+        weekdays_only?: boolean;
+    };
+    config?: {
+        alert_on_missed_uploads?: boolean;
+        tolerance_minutes?: number;
+        alert_threshold?: number;
+        alert_config?: Record<string, unknown>;
+    };
+    expected_next_upload_at?: string | null;
+    last_upload_at?: string | null;
+    missed_upload_count?: number;
+}
+export interface SftpMonitoredAccount {
+    id: number;
+    org_id?: number;
+    username: string;
+    enabled?: boolean;
+    monitoring?: SftpMonitoringConfig;
+}
+export interface SftpContact {
+    id: number;
+    name?: string;
+    email?: string;
+    phone?: string;
+    [key: string]: unknown;
+}
+export interface SftpReportSchedule {
+    id: number;
+    enabled?: boolean;
+    schedule_type?: string;
+    next_run_at?: string | null;
+    last_run_at?: string | null;
+    last_run_status?: string | null;
+    last_run_error?: string | null;
+    failure_count?: number;
+    [key: string]: unknown;
+}
+/** Assert the installed release exposes an operation, with a release-aware error. */
+export declare function requireOperation(spec: OpenApiDocument, ref: string): ResolvedOperation;
+export declare function supportsOperation(spec: OpenApiDocument, ref: string): boolean;
+export declare const ACCOUNT_USERNAME_PATTERN: RegExp;
+export declare function validateUsername(username: string): void;
+export declare function generateSftpPassword(length?: number): string;
+export declare function parseQuotaGb(value: string | undefined): number | null | undefined;
+/**
+ * Parse repeated `--on-success` / `--on-failure` values.
+ * Accepts a bare action type, an inline JSON object, or `@file` containing a
+ * JSON object or array of objects.
+ */
+export declare function parseActionOptions(values: string[] | undefined): SftpAction[] | undefined;
+export interface CreateAccountInput {
+    username: string;
+    password?: string;
+    generatePassword?: boolean;
+    description?: string;
+    enabled?: boolean;
+    quotaGb?: string;
+    callmanagerId?: string;
+    onSuccess: string[];
+    onFailure: string[];
+}
+export interface AccountPayloadResult {
+    account: Record<string, unknown>;
+    generatedPassword?: string;
+}
+export declare function buildCreateAccountPayload(input: CreateAccountInput): AccountPayloadResult;
+export interface UpdateAccountInput {
+    description?: string;
+    quotaGb?: string;
+    callmanagerId?: string;
+    enable?: boolean;
+    disable?: boolean;
+    password?: string;
+    generatePassword?: boolean;
+    onSuccess: string[];
+    onFailure: string[];
+    clearSuccess?: boolean;
+    clearFailure?: boolean;
+}
+export declare function buildUpdateAccountPayload(input: UpdateAccountInput): AccountPayloadResult;
+export declare function listAccounts(api: ApplianceApi): Promise<SftpAccount[]>;
+export declare function resolveAccount(api: ApplianceApi, ref: string): Promise<SftpAccount>;
+export declare function getAccountQuota(api: ApplianceApi, account: SftpAccount): Promise<SftpQuota>;
+export declare function getAccountRuns(api: ApplianceApi, account: SftpAccount, limit?: number, offset?: number): Promise<SftpRun[]>;
+export declare function getAccountActivity(api: ApplianceApi, account: SftpAccount, limit?: number, offset?: number): Promise<SftpActivity[]>;
+export declare function getAccountFiles(api: ApplianceApi, account: SftpAccount, path?: string, limit?: number): Promise<{
+    path?: string;
+    total?: number;
+    entries: SftpFileEntry[];
+}>;
+export declare function getAccountContacts(api: ApplianceApi, account: SftpAccount): Promise<SftpContact[]>;
+export declare function addAccountContacts(api: ApplianceApi, account: SftpAccount, contactIds: number[]): Promise<unknown>;
+export declare function removeAccountContact(api: ApplianceApi, account: SftpAccount, contactId: number): Promise<unknown>;
+export interface MonitoringInput {
+    schedule?: string;
+    hour?: string;
+    minute?: string;
+    dayOfWeek?: string;
+    dayOfMonth?: string;
+    weekdaysOnly?: boolean;
+    tolerance?: string;
+    threshold?: string;
+    alertOnMissed?: boolean;
+    alertConfig?: string;
+}
+export declare function buildMonitoringPayload(input: MonitoringInput, requireSchedule: boolean): Record<string, unknown>;
+export declare function listMonitoredAccounts(api: ApplianceApi): Promise<SftpMonitoredAccount[]>;
+export declare function getAccountMonitoring(api: ApplianceApi, account: SftpAccount): Promise<SftpMonitoringConfig>;
+export interface DiscoverMonitoringInput {
+    host?: string;
+    username?: string;
+    password?: string;
+    scheduleName?: string;
+    callmanagerId?: string;
+    tolerance?: string;
+}
+export declare function buildDiscoverPayload(input: DiscoverMonitoringInput): Record<string, unknown>;
+export interface SftpStatusSnapshot {
+    accounts: {
+        total: number;
+        enabled: number;
+        disabled: number;
+    };
+    storage: SftpStorageStatus | null;
+    monitoring: {
+        available: boolean;
+        monitoredCount: number;
+        missingUploads: number | null;
+    };
+    operations: {
+        total: number;
+        specOpenApi: string | null;
+    };
+}
+export declare function collectSftpStatus(api: ApplianceApi, spec: OpenApiDocument): Promise<SftpStatusSnapshot>;
+/** Read a CSV or JSON file for import. */
+export declare function readImportFile(path: string): {
+    filename: string;
+    data: Buffer;
+    contentType: string;
+};
+export declare function parseContactIds(values: string[] | undefined): number[];
+//# sourceMappingURL=sftp.d.ts.map

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

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