@emeryld/rrroutes-contract 2.7.13 → 2.8.0

package/dist/export/exportFinalizedLeaves.d.ts

@@ -1,62 +0,0 @@
-import type { AnyLeafLowProfile } from '../core/routesV3.core';
-import type { FinalizedRegistry } from '../core/routesV3.finalize';
-import { type FlatSchemaMap } from './flattenSchema';
-import { type SerializeLeafContractOptions, type SerializedLeafContract } from './serializeLeafContract';
-import { type LeafSourceByKey, type SourceExtractionReason } from './extractLeafSourceByAst';
-export type ExportFinalizedLeavesInput = readonly AnyLeafLowProfile[] | FinalizedRegistry<readonly AnyLeafLowProfile[]>;
-export type ExportFinalizedLeavesMeta = {
-    generatedAt: string;
-    description: string;
-    sourceExtraction?: {
-        mode: 'ast';
-        enabled: boolean;
-        modulePath?: string;
-        exportName?: string;
-        tsconfigPath?: string;
-        resolvedLeafCount: number;
-        reason?: SourceExtractionReason;
-        stats?: {
-            visitedSymbols: number;
-            visitedFiles: number;
-            unresolvedReferences: number;
-        };
-    };
-    fieldCatalog: {
-        leaf: string[];
-        cfg: string[];
-        schemaNode: string[];
-        flatSchemaEntry: string[];
-    };
-    flattening: {
-        notation: 'dot+[]';
-        unionBranchSuffix: '-N';
-        sections: readonly ['params', 'query', 'body', 'output'];
-    };
-};
-export type FinalizedLeavesExport = {
-    _meta: ExportFinalizedLeavesMeta;
-    leaves: SerializedLeafContract[];
-    schemaFlatByLeaf: Record<string, FlatSchemaMap>;
-    sourceByLeaf?: LeafSourceByKey;
-};
-export type ExportFinalizedLeavesOptions = SerializeLeafContractOptions & {
-    outFile?: string;
-    htmlFile?: string;
-    viewerTemplateFile?: string;
-    openOnFinish?: boolean;
-    includeSource?: boolean;
-    tsconfigPath?: string;
-    sourceModulePath?: string;
-    sourceExportName?: string;
-};
-export type WriteFinalizedLeavesExportOptions = {
-    outFile?: string;
-    htmlFile?: string;
-    viewerTemplateFile?: string;
-    openOnFinish?: boolean;
-};
-export declare function writeFinalizedLeavesExport(payload: FinalizedLeavesExport, outFileOrOptions: string | WriteFinalizedLeavesExportOptions): Promise<{
-    outFile?: string;
-    htmlFile?: string;
-}>;
-export declare function exportFinalizedLeaves(input: ExportFinalizedLeavesInput, options?: ExportFinalizedLeavesOptions): Promise<FinalizedLeavesExport>;

package/dist/export/extractLeafSourceByAst.d.ts

@@ -1,38 +0,0 @@
-declare const SCHEMA_KEYS: readonly ["bodySchema", "querySchema", "paramsSchema", "outputSchema", "outputMetaSchema", "queryExtensionSchema"];
-export type SourceExtractionReason = 'module_not_in_program' | 'export_not_found' | 'unsupported_expression_shape' | 'resolved_zero_leaves';
-type SchemaKey = (typeof SCHEMA_KEYS)[number];
-export type LeafSourceLocation = {
-    file: string;
-    line: number;
-    column: number;
-};
-export type SchemaSourceMetadata = LeafSourceLocation & {
-    sourceName?: string;
-    tag?: '<inline>' | '<anonymous>' | '<expression>';
-};
-export type LeafSourceMetadata = {
-    definition: LeafSourceLocation & {
-        symbolName?: string;
-    };
-    schemas: Partial<Record<SchemaKey, SchemaSourceMetadata>>;
-};
-export type LeafSourceByKey = Record<string, LeafSourceMetadata>;
-export type ExtractLeafSourceByAstOptions = {
-    modulePath: string;
-    exportName: string;
-    tsconfigPath?: string;
-    cwd?: string;
-};
-export type ExtractLeafSourceByAstStats = {
-    visitedSymbols: number;
-    visitedFiles: number;
-    unresolvedReferences: number;
-};
-export type ExtractLeafSourceByAstResult = {
-    sourceByLeaf: LeafSourceByKey;
-    tsconfigPath?: string;
-    reason?: SourceExtractionReason;
-    stats: ExtractLeafSourceByAstStats;
-};
-export declare function extractLeafSourceByAst({ modulePath, exportName, tsconfigPath, cwd, }: ExtractLeafSourceByAstOptions): ExtractLeafSourceByAstResult;
-export {};

package/dist/export/flattenSchema.d.ts

@@ -1,12 +0,0 @@
-import type { AnyLeafLowProfile } from '../core/routesV3.core';
-import { type SerializedLeafContract } from './serializeLeafContract';
-import type { SerializableSchema } from './schemaIntrospection';
-export type FlatSchemaEntry = {
-    type: string;
-    nullable: boolean;
-    optional: boolean;
-    literal?: unknown;
-};
-export type FlatSchemaMap = Record<string, FlatSchemaEntry>;
-export declare function flattenSerializableSchema(schema: SerializableSchema | undefined, path: string): FlatSchemaMap;
-export declare function flattenLeafSchemas(leaf: AnyLeafLowProfile | SerializedLeafContract): FlatSchemaMap;

package/dist/export/index.d.ts

@@ -1,7 +0,0 @@
-export * from './schemaIntrospection';
-export * from './serializeLeafContract';
-export * from './flattenSchema';
-export * from './exportFinalizedLeaves';
-export * from './exportFinalizedLeaves.cli';
-export * from './defaultViewerTemplate';
-export * from './extractLeafSourceByAst';

package/dist/export/schemaIntrospection.d.ts

@@ -1,47 +0,0 @@
-import * as z from 'zod';
-export declare const serializableSchemaKinds: readonly ["object", "string", "number", "boolean", "bigint", "date", "array", "enum", "literal", "union", "record", "tuple", "unknown", "any"];
-export type SerializableSchemaKind = (typeof serializableSchemaKinds)[number];
-export type SerializableSchema = {
-    kind: SerializableSchemaKind;
-    optional?: boolean;
-    nullable?: boolean;
-    description?: string;
-    properties?: Record<string, SerializableSchema>;
-    element?: SerializableSchema;
-    union?: SerializableSchema[];
-    literal?: unknown;
-    enumValues?: string[];
-};
-type ZodAny = z.ZodTypeAny;
-type InternalSchemaKind = SerializableSchemaKind | 'intersection';
-type IntrospectionWalker = (schema: ZodAny | undefined) => SerializableSchema | undefined;
-export type IntrospectionContext = {
-    zod: typeof z;
-    introspect: IntrospectionWalker;
-    getDef: (schema: unknown) => any | undefined;
-    unwrap: (schema: ZodAny) => {
-        base: ZodAny;
-        optional: boolean;
-        nullable: boolean;
-    };
-    getDescription: (schema: ZodAny) => string | undefined;
-};
-export type IntrospectionNode = {
-    schema: ZodAny;
-    base: ZodAny;
-    def: any;
-    kind: InternalSchemaKind;
-    optional: boolean;
-    nullable: boolean;
-    node: SerializableSchema;
-};
-export type SchemaIntrospectionHandler = (args: IntrospectionNode, ctx: IntrospectionContext) => SerializableSchema | undefined;
-export type SchemaIntrospectionHandlerMap = Partial<Record<InternalSchemaKind, SchemaIntrospectionHandler>>;
-export type IntrospectSchemaOptions = {
-    handlers?: SchemaIntrospectionHandlerMap;
-};
-export declare function registerSchemaIntrospectionHandler(kind: InternalSchemaKind, handler: SchemaIntrospectionHandler): void;
-export declare function clearSchemaIntrospectionHandlers(): void;
-export declare function createSchemaIntrospector(options?: IntrospectSchemaOptions): IntrospectionWalker;
-export declare function introspectSchema(schema: ZodAny | undefined, options?: IntrospectSchemaOptions): SerializableSchema | undefined;
-export {};

package/dist/export/serializeLeafContract.d.ts

@@ -1,31 +0,0 @@
-import { type AnyLeafLowProfile, type FileField } from '../core/routesV3.core';
-import { type IntrospectSchemaOptions, type SerializableSchema } from './schemaIntrospection';
-export type ContractLeafSchemas = {
-    body?: SerializableSchema;
-    query?: SerializableSchema;
-    params?: SerializableSchema;
-    output?: SerializableSchema;
-    outputMeta?: SerializableSchema;
-    queryExtension?: SerializableSchema;
-};
-export type SerializedLeafContract = {
-    key: string;
-    method: AnyLeafLowProfile['method'];
-    path: string;
-    cfg: {
-        description?: string;
-        summary?: string;
-        docsGroup?: string;
-        tags?: string[];
-        deprecated?: boolean;
-        stability?: 'experimental' | 'beta' | 'stable' | 'deprecated';
-        docsHidden?: boolean;
-        docsMeta?: Record<string, unknown>;
-        feed?: boolean;
-        bodyFiles?: FileField[];
-        schemas: ContractLeafSchemas;
-    };
-};
-export type SerializeLeafContractOptions = IntrospectSchemaOptions;
-export declare function serializeLeafContract(leaf: AnyLeafLowProfile, options?: SerializeLeafContractOptions): SerializedLeafContract;
-export declare function serializeLeavesContract(leaves: readonly AnyLeafLowProfile[], options?: SerializeLeafContractOptions): SerializedLeafContract[];