@hasna/connectors 1.3.44 → 1.3.46

package/connectors/tidio/src/index.ts

@@ -1,12 +1,12 @@
 // Tidio Connector
-// Live chat support, contacts, conversations, and operators
+// Contacts, contact messages, departments, operators, project, tickets, products, and Lyro.
 
 export { Tidio, TidioClient } from './api';
 export * from './types';
 
 export {
-  getApiKey,
-  setApiKey,
+  getClientCredentials,
+  setClientCredentials,
   getCurrentProfile,
   setCurrentProfile,
   listProfiles,
@@ -16,5 +16,7 @@ export {
   saveProfile,
   clearConfig,
   getConfigDir,
+  getProfilesDir,
   getActiveProfileName,
+  validateProfileName,
 } from './utils/config';

package/connectors/tidio/src/types/index.ts

@@ -1,20 +1,16 @@
 // Tidio Connector Types
 
 export interface TidioConfig {
-  apiKey: string;
+  clientId: string;
+  clientSecret: string;
   baseUrl?: string;
 }
 
 export type OutputFormat = 'json' | 'pretty';
 
-export type ConversationStatus = 'open' | 'closed' | 'snoozed';
-export type MessageType = 'text' | 'image' | 'file' | 'note';
-export type WebhookEvent =
-  | 'contact.created'
-  | 'contact.updated'
-  | 'conversation.created'
-  | 'conversation.updated'
-  | 'message.created';
+export type TicketStatus = 'open' | 'pending' | 'closed';
+export type TicketPriority = 'low' | 'medium' | 'high' | 'urgent';
+export type LyroDataSourceKind = 'folder' | 'qa';
 
 export interface PaginatedMeta {
   cursor?: string;
@@ -23,7 +19,7 @@ export interface PaginatedMeta {
 }
 
 export interface PaginatedResponse<T> {
-  data?: T[];
+  resources?: T[];
   meta?: PaginatedMeta;
   [key: string]: unknown;
 }
@@ -32,40 +28,39 @@ export interface Contact {
   id: string;
   email?: string;
   phone?: string;
-  name?: string;
-  external_id?: string;
-  tags?: string[];
-  properties?: Record<string, unknown>;
-  subscriber?: boolean;
-  consent?: boolean;
+  first_name?: string | null;
+  last_name?: string | null;
+  distinct_id?: string;
+  properties?: ContactProperty[];
+  email_consent?: 'subscribed' | 'unsubscribed' | null;
   created_at?: string;
   updated_at?: string;
   [key: string]: unknown;
 }
 
-export interface Conversation {
+export interface ContactProperty {
+  name: string;
+  value: string | number | boolean | null;
+}
+
+export interface ContactMessage {
   id: string;
-  status?: ConversationStatus;
-  channel?: string;
   contact_id?: string;
-  operator_id?: string;
-  department_id?: string;
-  created_at?: string;
-  updated_at?: string;
+  message?: string;
+  author?: string;
+  timestamp?: string;
   [key: string]: unknown;
 }
 
-export interface Message {
-  id: string;
-  type?: MessageType;
-  content?: string;
-  media_url?: string;
-  private?: boolean;
-  operator_id?: string;
-  created_at?: string;
+export interface MessageAccepted {
+  status?: string;
   [key: string]: unknown;
 }
 
+export interface UuidResponse {
+  id: string;
+}
+
 export interface Operator {
   id: string;
   name?: string;
@@ -79,32 +74,59 @@ export interface Department {
   [key: string]: unknown;
 }
 
-export interface Tag {
+export interface TicketTag {
   id: string;
   name: string;
-  color?: string;
   [key: string]: unknown;
 }
 
-export interface Automation {
+export interface TicketCustomField {
   id: string;
   name?: string;
+  type?: string;
   [key: string]: unknown;
 }
 
-export interface CannedResponse {
+export interface Ticket {
   id: string;
-  shortcut: string;
-  content: string;
-  department_id?: string;
+  status?: TicketStatus;
+  priority?: TicketPriority;
+  subject?: string;
+  contact_id?: string;
+  assignee_id?: string | null;
+  department_id?: string | null;
+  messages?: unknown[];
+  created_at?: string;
+  updated_at?: string;
   [key: string]: unknown;
 }
 
-export interface Webhook {
-  id: string;
+export interface Product {
+  id: number;
+  title: string;
   url: string;
-  events: WebhookEvent[];
-  secret?: string;
+  image_url?: string;
+  description?: string;
+  price?: number;
+  default_currency?: string;
+  vendor?: string;
+  product_type?: string;
+  sku?: string;
+  barcode?: string;
+  availability?: string;
+  updated_at: string;
+  features?: Record<string, string>;
+  [key: string]: unknown;
+}
+
+export interface LyroDataSource {
+  id: string;
+  kind?: LyroDataSourceKind;
+  type?: string;
+  title?: string;
+  content?: string | null;
+  source_url?: string | null;
+  parent_id?: string | null;
   [key: string]: unknown;
 }
 
@@ -124,76 +146,106 @@ export interface ListContactsParams {
 export interface CreateContactParams {
   email?: string;
   phone?: string;
-  name?: string;
-  externalId?: string;
-  tags?: string[];
-  properties?: Record<string, unknown>;
-  subscriber?: boolean;
-  consent?: boolean;
+  firstName?: string | null;
+  lastName?: string | null;
+  distinctId?: string;
+  properties?: ContactProperty[];
+  emailConsent?: 'subscribed' | 'unsubscribed' | null;
 }
 
 export interface UpdateContactParams {
   email?: string;
   phone?: string;
-  name?: string;
-  externalId?: string;
-  tags?: string[];
-  properties?: Record<string, unknown>;
-  subscriber?: boolean;
-  consent?: boolean;
+  firstName?: string | null;
+  lastName?: string | null;
+  distinctId?: string;
+  properties?: ContactProperty[];
+  emailConsent?: 'subscribed' | 'unsubscribed' | null;
 }
 
-export interface ListConversationsParams {
-  limit?: number;
+export interface BatchContactsParams<T extends CreateContactParams | UpdateContactParams> {
+  contacts: T[];
+}
+
+export interface ListContactMessagesParams {
   cursor?: string;
-  status?: ConversationStatus;
-  channel?: string;
-  updatedAfter?: string;
 }
 
-export interface ListMessagesParams {
+export interface SendContactMessageParams {
+  message: string;
+}
+
+export interface ListTicketsParams {
   limit?: number;
   cursor?: string;
+  status?: TicketStatus;
+  priority?: TicketPriority;
 }
 
-export interface SendMessageParams {
-  type: MessageType;
-  content: string;
-  mediaUrl?: string;
-  private?: boolean;
-  operatorId?: string;
+export interface CreateTicketAsContactParams {
+  contactId: string;
+  message: string;
+  subject?: string;
+  priority?: TicketPriority;
 }
 
-export interface SetConversationStatusParams {
-  status: ConversationStatus;
-  snoozedUntil?: string;
+export interface UpdateTicketParams {
+  status?: TicketStatus;
+  priority?: TicketPriority;
+  assigneeId?: string | null;
+  departmentId?: string | null;
 }
 
-export interface AssignConversationParams {
-  operatorId: string | null;
-  departmentId?: string;
+export interface ReplyTicketParams {
+  message: string;
+  authorType?: 'operator' | 'contact';
 }
 
-export interface CreateTagParams {
-  name: string;
-  color?: string;
+export interface ListLyroDataSourcesParams {
+  cursor?: string;
+  limit?: number;
+  kind?: LyroDataSourceKind;
+  parentId?: string | null;
+}
+
+export interface CreateLyroQaDataSourceParams {
+  question: string;
+  answer: string;
+  parentId?: string | null;
 }
 
-export interface CreateCannedResponseParams {
-  shortcut: string;
+export interface UpsertLyroWebsiteDataSourceParams {
+  url: string;
+  title?: string;
   content: string;
-  departmentId?: string;
 }
 
-export interface CreateWebhookParams {
+export interface ScrapeLyroWebsiteParams {
   url: string;
-  events: WebhookEvent[];
-  secret?: string;
+}
+
+export interface LyroTicketMessage {
+  created_at: string;
+  message_id: string;
+  author_type: 'contact';
+  message_type: 'public';
+  message_content: string;
+  attachments?: string[];
+}
+
+export interface AskLyroTicketParams {
+  ticketId: string;
+  subject: string;
+  contactEmail: string;
+  contactName: string;
+  recipientEmail: string;
+  messages: LyroTicketMessage[];
 }
 
 export interface TidioErrorResponse {
   message?: string;
   error?: string;
+  errors?: Array<{ code?: string; message?: string }>;
   [key: string]: unknown;
 }
 
@@ -211,6 +263,7 @@ export class TidioApiError extends Error {
 
 export function parseTidioError(data: unknown, statusCode: number): TidioApiError {
   const record = data && typeof data === 'object' ? (data as TidioErrorResponse) : {};
-  const message = record.message ?? record.error ?? `Request failed (${statusCode})`;
+  const nestedMessage = Array.isArray(record.errors) ? record.errors[0]?.message : undefined;
+  const message = nestedMessage ?? record.message ?? record.error ?? `Request failed (${statusCode})`;
   return new TidioApiError(String(message), statusCode, record);
 }

package/connectors/tidio/src/utils/config.ts

@@ -1,35 +1,73 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  rmSync,
+  chmodSync,
+  writeFileSync,
+} from 'fs';
 import { homedir } from 'os';
-import { join } from 'path';
+import { join, resolve, sep } from 'path';
 
 const CONNECTOR_NAME = 'connect-tidio';
 const DEFAULT_PROFILE = 'default';
+const PROFILE_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
 
 export interface ProfileConfig {
-  apiKey?: string;
+  clientId?: string;
+  clientSecret?: string;
 }
 
 let profileOverride: string | undefined;
 
-const CONFIG_DIR = join(homedir(), '.hasna', 'connectors', CONNECTOR_NAME);
-const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
-const CURRENT_PROFILE_FILE = join(CONFIG_DIR, 'current_profile');
+function rootConfigDir(): string {
+  return process.env.TIDIO_CONFIG_HOME || join(homedir(), '.hasna', 'connectors', CONNECTOR_NAME);
+}
 
-export function setProfileOverride(profile: string | undefined): void {
-  profileOverride = profile;
+function profilesDir(): string {
+  return join(rootConfigDir(), 'profiles');
 }
 
-export function ensureConfigDir(): void {
-  if (!existsSync(CONFIG_DIR)) {
-    mkdirSync(CONFIG_DIR, { recursive: true });
+function currentProfileFile(): string {
+  return join(rootConfigDir(), 'current_profile');
+}
+
+export function validateProfileName(profile: string): string {
+  if (!PROFILE_NAME_PATTERN.test(profile)) {
+    throw new Error('Profile name can only contain letters, numbers, hyphens, and underscores');
   }
-  if (!existsSync(PROFILES_DIR)) {
-    mkdirSync(PROFILES_DIR, { recursive: true });
+  return profile;
+}
+
+function ensureInsideProfilesDir(path: string): string {
+  const root = resolve(profilesDir());
+  const candidate = resolve(path);
+  if (candidate !== root && !candidate.startsWith(`${root}${sep}`)) {
+    throw new Error('Profile path escapes the profiles directory');
   }
+  return candidate;
+}
+
+export function setProfileOverride(profile: string | undefined): void {
+  profileOverride = profile ? validateProfileName(profile) : undefined;
+}
+
+export function ensureConfigDir(): void {
+  mkdirSync(rootConfigDir(), { recursive: true, mode: 0o700 });
+  chmodSync(rootConfigDir(), 0o700);
+  mkdirSync(profilesDir(), { recursive: true, mode: 0o700 });
+  chmodSync(profilesDir(), 0o700);
 }
 
 function getProfilePath(profile: string): string {
-  return join(PROFILES_DIR, `${profile}.json`);
+  const validProfile = validateProfileName(profile);
+  return ensureInsideProfilesDir(join(profilesDir(), `${validProfile}.json`));
+}
+
+function writePrivateFile(path: string, value: string): void {
+  writeFileSync(path, value, { mode: 0o600 });
+  chmodSync(path, 0o600);
 }
 
 export function getCurrentProfile(): string {
@@ -39,14 +77,14 @@ export function getCurrentProfile(): string {
 
   ensureConfigDir();
 
-  if (existsSync(CURRENT_PROFILE_FILE)) {
+  if (existsSync(currentProfileFile())) {
     try {
-      const profile = readFileSync(CURRENT_PROFILE_FILE, 'utf-8').trim();
-      if (profile && profileExists(profile)) {
+      const profile = readFileSync(currentProfileFile(), 'utf-8').trim();
+      if (profile && validateProfileName(profile) && profileExists(profile)) {
         return profile;
       }
     } catch {
-      // Fall through to default
+      // Fall through to default.
     }
   }
 
@@ -54,13 +92,14 @@ export function getCurrentProfile(): string {
 }
 
 export function setCurrentProfile(profile: string): void {
+  const validProfile = validateProfileName(profile);
   ensureConfigDir();
 
-  if (!profileExists(profile) && profile !== DEFAULT_PROFILE) {
-    throw new Error(`Profile "${profile}" does not exist`);
+  if (!profileExists(validProfile) && validProfile !== DEFAULT_PROFILE) {
+    throw new Error(`Profile "${validProfile}" does not exist`);
   }
 
-  writeFileSync(CURRENT_PROFILE_FILE, profile);
+  writePrivateFile(currentProfileFile(), validProfile);
 }
 
 export function profileExists(profile: string): boolean {
@@ -70,51 +109,50 @@ export function profileExists(profile: string): boolean {
 export function listProfiles(): string[] {
   ensureConfigDir();
 
-  if (!existsSync(PROFILES_DIR)) {
+  if (!existsSync(profilesDir())) {
     return [];
   }
 
-  return readdirSync(PROFILES_DIR)
-    .filter(f => f.endsWith('.json'))
-    .map(f => f.replace('.json', ''))
+  return readdirSync(profilesDir())
+    .filter(file => file.endsWith('.json'))
+    .map(file => file.replace(/\.json$/, ''))
+    .filter(profile => PROFILE_NAME_PATTERN.test(profile))
     .sort();
 }
 
 export function createProfile(profile: string, config: ProfileConfig = {}): boolean {
+  const validProfile = validateProfileName(profile);
   ensureConfigDir();
 
-  if (profileExists(profile)) {
+  if (profileExists(validProfile)) {
     return false;
   }
 
-  if (!/^[a-zA-Z0-9_-]+$/.test(profile)) {
-    throw new Error('Profile name can only contain letters, numbers, hyphens, and underscores');
-  }
-
-  writeFileSync(getProfilePath(profile), JSON.stringify(config, null, 2));
+  writePrivateFile(getProfilePath(validProfile), `${JSON.stringify(config, null, 2)}\n`);
   return true;
 }
 
 export function deleteProfile(profile: string): boolean {
-  if (profile === DEFAULT_PROFILE) {
+  const validProfile = validateProfileName(profile);
+  if (validProfile === DEFAULT_PROFILE) {
     return false;
   }
 
-  if (!profileExists(profile)) {
+  if (!profileExists(validProfile)) {
     return false;
   }
 
-  if (getCurrentProfile() === profile) {
+  if (getCurrentProfile() === validProfile) {
     setCurrentProfile(DEFAULT_PROFILE);
   }
 
-  rmSync(getProfilePath(profile));
+  rmSync(getProfilePath(validProfile));
   return true;
 }
 
 export function loadProfile(profile?: string): ProfileConfig {
   ensureConfigDir();
-  const profileName = profile || getCurrentProfile();
+  const profileName = profile ? validateProfileName(profile) : getCurrentProfile();
   const profilePath = getProfilePath(profileName);
 
   if (!existsSync(profilePath)) {
@@ -122,7 +160,7 @@ export function loadProfile(profile?: string): ProfileConfig {
   }
 
   try {
-    return JSON.parse(readFileSync(profilePath, 'utf-8'));
+    return JSON.parse(readFileSync(profilePath, 'utf-8')) as ProfileConfig;
   } catch {
     return {};
   }
@@ -130,17 +168,21 @@ export function loadProfile(profile?: string): ProfileConfig {
 
 export function saveProfile(config: ProfileConfig, profile?: string): void {
   ensureConfigDir();
-  const profileName = profile || getCurrentProfile();
-  writeFileSync(getProfilePath(profileName), JSON.stringify(config, null, 2));
+  const profileName = profile ? validateProfileName(profile) : getCurrentProfile();
+  writePrivateFile(getProfilePath(profileName), `${JSON.stringify(config, null, 2)}\n`);
 }
 
-export function getApiKey(): string | undefined {
-  return process.env.TIDIO_API_KEY || loadProfile().apiKey;
+export function getClientCredentials(): ProfileConfig {
+  return {
+    clientId: process.env.TIDIO_CLIENT_ID || loadProfile().clientId,
+    clientSecret: process.env.TIDIO_CLIENT_SECRET || loadProfile().clientSecret,
+  };
 }
 
-export function setApiKey(apiKey: string): void {
+export function setClientCredentials(clientId: string, clientSecret: string): void {
   const config = loadProfile();
-  config.apiKey = apiKey;
+  config.clientId = clientId;
+  config.clientSecret = clientSecret;
   saveProfile(config);
 }
 
@@ -149,7 +191,11 @@ export function clearConfig(): void {
 }
 
 export function getConfigDir(): string {
-  return CONFIG_DIR;
+  return rootConfigDir();
+}
+
+export function getProfilesDir(): string {
+  return profilesDir();
 }
 
 export function getActiveProfileName(): string {

package/connectors/wandb/.env.example

@@ -0,0 +1,7 @@
+# Weights & Biases API credentials
+# Get your API key from: https://wandb.ai/authorize
+
+WANDB_API_KEY=your-api-key-here
+
+# Optional: Custom GraphQL base URL (default: https://api.wandb.ai/graphql)
+# WANDB_BASE_URL=https://api.wandb.ai/graphql

package/connectors/wandb/AGENTS.md

@@ -0,0 +1,43 @@
+# AGENTS.md
+
+Guidance for AI coding agents working with the Weights & Biases connector.
+
+## Project Overview
+
+connect-wandb is a TypeScript connector for the W&B GraphQL API with multi-profile configuration, Bearer token authentication, and Commander.js CLI.
+
+## Build & Run Commands
+
+```bash
+bun install
+bun run dev
+bun run build
+bun run typecheck
+bun test
+```
+
+## Authentication
+
+Bearer Token authentication via `WANDB_API_KEY` or `wandb config set-key <key>`.
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `WANDB_API_KEY` | API key (overrides profile) |
+| `WANDB_BASE_URL` | Override GraphQL base URL |
+
+## Data Storage
+
+```
+~/.hasna/connectors/wandb/
+├── current_profile
+└── profiles/
+    └── default.json
+```
+
+## Key Patterns
+
+- `WandbClient` handles GraphQL POST with Bearer auth and error handling
+- `Wandb` facade exposes `viewer`, `projects`, and `graphql` APIs
+- Run filters use JSON-stringified MongoDB-style syntax per W&B API