googleformsubmitter 1.0.0

package/create-form.ts

@@ -0,0 +1,410 @@
+import fs from 'fs/promises';
+import path from 'path';
+import process from 'process';
+import { google } from 'googleapis';
+import { authenticate } from '@google-cloud/local-auth';
+
+// Helper to check if file exists
+async function fileExists(filePath: string): Promise<boolean> {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function resolvePaths() {
+  let credentialsPath = path.join(process.cwd(), '.data', 'credentials.json');
+  let tokenPath = path.join(process.cwd(), '.data', 'forms-auth.json');
+
+  // Fallback to parent directory if not found in current directory
+  if (!(await fileExists(credentialsPath))) {
+    const parentCreds = path.join(process.cwd(), '..', '.data', 'credentials.json');
+    if (await fileExists(parentCreds)) {
+      credentialsPath = parentCreds;
+    }
+  }
+
+  if (!(await fileExists(tokenPath))) {
+    const parentToken = path.join(process.cwd(), '..', '.data', 'forms-auth.json');
+    if (await fileExists(parentToken)) {
+      tokenPath = parentToken;
+    }
+  }
+
+  return { credentialsPath, tokenPath };
+}
+
+const SCOPES = [
+  'https://www.googleapis.com/auth/forms.body',
+  'https://www.googleapis.com/auth/drive'
+];
+
+async function loadSavedCredentialsIfExist(tokenPath: string) {
+  try {
+    const content = await fs.readFile(tokenPath, 'utf-8');
+    const credentials = JSON.parse(content);
+    
+    const oauth2Client = new google.auth.OAuth2(
+      credentials.client_id,
+      credentials.client_secret
+    );
+    oauth2Client.setCredentials({ refresh_token: credentials.refresh_token });
+    return oauth2Client;
+  } catch (err) {
+    return null;
+  }
+}
+
+async function saveCredentials(refreshToken: string, credentialsPath: string, tokenPath: string): Promise<void> {
+  const content = await fs.readFile(credentialsPath, 'utf-8');
+  const keys = JSON.parse(content);
+  const key = keys.installed || keys.web;
+  const payload = JSON.stringify({
+    type: 'authorized_user',
+    client_id: key.client_id,
+    client_secret: key.client_secret,
+    refresh_token: refreshToken,
+  });
+  await fs.mkdir(path.dirname(tokenPath), { recursive: true });
+  await fs.writeFile(tokenPath, payload);
+}
+
+async function authorize(credentialsPath: string, tokenPath: string) {
+  const saved = await loadSavedCredentialsIfExist(tokenPath);
+  if (saved) return saved;
+
+  console.log('Triggering new authentication flow for Google Forms & Drive...');
+  const client = await authenticate({
+    scopes: SCOPES,
+    keyfilePath: credentialsPath,
+  });
+
+  const refreshToken = client.credentials.refresh_token;
+  if (refreshToken) {
+    await saveCredentials(refreshToken, credentialsPath, tokenPath);
+  }
+
+  const content = await fs.readFile(credentialsPath, 'utf-8');
+  const keys = JSON.parse(content);
+  const key = keys.installed || keys.web;
+  const oauth2Client = new google.auth.OAuth2(
+    key.client_id,
+    key.client_secret,
+    key.redirect_uris?.[0]
+  );
+  oauth2Client.setCredentials(client.credentials);
+  return oauth2Client;
+}
+
+async function main() {
+  const { credentialsPath, tokenPath } = await resolvePaths();
+
+  await fs.access(credentialsPath).catch(() => {
+    console.error(`❌ Error: Credentials file not found at ${credentialsPath}`);
+    console.log('Please place your Google Cloud credentials.json in the .data directory.');
+    process.exit(1);
+  });
+
+  const auth = await authorize(credentialsPath, tokenPath);
+  const forms = google.forms({ version: 'v1', auth });
+
+  console.log('Creating new Google Form...');
+  const formRes = await forms.forms.create({
+    requestBody: {
+      info: {
+        title: "Анкета для отправки кандидата на рассмотрение (Копия)"
+      }
+    }
+  });
+
+  const formId = formRes.data.formId!;
+  const responderUri = formRes.data.responderUri!;
+  console.log(`Created Form ID: ${formId}`);
+
+  console.log('Adding questions to the form...');
+  
+  const requests = [
+    // 1. Update form description
+    {
+      updateFormInfo: {
+        info: {
+          description: "Заполните, пожалуйста, информацию по направляемому кандидату"
+        },
+        updateMask: "description"
+      }
+    },
+    // 2. Add "Номер запроса" (Required, Short Text)
+    {
+      createItem: {
+        item: {
+          title: "Номер запроса",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {}
+            }
+          }
+        },
+        location: { index: 0 }
+      }
+    },
+    // 3. Add "ФИО (полностью)" (Required, Short Text)
+    {
+      createItem: {
+        item: {
+          title: "ФИО (полностью)",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {}
+            }
+          }
+        },
+        location: { index: 1 }
+      }
+    },
+    // 4. Add "Дата рождения" (Required, Date)
+    {
+      createItem: {
+        item: {
+          title: "Дата рождения",
+          questionItem: {
+            question: {
+              required: true,
+              dateQuestion: {
+                includeYear: true,
+                includeTime: false
+              }
+            }
+          }
+        },
+        location: { index: 2 }
+      }
+    },
+    // 5. Add "Грейд" (Required, Dropdown)
+    {
+      createItem: {
+        item: {
+          title: "Грейд",
+          questionItem: {
+            question: {
+              required: true,
+              choiceQuestion: {
+                type: "DROP_DOWN",
+                options: [
+                  { value: "Junior" },
+                  { value: "Junior+" },
+                  { value: "Middle" },
+                  { value: "Middle+" },
+                  { value: "Senior" },
+                  { value: "Senior+" },
+                  { value: "Team Lead" }
+                ]
+              }
+            }
+          }
+        },
+        location: { index: 3 }
+      }
+    },
+    // 6. Add "Локация (страна, город)" (Required, Short Text)
+    {
+      createItem: {
+        item: {
+          title: "Локация (страна, город)",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {}
+            }
+          }
+        },
+        location: { index: 4 }
+      }
+    },
+    // 7. Add "Рейт (руб./ч) без НДС " (Required, Short Text)
+    {
+      createItem: {
+        item: {
+          title: "Рейт (руб./ч) без НДС ",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {}
+            }
+          }
+        },
+        location: { index: 5 }
+      }
+    },
+    // 8. Add "Какой у вас НДС: " (Required, Multiple Choice)
+    {
+      createItem: {
+        item: {
+          title: "Какой у вас НДС: ",
+          questionItem: {
+            question: {
+              required: true,
+              choiceQuestion: {
+                type: "RADIO",
+                options: [
+                  { value: "5%" },
+                  { value: "7%" },
+                  { value: "20%" },
+                  { value: "22%" },
+                  { value: "Нет" }
+                ]
+              }
+            }
+          }
+        },
+        location: { index: 6 }
+      }
+    },
+    // 9. Add "Когда кандидат сможет выйти на проект" (Required, Paragraph)
+    {
+      createItem: {
+        item: {
+          title: "Когда кандидат сможет выйти на проект",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {
+                paragraph: true
+              }
+            }
+          }
+        },
+        location: { index: 7 }
+      }
+    },
+    // 10. Add "Ближайший планируемый отпуск" (Required, Short Text)
+    {
+      createItem: {
+        item: {
+          title: "Ближайший планируемый отпуск",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {}
+            }
+          }
+        },
+        location: { index: 8 }
+      }
+    },
+    // 11. Add "Находится ли специалист в штате? " (Required, Multiple Choice)
+    {
+      createItem: {
+        item: {
+          title: "Находится ли специалист в штате? ",
+          description: "⚠️ [ВНИМАНИЕ] В веб-редакторе формы обязательно нажмите кнопку \"Добавить вариант 'Другое'\" (Add 'Other') для этого вопроса.",
+          questionItem: {
+            question: {
+              required: true,
+              choiceQuestion: {
+                type: "RADIO",
+                options: [
+                  { value: "Да" }
+                ]
+              }
+            }
+          }
+        },
+        location: { index: 9 }
+      }
+    },
+    // 12. Add PLACEHOLDER for CV (файл)
+    {
+      createItem: {
+        item: {
+          title: "CV (файл) ",
+          description: "⚠️ [ВНИМАНИЕ] Google Forms API запрещает программное создание полей 'Загрузка файла'. Пожалуйста, перейдите в веб-интерфейс редактирования формы по ссылке ниже и вручную измените тип этого вопроса с 'Текст (строка)' на 'Загрузка файлов' (File Upload). Назовите вопрос именно 'CV (файл) ', сделайте его обязательным и укажите разрешённые типы: только DOC/DOCX, размер до 10 МБ.",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {}
+            }
+          }
+        },
+        location: { index: 10 }
+      }
+    },
+    // 13. Add "Название вашей компании и контакты для связи" (Required, Short Text)
+    {
+      createItem: {
+        item: {
+          title: "Название вашей компании и контакты для связи",
+          description: "Пример: 65apps, ТГ - @Elizaveta_Kalinina",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {}
+            }
+          }
+        },
+        location: { index: 11 }
+      }
+    },
+    // 14. Add "Чек-лист по требованиям " (Required, Paragraph)
+    {
+      createItem: {
+        item: {
+          title: "Чек-лист по требованиям ",
+          questionItem: {
+            question: {
+              required: true,
+              textQuestion: {
+                paragraph: true
+              }
+            }
+          }
+        },
+        location: { index: 12 }
+      }
+    },
+    // 15. Add "Комментарий" (Optional, Paragraph)
+    {
+      createItem: {
+        item: {
+          title: "Комментарий",
+          questionItem: {
+            question: {
+              required: false,
+              textQuestion: {
+                paragraph: true
+              }
+            }
+          }
+        },
+        location: { index: 13 }
+      }
+    }
+  ];
+
+  await forms.forms.batchUpdate({
+    formId,
+    requestBody: {
+      requests
+    }
+  });
+
+  console.log('\n🎉 Google Form has been successfully created!');
+  console.log(`🔗 Link to edit (Google Forms Owner Web UI):`);
+  console.log(`   https://docs.google.com/forms/d/${formId}/edit`);
+  console.log(`🔗 Link to fill (Responder Web UI):`);
+  console.log(`   ${responderUri}`);
+  console.log('\n⚠️  IMPORTANT NOTES:');
+  console.log('  1. Since Google Forms API forbids programmatic creation of File Upload fields,');
+  console.log('     the question "CV (файл) " was created as a standard text field.');
+  console.log('     You must open the edit link above and manually change the type of "CV (файл) " to "File Upload" (Загрузка файлов).');
+  console.log('  2. For the question "Находится ли специалист в штате?", you must click "Добавить вариант \'Другое\'" (Add \'Other\')');
+  console.log('     in the edit UI so custom answers like "С рынка, на предоффере" can be submitted.');
+}
+
+main().catch((err) => {
+  console.error('❌ Failed to create Google Form:', err);
+  process.exit(1);
+});

package/index.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './GoogleFormSubmitter';

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "googleformsubmitter",
+  "version": "1.0.0",
+  "module": "index.ts",
+  "type": "module",
+  "scripts": {
+    "test": "bun run ./test.ts",
+    "lint": "oxlint",
+    "validate": "tsgo --noEmit",
+    "create-form": "bun run ./create-form.ts"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@typescript/native-preview": "^7.0.0-dev.20260706.1",
+    "oxlint": "^1.72.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@google-cloud/local-auth": "^3.0.1",
+    "ajv": "^8.20.0",
+    "googleapis": "^173.0.0",
+    "playwright": "^1.61.1"
+  }
+}

package/test.ts

@@ -0,0 +1,139 @@
+import { GoogleFormSubmitter } from './GoogleFormSubmitter';
+import type { FormSchemaMapping } from './types';
+import fs from 'fs/promises';
+import path from 'path';
+
+// 1. Describe the Form structure using JSON Schema (Standard specification)
+const jsonSchema = {
+  type: 'object',
+  properties: {
+    requestId: { type: 'string' },
+    fullName: { type: 'string' },
+    birthDate: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+    grade: { type: 'string', enum: ['Junior', 'Junior+', 'Middle', 'Middle+', 'Senior', 'Senior+', 'Team Lead'] },
+    location: { type: 'string' },
+    rate: { type: 'string' },
+    nds: { type: 'string', enum: ['5%', '7%', '20%', '22%', 'Нет'] },
+    exitDate: { type: 'string' },
+    vacation: { type: 'string' },
+    inStaff: { type: 'string' },
+    cvFile: {
+      type: 'object',
+      properties: {
+        fileId: { type: 'string' },
+        filename: { type: 'string' },
+        mimeType: { type: 'string' }
+      },
+      required: ['fileId', 'filename', 'mimeType']
+    },
+    company: { type: 'string' },
+    checklist: { type: 'string' },
+    comment: { type: 'string' }
+  },
+  required: [
+    'requestId',
+    'fullName',
+    'birthDate',
+    'grade',
+    'location',
+    'rate',
+    'nds',
+    'exitDate',
+    'vacation',
+    'inStaff',
+    'cvFile',
+    'company',
+    'checklist'
+  ]
+};
+
+// 2. Describe the mapping schema pointing property names to their Form titles/labels
+const mappingSchema: FormSchemaMapping = {
+  requestId: { label: 'Номер запроса', type: 'text' },
+  fullName: { label: 'ФИО (полностью)', type: 'text' },
+  birthDate: { label: 'Дата рождения', type: 'date' },
+  grade: { label: 'Грейд', type: 'choice', options: { choices: ['Junior', 'Junior+', 'Middle', 'Middle+', 'Senior', 'Senior+', 'Team Lead'] } },
+  location: { label: 'Локация (страна, город)', type: 'text' },
+  rate: { label: 'Рейт (руб./ч) без НДС', type: 'text' },
+  nds: { label: 'Какой у вас НДС:', type: 'choice', options: { choices: ['5%', '7%', '20%', '22%', 'Нет'] } },
+  exitDate: { label: 'Когда кандидат сможет выйти на проект', type: 'paragraph' },
+  vacation: { label: 'Ближайший планируемый отпуск', type: 'text' },
+  inStaff: { label: 'Находится ли специалист в штате?', type: 'choice', options: { choices: ['Да'], allowOther: true } },
+  cvFile: { label: 'CV (файл)', type: 'file' },
+  company: { label: 'Название вашей компании и контакты для связи', type: 'text' },
+  checklist: { label: 'Чек-лист по требованиям', type: 'paragraph' },
+  comment: { label: 'Комментарий', type: 'paragraph' }
+};
+
+async function run() {
+  console.log('🚀 Starting Google Form Submitter Integration Test...');
+
+  // Load cookies from local scratch path if it exists
+  let cookies: any[] = [];
+  const localCookiesPath = path.join(__dirname, '..', 'scratch', 'playwright-submit', 'google-cookies.json');
+  try {
+    const cookiesStr = await fs.readFile(localCookiesPath, 'utf8');
+    cookies = JSON.parse(cookiesStr);
+    console.log(`[Test] Loaded ${cookies.length} session cookies from ${localCookiesPath}`);
+  } catch (err: any) {
+    console.warn(`[Test] Warning: Could not load local session cookies: ${err.message}`);
+  }
+
+  // 3. Instantiate the Submitter
+  const formUrl = 'https://docs.google.com/forms/d/e/1FAIpQLSc1aiEAhxWCMSNjZ1asGDtXV_mT8vTiJRquiqfdjsoMkKT9tw/viewform';
+  const submitter = new GoogleFormSubmitter({
+    formUrl,
+    jsonSchema,
+    mappingSchema,
+    cdpUrl: 'ws://127.0.0.1:9222/', // CDP endpoint to Lightpanda
+    cacheDir: './.data',
+    cookies
+  });
+
+  // Mock candidate payload matching the JSON Schema
+  const candidateData = {
+    requestId: '910',
+    fullName: 'Багманов Алмаз (Схема)',
+    birthDate: '1996-07-03',
+    grade: 'Middle',
+    location: 'Россия, Набережные Челны',
+    rate: '2000',
+    nds: 'Нет',
+    exitDate: 'через 21 дней',
+    vacation: 'нет',
+    inStaff: 'Да', // Standard predefined value
+    cvFile: {
+      fileId: '1BRVwwPlohb_4g7DUZ3HTzHTwe6yQz2f7', // Real Drive File ID from earlier successful run
+      filename: 'cv_Багманов_Алмаз.docx',
+      mimeType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+    },
+    company: 'Iconicompany',
+    checklist: '📊 Чек-лист: 77% (Kotlin, Android, Compose, Coroutines)',
+    comment: 'Отправлено автоматически через типизированный маппер.'
+  };
+
+  try {
+    // Perform first submission (will trigger lazy DOM-resolution and save cache)
+    console.log('\n--- FIRST RUN: Performing dynamic DOM-resolution and submission ---');
+    const result1 = await submitter.submit(candidateData);
+    console.log('Result 1 Success:', result1.success);
+    console.log('Result 1 Status Code:', result1.statusCode);
+    console.log('Result 1 Fields Submitted:', JSON.stringify(result1.fieldsSubmitted, null, 2));
+
+    // Perform second submission (will load resolved entryIds instantly from cache)
+    console.log('\n--- SECOND RUN: Submitting instantly using cache ---');
+    // Change name slightly to verify a new answer is posted
+    candidateData.fullName = 'Багманов Алмаз (Схема-Кэш)';
+    const result2 = await submitter.submit(candidateData);
+    console.log('Result 2 Success:', result2.success);
+    console.log('Result 2 Status Code:', result2.statusCode);
+    console.log('Result 2 Fields Submitted:', JSON.stringify(result2.fieldsSubmitted, null, 2));
+
+    console.log('\n🎉 Integration test completed successfully!');
+  } catch (error) {
+    console.error('❌ Integration test failed:', error);
+    process.exit(1);
+  }
+}
+
+run();

package/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext", "DOM"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "types": ["bun"],
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}

package/types.ts

@@ -0,0 +1,18 @@
+export interface FormFieldMapping {
+  label: string;
+  type: 'text' | 'paragraph' | 'choice' | 'date' | 'file';
+  allowOther?: boolean;
+  options?: {
+    choices?: string[];
+    allowOther?: boolean;
+  };
+}
+
+export type FormSchemaMapping = Record<string, FormFieldMapping>;
+
+export interface SubmissionResult {
+  success: boolean;
+  statusCode: number;
+  message?: string;
+  fieldsSubmitted: Record<string, string>;
+}