npm install ads-genesys-sdk

import { AdsGenesysClient } from 'ads-genesys-sdk';

<dependency>
  <groupId>com.vio</groupId>
  <artifactId>ads-genesys-sdk</artifactId>
  <version>1.0.0</version>
</dependency>

import { AdsGenesysClient, impression, viewComplete } from 'ads-genesys-sdk';

const client = new AdsGenesysClient({
  apiKey:    'vio_your_api_key',
  apiSecret: 'your_api_secret',
});

// Request an ad block
const blocks = await client.chunklist().createChunklist({
  platformId:  'platform-1',
  subscriberId: 'sub-123',
  deviceType:   'TV',
  deviceId:     'device-456',
  channelId:    'channel-789',
  bids: [{ blockId: 'block-1', duration: 30 }],
});

// Track an impression
await client.statistics().sendEvent(
  impression('campaign-1', 'creative-1', 'session-1')
);

import { AdsGenesysError } from 'ads-genesys-sdk';

try {
  const blocks = await client.chunklist().createChunklist(request);
} catch (err) {
  if (err instanceof AdsGenesysError) {
    console.error(err.statusCode, err.message);
  }
}

const blocks = await client.chunklist().createChunklist({
  platformId:      'platform-1',
  channelId:       'channel-live-1',   // or vodId for VOD
  subscriberId:    'sub-123',
  deviceType:      'TV',
  deviceId:        'device-456',
  playingSessionId: 'session-abc',
  resolution:      '1920x1080',
  ipAddress:       '203.0.113.5',
  bids: [
    { blockId: 'mid-1', duration: 30 },
    { blockId: 'mid-2', duration: 15 },
  ],
});

blocks.forEach(block => {
  console.log(block.blockId, block.chunklist);
});

const vastXml = await client.vast().getVastXml({
  platformId:    'platform-1',
  channelId:     'channel-live-1',
  subscriberId:  'sub-123',
  deviceType:    'WEB',
  blockDuration: 30,
  ipAddress:     '203.0.113.5',
});

// Pass vastXml to your video player's ad client

import { impression, viewStart, viewProgress, viewComplete, click, skip, error } from 'ads-genesys-sdk';

const stats = client.statistics();

await stats.sendEvent(impression('campaign-1', 'creative-1', 'sess-1'));
await stats.sendEvent(viewStart('campaign-1', 'creative-1', 'sess-1'));
await stats.sendEvent(viewProgress('campaign-1', 'creative-1', 25, 'sess-1'));
await stats.sendEvent(viewComplete('campaign-1', 'creative-1', 30000, 'sess-1'));
await stats.sendEvent(click('campaign-1', 'creative-1', 'sess-1'));
await stats.sendEvent(skip('campaign-1', 'creative-1', 'sess-1'));
await stats.sendEvent(error('campaign-1', 'creative-1', 'MEDIA_ERR', 'Failed to load', 'sess-1'));

const batch = client.statistics().createBatch();

batch.add(impression('campaign-1', 'creative-1', 'sess-1'));
batch.add(viewStart('campaign-1', 'creative-1', 'sess-1'));
batch.add(viewComplete('campaign-1', 'creative-1', 30000, 'sess-1'));

await batch.close();  // final flush + stop timer

const stats = client.statistics();

const report = await stats.getCampaignReport('campaign-1', {
  from: '2024-01-01',
  to:   '2024-01-31',
});

const creatives = await stats.getCampaignCreatives('campaign-1', { from: '2024-01-01' });

// Cross-device: combined view counts for the subscriber
const history = await client.frequencyCap().getUserViews('sub-123');
// { periodViews: { 'period-abc': 3, 'period-xyz': 1 }, ... }

// Per-device view counts
const deviceHistory = await client.frequencyCap().getUserViews(
  'sub-123', 'device-456', 'TV'
);

const watch = client.videoWatch();

// Record that a subscriber started watching
await watch.recordWatchSession('sub-123', 'vod-456');

// Query last watch time
const lastWatch = await watch.getLastWatchTime('sub-123');
// returns Date | null

// Check idle eligibility directly
const eligible = await watch.isAdEligibleByWatchHistory('sub-123', 8400, {
  minContentDurationSeconds: 7200,
  idleThresholdMinutes:      30,
  firstAdOffsetMinSeconds:   600,
  firstAdOffsetMaxSeconds:   900,
});

const session = client.createDaiSession(
  {
    firstAdOffsetSeconds:       900,
    subsequentIntervalSeconds:  1800,
    maxAdsPerContent:            4,
    defaultBlockDurationSeconds: 30,
  },
  'vod-123',    // vodId
  5400,         // contentDurationSeconds (90 min)
  'platform-1',
  'sub-123',
  'TV',
  'device-456',
);

// Inspect planned breaks
session.getAdBreaks().forEach(b => console.log(b.offsetSeconds, b.position));

// During playback loop
const adBreak = session.checkForAdBreak(currentPositionSeconds);
if (adBreak) {
  const ads = await session.requestAdBlock(adBreak);
}

// SDK fetches last watch time automatically and applies the rule
const session = await client.createDaiSessionWithWatchCheck(
  {
    videoWatchConfig: {
      minContentDurationSeconds: 7200,  // 120 min
      idleThresholdMinutes:      30,
      firstAdOffsetMinSeconds:   600,   // 10 min
      firstAdOffsetMaxSeconds:   900,   // 15 min
    },
  },
  'vod-123',
  8400,          // 140 min content — rule applies
  'platform-1',
  'sub-123',
  'TV',
  'device-456',
);

// Or pass the last watch time manually
const lastWatch = await client.videoWatch().getLastWatchTime('sub-123');
const session2 = client.createDaiSession(config, 'vod-123', 8400,
  'platform-1', 'sub-123', 'TV', 'device-456', lastWatch);

const mgmt = client.management();

const campaigns = await mgmt.getCampaignsByProvider('provider-1');
const campaign  = await mgmt.getCampaign('campaign-1', 'provider-1');
const platform  = await mgmt.getPlatform('platform-1');

const mgmt = client.management();

// Create
const segment = await mgmt.createAudienceSegment('platform-1', {
  name:      'Adults 25-44',
  ageFrom:   25,
  ageTo:     44,
  countries: ['UA', 'PL'],
});

// Activate / deactivate
await mgmt.activateAudienceSegment('platform-1', segment.uuid);
await mgmt.deactivateAudienceSegment('platform-1', segment.uuid);

// List
const all = await mgmt.getAudienceSegmentsByPlatform('platform-1');

// Delete
await mgmt.deleteAudienceSegment('platform-1', segment.uuid);

import type {
  // Config
  AdsGenesysConfig,

  // Ad delivery
  ChunklistRequest,  BidRequest,
  AdBlock,           AdItem,           AdMetadata,
  AdPosition,
  VastRequest,

  // Statistics
  AdEventType,
  AdEventRequest,    AdEventData,
  ReportQuery,       CampaignReport,

  // Frequency cap
  UserViewHistory,

  // Video watch
  VideoWatchConfig,  VideoWatchRecord,

  // DAI
  DaiConfig,

  // Management
  AudienceSegment,   AudienceSegmentRequest,
} from 'ads-genesys-sdk';