@pattern-stack/frontend-patterns 0.1.2 → 0.1.3

package/dist/atoms/utils/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAG5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAGD,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAG5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAGD,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7D,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/codegen/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Code Generation Utilities
+ *
+ * Build-time tools for generating code from specifications
+ */
+export * from './openapi';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,WAAW,CAAC"}

package/dist/codegen/openapi/bulk-hook-generator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Bulk Operations Hook Generator
+ *
+ * Generates specialized React hooks for bulk operations with proper typing,
+ * error handling, and progress tracking.
+ *
+ * Part of FRO-35: Bulk Operations Hook Generation
+ */
+import type { ParsedEndpoint } from './parser';
+export declare class BulkHookGenerator {
+    /**
+     * Generate a bulk mutation hook with progress tracking and retry logic
+     */
+    generateBulkMutationHook(endpoint: ParsedEndpoint, hookName: string, operationName: string): string;
+    /**
+     * Generate optimistic updates for bulk operations
+     */
+    private generateBulkOptimisticUpdate;
+    /**
+     * Generate cache invalidation for bulk operations
+     */
+    private generateBulkCacheInvalidation;
+    /**
+     * Generate bulk mutation hook name
+     */
+    generateBulkMutationHookName(endpoint: ParsedEndpoint, resourceName: string): string | null;
+    /**
+     * Check if endpoint is a bulk operation
+     */
+    isBulkEndpoint(endpoint: ParsedEndpoint): boolean;
+    /**
+     * Helper to convert to camelCase
+     */
+    private camelCase;
+    /**
+     * Helper to capitalize string
+     */
+    private capitalize;
+}
+//# sourceMappingURL=bulk-hook-generator.d.ts.map

package/dist/codegen/openapi/bulk-hook-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-hook-generator.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/bulk-hook-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAO9C,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAgHnG;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAkFpC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAQrC;;OAEG;IACH,4BAA4B,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAgB3F;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAKjD;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,UAAU;CAWnB"}

package/dist/codegen/openapi/bulk-types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Bulk Operations Types
+ *
+ * Standard types for bulk operations in generated hooks
+ * Part of FRO-35: Bulk Operations Hook Generation
+ */
+/**
+ * Standard bulk operation request format
+ */
+export interface BulkOperationRequest<T = unknown> {
+    /** Array of IDs to operate on */
+    ids: Array<string | number>;
+    /** Optional additional data for the operation */
+    data?: T;
+    /** Optional operation-specific options */
+    options?: BulkOperationOptions;
+}
+/**
+ * Options for bulk operations
+ */
+export interface BulkOperationOptions {
+    /** Continue processing if some items fail */
+    continueOnError?: boolean;
+    /** Batch size for processing */
+    batchSize?: number;
+    /** Progress callback */
+    onProgress?: (progress: BulkOperationProgress) => void;
+}
+/**
+ * Progress tracking for bulk operations
+ */
+export interface BulkOperationProgress {
+    /** Total number of items to process */
+    total: number;
+    /** Number of items processed so far */
+    processed: number;
+    /** Number of successful operations */
+    succeeded: number;
+    /** Number of failed operations */
+    failed: number;
+    /** Percentage complete (0-100) */
+    percentage: number;
+    /** Current status */
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+}
+/**
+ * Standard bulk operation response format
+ */
+export interface BulkOperationResponse<T = unknown> {
+    /** Overall operation success */
+    success: boolean;
+    /** Results for successful operations */
+    succeeded: BulkOperationResult<T>[];
+    /** Results for failed operations */
+    failed: BulkOperationError[];
+    /** Summary statistics */
+    summary: BulkOperationSummary;
+}
+/**
+ * Individual result for a successful bulk operation
+ */
+export interface BulkOperationResult<T = unknown> {
+    /** ID of the processed item */
+    id: string | number;
+    /** Result data */
+    data?: T;
+    /** Operation-specific message */
+    message?: string;
+}
+/**
+ * Individual error for a failed bulk operation
+ */
+export interface BulkOperationError {
+    /** ID of the failed item */
+    id: string | number;
+    /** Error code */
+    code?: string;
+    /** Error message */
+    message: string;
+    /** Detailed error information */
+    details?: unknown;
+    /** Whether this error is retryable */
+    retryable?: boolean;
+}
+/**
+ * Summary statistics for bulk operations
+ */
+export interface BulkOperationSummary {
+    /** Total items requested */
+    total: number;
+    /** Successfully processed items */
+    succeeded: number;
+    /** Failed items */
+    failed: number;
+    /** Processing duration in ms */
+    duration?: number;
+    /** Operation timestamp */
+    timestamp: string;
+}
+/**
+ * Retry configuration for bulk operations
+ */
+export interface BulkRetryConfig {
+    /** Maximum number of retry attempts */
+    maxAttempts?: number;
+    /** Initial delay between retries (ms) */
+    initialDelay?: number;
+    /** Maximum delay between retries (ms) */
+    maxDelay?: number;
+    /** Backoff multiplier */
+    backoffMultiplier?: number;
+    /** Which errors should trigger a retry */
+    retryOn?: (error: BulkOperationError) => boolean;
+}
+/**
+ * Hook options specific to bulk operations
+ */
+export interface BulkMutationOptions<TData = unknown, TError = unknown, TVariables = unknown> {
+    /** Retry configuration */
+    retry?: BulkRetryConfig;
+    /** Progress tracking */
+    onProgress?: (progress: BulkOperationProgress) => void;
+    /** Callback for partial success */
+    onPartialSuccess?: (response: BulkOperationResponse<TData>) => void;
+    /** Transform function for request */
+    transformRequest?: (request: BulkOperationRequest<TVariables>) => unknown;
+    /** Transform function for response */
+    transformResponse?: (response: unknown) => BulkOperationResponse<TData>;
+}
+/**
+ * Type guard to check if an endpoint handles bulk operations
+ */
+export declare function isBulkOperation(path: string, method: string, requestBody?: unknown): boolean;
+/**
+ * Detect bulk operation type from endpoint
+ */
+export declare function detectBulkOperationType(path: string, method: string): 'create' | 'update' | 'delete' | 'mixed' | null;
+/**
+ * Generate a descriptive bulk operation name
+ */
+export declare function generateBulkOperationName(resource: string, operationType: string): string;
+//# sourceMappingURL=bulk-types.d.ts.map

package/dist/codegen/openapi/bulk-types.d.ts.map

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

package/dist/codegen/openapi/client-generator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * API Client Generator
+ *
+ * Creates a type-safe API client with interceptors and error handling
+ * based on parsed OpenAPI specifications.
+ *
+ * Part of FRO-12: API Client Generator
+ */
+import type { ParsedOpenAPI } from './parser';
+export interface ClientGeneratorOptions {
+    clientType: 'axios' | 'fetch';
+    baseUrl?: string;
+    includeAuth?: boolean;
+    authType?: 'bearer' | 'apiKey' | 'basic';
+    timeout?: number;
+    retries?: number;
+    includeInterceptors?: boolean;
+}
+export interface GeneratedClient {
+    client: string;
+    methods: string;
+    types: string;
+    config: string;
+    index: string;
+}
+export declare class APIClientGenerator {
+    private options;
+    constructor(options?: Partial<ClientGeneratorOptions>);
+    generate(parsedAPI: ParsedOpenAPI): GeneratedClient;
+    private generateClientSetup;
+    private generateAxiosClient;
+    private generateFetchClient;
+    private generateAxiosInterceptors;
+    private generateAuthInjection;
+    private generateFetchAuthInjection;
+    private generateApiMethods;
+    private generateEndpointMethod;
+    private generateClientTypes;
+    private generateAuthTypes;
+    private generateConfiguration;
+    private generateIndexFile;
+    private generateFileHeader;
+    private getMethodName;
+    private generatePathWithParams;
+    private getParameterType;
+    private getResponseType;
+    private groupEndpoints;
+    private camelCase;
+    private capitalize;
+}
+export declare function generateAPIClient(parsedAPI: ParsedOpenAPI, options?: ClientGeneratorOptions): GeneratedClient;
+//# sourceMappingURL=client-generator.d.ts.map

package/dist/codegen/openapi/client-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-generator.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/client-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAmC,MAAM,UAAU,CAAA;AAE9E,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAkC;gBAErC,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAYzD,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,eAAe;IAUnD,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,mBAAmB;IA4G3B,OAAO,CAAC,mBAAmB;IAuI3B,OAAO,CAAC,yBAAyB;IAmEjC,OAAO,CAAC,qBAAqB;IAgD7B,OAAO,CAAC,0BAA0B;IA+BlC,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,sBAAsB;IAiE9B,OAAO,CAAC,mBAAmB;IA8C3B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;CAGnB;AAGD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAG7G"}

package/dist/codegen/openapi/confidence-scorer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Confidence scoring for generated hook names
+ * Helps identify names that may need human review
+ */
+export type ConfidenceLevel = 'high' | 'medium' | 'low';
+export interface ScoredHookName {
+    name: string;
+    confidence: ConfidenceLevel;
+    score: number;
+    issues: string[];
+    suggestions: string[];
+}
+export declare class ConfidenceScorer {
+    /**
+     * Score a generated hook name based on various quality indicators
+     */
+    scoreHookName(generatedName: string, originalOperationId: string, path: string, method: string): ScoredHookName;
+    private isProperCamelCase;
+    private hasConsecutiveUppercase;
+    private hasRepeatedWords;
+    private matchesCommonPattern;
+    private hasWordBoundaryIssues;
+    private suggestFixForConsecutiveUppercase;
+    private camelCaseToWords;
+    /**
+     * Generate a confidence report for review
+     */
+    generateReport(scoredNames: ScoredHookName[]): string;
+}
+//# sourceMappingURL=confidence-scorer.d.ts.map

package/dist/codegen/openapi/confidence-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-scorer.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/confidence-scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,eAAe,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,aAAa,CACX,aAAa,EAAE,MAAM,EACrB,mBAAmB,EAAE,MAAM,EAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,cAAc;IA8DjB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,iCAAiC;IA2CzC,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM;CAuCtD"}

package/dist/codegen/openapi/hook-config.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Hook generation configuration system
+ * Stores learned patterns and manual overrides for hook name generation
+ */
+export interface HookNameOverride {
+    original: string;
+    override: string;
+    confidence: 'high' | 'medium' | 'low';
+    reason?: string;
+    path?: string;
+    method?: string;
+    approvedAt?: string;
+    approvedBy?: 'human' | 'auto';
+}
+export interface HookGenerationConfig {
+    version: string;
+    nameOverrides: Record<string, string>;
+    reviewedNames: HookNameOverride[];
+    patterns: {
+        removeDoubleWords: boolean;
+        smartCasing: boolean;
+        deduplicateSegments: boolean;
+    };
+    statistics?: {
+        totalGenerated: number;
+        highConfidence: number;
+        mediumConfidence: number;
+        lowConfidence: number;
+        humanReviewed: number;
+        lastUpdated: string;
+    };
+}
+export declare class HookConfigManager {
+    private configPath;
+    private config;
+    constructor(configPath?: string);
+    load(): Promise<void>;
+    save(): Promise<void>;
+    getOverride(operationId: string): string | undefined;
+    addOverride(override: HookNameOverride): void;
+    getPatterns(): {
+        removeDoubleWords: boolean;
+        smartCasing: boolean;
+        deduplicateSegments: boolean;
+    };
+    updateStatistics(stats: Partial<HookGenerationConfig['statistics']>): void;
+    getReviewedNames(): HookNameOverride[];
+    hasBeenReviewed(operationId: string): boolean;
+}
+//# sourceMappingURL=hook-config.d.ts.map

package/dist/codegen/openapi/hook-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-config.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/hook-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,aAAa,EAAE,gBAAgB,EAAE,CAAA;IACjC,QAAQ,EAAE;QACR,iBAAiB,EAAE,OAAO,CAAA;QAC1B,WAAW,EAAE,OAAO,CAAA;QACpB,mBAAmB,EAAE,OAAO,CAAA;KAC7B,CAAA;IACD,UAAU,CAAC,EAAE;QACX,cAAc,EAAE,MAAM,CAAA;QACtB,cAAc,EAAE,MAAM,CAAA;QACtB,gBAAgB,EAAE,MAAM,CAAA;QACxB,aAAa,EAAE,MAAM,CAAA;QACrB,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAaD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,MAAM,CAAuC;gBAEzC,UAAU,GAAE,MAA8B;IAIhD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpD,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAQ7C,WAAW;2BA5DU,OAAO;qBACb,OAAO;6BACC,OAAO;;IA8D9B,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAQnE,gBAAgB,IAAI,gBAAgB,EAAE;IAItC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;CAG9C"}

package/dist/codegen/openapi/hook-generator.d.ts

@@ -0,0 +1,108 @@
+/**
+ * React Hook Generator
+ *
+ * Generates React hooks with TanStack Query integration for API endpoints
+ * with proper TypeScript typing and error/loading states.
+ *
+ * Part of FRO-3: React Hook Generator
+ */
+import type { ParsedOpenAPI } from './parser';
+export interface HookGeneratorOptions {
+    queryKeyPrefix?: string;
+    includeInfiniteQueries?: boolean;
+    includeOptimisticUpdates?: boolean;
+    includeMutationHelpers?: boolean;
+    authenticationRequired?: boolean;
+    errorHandling?: 'throw' | 'return' | 'callback';
+    configPath?: string;
+    enableConfidenceScoring?: boolean;
+}
+export interface GeneratedHooks {
+    queries: string;
+    mutations: string;
+    keys: string;
+    types: string;
+    index: string;
+    report?: string;
+}
+export declare class ReactHookGenerator {
+    private options;
+    private configManager;
+    private confidenceScorer;
+    private bulkHookGenerator;
+    private scoredNames;
+    private resourceConfigs;
+    constructor(options?: HookGeneratorOptions);
+    /**
+     * Detect resource operations from endpoints
+     */
+    private detectResourceOperations;
+    /**
+     * Extract resource name from path
+     */
+    private extractResourceName;
+    /**
+     * Create default API config for a resource
+     */
+    private createDefaultConfig;
+    generate(parsedAPI: ParsedOpenAPI): Promise<GeneratedHooks>;
+    private generateQueryHooks;
+    private generateQueryHook;
+    private generateInfiniteQueryHook;
+    private generateMutationHooks;
+    private generateMutationHook;
+    private generateOptimisticUpdate;
+    private generateCacheInvalidation;
+    private generateQueryKeys;
+    private generateHookTypes;
+    private generateIndexFile;
+    private generateFileHeader;
+    private generateQueryHookName;
+    private generateMutationHookName;
+    private getOperationName;
+    private cleanOperationId;
+    /**
+     * Parse operation ID into structured components
+     */
+    private parseOperationId;
+    /**
+     * Extract meaningful prefix from operation ID parts
+     */
+    private extractPrefix;
+    /**
+     * Extract resources from API path
+     */
+    private extractResourcesFromPath;
+    /**
+     * Generate clean hook name from parsed components
+     */
+    private generateNameFromParsed;
+    /**
+     * Check if prefix adds meaningful context
+     */
+    private isMeaningfulPrefix;
+    /**
+     * Format name with meaningful prefix
+     */
+    private formatWithPrefix;
+    /**
+     * Format standard REST operation
+     */
+    private formatStandardOperation;
+    private generateCleanName;
+    private pluralize;
+    private singularize;
+    private hasRequiredParams;
+    private generateParamType;
+    private generateMutationType;
+    private getParameterType;
+    private isListEndpoint;
+    private groupEndpointsByResource;
+    private getRelatedQueryTags;
+    private camelCase;
+    private capitalize;
+    private getMethodPrefix;
+    private removeDuplicateSegments;
+}
+export declare function generateHooks(parsedAPI: ParsedOpenAPI, options?: HookGeneratorOptions): Promise<GeneratedHooks>;
+//# sourceMappingURL=hook-generator.d.ts.map

package/dist/codegen/openapi/hook-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-generator.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/hook-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAA;AAM7D,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,aAAa,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAgDD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,eAAe,CAAoC;gBAE/C,OAAO,GAAE,oBAAyB;IAiB9C;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2EhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQrB,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA2CjE,OAAO,CAAC,kBAAkB;IAyE1B,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,yBAAyB;IAgCjC,OAAO,CAAC,qBAAqB;IAgD7B,OAAO,CAAC,oBAAoB;IA6C5B,OAAO,CAAC,wBAAwB;IAuGhC,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,iBAAiB;IAkFzB,OAAO,CAAC,iBAAiB;IAwCzB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,wBAAwB;IAehC,OAAO,CAAC,gBAAgB;IA2DxB,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqDrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2BhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyC/B,OAAO,CAAC,iBAAiB;IAoDzB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,uBAAuB;CAgBhC;AAGD,wBAAsB,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAGrH"}

package/dist/codegen/openapi/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * OpenAPI Services
+ *
+ * Complete OpenAPI processing pipeline from specification to generated code
+ */
+export * from './parser';
+export * from './type-generator';
+export * from './client-generator';
+export * from './hook-generator';
+export * from './bulk-types';
+export * from './bulk-hook-generator';
+export { parseOpenAPI, loadOpenAPISpec } from './parser';
+export { generateTypes } from './type-generator';
+export { generateAPIClient } from './client-generator';
+export { generateHooks } from './hook-generator';
+export { BulkHookGenerator } from './bulk-hook-generator';
+export declare function processOpenAPI(spec: string | object, options?: {
+    typeOptions?: any;
+    clientOptions?: any;
+    hookOptions?: any;
+}): Promise<{
+    parsed: import("./parser").ParsedOpenAPI;
+    types: import("./type-generator").GeneratedTypes;
+    client: import("./client-generator").GeneratedClient;
+    hooks: Promise<import("./hook-generator").GeneratedHooks>;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/codegen/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/codegen/openapi/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AAGrC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAGzD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,GAAG,CAAA;IACjB,aAAa,CAAC,EAAE,GAAG,CAAA;IACnB,WAAW,CAAC,EAAE,GAAG,CAAA;CAClB;;;;;GA4BF"}

package/dist/codegen/openapi/parser.d.ts

@@ -0,0 +1,107 @@
+/**
+ * OpenAPI Parser Implementation
+ *
+ * Core parser that reads OpenAPI 3.0 specifications and converts them
+ * into an intermediate representation for code generation.
+ *
+ * Part of FRO-11: OpenAPI Parser Implementation
+ */
+import { OpenAPIV3 } from 'openapi-types';
+export interface ParsedOpenAPI {
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers: ParsedServer[];
+    endpoints: ParsedEndpoint[];
+    schemas: ParsedSchema[];
+    security: ParsedSecurity[];
+}
+export interface ParsedServer {
+    url: string;
+    description?: string;
+    variables?: Record<string, string>;
+}
+export interface ParsedEndpoint {
+    path: string;
+    method: HTTPMethod;
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    parameters: ParsedParameter[];
+    requestBody?: ParsedRequestBody;
+    responses: ParsedResponse[];
+    security?: ParsedSecurity[];
+}
+export interface ParsedParameter {
+    name: string;
+    in: 'query' | 'path' | 'header' | 'cookie';
+    required: boolean;
+    schema: ParsedSchema;
+    description?: string;
+}
+export interface ParsedRequestBody {
+    required: boolean;
+    content: Record<string, ParsedMediaType>;
+    description?: string;
+}
+export interface ParsedResponse {
+    statusCode: string;
+    description?: string;
+    content?: Record<string, ParsedMediaType>;
+    headers?: Record<string, ParsedSchema>;
+}
+export interface ParsedMediaType {
+    schema: ParsedSchema;
+}
+export interface ParsedSchema {
+    type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'null' | 'any';
+    format?: string;
+    items?: ParsedSchema;
+    properties?: Record<string, ParsedSchema>;
+    required?: string[];
+    enum?: unknown[];
+    description?: string;
+    example?: unknown;
+    nullable?: boolean;
+    ref?: string;
+    originalRef?: string;
+}
+export interface ParsedSecurity {
+    type: 'http' | 'apiKey' | 'oauth2' | 'openIdConnect';
+    scheme?: string;
+    bearerFormat?: string;
+    in?: 'query' | 'header' | 'cookie';
+    name?: string;
+    flows?: Record<string, unknown>;
+    openIdConnectUrl?: string;
+}
+export type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options';
+export declare class OpenAPIParser {
+    private spec;
+    private refs;
+    constructor(spec: OpenAPIV3.Document);
+    /**
+     * Parse the OpenAPI specification into our intermediate representation
+     */
+    parse(): ParsedOpenAPI;
+    private parseInfo;
+    private parseServers;
+    private parseEndpoints;
+    private parseParameters;
+    private parseRequestBody;
+    private parseResponses;
+    private parseSchema;
+    private parseSchemas;
+    private parseSecurity;
+    private parseOperationSecurity;
+    private mapOpenAPIType;
+    private buildRefsMap;
+    private traverseAndMapRefs;
+    private resolveRef;
+}
+export declare function parseOpenAPI(spec: OpenAPIV3.Document): Promise<ParsedOpenAPI>;
+export declare function loadOpenAPISpec(source: string): Promise<OpenAPIV3.Document>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/codegen/openapi/parser.d.ts.map

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