@happyvertical/smrt-core 0.30.0

package/dist/runtime.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SMRT runtime utilities
+ *
+ * Re-exports runtime functionality from the runtime/ directory.
+ * This file serves as the entry point for @smrt/core/runtime exports.
+ */
+export * from './runtime/index.js';
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,oBAAoB,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,10 @@
+import { createSmrtClient } from "./runtime/client.js";
+import { SmrtMCPServer, createMCPServer } from "./runtime/mcp.js";
+import { createSmrtServer } from "./runtime/server.js";
+export {
+  SmrtMCPServer,
+  createMCPServer,
+  createSmrtClient,
+  createSmrtServer
+};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/scanner/import-scanner.d.ts

@@ -0,0 +1,7 @@
+import { ScannerModule } from '../utils/scanner-module.js';
+interface ImportScannerOptions {
+    missingBuildInstruction: string;
+}
+export declare function importScanner({ missingBuildInstruction, }: ImportScannerOptions): Promise<ScannerModule>;
+export {};
+//# sourceMappingURL=import-scanner.d.ts.map

package/dist/scanner/import-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-scanner.d.ts","sourceRoot":"","sources":["../../src/scanner/import-scanner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,UAAU,oBAAoB;IAC5B,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,aAAa,CAAC,EAClC,uBAAuB,GACxB,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAc/C"}

package/dist/scanner/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Manifest generation for SMRT objects
+ *
+ * Note: AST scanning is now handled by @happyvertical/smrt-scanner package
+ * which uses OXC (Rust-based parser) for 2-3x faster performance.
+ *
+ * For scanning capabilities, import from '@happyvertical/smrt-scanner':
+ *   import { OxcScanner, ManifestAdapter } from '@happyvertical/smrt-scanner';
+ */
+export { generateManifest, ManifestGenerator } from './manifest-generator.js';
+export type { AgentAdminRouteManifest, AgentComponentDeclaration, AgentFeature, AgentManifest, AgentMenuItem, AgentPermission, AgentUISlotManifest, FieldDefinition, MethodDefinition, ScanOptions, ScanResult, SmartObjectDefinition, SmartObjectManifest, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/scanner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/scanner/manifest-generator.d.ts

@@ -0,0 +1,304 @@
+import { ScanResult, SmartObjectManifest, SmrtVisibility } from './types.js';
+export declare class ManifestGenerator {
+    /**
+     * Generate manifest from scan results
+     *
+     * @param scanResults - Array of scan results containing object definitions
+     * @param options - Optional configuration
+     * @param options.packageName - Package name to inject into manifest and object definitions
+     * @param options.packageVersion - Package version
+     * @param options.packageJson - Full package.json object for determining import paths
+     * @param options.smrtDependencies - List of SMRT package dependencies to include in manifest
+     * @param options.includeVisibility - Array of visibility levels to include (default: all)
+     *   - For published packages: ['public']
+     *   - For development: ['public', 'internal', 'test'] or omit for all
+     */
+    generateManifest(scanResults: ScanResult[], options?: {
+        packageName?: string;
+        packageVersion?: string;
+        packageJson?: any;
+        smrtDependencies?: string[];
+        includeVisibility?: SmrtVisibility[];
+    }): SmartObjectManifest;
+    /**
+     * Materialize tenantScoped schema fields.
+     *
+     * Runtime registration already injects tenant fields for
+     * `@smrt({ tenantScoped: true })`, but published manifests must contain the
+     * same field before schema generation so migrations create `tenant_id`.
+     */
+    injectTenantScopedFields(manifest: SmartObjectManifest): void;
+    private injectTenantScopedField;
+    assertTenantScopedSchemaContract(manifest: SmartObjectManifest): void;
+    private getTenantScopedSchemaOwner;
+    private getTenantScopedFieldTypeFailure;
+    private normalizeTenantScopedConfig;
+    /**
+     * Generate pre-computed validation rules for all objects in the manifest.
+     *
+     * This extracts validation constraints (required, min, max, minLength, maxLength, pattern)
+     * from field definitions and stores them as serializable rules in the manifest.
+     *
+     * At runtime, these rules can be evaluated without creating validator closures,
+     * significantly reducing CLI startup time for projects with many SMRT objects.
+     *
+     * @param manifest - The manifest to process in-place
+     */
+    generateValidationRules(manifest: SmartObjectManifest): void;
+    /**
+     * Generate pre-computed schemas for all objects in the manifest.
+     *
+     * This enables external package consumers to use pre-generated schemas
+     * without calling generateSchema() at runtime, eliminating latency.
+     *
+     * IMPORTANT: For STI classes, we aggregate ALL descendants from both local
+     * and external packages to ensure complete schemas are generated.
+     *
+     * This method is public to allow external callers (like OXC scanner) to use it.
+     *
+     * @param manifest - The manifest to process in-place
+     */
+    generateSchemas(manifest: SmartObjectManifest): void;
+    private resolveSamePackageForeignKeyColumnTypes;
+    private findForeignKeyTargetSchema;
+    private getObjectTableName;
+    private refreshManifestSchemaDDL;
+    private computeManifestSchemaVersion;
+    private findDescendantsInManifest;
+    private applySqlTypeOverrides;
+    private getReferenceKind;
+    /**
+     * Create an aggregated manifest that includes objects from all external packages
+     *
+     * This is used for STI schema generation to ensure ALL descendants are found,
+     * regardless of which package they're defined in.
+     *
+     * @param manifest - The local manifest
+     * @returns Aggregated manifest with local + external objects
+     */
+    private createAggregatedManifest;
+    /**
+     * Check if an object is an STI child class (inherits from STI base)
+     *
+     * Walks up the inheritance chain to find if any ancestor has tableStrategy: 'sti'.
+     * Also checks external SMRT packages for parent class definitions.
+     */
+    private isSTIChildClass;
+    /**
+     * Check whether `obj` extends a framework abstract base class anywhere
+     * in its chain.
+     *
+     * Framework abstract bases (`SmrtHierarchical`, `SmrtJunction`, …) have
+     * no table of their own — fields they declare must be merged into every
+     * subclass's manifest, even when the subclass uses CTI. Without this,
+     * a class like `Account extends SmrtHierarchical` would silently lose
+     * `parentId` from its `fields` map and downstream WHERE-clause
+     * validation would reject queries on the inherited column.
+     *
+     * Identified by name against the same hardcoded set the scanner's
+     * `FRAMEWORK_BASE_CLASSES` recognizes (`packages/scanner/src/
+     * inheritance-resolver.ts`). Keep the two lists in sync.
+     */
+    private extendsFrameworkAbstractBase;
+    /**
+     * Find full STI base class info (className + tableName)
+     *
+     * Walks up the inheritance chain to find the STI base class and returns
+     * both its className and tableName. This is critical for external STI bases
+     * where the child needs to use the base's table name for schema generation.
+     */
+    private findSTIBaseInfo;
+    /**
+     * Convert class name to table name (snake_case pluralized)
+     *
+     * IMPORTANT: Must use the same algorithm as runtime's tableNameFromClass()
+     * to ensure manifest-generated table names match runtime-derived names.
+     */
+    private classNameToTableName;
+    private normalizeFrameworkInheritedField;
+    private simpleClassName;
+    /**
+     * Merge inherited fields into child classes (build-time inheritance resolution)
+     *
+     * For STI hierarchies, child classes don't define their own fields in source code
+     * (they inherit from parent). This method merges parent fields into child manifests
+     * so that runtime code doesn't need to do field resolution.
+     *
+     * Also handles collection classes (SmrtCollection<T>) that should inherit their
+     * item class's tableName and collection when the item uses STI.
+     *
+     * Handles multi-level inheritance (grandparents, great-grandparents, etc.)
+     * Automatically loads parent class definitions from external SMRT packages when needed
+     *
+     * @param manifest - The manifest to process in-place
+     */
+    mergeInheritedFields(manifest: SmartObjectManifest): void;
+    /**
+     * Check if a class extends SmrtCollection (directly or indirectly)
+     *
+     * @param obj - The object definition to check
+     * @param objectsByName - Map of className -> objectDef for lookups
+     * @returns true if this class extends SmrtCollection
+     */
+    private extendsCollection;
+    /**
+     * Find the item class for a collection class
+     *
+     * Lookup priority:
+     * 1. extendsTypeArg - Generic type argument from extends clause (e.g., "Meeting" from SmrtCollection<Meeting>)
+     * 2. _itemClass static property - May be captured by AST scanner
+     * 3. Name-based inference - Fallback (e.g., "Meetings" -> "Meeting")
+     *
+     * @param collectionObj - The collection class definition
+     * @param manifest - The manifest
+     * @param objectsByName - Map of className -> objectDef for lookups
+     * @returns Item class definition or undefined
+     */
+    private findItemClass;
+    /**
+     * Check if a class uses STI (either explicitly or inherited from an ancestor)
+     *
+     * Walks up the inheritance chain to find if any ancestor has tableStrategy: 'sti'.
+     * If found, all descendants inherit STI and should have fields merged.
+     * Also checks external SMRT packages for parent class definitions.
+     *
+     * @param obj - The object definition to check
+     * @param objectsByName - Map of className -> objectDef for lookups
+     * @param manifest - The manifest (for accessing smrtDependencies)
+     * @returns true if this class uses STI (directly or inherited)
+     */
+    private isSTIClass;
+    /**
+     * Find the STI base class for a given object
+     *
+     * Walks up the inheritance chain to find the first ancestor that defines
+     * tableStrategy: 'sti'. This is the class that owns the shared table.
+     *
+     * @param obj - The object definition to find the STI base for
+     * @param objectsByName - Map of className -> objectDef for lookups
+     * @param manifest - The manifest (for accessing smrtDependencies)
+     * @returns The STI base class definition, or the object itself if it's the base
+     */
+    private findSTIBase;
+    /**
+     * Load parent class definition from external SMRT packages
+     *
+     * When a child class extends a parent from an external package (e.g., praeco's Council extends
+     * smrt-profiles' Organization), this method loads the parent's manifest and extracts the
+     * parent's field definitions.
+     *
+     * @param parentClassName - Name of the parent class to find
+     * @param smrtDependencies - List of external SMRT packages to search
+     * @param objectsByName - Map to cache loaded external objects
+     * @returns Parent object definition if found, undefined otherwise
+     */
+    private loadParentFromExternalPackage;
+    /**
+     * Determine import path from package.json exports
+     *
+     * Tries the following strategies in order:
+     * 1. package.json exports["./objects"] - Specific objects export
+     * 2. package.json exports["."] - Main export
+     * 3. package.json main - Main field
+     * 4. Fallback to package name
+     */
+    private determineImportPath;
+    /**
+     * Generate TypeScript interfaces from manifest
+     */
+    generateTypeDefinitions(manifest: SmartObjectManifest): string;
+    /**
+     * Generate a single interface definition
+     */
+    private generateInterface;
+    /**
+     * Map field types to TypeScript types
+     */
+    private mapFieldTypeToTS;
+    /**
+     * Generate simple endpoint list for testing/documentation
+     */
+    generateRestEndpoints(manifest: SmartObjectManifest): string;
+    /**
+     * Generate REST endpoint code implementations
+     */
+    generateRestEndpointCode(manifest: SmartObjectManifest): string;
+    /**
+     * Get simple endpoint strings for an object
+     */
+    private getApiRouteMetadata;
+    private getSimpleEndpoints;
+    /**
+     * Generate a single REST endpoint
+     */
+    private generateRestEndpoint;
+    /**
+     * Generate simple MCP tool names for testing/documentation
+     */
+    generateMCPTools(manifest: SmartObjectManifest): string;
+    /**
+     * Generate MCP tool JSON definitions
+     */
+    generateMCPToolsCode(manifest: SmartObjectManifest): string;
+    /**
+     * Get simple MCP tool names for an object
+     */
+    private getSimpleMCPToolNames;
+    /**
+     * Generate a single MCP tool
+     */
+    private generateMCPTool;
+    /**
+     * Generate JSON schema properties for fields
+     */
+    private generateSchemaProperties;
+    /**
+     * Map field types to JSON Schema types
+     */
+    private mapFieldTypeToJSON;
+    /**
+     * Generate agent manifests for Agent subclasses (fifth pass).
+     *
+     * For any SmartObjectDefinition with `agent` in its decoratorConfig,
+     * auto-generates:
+     * - Permissions from uiSlots (manage:*) and CLI/MCP methods (execute:*)
+     * - Features from uiSlots and exposed methods
+     * - Menu items from uiSlots
+     * - Component declarations from package.json exports
+     *
+     * @param manifest - The manifest to process in-place
+     * @param packageName - Package name for component export paths
+     * @param packageJson - Full package.json for component discovery
+     */
+    generateAgentManifests(manifest: SmartObjectManifest, packageName?: string, packageJson?: any): void;
+    /**
+     * Get deduplicated list of method names exposed via CLI and MCP config
+     */
+    private getExposedMethods;
+    /**
+     * Check if an export value has a svelte condition (indicating a component export)
+     */
+    private hasSvelteExport;
+    /**
+     * Save manifest to file
+     */
+    saveManifest(manifest: SmartObjectManifest, filePath: string): void;
+    /**
+     * Load manifest from file
+     */
+    loadManifest(filePath: string): SmartObjectManifest;
+}
+/**
+ * Convenience function to generate manifest
+ *
+ * @param scanResults - Array of scan results containing object definitions
+ * @param options - Optional configuration (passed to ManifestGenerator.generateManifest)
+ */
+export declare function generateManifest(scanResults: ScanResult[], options?: {
+    packageName?: string;
+    packageVersion?: string;
+    packageJson?: any;
+    smrtDependencies?: string[];
+    includeVisibility?: SmrtVisibility[];
+}): SmartObjectManifest;
+//# sourceMappingURL=manifest-generator.d.ts.map

package/dist/scanner/manifest-generator.d.ts.map

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