veryfront/extensions

Import

import {
  auditCapabilities,
  detectConflicts,
  discoverLocalExtensions,
  discoverPackageExtensions,
  discoverProjectExtensions,
  formatCapabilities,
} from "veryfront/extensions";

Examples

import { orchestrateExtensions } from "veryfront/extensions";

const loader = await orchestrateExtensions({
  projectDir: Deno.cwd(),
  config,
  logger,
});

// Later, on shutdown:
await loader.teardownAll();

Exports

Components

Name	Description	Source
`CIRCULAR_DEPENDENCY_ERROR`	Shared circular dependency error value.	source
`EXTENSION_CONFLICT_ERROR`	Shared extension conflict error value.	source
`EXTENSION_VALIDATION_ERROR`	Shared extension validation error value.	source
`MISSING_EXTENSION_ERROR`	Shared missing extension error value.	source
`SandboxShellToolsProviderName`	Render sandbox shell tools provider name.	source

Functions

Name	Description	Source
`auditCapabilities`	Log capabilities for a named extension at startup.	source
`detectConflicts`	Detect contract conflicts between resolved extensions.	source
`discoverLocalExtensions`	Find `*.extension.ts` files in the project root.	source
`discoverPackageExtensions`	Scan `node_modules` (including `@scoped` packages) for packages that declare veryfront extension metadata in their `package.json`.	source
`discoverProjectExtensions`	Discover project extensions living under `extensions/` in the project root.	source
`formatCapabilities`	Format capabilities as human-readable strings for logging.	source
`getRecommendation`	Return recommendation.	source
`loadExtensionFactory`	Dynamically import an extension factory from `path` and resolve it.	source
`mapToDenoPermissions`	Map capabilities to Deno CLI permission flags. Skips capabilities without a Deno permission mapping.	source
`mergeExtensions`	Merge extensions from all four sources in priority order.	source
`orchestrateExtensions`	Run the full extension pipeline against a resolved project config.	source
`parsePackageMetadata`	Parse veryfront extension metadata from a package.json-like object.	source
`resolve`	Resolve path segments to an absolute path.	source
`tryResolve`	Try to resolve.	source
`validateExtension`	Validate the shape of an extension object. Returns an array of issue descriptions (empty array = valid).	source

Classes

Name	Description	Source
`ExtensionLoader`	Implement extension loader.	source

Types

Name	Description	Source
`Capability`	Declares a system capability an extension requires. Object-based for extensibility — scoping fields vary by type.	source
`ConflictInfo`	Information about a contract conflict between extensions.	source
`CreateSandboxShellToolsInput`	Input payload for create sandbox shell tools.	source
`Extension`	Public API contract for extension.	source
`ExtensionConfigEntry`	Entry shape for extension config.	source
`ExtensionContext`	Context for extension.	source
`ExtensionContractMetadata`	Public API contract for extension contract metadata.	source
`ExtensionFactory`	Public API contract for extension factory.	source
`ExtensionLogger`	Public API contract for extension logger.	source
`ExtensionSource`	Public API contract for extension source.	source
`OrchestrateOptions`	Options for `orchestrateExtensions`.	source
`PackageMetadata`	Metadata extracted from a package.json that declares itself as a veryfront extension.	source
`ResolvedExtension`	Public API contract for resolved extension.	source
`SandboxShellClient`	Public API contract for sandbox shell client.	source
`SandboxShellToolDefinition`	Definition for sandbox shell tool.	source
`SandboxShellToolExecute`	Public API contract for sandbox shell tool execute.	source
`SandboxShellToolSet`	Public API contract for sandbox shell tool set.	source
`SandboxShellToolsProvider`	Public API contract for sandbox shell tools provider.	source

Deep imports

These import paths group focused functionality under this module. Each is a separate barrel; import only what you need.

`veryfront/extensions/auth`

Auth category barrel - AuthProvider contract and token shapes.

import "veryfront/extensions/auth";

Types

Name	Description	Source
`AuthProvider`	AuthProvider contract interface.	source
`SignOptions`	Options for signing a token.	source
`TokenHeader`	The parsed, unverified header of a JWT.	source
`TokenPayload`	Payload data stored within a signed token.	source
`VerifyOptions`	Options for verifying a token.	source

`veryfront/extensions/bundler`

Bundler category barrel - Bundler contract, module lexer, and resolver helper.

import { build, context, getBundler } from "veryfront/extensions/bundler";

Functions

Name	Description	Source
`build`	Convenience wrapper: `bundler.bundle(opts)`.	source
`context`	Create an incremental build context (watch/rebuild mode).	source
`getBundler`	Resolve the registered `Bundler` contract. Throws if no extension provides it.	source
`stop`	Stop the bundler. Optional - extension teardown will also call this. Provided so tests that previously called `esbuild.stop()` keep working.	source
`transform`	Convenience wrapper that mirrors esbuild’s `transform(code, options)` positional signature so call-sites migrating off esbuild keep their shape.	source

Types

Name	Description	Source
`BuildContext`	Incremental/rebuild context produced by `Bundler.context`.	source
`BuildFailure`	Failure thrown by `Bundler.bundle` or `Bundler.transform`.	source
`BuildOptions`	Options passed to `Bundler.bundle`.	source
`BuildResult`	Result returned from `Bundler.bundle`.	source
`BundleOptions`	Options passed to `Bundler.bundle`.	source
`BundleOutput`	A single output file produced by a bundle operation.	source
`Bundler`	Bundler contract interface.	source
`BundleResult`	Result returned from `Bundler.bundle`.	source
`BundlerMessage`	A diagnostic message (error or warning) from a bundler.	source
`BundlerMessageLocation`	Location of an error or warning in source.	source
`BundlerPlugin`	A bundler plugin that hooks into the build pipeline.	source
`BundlerPluginBuild`	Build context exposed to bundler plugins.	source
`ImportSpecifier`	A single import specifier position record, matching the shape produced by `es-module-lexer`.	source
`Loader`	Loader hint for source files. Mirrors esbuild’s `Loader` type.	source
`Message`	A diagnostic message (error or warning) from a bundler.	source
`Metafile`	Dependency-graph metadata produced by a bundler when `metafile: true`.	source
`MetafileInput`	Input file entry in a `Metafile`.	source
`MetafileOutput`	Output file entry in a `Metafile`.	source
`ModuleLexer`	Module lexer contract interface.	source
`OnLoadArgs`	Arguments passed to an `onLoad` callback.	source
`OnLoadResult`	Result returned from an `onLoad` callback.	source
`OnResolveArgs`	Arguments passed to an `onResolve` callback.	source
`OnResolveResult`	Result returned from an `onResolve` callback.	source
`Plugin`	A bundler plugin that hooks into the build pipeline.	source
`PluginBuild`	Build context exposed to bundler plugins.	source
`ResolveResult`	Result returned from an `onResolve` callback.	source
`StdinOptions`	In-memory source input for `BundleOptions.stdin`.	source
`TransformOptions`	Options passed to `Bundler.transform`.	source
`TransformResult`	Result returned from `Bundler.transform`.	source

`veryfront/extensions/cache`

Cache category barrel - generic cache and proxy-grade token cache.

import "veryfront/extensions/cache";

Types

Name	Description	Source
`CacheStore`	CacheStore contract interface.	source
`TokenCacheEntry`	A cache entry stored by `TokenCacheStore`.	source
`TokenCacheStats`	Aggregate usage statistics for a `TokenCacheStore`.	source
`TokenCacheStore`	TokenCacheStore contract interface.	source

`veryfront/extensions/compat`

Compat category barrel - optional native runtime services.

import "veryfront/extensions/compat";

Types

Name	Description	Source
`DocumentExtractor`	Document extraction contract.	source
`KreuzbergExtractor`	Shape returned by the kreuzberg document-extraction module.	source
`SqliteDatabase`	Minimal interface for a SQLite database connection, compatible with `better-sqlite3`’s `Database` shape as consumed by `SqliteKv`.	source
`SqliteStatement`	Minimal interface for a prepared SQLite statement, compatible with `better-sqlite3`’s `Statement` shape.	source
`SqliteStore`	SQLite-backed storage contract.	source

`veryfront/extensions/content`

Content category barrel for the MDX/Markdown content processor contract.

import "veryfront/extensions/content";

Types

Name	Description	Source
`CompilationMode`	Compilation mode. Dev surfaces extra diagnostics.	source
`CompilationTarget`	Where the output is destined: server-side RSC or browser bundle.	source
`ContentCompileOptions`	Options for `ContentProcessor.compileMdx` and `ContentProcessor.compileMarkdown`.	source
`ContentPlugin`	Opaque unified-compatible plugin entry. Kept as `unknown[]	unknown`so the contract surface doesn't require consumers to depend on the`unified` package directly. Callers cast to the plugin-list shape they need.	source
`ContentProcessingResult`	Processing result returned by the content pipeline.	source
`ContentProcessor`	ContentProcessor contract for MDX/Markdown processing.	source

`veryfront/extensions/contracts`

Contract registry - runtime resolution of extension-provided implementations.

import { register, reset, resolve } from "veryfront/extensions/contracts";

Functions

Name	Description	Source
`register`	Register.	source
`reset`	Reset.	source
`resolve`	Resolve path segments to an absolute path.	source
`tryResolve`	Try to resolve.	source
`unregister`	Unregister.	source

`veryfront/extensions/css`

CSS category barrel - CSS processor and compiler contracts.

import "veryfront/extensions/css";

Types

Name	Description	Source
`CSSCompileOptions`	Options passed to `CSSProcessor.compile`.	source
`CSSCompiler`	Stateful compiler returned by `CSSProcessor.compile`.	source
`CSSModuleSource`	A loaded module (Tailwind plugin). `module` is the plugin’s default export.	source
`CSSProcessor`	CSSProcessor contract interface.	source
`CSSStylesheetSource`	A loaded stylesheet body with the base path used to resolve relative imports.	source

`veryfront/extensions/database`

Database category barrel - DatabaseClient contract.

import "veryfront/extensions/database";

Types

Name	Description	Source
`DatabaseClient`	DatabaseClient contract interface.	source
`QueryResult`	Result returned from `DatabaseClient.query`.	source

`veryfront/extensions/llm`

LLM category barrel - provider, embedding, and registry contracts. Interfaces re-exported with export type { ... } because Deno --no-check transpiles each file in isolation and would otherwise emit a runtime value re-export that fails ESM resolution. Reserve plain export { ... } for runtime values.

import { createLLMProviderRegistry, LLMProviderRegistryName } from "veryfront/extensions/llm";

Components

Name	Description	Source
`LLMProviderRegistryName`	Contract name used for `resolve()` / `provide()`.	source

Functions

Name	Description	Source
`createLLMProviderRegistry`	Create llmprovider registry.	source

Types

Name	Description	Source
`EmbeddingOptions`	Options passed to `EmbeddingProvider.embed`.	source
`EmbeddingProvider`	EmbeddingProvider contract interface.	source
`EmbeddingResult`	Result returned from `EmbeddingProvider.embed`.	source
`LLMProvider`	An LLM provider implementation. Extensions register one of these with the `LLMProviderRegistry` during setup(). `createModel` is required; `createEmbedding` and `createResponses` are optional and absent on providers that don’t support them.	source
`LLMProviderConfig`	Config passed to any provider’s create* method.	source
`LLMProviderRegistry`	Registry contract. Single impl created at bootstrap.	source

`veryfront/extensions/observability`

Observability category barrel: tracing and Node telemetry contracts.

import { NodeTelemetryProviderName } from "veryfront/extensions/observability";

Components

Name	Description	Source
`NodeTelemetryProviderName`	Contract interface for Node.js OpenTelemetry runtime bootstrap.	source

Types

Name	Description	Source
`NodeTelemetryInitializeOptions`	Options accepted by node telemetry initialize.	source
`NodeTelemetryInstrumentationConfig`	Configuration used by node telemetry instrumentation.	source
`NodeTelemetryLogger`	Public API contract for node telemetry logger.	source
`NodeTelemetryProcessTarget`	Public API contract for node telemetry process target.	source
`NodeTelemetryProvider`	Initializes Node-specific OpenTelemetry SDK behavior.	source
`SpanData`	Data describing a single trace span.	source
`TracerProvider`	Minimal TracerProvider interface for the contract. Structurally compatible with both the core shim and the real OTel SDK.	source
`TracingExporter`	TracingExporter contract interface.	source

`veryfront/extensions/parser`

Parser category barrel - CodeParser (AST traversal) contract.

import "veryfront/extensions/parser";

Types

Name	Description	Source
`ASTNode`	A single node in an abstract syntax tree.	source
`CodeParser`	Public API contract for code parser.	source
`GenerateOptions`	Options passed to `CodeParser.generate`.	source
`GenerateResult`	Result returned from `CodeParser.generate`.	source
`InjectJsxNodePositionsOptions`	Options for `CodeParser.injectJsxNodePositions`.	source
`NodePath`	Wrapper providing traversal context for a visited node.	source
`ParseOptions`	Options passed to `CodeParser.parse`.	source
`TraverseVisitor`	Visitor callbacks keyed by node type.	source

`veryfront/extensions/sandbox`

Sandbox category barrel.

import { SandboxShellToolsProviderName } from "veryfront/extensions/sandbox";

Components

Name	Description	Source
`SandboxShellToolsProviderName`	Render sandbox shell tools provider name.	source

Types

Name	Description	Source
`CreateSandboxShellToolsInput`	Input payload for create sandbox shell tools.	source
`SandboxShellClient`	Public API contract for sandbox shell client.	source
`SandboxShellToolDefinition`	Definition for sandbox shell tool.	source
`SandboxShellToolExecute`	Public API contract for sandbox shell tool execute.	source
`SandboxShellToolSet`	Public API contract for sandbox shell tool set.	source
`SandboxShellToolsProvider`	Public API contract for sandbox shell tools provider.	source

`veryfront/extensions/schema`

Schema category barrel - SchemaValidator contract and inference helpers.

import "veryfront/extensions/schema";

Types

Name	Description	Source
`InferInput`	Extracts the inferred input type from a `Schema<T>`.	source
`InferSchema`	Extracts the inferred output type `T` from a `Schema<T>`.	source
`InferShape`	Maps a raw object shape to its inferred object type, preserving optionality.	source
`JsonSchema`	Minimal JSON Schema type used by the `SchemaValidator` contract for `toJsonSchema()`. Kept in the extensions/schema category so the contract can reference it without depending on any non-leaf module.	source
`RefinementCtx`	Context passed to a `superRefine` callback. Provides `addIssue` to emit one or more validation issues and `path` to locate the current value.	source
`Schema`	An opaque schema definition that validates and infers type `T`.	source
`SchemaFactory`	Factory type accepted by `defineSchema`.	source
`SchemaValidator`	SchemaValidator contract interface.	source
`SchemaValidatorCoerce`	Namespace for `coerce.*` constructors - accepts input in any form and coerces to the target type before validation.	source
`ValidationFailure`	Failed validation outcome.	source
`ValidationIssue`	A single validation issue with location context.	source
`ValidationResult`	Discriminated union of validation outcomes.	source
`ValidationSuccess`	Successful validation outcome.	source

​Import

​Examples

​Exports

​Components

​Functions

​Classes

​Types

​Deep imports

​veryfront/extensions/auth

​Types

​veryfront/extensions/bundler

​Functions

​Types

​veryfront/extensions/cache

​Types

​veryfront/extensions/compat

​Types

​veryfront/extensions/content

​Types

​veryfront/extensions/contracts

​Functions

​veryfront/extensions/css

​Types

​veryfront/extensions/database

​Types

​veryfront/extensions/llm

​Components

​Functions

​Types

​veryfront/extensions/observability

​Components

​Types

​veryfront/extensions/parser

​Types

​veryfront/extensions/sandbox

​Components

​Types

​veryfront/extensions/schema

​Types

Import

Examples

Exports

Components

Functions

Classes

Types

Deep imports

`veryfront/extensions/auth`

Types

`veryfront/extensions/bundler`

Functions

Types

`veryfront/extensions/cache`

Types

`veryfront/extensions/compat`

Types

`veryfront/extensions/content`

Types

`veryfront/extensions/contracts`

Functions

`veryfront/extensions/css`

Types

`veryfront/extensions/database`

Types

`veryfront/extensions/llm`

Components

Functions

Types

`veryfront/extensions/observability`

Components

Types

`veryfront/extensions/parser`

Types

`veryfront/extensions/sandbox`

Components

Types

`veryfront/extensions/schema`

Types