tailprint 0.0.0-stage → 1.0.0

package/dist/schemas/render.d.ts

@@ -0,0 +1,422 @@
+import { z } from 'zod';
+export declare const PdfMarginSchema: z.ZodObject<{
+    top: z.ZodOptional<z.ZodString>;
+    bottom: z.ZodOptional<z.ZodString>;
+    left: z.ZodOptional<z.ZodString>;
+    right: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    top?: string | undefined;
+    bottom?: string | undefined;
+    left?: string | undefined;
+    right?: string | undefined;
+}, {
+    top?: string | undefined;
+    bottom?: string | undefined;
+    left?: string | undefined;
+    right?: string | undefined;
+}>;
+export declare const RenderPdfRequestSchema: z.ZodEffects<z.ZodObject<{
+    html: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<["A4", "Letter", "Legal"]>>;
+    landscape: z.ZodDefault<z.ZodBoolean>;
+    print_background: z.ZodDefault<z.ZodBoolean>;
+    margin: z.ZodOptional<z.ZodObject<{
+        top: z.ZodOptional<z.ZodString>;
+        bottom: z.ZodOptional<z.ZodString>;
+        left: z.ZodOptional<z.ZodString>;
+        right: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        top?: string | undefined;
+        bottom?: string | undefined;
+        left?: string | undefined;
+        right?: string | undefined;
+    }, {
+        top?: string | undefined;
+        bottom?: string | undefined;
+        left?: string | undefined;
+        right?: string | undefined;
+    }>>;
+    display_header_footer: z.ZodOptional<z.ZodBoolean>;
+    header_html: z.ZodOptional<z.ZodString>;
+    footer_html: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    owner_password: z.ZodOptional<z.ZodString>;
+    wait_for: z.ZodOptional<z.ZodString>;
+    delay_ms: z.ZodOptional<z.ZodNumber>;
+    store: z.ZodDefault<z.ZodBoolean>;
+    expires_in: z.ZodDefault<z.ZodEnum<["1h", "24h", "7d"]>>;
+}, "strip", z.ZodTypeAny, {
+    format: "A4" | "Letter" | "Legal";
+    landscape: boolean;
+    print_background: boolean;
+    store: boolean;
+    expires_in: "1h" | "24h" | "7d";
+    html?: string | undefined;
+    url?: string | undefined;
+    margin?: {
+        top?: string | undefined;
+        bottom?: string | undefined;
+        left?: string | undefined;
+        right?: string | undefined;
+    } | undefined;
+    display_header_footer?: boolean | undefined;
+    header_html?: string | undefined;
+    footer_html?: string | undefined;
+    password?: string | undefined;
+    owner_password?: string | undefined;
+    wait_for?: string | undefined;
+    delay_ms?: number | undefined;
+}, {
+    html?: string | undefined;
+    url?: string | undefined;
+    format?: "A4" | "Letter" | "Legal" | undefined;
+    landscape?: boolean | undefined;
+    print_background?: boolean | undefined;
+    margin?: {
+        top?: string | undefined;
+        bottom?: string | undefined;
+        left?: string | undefined;
+        right?: string | undefined;
+    } | undefined;
+    display_header_footer?: boolean | undefined;
+    header_html?: string | undefined;
+    footer_html?: string | undefined;
+    password?: string | undefined;
+    owner_password?: string | undefined;
+    wait_for?: string | undefined;
+    delay_ms?: number | undefined;
+    store?: boolean | undefined;
+    expires_in?: "1h" | "24h" | "7d" | undefined;
+}>, {
+    format: "A4" | "Letter" | "Legal";
+    landscape: boolean;
+    print_background: boolean;
+    store: boolean;
+    expires_in: "1h" | "24h" | "7d";
+    html?: string | undefined;
+    url?: string | undefined;
+    margin?: {
+        top?: string | undefined;
+        bottom?: string | undefined;
+        left?: string | undefined;
+        right?: string | undefined;
+    } | undefined;
+    display_header_footer?: boolean | undefined;
+    header_html?: string | undefined;
+    footer_html?: string | undefined;
+    password?: string | undefined;
+    owner_password?: string | undefined;
+    wait_for?: string | undefined;
+    delay_ms?: number | undefined;
+}, {
+    html?: string | undefined;
+    url?: string | undefined;
+    format?: "A4" | "Letter" | "Legal" | undefined;
+    landscape?: boolean | undefined;
+    print_background?: boolean | undefined;
+    margin?: {
+        top?: string | undefined;
+        bottom?: string | undefined;
+        left?: string | undefined;
+        right?: string | undefined;
+    } | undefined;
+    display_header_footer?: boolean | undefined;
+    header_html?: string | undefined;
+    footer_html?: string | undefined;
+    password?: string | undefined;
+    owner_password?: string | undefined;
+    wait_for?: string | undefined;
+    delay_ms?: number | undefined;
+    store?: boolean | undefined;
+    expires_in?: "1h" | "24h" | "7d" | undefined;
+}>;
+export type RenderPdfRequest = z.input<typeof RenderPdfRequestSchema>;
+export type RenderPdfOutput = z.infer<typeof RenderPdfRequestSchema>;
+export declare const RenderImageRequestSchema: z.ZodEffects<z.ZodObject<{
+    html: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    width: z.ZodDefault<z.ZodNumber>;
+    height: z.ZodDefault<z.ZodNumber>;
+    type: z.ZodDefault<z.ZodEnum<["png", "jpeg"]>>;
+    wait_for: z.ZodOptional<z.ZodString>;
+    delay_ms: z.ZodOptional<z.ZodNumber>;
+    store: z.ZodDefault<z.ZodBoolean>;
+    expires_in: z.ZodDefault<z.ZodEnum<["1h", "24h", "7d"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "png" | "jpeg";
+    store: boolean;
+    expires_in: "1h" | "24h" | "7d";
+    width: number;
+    height: number;
+    html?: string | undefined;
+    url?: string | undefined;
+    wait_for?: string | undefined;
+    delay_ms?: number | undefined;
+}, {
+    type?: "png" | "jpeg" | undefined;
+    html?: string | undefined;
+    url?: string | undefined;
+    wait_for?: string | undefined;
+    delay_ms?: number | undefined;
+    store?: boolean | undefined;
+    expires_in?: "1h" | "24h" | "7d" | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+}>, {
+    type: "png" | "jpeg";
+    store: boolean;
+    expires_in: "1h" | "24h" | "7d";
+    width: number;
+    height: number;
+    html?: string | undefined;
+    url?: string | undefined;
+    wait_for?: string | undefined;
+    delay_ms?: number | undefined;
+}, {
+    type?: "png" | "jpeg" | undefined;
+    html?: string | undefined;
+    url?: string | undefined;
+    wait_for?: string | undefined;
+    delay_ms?: number | undefined;
+    store?: boolean | undefined;
+    expires_in?: "1h" | "24h" | "7d" | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+}>;
+export type RenderImageRequest = z.input<typeof RenderImageRequestSchema>;
+export type RenderImageOutput = z.infer<typeof RenderImageRequestSchema>;
+export declare const HostedFileResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    hostedUrl: z.ZodString;
+    fileId: z.ZodString;
+    filename: z.ZodString;
+    mimeType: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    expiresAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    hostedUrl: string;
+    fileId: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    expiresAt: string;
+}, {
+    success: boolean;
+    hostedUrl: string;
+    fileId: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    expiresAt: string;
+}>;
+export type HostedFileResponse = z.infer<typeof HostedFileResponseSchema>;
+export declare const EInvoicePartySchema: z.ZodObject<{
+    name: z.ZodString;
+    vatId: z.ZodOptional<z.ZodString>;
+    country: z.ZodDefault<z.ZodString>;
+    street: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    postcode: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    country: string;
+    vatId?: string | undefined;
+    street?: string | undefined;
+    city?: string | undefined;
+    postcode?: string | undefined;
+    email?: string | undefined;
+}, {
+    name: string;
+    vatId?: string | undefined;
+    country?: string | undefined;
+    street?: string | undefined;
+    city?: string | undefined;
+    postcode?: string | undefined;
+    email?: string | undefined;
+}>;
+export declare const EInvoiceLineItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    vatRate: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    vatRate: number;
+}, {
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    vatRate?: number | undefined;
+}>;
+export declare const RenderEInvoiceRequestSchema: z.ZodObject<{
+    invoiceNumber: z.ZodString;
+    issueDate: z.ZodOptional<z.ZodString>;
+    dueDate: z.ZodOptional<z.ZodString>;
+    currency: z.ZodDefault<z.ZodString>;
+    seller: z.ZodObject<{
+        name: z.ZodString;
+        vatId: z.ZodOptional<z.ZodString>;
+        country: z.ZodDefault<z.ZodString>;
+        street: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        postcode: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        country: string;
+        vatId?: string | undefined;
+        street?: string | undefined;
+        city?: string | undefined;
+        postcode?: string | undefined;
+        email?: string | undefined;
+    }, {
+        name: string;
+        vatId?: string | undefined;
+        country?: string | undefined;
+        street?: string | undefined;
+        city?: string | undefined;
+        postcode?: string | undefined;
+        email?: string | undefined;
+    }>;
+    buyer: z.ZodObject<{
+        name: z.ZodString;
+        vatId: z.ZodOptional<z.ZodString>;
+        country: z.ZodDefault<z.ZodString>;
+        street: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        postcode: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        country: string;
+        vatId?: string | undefined;
+        street?: string | undefined;
+        city?: string | undefined;
+        postcode?: string | undefined;
+        email?: string | undefined;
+    }, {
+        name: string;
+        vatId?: string | undefined;
+        country?: string | undefined;
+        street?: string | undefined;
+        city?: string | undefined;
+        postcode?: string | undefined;
+        email?: string | undefined;
+    }>;
+    lineItems: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        vatRate: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        vatRate: number;
+    }, {
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        vatRate?: number | undefined;
+    }>, "many">;
+    paymentIban: z.ZodOptional<z.ZodString>;
+    paymentBic: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+    profile: z.ZodDefault<z.ZodEnum<["BASIC", "EN16931"]>>;
+    store: z.ZodDefault<z.ZodBoolean>;
+    expires_in: z.ZodDefault<z.ZodEnum<["1h", "24h", "7d"]>>;
+}, "strip", z.ZodTypeAny, {
+    store: boolean;
+    expires_in: "1h" | "24h" | "7d";
+    invoiceNumber: string;
+    currency: string;
+    seller: {
+        name: string;
+        country: string;
+        vatId?: string | undefined;
+        street?: string | undefined;
+        city?: string | undefined;
+        postcode?: string | undefined;
+        email?: string | undefined;
+    };
+    buyer: {
+        name: string;
+        country: string;
+        vatId?: string | undefined;
+        street?: string | undefined;
+        city?: string | undefined;
+        postcode?: string | undefined;
+        email?: string | undefined;
+    };
+    lineItems: {
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        vatRate: number;
+    }[];
+    profile: "BASIC" | "EN16931";
+    issueDate?: string | undefined;
+    dueDate?: string | undefined;
+    paymentIban?: string | undefined;
+    paymentBic?: string | undefined;
+    notes?: string | undefined;
+}, {
+    invoiceNumber: string;
+    seller: {
+        name: string;
+        vatId?: string | undefined;
+        country?: string | undefined;
+        street?: string | undefined;
+        city?: string | undefined;
+        postcode?: string | undefined;
+        email?: string | undefined;
+    };
+    buyer: {
+        name: string;
+        vatId?: string | undefined;
+        country?: string | undefined;
+        street?: string | undefined;
+        city?: string | undefined;
+        postcode?: string | undefined;
+        email?: string | undefined;
+    };
+    lineItems: {
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        vatRate?: number | undefined;
+    }[];
+    store?: boolean | undefined;
+    expires_in?: "1h" | "24h" | "7d" | undefined;
+    issueDate?: string | undefined;
+    dueDate?: string | undefined;
+    currency?: string | undefined;
+    paymentIban?: string | undefined;
+    paymentBic?: string | undefined;
+    notes?: string | undefined;
+    profile?: "BASIC" | "EN16931" | undefined;
+}>;
+export type RenderEInvoiceRequest = z.input<typeof RenderEInvoiceRequestSchema>;
+export type RenderEInvoiceOutput = z.infer<typeof RenderEInvoiceRequestSchema>;
+export declare const ErrorResponseSchema: z.ZodObject<{
+    statusCode: z.ZodNumber;
+    error: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    statusCode: number;
+    error: string;
+    details?: any;
+}, {
+    message: string;
+    statusCode: number;
+    error: string;
+    details?: any;
+}>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;

package/dist/schemas/render.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+export const PdfMarginSchema = z.object({
+    top: z.string().optional().describe('Top margin with unit (e.g. 10mm, 0.5in, 20px)'),
+    bottom: z.string().optional().describe('Bottom margin with unit (e.g. 10mm, 0.5in, 20px)'),
+    left: z.string().optional().describe('Left margin with unit (e.g. 10mm, 0.5in, 20px)'),
+    right: z.string().optional().describe('Right margin with unit (e.g. 10mm, 0.5in, 20px)'),
+}).describe('Page margins');
+export const RenderPdfRequestSchema = z
+    .object({
+    html: z.string().optional().describe('HTML string with optional Tailwind CSS utility classes. Either html or url is required.'),
+    url: z.string().url().optional().describe('Direct web URL to render to PDF (e.g. https://example.com). Either html or url is required.'),
+    format: z.enum(['A4', 'Letter', 'Legal']).default('A4').describe('Paper format'),
+    landscape: z.boolean().default(false).describe('Whether to print in landscape orientation'),
+    print_background: z.boolean().default(true).describe('Whether to print background graphics and colors'),
+    margin: PdfMarginSchema.optional(),
+    display_header_footer: z.boolean().optional().describe('Whether to display header and footer. Automatically enabled if header_html or footer_html is provided.'),
+    header_html: z.string().optional().describe('HTML template for the print header. Must include font-size styling (e.g. font-size: 10px). Supports Chromium template classes: pageNumber, totalPages, date, title, url.'),
+    footer_html: z.string().optional().describe('HTML template for the print footer. Must include font-size styling (e.g. font-size: 10px). Supports Chromium template classes: pageNumber, totalPages, date, title, url.'),
+    password: z.string().min(1).max(128).optional().describe('Optional user password to encrypt the PDF with industry-standard AES-256 encryption.'),
+    owner_password: z.string().min(1).max(128).optional().describe('Optional owner password for PDF permission controls.'),
+    wait_for: z.string().max(256).optional().describe('CSS selector to wait for before rendering (e.g. "#chart-loaded", ".ready"). Maximum wait 5s.'),
+    delay_ms: z.coerce.number().int().min(0).max(5000).optional().describe('Additional delay in milliseconds before capturing (e.g. 500 for animations/charts to settle). Maximum 5000ms.'),
+    store: z.boolean().default(false).describe('If true, saves the rendered PDF to Tailprint hosted delivery and returns a public hostedUrl link.'),
+    expires_in: z.enum(['1h', '24h', '7d']).default('24h').describe('Expiration duration for the hosted link (1h, 24h, or 7d). Defaults to 24h.'),
+})
+    .refine((data) => Boolean(data.html || data.url), {
+    message: 'Either "html" or "url" must be provided',
+    path: ['html'],
+});
+export const RenderImageRequestSchema = z
+    .object({
+    html: z.string().optional().describe('HTML string with optional Tailwind CSS utility classes. Either html or url is required.'),
+    url: z.string().url().optional().describe('Direct web URL to capture as image (e.g. https://example.com). Either html or url is required.'),
+    width: z.coerce.number().int().min(10).max(4000).default(1200).describe('Viewport and image width in pixels (e.g. 1200 for OG image)'),
+    height: z.coerce.number().int().min(10).max(4000).default(630).describe('Viewport and image height in pixels (e.g. 630 for OG image)'),
+    type: z.enum(['png', 'jpeg']).default('png').describe('Output image format'),
+    wait_for: z.string().max(256).optional().describe('CSS selector to wait for before rendering (e.g. "#chart-loaded", ".ready"). Maximum wait 5s.'),
+    delay_ms: z.coerce.number().int().min(0).max(5000).optional().describe('Additional delay in milliseconds before capturing (e.g. 500 for animations/charts to settle). Maximum 5000ms.'),
+    store: z.boolean().default(false).describe('If true, saves the rendered image to Tailprint hosted delivery and returns a public hostedUrl link.'),
+    expires_in: z.enum(['1h', '24h', '7d']).default('24h').describe('Expiration duration for the hosted link (1h, 24h, or 7d). Defaults to 24h.'),
+})
+    .refine((data) => Boolean(data.html || data.url), {
+    message: 'Either "html" or "url" must be provided',
+    path: ['html'],
+});
+export const HostedFileResponseSchema = z.object({
+    success: z.boolean(),
+    hostedUrl: z.string().url().describe('Directly accessible public CDN/document link'),
+    fileId: z.string().describe('Unique secure identifier of the stored file'),
+    filename: z.string().describe('Original or assigned file name'),
+    mimeType: z.string().describe('MIME type of the stored document'),
+    sizeBytes: z.number().describe('File size in bytes'),
+    expiresAt: z.string().describe('ISO timestamp of expiration'),
+});
+export const EInvoicePartySchema = z.object({
+    name: z.string().min(1).describe('Company or person legal name'),
+    vatId: z.string().optional().describe('VAT ID / Tax identifier (e.g. DK12345678, DE987654321)'),
+    country: z.string().length(2).default('DK').describe('ISO 3166-1 alpha-2 country code (e.g. DK, DE, FR)'),
+    street: z.string().optional().describe('Street address and building number'),
+    city: z.string().optional().describe('City name'),
+    postcode: z.string().optional().describe('Postal code / ZIP code'),
+    email: z.string().email().optional().describe('Contact email address'),
+});
+export const EInvoiceLineItemSchema = z.object({
+    name: z.string().min(1).describe('Product or service description'),
+    quantity: z.number().positive().describe('Quantity of items or hours'),
+    unitPrice: z.number().nonnegative().describe('Unit price excluding VAT'),
+    vatRate: z.number().nonnegative().default(25).describe('VAT / Tax rate in percent (e.g. 25 for 25% VAT, 0 for exempt)'),
+});
+export const RenderEInvoiceRequestSchema = z.object({
+    invoiceNumber: z.string().min(1).describe('Unique invoice reference number (e.g. INV-2026-001)'),
+    issueDate: z.string().optional().describe('Invoice date (YYYY-MM-DD)'),
+    dueDate: z.string().optional().describe('Due payment date (YYYY-MM-DD)'),
+    currency: z.string().length(3).default('EUR').describe('ISO 4217 3-letter currency code (e.g. EUR, DKK, USD, SEK)'),
+    seller: EInvoicePartySchema.describe('Supplier / Seller billing details'),
+    buyer: EInvoicePartySchema.describe('Customer / Buyer billing details'),
+    lineItems: z.array(EInvoiceLineItemSchema).min(1).describe('Line items to bill'),
+    paymentIban: z.string().optional().describe('Bank transfer IBAN number'),
+    paymentBic: z.string().optional().describe('Bank BIC / SWIFT code'),
+    notes: z.string().optional().describe('Optional payment terms or invoice notes'),
+    profile: z.enum(['BASIC', 'EN16931']).default('BASIC').describe('Factur-X / ZUGFeRD profile compliance level'),
+    store: z.boolean().default(false).describe('If true, returns hosted CDN URL in JSON response; if false, returns binary hybrid PDF'),
+    expires_in: z.enum(['1h', '24h', '7d']).default('24h').describe('Expiration duration if store is true'),
+});
+export const ErrorResponseSchema = z.object({
+    statusCode: z.number().describe('HTTP status code'),
+    error: z.string().describe('Error name / status title'),
+    message: z.string().describe('Descriptive error message'),
+    details: z.any().optional().describe('Optional validation or error details'),
+});
+//# sourceMappingURL=render.js.map

package/dist/schemas/render.js.map

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

package/dist/schemas/scrape.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export declare const ScrapeMarkdownRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    wait_for: z.ZodOptional<z.ZodString>;
+    strip_images: z.ZodDefault<z.ZodBoolean>;
+    include_raw_html: z.ZodDefault<z.ZodBoolean>;
+    timeout_ms: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    strip_images: boolean;
+    include_raw_html: boolean;
+    timeout_ms: number;
+    wait_for?: string | undefined;
+}, {
+    url: string;
+    wait_for?: string | undefined;
+    strip_images?: boolean | undefined;
+    include_raw_html?: boolean | undefined;
+    timeout_ms?: number | undefined;
+}>;
+export type ScrapeMarkdownRequest = z.infer<typeof ScrapeMarkdownRequestSchema>;
+export declare const ScrapeMarkdownResponseSchema: z.ZodObject<{
+    url: z.ZodString;
+    title: z.ZodString;
+    byline: z.ZodNullable<z.ZodString>;
+    published_at: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    markdown: z.ZodString;
+    word_count: z.ZodNumber;
+    estimated_tokens: z.ZodNumber;
+    raw_content_bytes: z.ZodNumber;
+    markdown_bytes: z.ZodNumber;
+    token_savings_percent: z.ZodString;
+    cached: z.ZodBoolean;
+    raw_html: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    title: string;
+    description: string | null;
+    byline: string | null;
+    published_at: string | null;
+    markdown: string;
+    word_count: number;
+    estimated_tokens: number;
+    raw_content_bytes: number;
+    markdown_bytes: number;
+    token_savings_percent: string;
+    cached: boolean;
+    raw_html?: string | undefined;
+}, {
+    url: string;
+    title: string;
+    description: string | null;
+    byline: string | null;
+    published_at: string | null;
+    markdown: string;
+    word_count: number;
+    estimated_tokens: number;
+    raw_content_bytes: number;
+    markdown_bytes: number;
+    token_savings_percent: string;
+    cached: boolean;
+    raw_html?: string | undefined;
+}>;
+export type ScrapeMarkdownResponse = z.infer<typeof ScrapeMarkdownResponseSchema>;

package/dist/schemas/scrape.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export const ScrapeMarkdownRequestSchema = z.object({
+    url: z.string().url('A valid http or https URL is required').describe('Target web page URL to scrape and convert to LLM-ready markdown'),
+    wait_for: z.string().optional().describe('Optional CSS selector to wait for before extracting content (e.g. "article", ".main-content")'),
+    strip_images: z.boolean().default(true).describe('Whether to remove image links and tags from generated markdown (recommended to save tokens)'),
+    include_raw_html: z.boolean().default(false).describe('Whether to include the unparsed raw HTML string in the response'),
+    timeout_ms: z.coerce.number().int().min(1000).max(15000).default(8000).describe('Hard network and render timeout in milliseconds'),
+});
+export const ScrapeMarkdownResponseSchema = z.object({
+    url: z.string().url().describe('The resolved final URL'),
+    title: z.string().describe('Extracted page or article title'),
+    byline: z.string().nullable().describe('Extracted author or publisher name if detected'),
+    published_at: z.string().nullable().describe('Publication date ISO string if detected'),
+    description: z.string().nullable().describe('Meta description or summary excerpt'),
+    markdown: z.string().describe('Clean, structured Markdown formatted for LLM prompts, RAG context, or agents'),
+    word_count: z.number().int().describe('Total word count in cleaned markdown'),
+    estimated_tokens: z.number().int().describe('Estimated LLM token count (~1.3 tokens per word)'),
+    raw_content_bytes: z.number().int().describe('Raw HTML payload size in bytes before cleaning'),
+    markdown_bytes: z.number().int().describe('Cleaned Markdown payload size in bytes'),
+    token_savings_percent: z.string().describe('Percentage of token payload saved compared to raw HTML (e.g. "94.2%")'),
+    cached: z.boolean().describe('Whether this response was served from the Redis deduplication cache'),
+    raw_html: z.string().optional().describe('Raw HTML if include_raw_html was true'),
+});
+//# sourceMappingURL=scrape.js.map

package/dist/schemas/scrape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/schemas/scrape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC,QAAQ,CAAC,iEAAiE,CAAC;IACxI,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+FAA+F,CAAC;IACzI,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,6FAA6F,CAAC;IAC/I,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,iEAAiE,CAAC;IACxH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CACnI,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACxF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACvF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAClF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;IAC7G,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC7E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC/F,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC9F,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACnF,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;IACnH,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;IACnG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAClF,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { type FastifyInstance } from 'fastify';
+export declare function buildApp(): Promise<FastifyInstance>;