@checkstack/common

--- package/src/plugin-source.ts (excerpt) ---
import { z } from "zod";

// ─────────────────────────────────────────────────────────────────────────────
// PluginSource — discriminated union describing where a plugin came from.
// One installer per `type`. Persisted on the `plugins` row so fresh-instance
// bootstrap and reinstall can recreate the artifact from the same source.
//
// Lives in `@checkstack/common` (not `backend-api`) so it can be referenced
// from contracts (which must remain importable from frontend & common
// packages).
// ─────────────────────────────────────────────────────────────────────────────

export const npmPluginSourceSchema = z.object({
  type: z.literal("npm"),
  packageName: z.string().min(1),
  version: z.string().optional(),
  registry: z.string().url().optional(),
});
export type NpmPluginSource = z.infer<typeof npmPluginSourceSchema>;

export const tarballPluginSourceSchema = z.object({
  type: z.literal("tarball"),
  /**
   * The plugin_artifacts row id. The tarball bytes themselves live in
   * Postgres — only the artifact reference is stored on the `plugins` row.
   * On fresh-instance bootstrap, this is what's used to re-fetch the bytes.
   */
  artifactId: z.string().min(1),
  /** Original filename for display in the UI. */
  filename: z.string().optional(),
});
export type TarballPluginSource = z.infer<typeof tarballPluginSourceSchema>;

export const githubPluginSourceSchema = z.object({
  type: z.literal("github"),
  owner: z.string().min(1),
  repo: z.string().min(1),
  tag: z

--- package/src/transport-client.ts (excerpt) ---
/**
 * Generic transport client interface for remote command execution.
 *
 * Transport strategies (SSH, SNMP, WinRM) implement this interface to provide
 * a consistent abstraction for collectors.
 *
 * @template TCommand - Command type (e.g., string for SSH, OidRequest for SNMP)
 * @template TResult - Result type (e.g., { stdout, stderr, exitCode } for SSH)
 */
export interface TransportClient<TCommand, TResult> {
  /**
   * Execute a command on the remote host.
   * The command and result types are defined by the transport implementation.
   */
  exec(command: TCommand): Promise<TResult>;
}