@contractspec/bundle.workspace 4.5.0 → 4.5.1

package/dist/services/index.d.ts

@@ -35,6 +35,7 @@ export * from './llm/index';
 export * from './module-loader';
 export * as onboarding from './onboarding/index';
 export * from './openapi/index';
+export * as packageDeclarations from './package-declarations/index';
 export * from './package-scaffold';
 export * from './quickstart/index';
 export * from './regenerator';

package/dist/services/package-declarations/helpers.d.ts

@@ -0,0 +1,13 @@
+import type { PackageDeclarationTarget } from '@contractspec/lib.contracts-spec/workspace-config';
+import type { WorkspacePackageKind } from './types';
+export declare function inferWorkspacePackageKind(relativePackageRoot: string): WorkspacePackageKind | null;
+export declare function getCanonicalDeclarationRelativePath(kind: WorkspacePackageKind, packageDirName: string): string;
+export declare function getIndexExportPath(kind: WorkspacePackageKind, packageDirName: string): string;
+export declare function buildPackageDeclarationKey(relativePackageRoot: string): string;
+export declare function buildPackageTitle(packageDirName: string): string;
+export declare function buildDomain(packageDirName: string): string;
+export declare function buildDeclarationTags(packageDirName: string, kind: WorkspacePackageKind, defaultTags: string[]): string[];
+export declare function matchesAllowMissing(allowMissing: string[], relativePackageRoot: string, packageName: string): boolean;
+export declare function normalizePath(value: string): string;
+export declare function toPascalCase(value: string): string;
+export declare function buildExportName(target: PackageDeclarationTarget, packageDirName: string): string;

package/dist/services/package-declarations/index.d.ts

@@ -0,0 +1,5 @@
+export * from './helpers';
+export * from './inventory';
+export * from './render';
+export * from './sync';
+export * from './types';

package/dist/services/package-declarations/inventory.d.ts

@@ -0,0 +1,4 @@
+import type { FsAdapter } from '../../ports/fs';
+import { type PackageDeclarationAuditOptions, type PackageDeclarationAuditResult, type WorkspacePackageInfo } from './types';
+export declare function discoverWorkspacePackages(fs: FsAdapter, options?: PackageDeclarationAuditOptions): Promise<WorkspacePackageInfo[]>;
+export declare function auditPackageDeclarations(fs: FsAdapter, options?: PackageDeclarationAuditOptions): Promise<PackageDeclarationAuditResult[]>;

package/dist/services/package-declarations/render.d.ts

@@ -0,0 +1,41 @@
+import type { WorkspacePackageInfo } from './types';
+export interface PackageSpecRefs {
+    operations: Array<{
+        key: string;
+        version: string;
+    }>;
+    events: Array<{
+        key: string;
+        version: string;
+    }>;
+    presentations: Array<{
+        key: string;
+        version: string;
+    }>;
+    experiments: Array<{
+        key: string;
+        version: string;
+    }>;
+    workflows: Array<{
+        key: string;
+        version: string;
+    }>;
+    dataViews: Array<{
+        key: string;
+        version: string;
+    }>;
+    capabilities: Array<{
+        key: string;
+        version: string;
+    }>;
+    features: Array<{
+        key: string;
+        version: string;
+    }>;
+}
+export declare function renderPackageDeclaration(input: {
+    pkg: WorkspacePackageInfo;
+    refs: PackageSpecRefs;
+    owners: string[];
+    defaultTags: string[];
+}): string;

package/dist/services/package-declarations/sync.d.ts

@@ -0,0 +1,8 @@
+import type { FsAdapter } from '../../ports/fs';
+import { auditPackageDeclarations } from './inventory';
+import { type PackageDeclarationSyncEntry, type PackageDeclarationSyncOptions, type PackageDeclarationSyncResult } from './types';
+export declare function syncPackageDeclarations(fs: FsAdapter, options?: PackageDeclarationSyncOptions): Promise<PackageDeclarationSyncResult>;
+export declare function createPackageDeclarationIssue(entry: PackageDeclarationSyncEntry | Awaited<ReturnType<typeof auditPackageDeclarations>>[number], allowMissing: string[]): {
+    allowlisted: boolean;
+    message: string;
+};

package/dist/services/package-declarations/sync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/package-declarations/types.d.ts

@@ -0,0 +1,48 @@
+import type { PackageDeclarationConfig, PackageDeclarationRequiredByKind, PackageDeclarationTarget, ResolvedContractsrcConfig } from '@contractspec/lib.contracts-spec/workspace-config';
+export type WorkspacePackageKind = 'libs' | 'modules' | 'integrations' | 'bundles' | 'apps' | 'appsRegistry' | 'examples';
+export interface WorkspacePackageDeclarationRequirement {
+    kind: WorkspacePackageKind;
+    target: PackageDeclarationTarget;
+}
+export interface WorkspacePackageInfo {
+    workspaceRoot: string;
+    relativePackageRoot: string;
+    packageRoot: string;
+    packageName: string;
+    packageDirName: string;
+    description?: string;
+    kind: WorkspacePackageKind;
+    target: PackageDeclarationTarget;
+    canonicalDeclarationRelativePath: string;
+    canonicalDeclarationPath: string;
+    indexPath: string;
+    indexExportPath: string;
+}
+export interface PackageDeclarationAuditResult extends WorkspacePackageInfo {
+    exists: boolean;
+    matchesExpectedTarget: boolean;
+    detectedSpecType?: string;
+}
+export interface PackageDeclarationSyncEntry extends PackageDeclarationAuditResult {
+    action: 'created' | 'updated' | 'skipped';
+    declarationCreated: boolean;
+    indexUpdated: boolean;
+    packageJsonUpdated: boolean;
+    dependenciesUpdated: string[];
+}
+export interface PackageDeclarationAuditOptions {
+    config?: ResolvedContractsrcConfig;
+    workspaceRoot?: string;
+}
+export interface PackageDeclarationSyncOptions extends PackageDeclarationAuditOptions {
+    dryRun?: boolean;
+    force?: boolean;
+}
+export interface PackageDeclarationSyncResult {
+    packages: PackageDeclarationSyncEntry[];
+    createdFiles: string[];
+    updatedFiles: string[];
+}
+export declare const DEFAULT_PACKAGE_DECLARATION_REQUIRED_BY_KIND: Required<PackageDeclarationRequiredByKind>;
+export declare const WORKSPACE_PACKAGE_KIND_BY_PREFIX: Readonly<Record<string, WorkspacePackageKind>>;
+export declare function resolvePackageDeclarationConfig(config?: ResolvedContractsrcConfig): PackageDeclarationConfig;

package/dist/services/setup/setup-service.d.ts

@@ -4,9 +4,24 @@
  * Orchestrates the full ContractSpec setup flow.
  * Supports both single projects and monorepos.
  */
+import { findPackageRoot, findWorkspaceRoot, getPackageName, isMonorepo } from '../../adapters/workspace';
 import type { FsAdapter } from '../../ports/fs';
-import type { SetupOptions, SetupPromptCallbacks, SetupResult } from './types';
+import { setupGitignore } from './gitignore';
+import type { SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupTarget } from './types';
+type SetupTargetHandler = (fs: FsAdapter, options: SetupOptions, prompts: SetupPromptCallbacks) => Promise<SetupFileResult>;
+interface SetupWorkspaceAdapters {
+    findWorkspaceRoot: typeof findWorkspaceRoot;
+    findPackageRoot: typeof findPackageRoot;
+    isMonorepo: typeof isMonorepo;
+    getPackageName: typeof getPackageName;
+}
+export interface SetupServiceDeps {
+    targets?: Partial<Record<SetupTarget, SetupTargetHandler>>;
+    workspace?: Partial<SetupWorkspaceAdapters>;
+    setupGitignore?: typeof setupGitignore;
+}
 /**
  * Run the ContractSpec setup.
  */
-export declare function runSetup(fs: FsAdapter, options: SetupOptions, prompts?: SetupPromptCallbacks): Promise<SetupResult>;
+export declare function runSetup(fs: FsAdapter, options: SetupOptions, prompts?: SetupPromptCallbacks, deps?: SetupServiceDeps): Promise<SetupResult>;
+export {};

package/dist/services/test/test-generator-service.d.ts

@@ -1,18 +1,22 @@
 import type { OperationSpec } from '@contractspec/lib.contracts-spec';
 import { type TestSpec } from '@contractspec/lib.contracts-spec/tests';
 import type { LanguageModel } from 'ai';
+import { generateText } from 'ai';
 import type { LoggerAdapter } from '../../ports/logger';
 export interface TestGeneratorOptions {
     model?: LanguageModel;
     maxScenarios?: number;
 }
+type GenerateText = typeof generateText;
 export declare class TestGeneratorService {
     private readonly logger;
     private readonly defaultModel?;
-    constructor(logger: LoggerAdapter, defaultModel?: LanguageModel | undefined);
+    private readonly generateTextImpl;
+    constructor(logger: LoggerAdapter, defaultModel?: LanguageModel | undefined, generateTextImpl?: GenerateText);
     generateTests(spec: OperationSpec<any, any>, // Use any to satisfy generics for now
     options?: TestGeneratorOptions): Promise<TestSpec>;
     private parseResponse;
     private enrichSpec;
     private logUsage;
 }
+export {};

package/dist/services/workspace-info.d.ts

@@ -40,10 +40,13 @@ export interface ExtendedWorkspaceInfo extends WorkspaceInfo {
      */
     packageConfigPath?: string;
 }
+export interface WorkspaceInfoDeps {
+    getWorkspaceInfo?: typeof getWorkspaceInfo;
+}
 /**
  * Get extended workspace information including config paths.
  */
-export declare function getExtendedWorkspaceInfo(fs: FsAdapter, startDir?: string): Promise<ExtendedWorkspaceInfo>;
+export declare function getExtendedWorkspaceInfo(fs: FsAdapter, startDir?: string, deps?: WorkspaceInfoDeps): Promise<ExtendedWorkspaceInfo>;
 /**
  * Find all .contractsrc.json files in a monorepo.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.workspace",
-  "version": "4.5.0",
+  "version": "4.5.1",
   "description": "Workspace utilities for monorepo development",
   "keywords": [
     "contractspec",
@@ -34,16 +34,16 @@
     "@ai-sdk/anthropic": "3.0.68",
     "@ai-sdk/openai": "3.0.52",
     "@contractspec/biome-config": "3.8.8",
-    "@contractspec/integration.runtime": "3.9.2",
-    "@contractspec/lib.ai-agent": "8.0.8",
-    "@contractspec/lib.ai-providers": "3.7.13",
-    "@contractspec/lib.contracts-spec": "5.4.0",
-    "@contractspec/lib.contracts-integrations": "3.8.12",
-    "@contractspec/lib.contracts-transformers": "3.7.20",
-    "@contractspec/lib.surface-runtime": "0.5.20",
-    "@contractspec/lib.source-extractors": "2.7.20",
-    "@contractspec/module.workspace": "4.3.0",
-    "@contractspec/lib.utils-typescript": "3.7.13",
+    "@contractspec/integration.runtime": "3.9.3",
+    "@contractspec/lib.ai-agent": "8.0.9",
+    "@contractspec/lib.ai-providers": "3.7.14",
+    "@contractspec/lib.contracts-spec": "5.5.0",
+    "@contractspec/lib.contracts-integrations": "3.8.13",
+    "@contractspec/lib.contracts-transformers": "3.7.21",
+    "@contractspec/lib.surface-runtime": "0.5.21",
+    "@contractspec/lib.source-extractors": "2.7.21",
+    "@contractspec/module.workspace": "4.3.1",
+    "@contractspec/lib.utils-typescript": "3.7.14",
     "ai": "6.0.156",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
@@ -57,11 +57,11 @@
   },
   "devDependencies": {
     "@contractspec/tool.typescript": "3.7.13",
-    "@types/bun": "^1.3.11",
+    "@types/bun": "^1.3.12",
     "@types/micromatch": "^4.0.10",
     "@types/node": "^25.6.0",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.14"
+    "@contractspec/tool.bun": "3.7.15"
   },
   "exports": {
     ".": {