blockend-cli 2.1.0 → 2.1.1

package/dist/block-install/apply.d.ts

@@ -0,0 +1,2 @@
+import type { AppliedBlock, ApplyBlockOptions, BlockPlan } from "./types.js";
+export declare function applyBlock(plan: BlockPlan, options: ApplyBlockOptions): Promise<AppliedBlock>;

package/dist/block-install/config.d.ts

@@ -0,0 +1,3 @@
+import type { InstalledBlockRecord } from "./types.js";
+export declare function findUp(filename: string, startDir: string): Promise<string | null>;
+export declare function recordInstalledBlock(configPath: string, record: InstalledBlockRecord): Promise<void>;

package/dist/block-install/deps.d.ts

@@ -0,0 +1,7 @@
+export declare function parseDepSpec(dep: string): {
+    name: string;
+    versionRange: string | null;
+};
+export declare function semverSatisfies(installed: string, range: string): boolean;
+export declare function getVersionConflicts(deps: string[], installed: Record<string, string>): string[];
+export declare const getMissingDependencies: (deps: string[], installed: Record<string, string>, forceLatest?: boolean) => string[];

package/dist/block-install/imports.d.ts

@@ -0,0 +1 @@
+export declare function rewriteFileImports(fileContent: string, writtenFilePath: string, blocksRoot: string, aliasBase: string | undefined, strategy: "rewrite" | "remove", downloadedFiles?: Set<string>, blockRoot?: string): string;

package/dist/block-install/index.d.ts

@@ -0,0 +1,9 @@
+export type { AdapterConfig, AppliedBlock, ApplyBlockOptions, AssetMapping, AvailableBlock, BlockPlan, BlockPlanError, BlockPlanErrorCode, BlockPlanResult, BlockManifest, BlockendConfig, EnvironmentConfig, FrameworkName, InstalledBlockRecord, PlanBlockOptions, PreviewBlockOptions, PreviewFile, RegistryManifest, RegistrySource } from "./types.js";
+export { createGitHubRegistrySource, createStaticRegistrySource, loadRegistry, type GitHubRegistrySourceOptions } from "./registry.js";
+export { listAvailableBlocks, planBlock } from "./plan.js";
+export { previewBlock } from "./preview.js";
+export { applyBlock } from "./apply.js";
+export { findUp } from "./config.js";
+export { resolvePreferredVariant, selectVariant } from "./variants.js";
+export { getMissingDependencies, getVersionConflicts, parseDepSpec, semverSatisfies } from "./deps.js";
+export { rewriteFileImports } from "./imports.js";

package/dist/block-install/plan.d.ts

@@ -0,0 +1,3 @@
+import type { AvailableBlock, BlockPlanResult, PlanBlockOptions, RegistryManifest } from "./types.js";
+export declare function planBlock(registry: RegistryManifest, blockName: string, environment: string, options?: PlanBlockOptions): Promise<BlockPlanResult>;
+export declare function listAvailableBlocks(registry: RegistryManifest, environment: string): Promise<AvailableBlock[]>;

package/dist/block-install/preview.d.ts

@@ -0,0 +1,2 @@
+import type { BlockPlan, PreviewBlockOptions, PreviewFile } from "./types.js";
+export declare function previewBlock(plan: BlockPlan, options: PreviewBlockOptions): Promise<PreviewFile[]>;

package/dist/block-install/registry.d.ts

@@ -0,0 +1,11 @@
+import type { BlockManifest, RegistryManifest, RegistrySource } from "./types.js";
+export interface GitHubRegistrySourceOptions {
+    owner?: string;
+    repo?: string;
+    branch?: string;
+    baseUrl?: string;
+}
+export declare function createGitHubRegistrySource(options?: GitHubRegistrySourceOptions): RegistrySource;
+export declare function createStaticRegistrySource(registry: RegistryManifest, files: Record<string, string>): RegistrySource;
+export declare function loadRegistry(source: RegistrySource): Promise<RegistryManifest>;
+export declare function getBlockMap(registry: RegistryManifest): Record<string, BlockManifest>;

package/dist/block-install/types.d.ts

@@ -0,0 +1,94 @@
+import type { AdapterConfig as RegistryAdapterConfig, AssetMapping as RegistryAssetMapping, BlockManifest as RegistryBlockManifest, EnvironmentConfig as RegistryEnvironmentConfig, FrameworkName as RegistryFrameworkName, RegistryManifest as RegistryManifestType } from "@blockend/registry";
+export type AssetMapping = RegistryAssetMapping;
+export type AdapterConfig = RegistryAdapterConfig;
+export type EnvironmentConfig = RegistryEnvironmentConfig;
+export type FrameworkName = RegistryFrameworkName;
+export type BlockManifest = RegistryBlockManifest;
+export type RegistryManifest = RegistryManifestType;
+export interface RegistrySource {
+    fetchRegistry(): Promise<RegistryManifest>;
+    fetchFile(sourcePath: string): Promise<string>;
+}
+export interface InstalledBlockRecord {
+    name: string;
+    version: string;
+    installedAt: string;
+    files: string[];
+    contentHash: string;
+    variant?: string;
+}
+export interface BlockendConfig {
+    $schema: string;
+    environment: FrameworkName | "none";
+    language: "typescript" | "javascript";
+    packageManager: string;
+    importRewriteStrategy: "rewrite" | "remove";
+    includeRedis: boolean;
+    aliases: {
+        blocks?: string;
+    };
+    paths: {
+        blocks: string;
+    };
+    installed?: InstalledBlockRecord[];
+}
+export interface PlanBlockOptions {
+    variant?: string;
+    recordedVariant?: string;
+    targetFolder?: string;
+}
+export interface BlockPlan {
+    blockName: string;
+    block: BlockManifest;
+    environment: string;
+    variant: string;
+    variantKeys: string[];
+    files: AssetMapping[];
+    dependencies: string[];
+    devDependencies: string[];
+}
+export type BlockPlanErrorCode = "not-found" | "unsupported-environment" | "no-adapter" | "no-variants";
+export interface BlockPlanError {
+    code: BlockPlanErrorCode;
+    blockName: string;
+    environment: string;
+    message: string;
+}
+export type BlockPlanResult = {
+    ok: true;
+    plan: BlockPlan;
+} | {
+    ok: false;
+    error: BlockPlanError;
+};
+export interface AvailableBlock {
+    name: string;
+    description: string;
+    variants: string[];
+}
+export interface PreviewFile {
+    name: string;
+    sourcePath: string;
+    targetPath: string;
+    existingContent: string | null;
+    newContent: string;
+    status: "new" | "modified" | "unchanged";
+}
+export interface PreviewBlockOptions {
+    source: RegistrySource;
+    targetFolder: string;
+    onDownloadError?: "throw" | "empty";
+}
+export interface ApplyBlockOptions {
+    source: RegistrySource;
+    blocksRoot: string;
+    aliasBase?: string;
+    rewriteStrategy: "rewrite" | "remove";
+    configPath: string;
+}
+export interface AppliedBlock {
+    block: string;
+    variant: string;
+    files: string[];
+    record: InstalledBlockRecord;
+}

package/dist/block-install/variants.d.ts

@@ -0,0 +1,2 @@
+export declare function selectVariant(variantKeys: string[], preferredVariant?: string): string;
+export declare function resolvePreferredVariant(variantKeys: string[], recordedVariant: string | undefined, targetFolder: string): Promise<string | undefined>;

package/dist/commands/add.d.ts

@@ -1,44 +1,3 @@
-export interface AssetMapping {
-    source: string;
-    target: string;
-}
-export interface AdapterConfig {
-    dependencies?: string[];
-    devDependencies?: string[];
-    files: string[] | AssetMapping[];
-}
-export interface EnvironmentConfig {
-    core?: string;
-    dependencies?: string[];
-    devDependencies?: string[];
-    variants: Record<string, AdapterConfig>;
-}
-export interface BlockManifest {
-    name: string;
-    description: string;
-    version?: string;
-    frameworks?: Array<"express" | "fastify" | "hono" | "next" | "*">;
-    dependencies?: string[];
-    devDependencies?: string[];
-    baseFiles?: AssetMapping[];
-    adapters?: Record<string, EnvironmentConfig>;
-    environments?: Record<string, EnvironmentConfig>;
-}
-export interface RegistryManifest {
-    version?: string;
-    blocks?: Record<string, BlockManifest>;
-    [blockKey: string]: unknown;
-}
-export declare function selectVariant(variantKeys: string[], preferredVariant?: string): string;
-export declare function resolvePreferredVariant(variantKeys: string[], recordedVariant: string | undefined, targetFolder: string): Promise<string | undefined>;
-export declare function parseDepSpec(dep: string): {
-    name: string;
-    versionRange: string | null;
-};
-export declare function semverSatisfies(installed: string, range: string): boolean;
-export declare function getVersionConflicts(deps: string[], installed: Record<string, string>): string[];
-export declare const getMissingDependencies: (deps: string[], installed: Record<string, string>, forceLatest?: boolean) => string[];
-export declare function rewriteFileImports(fileContent: string, writtenFilePath: string, blocksRoot: string, aliasBase: string | undefined, strategy: "rewrite" | "remove", downloadedFiles?: Set<string>): string;
 export declare function addCommand(blockName: string | undefined, options?: {
     yes?: boolean;
     json?: boolean;

package/dist/commands/init.d.ts

@@ -2,26 +2,3 @@ export declare function initCommand(options?: {
     yes?: boolean;
     json?: boolean;
 }): Promise<void>;
-export interface InstalledBlockRecord {
-    name: string;
-    version: string;
-    installedAt: string;
-    files: string[];
-    contentHash: string;
-    variant?: string;
-}
-export type configPayloadType = {
-    $schema: string;
-    environment: "express" | "fastify" | "hono" | "next" | "none";
-    language: "typescript" | "javascript";
-    packageManager: string;
-    importRewriteStrategy: "rewrite" | "remove";
-    includeRedis: boolean;
-    aliases: {
-        blocks?: string;
-    };
-    paths: {
-        blocks: string;
-    };
-    installed?: InstalledBlockRecord[];
-};

package/dist/detectors/alias.d.ts

@@ -0,0 +1,2 @@
+export declare function flattenTsPaths(paths: Record<string, string[]>): Record<string, string>;
+export declare function deriveBlocksAlias(tsPaths: Record<string, string[]>, blocksPhysicalPath: string): string | undefined;

package/dist/detectors/index.d.ts

@@ -1,2 +1,5 @@
 import type { ProjectContext } from "../types/index.js";
-export declare function detectProject(cwd: string): Promise<ProjectContext>;
+export interface DetectProjectOptions {
+    blocksDir?: string;
+}
+export declare function detectProject(cwd: string, options?: DetectProjectOptions): Promise<ProjectContext>;

package/dist/detectors/readers/tsconfig.d.ts

@@ -7,4 +7,8 @@ export interface TsConfig {
         moduleResolution?: string;
     };
 }
-export declare function readTsConfig(cwd: string): Promise<TsConfig | null>;
+export interface CompilerConfig {
+    kind: "tsconfig" | "jsconfig";
+    config: TsConfig;
+}
+export declare function readCompilerConfig(cwd: string): Promise<CompilerConfig | null>;