@talkpilot/core-db 1.0.1

package/src/test-utils/factories/municipal/streets.ts

@@ -0,0 +1,17 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type { Street } from '../../../municipal/streets/streets.types';
+
+export const streetFactory = Factory.define<Street>(() => ({
+  _id: new ObjectId(),
+  createdAt: new Date(),
+  updatedAt: new Date(),
+  id: faker.string.uuid(),
+  name: faker.location.street(),
+  cityName: faker.helpers.arrayElement(['ashdod', 'maltar', 'billit', 'hashkelon']),
+}));
+
+export function createStreet(overrides?: Partial<Street>): Street {
+  return streetFactory.build(overrides);
+}

package/src/test-utils/factories/municipal/tickets.ts

@@ -0,0 +1,27 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type { Ticket } from '../../../municipal/tickets/tickets.types';
+import type { CityName } from '../../../municipal/departmentsSubjects/departmentsSubjects.types';
+
+const VALID_CITIES: CityName[] = ['ashdod', 'maltar', 'billit', 'hashkelon', 'tests'];
+
+export const ticketFactory = Factory.define<Ticket>(() => ({
+  _id: new ObjectId(),
+  createdAt: new Date(),
+  updatedAt: new Date(),
+  cityName: faker.helpers.arrayElement(VALID_CITIES),
+  externalCallFields: {
+    first_name: faker.person.firstName(),
+    last_name: faker.person.lastName(),
+    event_description: faker.lorem.sentence(),
+    street: faker.location.street(),
+    house_number: faker.location.buildingNumber(),
+    event_subject_id: faker.string.numeric(4),
+    event_sub_subject_id: faker.string.numeric(4),
+  },
+}));
+
+export function createTicket(overrides?: Partial<Ticket>): Ticket {
+  return ticketFactory.build(overrides);
+}

package/src/test-utils/factories/talkpilot/agents.ts

@@ -0,0 +1,19 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type { Agent } from '../../../talkpilot/agents/agents.types';
+
+export const agentFactory = Factory.define<Agent>(() => ({
+  name: faker.person.fullName(),
+  language: 'en',
+  voice: 'alloy',
+  instructions: faker.lorem.paragraph(),
+  labels: [],
+  clientId: new ObjectId().toString(),
+  role: 'assistant',
+  gender: faker.helpers.arrayElement(['male', 'female']),
+}));
+
+export function createAgent(overrides?: Partial<Agent>): Agent {
+  return agentFactory.build(overrides);
+}

package/src/test-utils/factories/talkpilot/calls.ts

@@ -0,0 +1,37 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type { Call } from '../../../talkpilot/calls/calls.types';
+
+export const callFactory = Factory.define<Call>(() => ({
+  callSid: faker.string.uuid(),
+  flowId: new ObjectId(),
+  clientId: faker.string.uuid(),
+  sessionId: null,
+  resultId: new ObjectId(),
+  customerPhoneNumber: faker.phone.number(),
+  agentPhoneNumber: faker.phone.number(),
+  isIncomingCall: false,
+  isOutgoingCall: true,
+  callLength: faker.number.int({ min: 0, max: 3600 }),
+  env: 'test',
+  updatedAt: new Date(),
+  createdAt: new Date(),
+}));
+
+export function createOutGoingCallDoc(overrides?: Partial<Call>): Call {
+  return callFactory.build({
+    ...overrides,
+    isIncomingCall: false,
+    isOutgoingCall: true,
+  });
+}
+
+export function createIncomingCallDoc(overrides?: Partial<Call>): Call {
+  return callFactory.build({
+    ...overrides,
+    isIncomingCall: true,
+    isOutgoingCall: false,
+    sessionId: overrides?.sessionId ?? null,
+  });
+}

package/src/test-utils/factories/talkpilot/clientAudioBuffers.ts

@@ -0,0 +1,18 @@
+import { Factory } from 'fishery';
+import { faker } from '@faker-js/faker';
+import { CreateAudioBufferInput } from '../../../talkpilot/clientAudioBuffers/clientsAudioBuffers.types';
+
+export const audioBufferInputFactory = Factory.define<CreateAudioBufferInput>(() => ({
+  callSid: 'CA1234567890abcdef1234567890abcdef',
+  clientId: faker.string.uuid(),
+  bucketStartMs: faker.number.int({ min: 0, max: 1000000 }),
+  bucketDurationMs: faker.helpers.arrayElement([500, 1000]),
+  data: Buffer.from(faker.string.alphanumeric({ length: 100 })),
+  ttlMs: faker.number.int({ min: 1000, max: 3600000 }),
+}));
+
+export function createAudioBufferInput(
+  overrides?: Partial<CreateAudioBufferInput>
+): CreateAudioBufferInput {
+  return audioBufferInputFactory.build(overrides ?? {});
+}

package/src/test-utils/factories/talkpilot/clientsConfig.ts

@@ -0,0 +1,19 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type {
+  ClientConfig,
+  ClientConfigDoc,
+} from '../../../talkpilot/clientsConfig/clientsConfig.types';
+
+export const clientConfigFactory = Factory.define<ClientConfigDoc>(() => ({
+  _id: new ObjectId(),
+  clientId: faker.string.uuid(),
+  products: {},
+}));
+
+export function createClientConfig(overrides?: Partial<ClientConfig>): ClientConfigDoc {
+  return clientConfigFactory.build({
+    ...overrides,
+  });
+}

package/src/test-utils/factories/talkpilot/flows.ts

@@ -0,0 +1,31 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type { Flow } from '../../../talkpilot/flows/flows.types';
+
+export const flowFactory = Factory.define<Flow & { _id: ObjectId }>(() => {
+  const now = new Date();
+  return {
+    _id: new ObjectId(),
+    flowName: faker.lorem.words(2),
+    clientId: faker.string.uuid(),
+    systemInstructions: faker.lorem.sentences(2),
+    initialSentence: faker.lorem.sentence(),
+    insights: [],
+    interactions: [],
+    createdAt: now,
+    updatedAt: now,
+  };
+});
+
+export function createFlow(overrides?: Partial<Flow>): Flow & { _id: ObjectId } {
+  const now = new Date();
+  const base = flowFactory.build();
+  return {
+    ...base,
+    ...overrides,
+    _id: (overrides?._id as ObjectId) ?? base._id,
+    updatedAt: now,
+    createdAt: overrides?.createdAt ?? now,
+  };
+}

package/src/test-utils/factories/talkpilot/groups.ts

@@ -0,0 +1,33 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type { Group, GroupContact, GroupDoc } from '../../../talkpilot/groups/groups.types';
+
+export const groupContactFactory = Factory.define<GroupContact>(() => ({
+  name: faker.person.firstName(),
+  phone: {
+    national: '500000000',
+     національний: '500000000',
+     nacionales: '500000000',
+     национальные: '500000000',
+    e164: '+972500000000' as const,
+    region: 'IL',
+    countryCallingCode: '972',
+    formatted: '+972 50-000-0000',
+  },
+  gender: faker.helpers.arrayElement(['male', 'female']),
+}));
+
+export const groupFactory = Factory.define<GroupDoc>(() => ({
+  _id: new ObjectId(),
+  clientId: faker.string.uuid(),
+  createdAt: new Date(),
+  updatedAt: new Date(),
+  name: faker.company.name(),
+  description: faker.lorem.sentence(),
+  contacts: groupContactFactory.buildList(2),
+}));
+
+export function createGroup(overrides?: Partial<Group>): GroupDoc {
+  return groupFactory.build(overrides);
+}

package/src/test-utils/factories/talkpilot/phone_numbers.ts

@@ -0,0 +1,20 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type { PhoneNumber } from '../../../talkpilot/phone_numbers/phone_numbers.types';
+
+export const phoneNumberFactory = Factory.define<PhoneNumber & { _id?: ObjectId }>(() => ({
+  _id: new ObjectId(),
+  client_id: faker.string.uuid(),
+  flow_id: new ObjectId(),
+  phone_number: faker.phone.number(),
+  createdAt: new Date(),
+  updatedAt: new Date(),
+  is_primary: true,
+}));
+
+export function createPhoneNumber(
+  overrides?: Partial<PhoneNumber> & { flow_id?: ObjectId }
+): PhoneNumber & { _id?: ObjectId } {
+  return phoneNumberFactory.build(overrides);
+}

package/src/test-utils/factories/talkpilot/sessions.ts

@@ -0,0 +1,35 @@
+import { Factory } from 'fishery';
+import { ObjectId } from 'mongodb';
+import { faker } from '@faker-js/faker';
+import type { Session } from '../../../talkpilot/sessions/sessions.types';
+
+export const sessionFactory = Factory.define<Session>(() => ({
+  _id: new ObjectId(),
+  session_name: faker.lorem.word(),
+  clientId: faker.string.uuid(),
+  flow_id: new ObjectId(),
+  phone_numbers: [
+    {
+      name: faker.person.firstName(),
+      phoneNumber: faker.phone.number(),
+      gender: 'male' as const,
+    },
+  ],
+  json: null,
+  metaKeys: null,
+  voice: null,
+  company_name: null,
+  createdAt: new Date(),
+  updatedAt: new Date(),
+}));
+
+export function createSession(overrides?: Partial<Session>): Session {
+  const now = new Date();
+  const base = sessionFactory.build();
+  return {
+    ...base,
+    ...overrides,
+    createdAt: overrides?.createdAt ?? now,
+    updatedAt: now,
+  };
+}

package/src/utils/validation.ts

@@ -0,0 +1,23 @@
+/**
+ * Simple validation utilities for the core-db package.
+ * Designed to be lightweight and only run when needed.
+ */
+
+export const validateConfig = (configName: string, value?: string): string => {
+  if (!value || value.trim() === '') {
+    throw new Error(
+      `[core-db] Configuration Error: '${configName}' is missing. ` +
+      `Please provide it via parameters or set the corresponding environment variable.`
+    );
+  }
+  return value;
+};
+
+export const validateMongoUri = (uri: string): void => {
+  if (!uri.startsWith('mongodb://') && !uri.startsWith('mongodb+srv://')) {
+    throw new Error(
+      `[core-db] Connection Error: The provided MongoDB URI is invalid. ` +
+      `It must start with 'mongodb://' or 'mongodb+srv://'. Received: '${uri}'`
+    );
+  }
+};

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "lib": ["ES2022"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "baseUrl": ".",
+    "paths": {
+      "@core/db": ["src/index.ts"],
+      "*": ["node_modules/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "test", "**/*.test.ts", "**/__tests__/*", "**/*.spec.ts"]
+}