pagerts 0.4.1 → 1.0.2

package/src/printers/JSONStylePrinter.ts

@@ -1,9 +0,0 @@
-import type { PageMetadata } from '../page/index.js';
-import { AbstractResourcePrinter } from './AbstractResourcePrinter.js';
-
-export class JSONStylePrinter extends AbstractResourcePrinter {
-  print(...pages: PageMetadata[]): void | Promise<void> {
-    const json = JSON.stringify(pages);
-    process.stdout.write(json + '\n');
-  }
-}

package/src/printers/LogStylePrinter.ts

@@ -1,30 +0,0 @@
-import { isPage, type PageMetadata } from '../page/index.js';
-import { AbstractResourcePrinter } from './AbstractResourcePrinter.js';
-
-export class LogStylePrinter extends AbstractResourcePrinter {
-  write(str: string): void {
-    process.stdout.write(str);
-  }
-
-  async print(...pages: PageMetadata[]): Promise<void> {
-    for (const page of pages) {
-      if (!isPage(page)) {
-        this.write(page.error);
-        continue;
-      }
-
-      const { resources, title, url } = page;
-
-      this.write(`Title: ${title}\n`);
-      this.write(`URL: ${url}\n\n`);
-
-      for (const resource of resources) {
-        const {
-          link: { url },
-          text: { value },
-        } = resource;
-        this.write(`${value}: ${url}\n`);
-      }
-    }
-  }
-}

package/src/printers/index.ts

@@ -1,3 +0,0 @@
-export { AbstractResourcePrinter } from './AbstractResourcePrinter.js';
-export { JSONStylePrinter } from './JSONStylePrinter.js';
-export { LogStylePrinter } from './LogStylePrinter.js';

package/src/resource.ts

@@ -1,88 +0,0 @@
-/**
- * @license MIT
- * We are interested in visualising a page as a collection of tags.
- *
- * We wish to work with tags that can be compactly previewed on a webpage.
- * Here we must declare all of the element types that can be used to represent
- * a resource that can be hyperlinked off a webpage.
- */
-type Tags = HTMLElementTagNameMap;
-
-function findDefinedKey(element: Resource, keys: LinkKey[]): LinkKey | undefined {
-  for (const key of keys) {
-    if (isKeyDefined(key, element)) {
-      return key;
-    }
-  }
-
-  return undefined;
-}
-
-export const RESOURCE_DISPLAYABLE_KEYS = [
-  'id',
-  'innerText',
-  'textContent',
-  'class',
-  'ariaLabel',
-  'ariaDescription',
-  'alt',
-] as const;
-
-export type DisplayableKey = (typeof RESOURCE_DISPLAYABLE_KEYS)[number];
-
-export type ResourceKey = {
-  key: DisplayableKey;
-  value: string;
-};
-
-export const RESOURCE_LINK_KEYS = ['href', 'data-src', 'target', 'action', 'src', 'url'] as const;
-
-export type LinkKey = (typeof RESOURCE_LINK_KEYS)[number];
-
-export type ResourceLink = {
-  key: LinkKey;
-  url: string;
-};
-
-export function findResourceText(element: Resource): ResourceKey | undefined {
-  for (const key of RESOURCE_DISPLAYABLE_KEYS) {
-    const value = element[key];
-    if (value && typeof value === 'string' && value.trim() !== '') return { key, value };
-  }
-
-  return undefined;
-}
-
-export function findResourceLink(element: Resource): ResourceLink | undefined {
-  const key = findDefinedKey(element, [...RESOURCE_LINK_KEYS]);
-  if (!key) {
-    return undefined;
-  }
-
-  const url = element[key];
-  if (url && typeof url === 'string' && url.trim() !== '') return { key, url };
-
-  return undefined;
-}
-
-export type ExternalResource = {
-  text: ResourceKey;
-  link: ResourceLink;
-};
-
-export const isResourceKey = (key: string): key is LinkKey => key in RESOURCE_LINK_KEYS;
-
-export const isKeyDefined = (key: DisplayableKey | LinkKey, element: Resource): boolean =>
-  key in element && element[key] !== undefined;
-
-export type ResourceElement<T, U> = {
-  [K in keyof T]: U extends keyof T[K] ? T[K] : never;
-}[keyof T];
-
-export type Tag = keyof Tags;
-
-export type Resource = HTMLElement & {
-  [K in DisplayableKey | LinkKey]?: string | null;
-};
-
-export type ResourceByName<T extends keyof Tags> = Tags[T];

package/src/security.ts

@@ -1,184 +0,0 @@
-/**
- * Security utilities for URL validation and sanitization
- */
-
-const ALLOWED_PROTOCOLS = ['http:', 'https:', 'file:'];
-const MAX_URL_LENGTH = 2048;
-const SUSPICIOUS_PATTERNS = [
-  /javascript:/i,
-  /data:/i,
-  /vbscript:/i,
-  /<script/i,
-  /on\w+=/i, // Event handlers like onclick=
-];
-
-export interface ValidationResult {
-  isValid: boolean;
-  error?: string;
-  sanitizedUrl?: string;
-}
-
-/**
- * Validates a URL for security concerns
- * @param url - The URL to validate
- * @returns ValidationResult object with validation status
- */
-export function validateUrl(url: string): ValidationResult {
-  // Check if URL is empty or whitespace
-  if (!url || !url.trim()) {
-    return {
-      isValid: false,
-      error: 'URL cannot be empty',
-    };
-  }
-
-  const trimmedUrl = url.trim();
-
-  // Check URL length to prevent DoS
-  if (trimmedUrl.length > MAX_URL_LENGTH) {
-    return {
-      isValid: false,
-      error: `URL exceeds maximum length of ${MAX_URL_LENGTH} characters`,
-    };
-  }
-
-  // Check for suspicious patterns
-  for (const pattern of SUSPICIOUS_PATTERNS) {
-    if (pattern.test(trimmedUrl)) {
-      return {
-        isValid: false,
-        error: 'URL contains suspicious patterns',
-      };
-    }
-  }
-
-  // Parse the URL
-  let parsedUrl: URL;
-  try {
-    parsedUrl = new URL(trimmedUrl);
-  } catch (error) {
-    // If URL parsing fails, it might be a file path
-    if (trimmedUrl.startsWith('file://')) {
-      return {
-        isValid: true,
-        sanitizedUrl: trimmedUrl,
-      };
-    }
-    return {
-      isValid: false,
-      error: 'Invalid URL format',
-    };
-  }
-
-  // Check protocol
-  if (!ALLOWED_PROTOCOLS.includes(parsedUrl.protocol)) {
-    return {
-      isValid: false,
-      error: `Protocol ${parsedUrl.protocol} is not allowed. Allowed protocols: ${ALLOWED_PROTOCOLS.join(', ')}`,
-    };
-  }
-
-  // Check for localhost/internal IPs in production (security consideration)
-  const hostname = parsedUrl.hostname.toLowerCase();
-  const isLocalhost =
-    hostname === 'localhost' ||
-    hostname === '127.0.0.1' ||
-    hostname === '::1' ||
-    hostname.startsWith('192.168.') ||
-    hostname.startsWith('10.') ||
-    /^172\.(1[6-9]|2\d|3[01])\./.test(hostname);
-
-  if (isLocalhost && parsedUrl.protocol !== 'file:') {
-    // Allow but warn about localhost URLs
-    console.warn(`Warning: Accessing local network resource: ${trimmedUrl}`);
-  }
-
-  return {
-    isValid: true,
-    sanitizedUrl: parsedUrl.toString(),
-  };
-}
-
-/**
- * Validates an array of URLs
- * @param urls - Array of URLs to validate
- * @returns Object with valid URLs and errors
- */
-export function validateUrls(urls: string[]): {
-  validUrls: string[];
-  errors: Array<{ url: string; error: string }>;
-} {
-  const validUrls: string[] = [];
-  const errors: Array<{ url: string; error: string }> = [];
-
-  for (const url of urls) {
-    const result = validateUrl(url);
-    if (result.isValid && result.sanitizedUrl) {
-      validUrls.push(result.sanitizedUrl);
-    } else {
-      errors.push({
-        url,
-        error: result.error || 'Unknown validation error',
-      });
-    }
-  }
-
-  return { validUrls, errors };
-}
-
-/**
- * Rate limiter to prevent abuse
- */
-export class RateLimiter {
-  private requests: number[] = [];
-  private readonly maxRequests: number;
-  private readonly windowMs: number;
-
-  constructor(maxRequests = 10, windowMs = 60000) {
-    this.maxRequests = maxRequests;
-    this.windowMs = windowMs;
-  }
-
-  /**
-   * Check if a request is allowed under rate limiting
-   * @returns true if request is allowed, false otherwise
-   */
-  public isAllowed(): boolean {
-    const now = Date.now();
-
-    // Remove old requests outside the time window
-    this.requests = this.requests.filter((time) => now - time < this.windowMs);
-
-    if (this.requests.length >= this.maxRequests) {
-      return false;
-    }
-
-    this.requests.push(now);
-    return true;
-  }
-
-  /**
-   * Get remaining requests in current window
-   */
-  public getRemainingRequests(): number {
-    const now = Date.now();
-    this.requests = this.requests.filter((time) => now - time < this.windowMs);
-    return Math.max(0, this.maxRequests - this.requests.length);
-  }
-}
-
-/**
- * Sanitizes HTML content to prevent XSS attacks
- * @param text - Text to sanitize
- * @returns Sanitized text
- */
-export function sanitizeText(text: string): string {
-  if (!text) return '';
-
-  return text
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&#x27;')
-    .replace(/\//g, '&#x2F;');
-}

package/tsconfig.eslint.json

@@ -1,5 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "bin", "coverage"]
-}

package/tsconfig.json

@@ -1,28 +0,0 @@
-{
-  "compilerOptions": {
-    "module": "NodeNext",
-    "target": "ES2022",
-    "lib": ["ES2022"],
-    "moduleResolution": "NodeNext",
-    "resolveJsonModule": true,
-    "outDir": "bin",
-    "sourceMap": true,
-    "strict": true,
-    "noImplicitAny": true,
-    "strictNullChecks": true,
-    "strictFunctionTypes": true,
-    "strictBindCallApply": true,
-    "strictPropertyInitialization": true,
-    "noImplicitThis": true,
-    "alwaysStrict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "bin", "coverage", "**/*.test.ts", "**/*.spec.ts"]
-}