chore: simplify automation to accept document URL/path inline

Author: bendersej

examples/with-playwright-automation/README.md

@@ -2,53 +2,34 @@
 
 Playwright-based CLI tool for automatically detecting form fields in PDF documents using the SimplePDF editor.
 
-## Features
-
-- Automatically detect form fields
-- Browser opens for visual inspection after detection
-
 ## Quick Start
 
 ```bash
 npm install
-npx tsx src/index.ts example.config.json
+npx tsx src/index.ts https://example.com/form.pdf
 ```
 
 ## Usage
 
 ```bash
-npx tsx src/index.ts <config.json> [options]
+npx tsx src/index.ts <document> [options]
+
+Arguments:
+  document              URL or local file path to a PDF
 
 Options:
   --company-identifier  Your SimplePDF company identifier (default: embed)
   --help                Show help
 ```
 
-### Using Your Company Identifier
+### Examples
 
 ```bash
-npx tsx src/index.ts config.json --company-identifier mycompany
-```
-
-This connects to `https://mycompany.simplepdf.com`.
-
-## Configuration
-
-Create a JSON configuration file:
-
-```json
-{
-  "document": "https://example.com/document.pdf"
-}
+npx tsx src/index.ts https://example.com/form.pdf
+npx tsx src/index.ts ./documents/form.pdf
+npx tsx src/index.ts https://example.com/form.pdf --company-identifier mycompany
 ```
 
-### Document Source
-
-| Format | Example |
-|--------|---------|
-| URL | `"https://example.com/doc.pdf"` |
-| Local file | `"./documents/form.pdf"` |
-
 ## How It Works
 
 The tool uses the SimplePDF editor's iframe postMessage API:

examples/with-playwright-automation/example.config.json

@@ -13,8 +13,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "playwright": "^1.49.0",
-    "zod": "^4.3.4"
+    "playwright": "^1.49.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",

examples/with-playwright-automation/package.json

@@ -1,7 +1,6 @@
 import { chromium, Browser, Page } from 'playwright';
 import * as fs from 'fs';
 import * as path from 'path';
-import type { AutomationConfig } from './schema';
 
 type AutomationErrorCode =
   | 'detect_fields_failed'
@@ -11,11 +10,6 @@ type AutomationResult =
   | { success: true; data: null }
   | { success: false; error: { code: AutomationErrorCode; message: string } };
 
-type RunAutomationArgs = {
-  config: AutomationConfig;
-  baseUrl: string;
-};
-
 type IframeEvent = {
   type: string;
   data?: Record<string, unknown>;
@@ -162,7 +156,7 @@ const setupIframePage = async ({
   };
 };
 
-const runAutomation = async ({ config, baseUrl }: RunAutomationArgs): Promise<AutomationResult> => {
+const runAutomation = async ({ document, baseUrl }: { document: string; baseUrl: string }): Promise<AutomationResult> => {
   let browser: Browser | null = null;
 
   try {
@@ -174,7 +168,7 @@ const runAutomation = async ({ config, baseUrl }: RunAutomationArgs): Promise<Au
 
     const page = await context.newPage();
 
-    const editorUrl = buildEditorUrl({ document: config.document, baseUrl });
+    const editorUrl = buildEditorUrl({ document, baseUrl });
     const { sendEvent, waitForEvent, waitForDocumentLoaded } = await setupIframePage({
       page,
       editorUrl,

examples/with-playwright-automation/src/automation.ts

@@ -1,49 +1,40 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { AutomationConfig } from './schema';
 import { runAutomation } from './automation';
 
 const EXIT_CODES = {
   SUCCESS: 0,
   INVALID_ARGS: 1,
-  FILE_NOT_FOUND: 2,
-  INVALID_CONFIG: 3,
-  AUTOMATION_FAILED: 4,
+  AUTOMATION_FAILED: 2,
 } as const;
 
 const DEFAULT_COMPANY_IDENTIFIER = 'embed';
 
 const printUsage = (): void => {
   console.log(`
-Usage: npx tsx src/index.ts <config.json> [options]
+Usage: npx tsx src/index.ts <document> [options]
 
 Arguments:
-  config.json           Path to JSON configuration file
+  document              URL or local file path to a PDF
 
 Options:
   --company-identifier  Your SimplePDF company identifier (default: embed)
   --help                Show this help message
 
-Configuration file format:
-{
-  "document": "https://example.com/document.pdf"
-}
-
 Examples:
-  npx tsx src/index.ts example.config.json
-  npx tsx src/index.ts example.config.json --company-identifier yourcompany
+  npx tsx src/index.ts https://example.com/form.pdf
+  npx tsx src/index.ts ./documents/form.pdf
+  npx tsx src/index.ts https://example.com/form.pdf --company-identifier yourcompany
 `);
 };
 
 type ParsedArgs = {
-  configPath: string | null;
+  document: string | null;
   baseUrl: string;
   showHelp: boolean;
 };
 
 const parseArgs = (): ParsedArgs => {
   const args = process.argv.slice(2);
-  let configPath: string | null = null;
+  let document: string | null = null;
   let companyIdentifier = DEFAULT_COMPANY_IDENTIFIER;
   let baseUrl: string | null = null;
   let showHelp = false;
@@ -67,57 +58,35 @@ const parseArgs = (): ParsedArgs => {
     }
 
     if (!arg?.startsWith('-')) {
-      configPath = arg ?? null;
+      document = arg ?? null;
     }
   }
 
   const resolvedBaseUrl = baseUrl ?? `https://${companyIdentifier}.simplepdf.com`;
 
-  return { configPath, baseUrl: resolvedBaseUrl, showHelp };
-};
-
-const loadConfig = ({ configPath }: { configPath: string }): AutomationConfig => {
-  const absolutePath = path.isAbsolute(configPath) ? configPath : path.resolve(process.cwd(), configPath);
-
-  if (!fs.existsSync(absolutePath)) {
-    throw new Error(`Configuration file not found: ${absolutePath}`);
-  }
-
-  const content = fs.readFileSync(absolutePath, 'utf-8');
-  const parsed = JSON.parse(content) as unknown;
-
-  return parsed as AutomationConfig;
+  return { document, baseUrl: resolvedBaseUrl, showHelp };
 };
 
 const main = async (): Promise<void> => {
-  const { configPath, baseUrl, showHelp } = parseArgs();
+  const { document, baseUrl, showHelp } = parseArgs();
 
   if (showHelp) {
     printUsage();
     process.exit(EXIT_CODES.SUCCESS);
   }
 
-  if (!configPath) {
-    console.error('Error: Configuration file path is required');
+  if (!document) {
+    console.error('Error: document URL or file path is required');
     printUsage();
     process.exit(EXIT_CODES.INVALID_ARGS);
   }
 
-  let config: AutomationConfig;
-  try {
-    config = loadConfig({ configPath });
-  } catch (e) {
-    const error = e as Error;
-    console.error(`Error loading configuration: ${error.message}`);
-    process.exit(EXIT_CODES.FILE_NOT_FOUND);
-  }
-
   console.log('Starting automation...');
-  console.log(`Document: ${config.document}`);
+  console.log(`Document: ${document}`);
   console.log(`Editor: ${baseUrl}`);
   console.log('');
 
-  const result = await runAutomation({ config, baseUrl });
+  const result = await runAutomation({ document, baseUrl });
 
   if (!result.success) {
     console.error(`Automation failed: [${result.error.code}] ${result.error.message}`);