@cesarandreslopez/occ 0.3.1 → 0.4.1

package/dist/src/code/types.js

@@ -1,2 +1,151 @@
-export {};
+import { z } from 'zod';
+export const CodeNodeTypeSchema = z.enum(['file', 'module', 'function', 'class', 'interface', 'type-alias', 'enum', 'variable', 'parameter']);
+export const CodeEdgeTypeSchema = z.enum(['contains', 'imports', 'calls', 'inherits', 'implements', 'has_parameter']);
+export const ResolutionStatusSchema = z.enum(['resolved', 'ambiguous', 'unresolved']);
+export const ImportKindSchema = z.enum(['local', 'external', 'unresolved']);
+export const CodeCapabilitiesSchema = z.object({
+    definitions: z.boolean(),
+    imports: z.boolean(),
+    calls: z.boolean(),
+    inheritance: z.boolean(),
+    content: z.boolean(),
+});
+export const ParsedImportBindingSchema = z.object({
+    localName: z.string(),
+    importedName: z.string().optional(),
+    isNamespace: z.boolean().optional(),
+    isDefault: z.boolean().optional(),
+});
+export const ParsedImportSchema = z.object({
+    specifier: z.string(),
+    line: z.number(),
+    kind: ImportKindSchema,
+    bindings: z.array(ParsedImportBindingSchema),
+    resolvedPath: z.string().optional(),
+    isReExport: z.boolean().optional(),
+});
+export const ParsedSymbolSchema = z.object({
+    type: z.enum(['function', 'class', 'interface', 'type-alias', 'enum', 'variable']),
+    name: z.string(),
+    line: z.number(),
+    containerName: z.string().optional(),
+    signature: z.string().optional(),
+    exported: z.boolean().optional(),
+});
+export const ParsedCallSchema = z.object({
+    callerName: z.string(),
+    callerLine: z.number(),
+    callerContainerName: z.string().optional(),
+    calleeName: z.string(),
+    qualifier: z.string().optional(),
+    line: z.number(),
+});
+export const ParsedInheritanceSchema = z.object({
+    className: z.string(),
+    classLine: z.number(),
+    baseName: z.string(),
+    line: z.number(),
+    kind: z.enum(['extends', 'implements']).optional(),
+});
+export const ParsedFileSchema = z.object({
+    path: z.string(),
+    relativePath: z.string(),
+    moduleName: z.string(),
+    language: z.string(),
+    content: z.string(),
+    lines: z.array(z.string()),
+    symbols: z.array(ParsedSymbolSchema),
+    imports: z.array(ParsedImportSchema),
+    calls: z.array(ParsedCallSchema),
+    inheritances: z.array(ParsedInheritanceSchema),
+});
+export const CodeNodeSchema = z.object({
+    id: z.string(),
+    type: CodeNodeTypeSchema,
+    name: z.string(),
+    path: z.string(),
+    relativePath: z.string().optional(),
+    line: z.number().optional(),
+    language: z.string(),
+    moduleName: z.string().optional(),
+    containerId: z.string().optional(),
+    containerName: z.string().optional(),
+    signature: z.string().optional(),
+    external: z.boolean().optional(),
+});
+export const CodeEdgeSchema = z.object({
+    id: z.string(),
+    type: CodeEdgeTypeSchema,
+    from: z.string(),
+    to: z.string().optional(),
+    fromPath: z.string(),
+    toPath: z.string().optional(),
+    line: z.number().optional(),
+    status: ResolutionStatusSchema,
+    targetName: z.string().optional(),
+    detail: z.string().optional(),
+    specifier: z.string().optional(),
+    importKind: ImportKindSchema.optional(),
+    candidates: z.array(z.object({
+        name: z.string(),
+        relativePath: z.string().optional(),
+        line: z.number().optional(),
+    })).optional(),
+});
+export const CodebaseIndexSchema = z.object({
+    repoRoot: z.string(),
+    files: z.array(ParsedFileSchema),
+    nodes: z.array(CodeNodeSchema),
+    edges: z.array(CodeEdgeSchema),
+    capabilities: z.record(z.string(), CodeCapabilitiesSchema),
+});
+export const CodeSearchResultSchema = z.object({
+    node: CodeNodeSchema,
+    resolution: ResolutionStatusSchema.optional(),
+});
+export const ContentMatchSchema = z.object({
+    path: z.string(),
+    relativePath: z.string(),
+    language: z.string(),
+    line: z.number(),
+    snippet: z.string(),
+});
+export const RelationMatchSchema = z.object({
+    from: CodeNodeSchema,
+    edge: CodeEdgeSchema,
+    to: CodeNodeSchema.optional(),
+});
+export const DependencyAnalysisSchema = z.object({
+    target: z.string(),
+    targetFile: CodeNodeSchema.optional(),
+    importers: z.array(RelationMatchSchema),
+    localImports: z.array(RelationMatchSchema),
+    externalImports: z.array(RelationMatchSchema),
+    unresolvedImports: z.array(RelationMatchSchema),
+});
+export const ClassTreeAnalysisSchema = z.object({
+    target: CodeNodeSchema,
+    parents: z.array(RelationMatchSchema),
+    children: z.array(RelationMatchSchema),
+    methods: z.array(CodeNodeSchema),
+});
+export const CallChainSchema = z.object({
+    nodes: z.array(CodeNodeSchema),
+    edges: z.array(CodeEdgeSchema),
+    direction: z.enum(['forward', 'reverse']).optional(),
+    status: z.enum(['resolved', 'blocked_ambiguous']).optional(),
+    blockedAt: CodeNodeSchema.optional(),
+    blockedBy: CodeEdgeSchema.optional(),
+});
+export const CodeCommandPayloadSchema = z.object({
+    repo: z.string(),
+    query: z.record(z.string(), z.unknown()),
+    results: z.unknown(),
+    stats: z.object({
+        filesIndexed: z.number(),
+        nodes: z.number(),
+        edges: z.number(),
+    }),
+    capabilities: z.record(z.string(), CodeCapabilitiesSchema),
+});
 //# sourceMappingURL=types.js.map

package/dist/src/code/types.js.map

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

package/dist/src/doc/command.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerDocCommands(program: Command): void;

package/dist/src/doc/command.js

@@ -0,0 +1,54 @@
+import { writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { inspectDocument } from './inspect.js';
+import { formatDocInspection, formatDocPayloadJson } from './output.js';
+import { createInspectPayload } from '../inspect/shared.js';
+import { writeStream } from '../utils.js';
+import { parsePositiveInt } from '../cli-validation.js';
+const DocCommandOptionsSchema = z.object({
+    format: z.string().optional(),
+    output: z.string().optional(),
+    ci: z.boolean().optional(),
+    sampleParagraphs: z.string().optional(),
+    structure: z.boolean().optional(),
+}).passthrough();
+function getOptions(command) {
+    return DocCommandOptionsSchema.parse(command.optsWithGlobals());
+}
+async function emit(output, options) {
+    if (options.output) {
+        await writeFile(options.output, output);
+        return;
+    }
+    await writeStream(process.stdout, output);
+}
+export function registerDocCommands(program) {
+    const doc = program.command('doc').description('Inspect document structure and content before deep reading');
+    const inspect = doc.command('inspect <file>').description('Inspect DOCX, PDF, or ODT document metadata, structure, and content preview');
+    inspect
+        .option('--format <type>', 'output format: tabular or json', 'tabular')
+        .option('-o, --output <file>', 'write output to file')
+        .option('--ci', 'ASCII-only output, no colors')
+        .option('--sample-paragraphs <n>', 'preview paragraph count', '5')
+        .option('--no-structure', 'skip heading tree extraction');
+    inspect.action(async (file, _options, command) => {
+        const options = getOptions(command);
+        const resolved = path.resolve(file);
+        const inspectOptions = {
+            sampleParagraphs: parsePositiveInt(options.sampleParagraphs, 5, 'sample paragraph count'),
+            includeStructure: options.structure !== false,
+        };
+        const result = await inspectDocument(resolved, inspectOptions);
+        const payload = createInspectPayload(resolved, {
+            command: 'doc.inspect',
+            sampleParagraphs: inspectOptions.sampleParagraphs,
+            includeStructure: inspectOptions.includeStructure,
+        }, result);
+        const output = options.format === 'json'
+            ? formatDocPayloadJson(payload)
+            : formatDocInspection(result, options.ci);
+        await emit(output.endsWith('\n') ? output : `${output}\n`, options);
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/src/doc/command.js.map

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

package/dist/src/doc/inspect-docx.d.ts

@@ -0,0 +1,14 @@
+import JSZip from 'jszip';
+import type { DocumentProperties } from '../inspect/shared.js';
+import type { DocRiskFlags, DocContentStats, ContentPreview } from './types.js';
+export declare function extractDocxProperties(zip: JSZip): Promise<DocumentProperties>;
+export declare function extractDocxRiskFlags(zip: JSZip): Promise<DocRiskFlags>;
+export declare function extractDocxContentStats(filePath: string, zip: JSZip): Promise<DocContentStats>;
+export declare function extractDocxPreview(filePath: string, sampleParagraphs: number): Promise<ContentPreview>;
+export declare function buildPreviewFromMarkdown(markdown: string, sampleParagraphs: number): ContentPreview;
+export declare function inspectDocx(filePath: string, buffer: Buffer, sampleParagraphs: number): Promise<{
+    properties: DocumentProperties;
+    riskFlags: DocRiskFlags;
+    contentStats: DocContentStats;
+    preview: ContentPreview;
+}>;

package/dist/src/doc/inspect-docx.js

@@ -0,0 +1,188 @@
+import JSZip from 'jszip';
+import mammoth from 'mammoth';
+import { countWords } from '../utils.js';
+import { asOptionalString, formatDateLike } from '../inspect/shared.js';
+function parseXmlText(xml, tag) {
+    const regex = new RegExp(`<${tag}[^>]*>([^<]*)</${tag}>`, 'i');
+    const match = xml.match(regex);
+    return match?.[1]?.trim() || undefined;
+}
+export async function extractDocxProperties(zip) {
+    const props = {};
+    const coreXml = await zip.file('docProps/core.xml')?.async('text');
+    if (coreXml) {
+        props.title = asOptionalString(parseXmlText(coreXml, 'dc:title'));
+        props.subject = asOptionalString(parseXmlText(coreXml, 'dc:subject'));
+        props.author = asOptionalString(parseXmlText(coreXml, 'dc:creator'));
+        props.keywords = asOptionalString(parseXmlText(coreXml, 'cp:keywords'));
+        props.lastModifiedBy = asOptionalString(parseXmlText(coreXml, 'cp:lastModifiedBy'));
+        props.createdDate = formatDateLike(parseXmlText(coreXml, 'dcterms:created'));
+        props.modifiedDate = formatDateLike(parseXmlText(coreXml, 'dcterms:modified'));
+    }
+    const appXml = await zip.file('docProps/app.xml')?.async('text');
+    if (appXml) {
+        props.company = asOptionalString(parseXmlText(appXml, 'Company'));
+    }
+    return props;
+}
+export async function extractDocxRiskFlags(zip) {
+    const flags = {
+        comments: false,
+        trackedChanges: false,
+        hyperlinks: false,
+        embeddedObjects: false,
+        footnotes: false,
+        endnotes: false,
+        macros: false,
+        headerFooter: false,
+        tables: false,
+        encrypted: false,
+    };
+    // Check comments
+    const commentsXml = await zip.file('word/comments.xml')?.async('text');
+    if (commentsXml && /<w:comment\b/.test(commentsXml)) {
+        flags.comments = true;
+    }
+    // Check document.xml for tracked changes, tables, hyperlinks
+    const docXml = await zip.file('word/document.xml')?.async('text');
+    if (docXml) {
+        if (/<w:ins\b/.test(docXml) || /<w:del\b/.test(docXml))
+            flags.trackedChanges = true;
+        if (/<w:tbl\b/.test(docXml))
+            flags.tables = true;
+        if (/<w:hyperlink\b/.test(docXml))
+            flags.hyperlinks = true;
+    }
+    // Check for macros
+    if (zip.file('word/vbaProject.bin'))
+        flags.macros = true;
+    // Check for images
+    const mediaFiles = Object.keys(zip.files).filter(name => name.startsWith('word/media/'));
+    if (mediaFiles.length > 0)
+        flags.embeddedObjects = true;
+    // Check footnotes/endnotes
+    const footnotesXml = await zip.file('word/footnotes.xml')?.async('text');
+    if (footnotesXml && /<w:footnote\b/.test(footnotesXml)) {
+        // Word always has footnotes.xml with separator/continuationSeparator; check for actual footnotes
+        const realFootnotes = (footnotesXml.match(/<w:footnote\b/g) || []).length;
+        if (realFootnotes > 2)
+            flags.footnotes = true; // skip the 2 built-in
+    }
+    const endnotesXml = await zip.file('word/endnotes.xml')?.async('text');
+    if (endnotesXml && /<w:endnote\b/.test(endnotesXml)) {
+        const realEndnotes = (endnotesXml.match(/<w:endnote\b/g) || []).length;
+        if (realEndnotes > 2)
+            flags.endnotes = true;
+    }
+    // Check headers/footers
+    const headerFiles = Object.keys(zip.files).filter(name => /^word\/(header|footer)\d*\.xml$/.test(name));
+    if (headerFiles.length > 0)
+        flags.headerFooter = true;
+    return flags;
+}
+export async function extractDocxContentStats(filePath, zip) {
+    const result = await mammoth.extractRawText({ path: filePath });
+    const text = result.value || '';
+    const words = countWords(text);
+    const paragraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0).length;
+    const characters = text.length;
+    // Pages from app.xml if available
+    const appXml = await zip.file('docProps/app.xml')?.async('text');
+    let pages = 0;
+    let pagesEstimated = true;
+    if (appXml) {
+        const pagesStr = parseXmlText(appXml, 'Pages');
+        if (pagesStr) {
+            const parsed = parseInt(pagesStr, 10);
+            if (parsed > 0) {
+                pages = parsed;
+                pagesEstimated = false;
+            }
+        }
+    }
+    if (pages === 0) {
+        pages = Math.max(1, Math.ceil(words / 250));
+        pagesEstimated = true;
+    }
+    // Count tables from HTML conversion
+    let tables = 0;
+    try {
+        const htmlResult = await mammoth.convertToHtml({ path: filePath });
+        const html = htmlResult.value || '';
+        tables = (html.match(/<table\b/gi) || []).length;
+    }
+    catch { /* ignore */ }
+    // Count images
+    const mediaFiles = Object.keys(zip.files).filter(name => name.startsWith('word/media/'));
+    const images = mediaFiles.length;
+    return { words, pages, pagesEstimated, paragraphs, characters, tables, images };
+}
+export async function extractDocxPreview(filePath, sampleParagraphs) {
+    const result = await mammoth.convertToHtml({ path: filePath });
+    const html = result.value || '';
+    if (!html.trim()) {
+        return { truncated: false, paragraphs: [] };
+    }
+    // Use turndown to convert to markdown for heading detection
+    const TurndownService = (await import('turndown')).default;
+    const turndown = new TurndownService({ headingStyle: 'atx' });
+    const markdown = turndown.turndown(html);
+    return buildPreviewFromMarkdown(markdown, sampleParagraphs);
+}
+export function buildPreviewFromMarkdown(markdown, sampleParagraphs) {
+    const lines = markdown.split('\n');
+    const previews = [];
+    let paragraphIndex = 0;
+    let i = 0;
+    while (i < lines.length && previews.length < sampleParagraphs) {
+        const line = lines[i].trim();
+        if (!line) {
+            i++;
+            continue;
+        }
+        const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+        if (headingMatch) {
+            previews.push({
+                index: paragraphIndex,
+                text: headingMatch[2],
+                isHeading: true,
+                headingLevel: headingMatch[1].length,
+            });
+        }
+        else {
+            // Collect contiguous non-empty lines as one paragraph
+            let text = line;
+            while (i + 1 < lines.length && lines[i + 1].trim() && !lines[i + 1].trim().match(/^#{1,6}\s/)) {
+                i++;
+                text += ' ' + lines[i].trim();
+            }
+            previews.push({
+                index: paragraphIndex,
+                text,
+                isHeading: false,
+            });
+        }
+        paragraphIndex++;
+        i++;
+    }
+    // Check for remaining content
+    let hasMore = false;
+    for (let j = i; j < lines.length; j++) {
+        if (lines[j].trim()) {
+            hasMore = true;
+            break;
+        }
+    }
+    return { truncated: hasMore, paragraphs: previews };
+}
+export async function inspectDocx(filePath, buffer, sampleParagraphs) {
+    const zip = await JSZip.loadAsync(buffer);
+    const [properties, riskFlags, contentStats, preview] = await Promise.all([
+        extractDocxProperties(zip),
+        extractDocxRiskFlags(zip),
+        extractDocxContentStats(filePath, zip),
+        extractDocxPreview(filePath, sampleParagraphs),
+    ]);
+    return { properties, riskFlags, contentStats, preview };
+}
+//# sourceMappingURL=inspect-docx.js.map

package/dist/src/doc/inspect-docx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-docx.js","sourceRoot":"","sources":["../../../src/doc/inspect-docx.ts"],"names":[],"mappings":"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"}

package/dist/src/doc/inspect-odt.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentProperties } from '../inspect/shared.js';
+import type { DocRiskFlags, DocContentStats, ContentPreview } from './types.js';
+export declare function inspectOdt(filePath: string, buffer: Buffer, sampleParagraphs: number): Promise<{
+    properties: DocumentProperties;
+    riskFlags: DocRiskFlags;
+    contentStats: DocContentStats;
+    preview: ContentPreview;
+}>;

package/dist/src/doc/inspect-odt.js

@@ -0,0 +1,92 @@
+import JSZip from 'jszip';
+import officeparser from 'officeparser';
+import { z } from 'zod';
+import { countWords } from '../utils.js';
+import { asOptionalString, formatDateLike } from '../inspect/shared.js';
+function parseXmlText(xml, tag) {
+    const regex = new RegExp(`<${tag}[^>]*>([^<]*)</${tag}>`, 'i');
+    const match = xml.match(regex);
+    return match?.[1]?.trim() || undefined;
+}
+export async function inspectOdt(filePath, buffer, sampleParagraphs) {
+    const zip = await JSZip.loadAsync(buffer);
+    // Parse metadata from meta.xml
+    const properties = {};
+    const metaXml = await zip.file('meta.xml')?.async('text');
+    if (metaXml) {
+        properties.title = asOptionalString(parseXmlText(metaXml, 'dc:title'));
+        properties.subject = asOptionalString(parseXmlText(metaXml, 'dc:subject'));
+        properties.author = asOptionalString(parseXmlText(metaXml, 'dc:creator') ?? parseXmlText(metaXml, 'meta:initial-creator'));
+        properties.keywords = asOptionalString(parseXmlText(metaXml, 'meta:keyword'));
+        properties.createdDate = formatDateLike(parseXmlText(metaXml, 'meta:creation-date'));
+        properties.modifiedDate = formatDateLike(parseXmlText(metaXml, 'dc:date'));
+    }
+    // Parse risk flags from content.xml
+    const riskFlags = {
+        comments: false,
+        trackedChanges: false,
+        hyperlinks: false,
+        embeddedObjects: false,
+        footnotes: false,
+        endnotes: false,
+        macros: false,
+        headerFooter: false,
+        tables: false,
+        encrypted: false,
+    };
+    const contentXml = await zip.file('content.xml')?.async('text');
+    if (contentXml) {
+        if (/<office:annotation\b/.test(contentXml))
+            riskFlags.comments = true;
+        if (/<text:tracked-changes\b/.test(contentXml))
+            riskFlags.trackedChanges = true;
+        if (/<text:a\b[^>]*xlink:href=/.test(contentXml))
+            riskFlags.hyperlinks = true;
+        if (/<draw:frame\b/.test(contentXml))
+            riskFlags.embeddedObjects = true;
+        if (/<text:note\b/.test(contentXml))
+            riskFlags.footnotes = true;
+        if (/<table:table\b/.test(contentXml))
+            riskFlags.tables = true;
+    }
+    // Check for macros
+    if (zip.file('Basic/') || zip.file('Scripts/'))
+        riskFlags.macros = true;
+    // Extract text via officeparser
+    const text = z.string().parse(await officeparser.parseOffice(buffer));
+    const words = countWords(text);
+    const paragraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0).length;
+    // Count images and tables from content.xml
+    let images = 0;
+    let tables = 0;
+    if (contentXml) {
+        images = (contentXml.match(/<draw:image\b/g) || []).length;
+        tables = (contentXml.match(/<table:table\b/g) || []).length;
+    }
+    const contentStats = {
+        words,
+        pages: Math.max(1, Math.ceil(words / 250)),
+        pagesEstimated: true,
+        paragraphs,
+        characters: text.length,
+        tables,
+        images,
+    };
+    // Build preview
+    const textParagraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0);
+    const previewParagraphs = [];
+    const limit = Math.min(sampleParagraphs, textParagraphs.length);
+    for (let i = 0; i < limit; i++) {
+        previewParagraphs.push({
+            index: i,
+            text: textParagraphs[i].trim().replace(/\s+/g, ' '),
+            isHeading: false,
+        });
+    }
+    const preview = {
+        truncated: textParagraphs.length > sampleParagraphs,
+        paragraphs: previewParagraphs,
+    };
+    return { properties, riskFlags, contentStats, preview };
+}
+//# sourceMappingURL=inspect-odt.js.map

package/dist/src/doc/inspect-odt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-odt.js","sourceRoot":"","sources":["../../../src/doc/inspect-odt.ts"],"names":[],"mappings":"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"}

package/dist/src/doc/inspect-pdf.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentProperties } from '../inspect/shared.js';
+import type { DocRiskFlags, DocContentStats, ContentPreview } from './types.js';
+export declare function inspectPdf(filePath: string, buffer: Buffer, sampleParagraphs: number): Promise<{
+    properties: DocumentProperties;
+    riskFlags: DocRiskFlags;
+    contentStats: DocContentStats;
+    preview: ContentPreview;
+}>;

package/dist/src/doc/inspect-pdf.js

@@ -0,0 +1,88 @@
+import pdf from 'pdf-parse';
+import { z } from 'zod';
+import { countWords } from '../utils.js';
+import { asOptionalString, formatDateLike } from '../inspect/shared.js';
+const PdfParseResultSchema = z.object({
+    text: z.string(),
+    numpages: z.number(),
+    info: z.record(z.string(), z.unknown()).default({}),
+});
+function parsePdfDate(value) {
+    if (!value)
+        return undefined;
+    const str = String(value);
+    // PDF dates: D:YYYYMMDDHHmmSS or plain ISO strings
+    const match = str.match(/^D:(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/);
+    if (match) {
+        return `${match[1]}-${match[2]}-${match[3]}T${match[4]}:${match[5]}:${match[6]}Z`;
+    }
+    return formatDateLike(str);
+}
+export async function inspectPdf(filePath, buffer, sampleParagraphs) {
+    // Suppress pdf.js warnings
+    const originalLog = console.log;
+    console.log = (...args) => {
+        if (typeof args[0] === 'string' && (args[0].startsWith('Warning: ') || args[0].startsWith('Info: ') || args[0].startsWith('Deprecated API usage: '))) {
+            return;
+        }
+        originalLog.apply(console, args);
+    };
+    let data;
+    try {
+        data = PdfParseResultSchema.parse(await pdf(buffer));
+    }
+    finally {
+        console.log = originalLog;
+    }
+    const info = data.info;
+    const properties = {
+        title: asOptionalString(info.Title),
+        subject: asOptionalString(info.Subject),
+        author: asOptionalString(info.Author),
+        keywords: asOptionalString(info.Keywords),
+        createdDate: parsePdfDate(info.CreationDate),
+        modifiedDate: parsePdfDate(info.ModDate),
+    };
+    // PDFs have limited risk flag detection
+    const riskFlags = {
+        comments: false,
+        trackedChanges: false,
+        hyperlinks: false,
+        embeddedObjects: false,
+        footnotes: false,
+        endnotes: false,
+        macros: false,
+        headerFooter: false,
+        tables: false,
+        encrypted: !!info.IsAcroFormPresent || info.Encrypted === true,
+    };
+    const text = data.text || '';
+    const words = countWords(text);
+    const paragraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0).length;
+    const contentStats = {
+        words,
+        pages: data.numpages,
+        pagesEstimated: false,
+        paragraphs,
+        characters: text.length,
+        tables: 0,
+        images: 0,
+    };
+    // Build preview from text
+    const textParagraphs = text.split(/\n\n+/).filter(p => p.trim().length > 0);
+    const previewParagraphs = [];
+    const limit = Math.min(sampleParagraphs, textParagraphs.length);
+    for (let i = 0; i < limit; i++) {
+        previewParagraphs.push({
+            index: i,
+            text: textParagraphs[i].trim().replace(/\s+/g, ' '),
+            isHeading: false,
+        });
+    }
+    const preview = {
+        truncated: textParagraphs.length > sampleParagraphs,
+        paragraphs: previewParagraphs,
+    };
+    return { properties, riskFlags, contentStats, preview };
+}
+//# sourceMappingURL=inspect-pdf.js.map