@mediaviz/sdk 1.7.0 → 1.8.0-dev.101

package/dist/sdk.d.cts

@@ -60,6 +60,79 @@ export class ServerError extends ApiError {
 
 export function handleResponse(response: Response): Promise<any>;
 
+export type WebhookAck = 'handled' | 'duplicate' | 'bad_signature';
+
+export interface WebhookDeliveryEvent {
+  event_id: string;
+  event_type: string;
+  schema_version?: string;
+  subscription_id: string;
+  project_table_name: string;
+  photo_id: number;
+  target: string;
+  completed_at?: string;
+  result_location?: string;
+  [key: string]: any;
+}
+
+export interface WebhookStoreLike {
+  markSeen(eventId: string, ttlS: number): boolean;
+  unmarkSeen(eventId: string): void;
+  saveSecret(subscriptionId: string, secret: string): void;
+  rotateSecret(subscriptionId: string, newSecret: string, windowS: number): void;
+  getSecrets(subscriptionId: string): [string | null, string | null];
+  getCursor(subscriptionId: string): string | null;
+  setCursor(subscriptionId: string, cursor: string): void;
+}
+
+export class InMemoryWebhookStore implements WebhookStoreLike {
+  markSeen(eventId: string, ttlS: number): boolean;
+  unmarkSeen(eventId: string): void;
+  saveSecret(subscriptionId: string, secret: string): void;
+  rotateSecret(subscriptionId: string, newSecret: string, windowS: number): void;
+  getSecrets(subscriptionId: string): [string | null, string | null];
+  getCursor(subscriptionId: string): string | null;
+  setCursor(subscriptionId: string, cursor: string): void;
+}
+
+export class WebhookConsumer {
+  constructor(ctx: any, subscriptionApi: any, options?: {
+    store?: WebhookStoreLike;
+    onEvent?: (event: WebhookDeliveryEvent) => void | Promise<void>;
+    skewToleranceS?: number;
+    rotationWindowS?: number;
+    dedupeTtlS?: number;
+    pageLimit?: number;
+  });
+  store: WebhookStoreLike;
+  skewToleranceS: number;
+  rotationWindowS: number;
+  dedupeTtlS: number;
+  pageLimit: number;
+  onEvent(fn: (event: WebhookDeliveryEvent) => void | Promise<void>): (event: WebhookDeliveryEvent) => void | Promise<void>;
+  useStore(store: WebhookStoreLike): void;
+  classifyMessage(body: any): 'verification' | 'delivery' | 'unknown';
+  handleChallenge(body: any): { challenge: string };
+  handleDelivery(headers: any, rawBody: string | Uint8Array | ArrayBuffer): Promise<WebhookAck>;
+  handleRequest(headers: any, rawBody: string | Uint8Array | ArrayBuffer): Promise<{ status: number; body: any }>;
+  register(projectTableName: string, callbackUrl: string, targets: string[]): Promise<any>;
+  confirm(subscriptionId: string): Promise<any>;
+  rotateSecret(subscriptionId: string): Promise<string>;
+  updateCallback(subscriptionId: string, callbackUrl: string): Promise<any>;
+  disable(subscriptionId: string): Promise<any>;
+  listSubscriptions(): Promise<any>;
+  pullEvents(subscriptionId: string, options?: { since?: string; limit?: number }): Promise<any>;
+  reconcile(subscriptionId: string, projectTableName: string): Promise<{ pulled: number; dispatched: number }>;
+  fetchResult(event: WebhookDeliveryEvent): Promise<{ photo: any; selected: Record<string, any> | null }>;
+  saveSecret(subscriptionId: string, secret: string): void;
+}
+
+export function signWebhookPayload(secret: string, timestamp: string, rawBody: string | Uint8Array | ArrayBuffer): Promise<string>;
+export function verifyWebhookSignature(secretCurrent: string | null, secretPrevious: string | null, headers: any, rawBody: string | Uint8Array | ArrayBuffer, options?: { skewToleranceS?: number; now?: number }): Promise<boolean>;
+export function selectResultColumns(photo: any, target: string): Record<string, any> | null;
+export const WEBHOOK_MODEL_COLUMNS: Record<string, string[]>;
+export const WEBHOOK_OUTCOME_MODELS: Record<string, string[]>;
+
 // ── response schemas ──
 export interface AlbumDisplay {
   name?: string;
@@ -107,6 +180,11 @@ export interface CuratedAlbumDisplay {
   confidence_value?: number;
 }
 
+export interface EventPage {
+  events: PullEvent[];
+  next_cursor?: string;
+}
+
 export interface HealthCheck {
   status?: string;
   timestamp?: string;
@@ -190,6 +268,15 @@ export interface PhotoDisplay {
   hue_values?: number[];
   light_values?: number[];
   saturation_values?: number[];
+  aesthetic_appeal?: number;
+  lighting?: number;
+  subject_significance?: number;
+  emotional_intensity?: number;
+  positive_emotion?: number;
+  universal_relatability?: number;
+  memorability?: number;
+  composition?: number;
+  judgment_overall_score?: number;
   user_id: number;
   company_id: number;
   id: number;
@@ -248,7 +335,7 @@ export interface PhotoPersonWithS3Link {
 export interface ProjectRunDisplay {
   name: string;
   private?: boolean;
-  type?: number;
+  type: number;
   description?: string;
   directory?: string;
   photo_upload_vector?: number;
@@ -278,11 +365,20 @@ export interface ProjectRunDisplay {
   image_comparison_model?: boolean;
   image_describe_model?: boolean;
   ocr_model?: boolean;
+  judgment_model?: boolean;
   similarity_model?: boolean;
   personhood_model?: boolean;
   evidence_model?: boolean;
   insights_model?: boolean;
   normalize?: boolean;
+  is_continuous_upload?: boolean;
+}
+
+export interface PullEvent {
+  event_id: string;
+  photo_id: number;
+  target: string;
+  completed_at: string;
 }
 
 export interface SearchDisplay {
@@ -305,6 +401,24 @@ export interface SearchDisplay {
   curated_album_id?: number;
 }
 
+export interface SubscriptionActivated {
+  subscription_id: string;
+  status: string;
+  signing_secret: string;
+}
+
+export interface SubscriptionDisplay {
+  id: string;
+  project_table_name: string;
+  callback_url: string;
+  targets: string[];
+  status: string;
+  consecutive_failures: number;
+  last_delivery_at?: string;
+  last_status_code?: number;
+  created_at: string;
+}
+
 export interface UserDisplay {
   id: number;
   company_id: number;
@@ -397,7 +511,7 @@ export class OauthAuthorization {
 export class OauthToken {
   token(body: { grantType: string, code: string, redirectUri: string, clientId: string, codeVerifier: string, refreshToken: string, clientSecret: string }): Promise<Record<string, any>>;
   adminRevokeUserTokens(userId: number): Promise<Record<string, any>>;
-  revoke(body: { token: string, tokenTypeHint: string, clientId: string }): Promise<any>;
+  revoke(body: { token: string, tokenTypeHint: string, clientId: string }): Promise<Record<string, any>>;
 }
 
 export class OauthLogin {
@@ -407,12 +521,14 @@ export class OauthLogin {
 
 export class Person {
   updatePerson(projectTableName: string, personId: string, options?: { personName?: string | string[] }): Promise<any>;
+  removePersonName(projectTableName: string, personId: string): Promise<PhotoPersonLight>;
   combinePersons(projectTableName: string, destinationPersonId: string, oldPersonId: string): Promise<PhotoPersonLight>;
   splitPersons(projectTableName: string, id: number, options?: { newName?: string | string[], destinationPersonId?: string | string[] }): Promise<PhotoPersonLight>;
   getAllPersonsFromProject(projectTableName: string): Promise<PhotoPersonWithS3Link[]>;
   getAllPersonNamesFromProject(projectTableName: string): Promise<any>;
   getPhotoIdsByPersons(projectTableName: string, options?: { personId?: string[] | string[][] }): Promise<any>;
   getAllPersonsFromPhoto(projectTableName: string, photoId: number): Promise<PhotoPersonLight[]>;
+  removePerson(projectTableName: string, personId: string): Promise<Record<string, any>>;
 }
 
 export class Photoupload {
@@ -432,7 +548,7 @@ export class Photos {
 }
 
 export class Projects {
-  createProjectAndRun(name: string, private_?: boolean, type?: number, description?: string, directory?: string, photoUploadVector?: number, thumbnail?: string, runName?: string, options?: { outcomes?: any, models?: any }): Promise<ProjectRunDisplay>;
+  createProjectAndRun(name: string, type: number, private_?: boolean, description?: string, directory?: string, photoUploadVector?: number, thumbnail?: string, runName?: string, options?: { outcomes?: any, models?: any }): Promise<ProjectRunDisplay>;
   markProjectUploadComplete(projectTableName: string, options?: { skippedFileCount?: number | number[] }): Promise<any>;
   checkProjectStatus(projectTableName: string): Promise<any>;
   getProjectPrelimModelRequestTemplate(projectTableName: string): Promise<Record<string, any>>;
@@ -464,6 +580,16 @@ export class Search {
   deleteSavedSearchById(searchId: number): Promise<Record<string, any>>;
 }
 
+export class Subscription {
+  createSubscription(projectTableName: string, callbackUrl: string, targets: string[]): Promise<SubscriptionActivated>;
+  verifySubscription(subscriptionId: string): Promise<SubscriptionActivated>;
+  listSubscriptions(): Promise<SubscriptionDisplay[]>;
+  listSubscriptionEvents(subscriptionId: string, options?: { since?: string | string[], limit?: number | number[] }): Promise<EventPage>;
+  updateSubscription(subscriptionId: string, body?: { callbackUrl?: string, targets?: string[] }): Promise<SubscriptionDisplay>;
+  deleteSubscription(subscriptionId: string): Promise<Record<string, any>>;
+  rotateSubscriptionSecret(subscriptionId: string): Promise<SubscriptionActivated>;
+}
+
 export class Users {
   createUser(name: string, email: string, accountType: number, companyId?: number, profilePicture?: string, paymentPlanType?: string): Promise<UserDisplay>;
   createUserAndCompany(name: string, email: string, password: string, companyId?: number, profilePicture?: string, paymentPlanType?: string, companyName?: string, credits?: number, options?: { inviteToken?: string | string[] }): Promise<UserDisplay>;
@@ -499,6 +625,8 @@ export class MediaViz {
   readonly photos: Photos;
   readonly projects: Projects;
   readonly search: Search;
+  readonly subscription: Subscription;
   readonly users: Users;
+  readonly webhooks: WebhookConsumer;
 }
 

package/dist/sdk.d.ts

@@ -60,6 +60,79 @@ export class ServerError extends ApiError {
 
 export function handleResponse(response: Response): Promise<any>;
 
+export type WebhookAck = 'handled' | 'duplicate' | 'bad_signature';
+
+export interface WebhookDeliveryEvent {
+  event_id: string;
+  event_type: string;
+  schema_version?: string;
+  subscription_id: string;
+  project_table_name: string;
+  photo_id: number;
+  target: string;
+  completed_at?: string;
+  result_location?: string;
+  [key: string]: any;
+}
+
+export interface WebhookStoreLike {
+  markSeen(eventId: string, ttlS: number): boolean;
+  unmarkSeen(eventId: string): void;
+  saveSecret(subscriptionId: string, secret: string): void;
+  rotateSecret(subscriptionId: string, newSecret: string, windowS: number): void;
+  getSecrets(subscriptionId: string): [string | null, string | null];
+  getCursor(subscriptionId: string): string | null;
+  setCursor(subscriptionId: string, cursor: string): void;
+}
+
+export class InMemoryWebhookStore implements WebhookStoreLike {
+  markSeen(eventId: string, ttlS: number): boolean;
+  unmarkSeen(eventId: string): void;
+  saveSecret(subscriptionId: string, secret: string): void;
+  rotateSecret(subscriptionId: string, newSecret: string, windowS: number): void;
+  getSecrets(subscriptionId: string): [string | null, string | null];
+  getCursor(subscriptionId: string): string | null;
+  setCursor(subscriptionId: string, cursor: string): void;
+}
+
+export class WebhookConsumer {
+  constructor(ctx: any, subscriptionApi: any, options?: {
+    store?: WebhookStoreLike;
+    onEvent?: (event: WebhookDeliveryEvent) => void | Promise<void>;
+    skewToleranceS?: number;
+    rotationWindowS?: number;
+    dedupeTtlS?: number;
+    pageLimit?: number;
+  });
+  store: WebhookStoreLike;
+  skewToleranceS: number;
+  rotationWindowS: number;
+  dedupeTtlS: number;
+  pageLimit: number;
+  onEvent(fn: (event: WebhookDeliveryEvent) => void | Promise<void>): (event: WebhookDeliveryEvent) => void | Promise<void>;
+  useStore(store: WebhookStoreLike): void;
+  classifyMessage(body: any): 'verification' | 'delivery' | 'unknown';
+  handleChallenge(body: any): { challenge: string };
+  handleDelivery(headers: any, rawBody: string | Uint8Array | ArrayBuffer): Promise<WebhookAck>;
+  handleRequest(headers: any, rawBody: string | Uint8Array | ArrayBuffer): Promise<{ status: number; body: any }>;
+  register(projectTableName: string, callbackUrl: string, targets: string[]): Promise<any>;
+  confirm(subscriptionId: string): Promise<any>;
+  rotateSecret(subscriptionId: string): Promise<string>;
+  updateCallback(subscriptionId: string, callbackUrl: string): Promise<any>;
+  disable(subscriptionId: string): Promise<any>;
+  listSubscriptions(): Promise<any>;
+  pullEvents(subscriptionId: string, options?: { since?: string; limit?: number }): Promise<any>;
+  reconcile(subscriptionId: string, projectTableName: string): Promise<{ pulled: number; dispatched: number }>;
+  fetchResult(event: WebhookDeliveryEvent): Promise<{ photo: any; selected: Record<string, any> | null }>;
+  saveSecret(subscriptionId: string, secret: string): void;
+}
+
+export function signWebhookPayload(secret: string, timestamp: string, rawBody: string | Uint8Array | ArrayBuffer): Promise<string>;
+export function verifyWebhookSignature(secretCurrent: string | null, secretPrevious: string | null, headers: any, rawBody: string | Uint8Array | ArrayBuffer, options?: { skewToleranceS?: number; now?: number }): Promise<boolean>;
+export function selectResultColumns(photo: any, target: string): Record<string, any> | null;
+export const WEBHOOK_MODEL_COLUMNS: Record<string, string[]>;
+export const WEBHOOK_OUTCOME_MODELS: Record<string, string[]>;
+
 // ── response schemas ──
 export interface AlbumDisplay {
   name?: string;
@@ -107,6 +180,11 @@ export interface CuratedAlbumDisplay {
   confidence_value?: number;
 }
 
+export interface EventPage {
+  events: PullEvent[];
+  next_cursor?: string;
+}
+
 export interface HealthCheck {
   status?: string;
   timestamp?: string;
@@ -190,6 +268,15 @@ export interface PhotoDisplay {
   hue_values?: number[];
   light_values?: number[];
   saturation_values?: number[];
+  aesthetic_appeal?: number;
+  lighting?: number;
+  subject_significance?: number;
+  emotional_intensity?: number;
+  positive_emotion?: number;
+  universal_relatability?: number;
+  memorability?: number;
+  composition?: number;
+  judgment_overall_score?: number;
   user_id: number;
   company_id: number;
   id: number;
@@ -248,7 +335,7 @@ export interface PhotoPersonWithS3Link {
 export interface ProjectRunDisplay {
   name: string;
   private?: boolean;
-  type?: number;
+  type: number;
   description?: string;
   directory?: string;
   photo_upload_vector?: number;
@@ -278,11 +365,20 @@ export interface ProjectRunDisplay {
   image_comparison_model?: boolean;
   image_describe_model?: boolean;
   ocr_model?: boolean;
+  judgment_model?: boolean;
   similarity_model?: boolean;
   personhood_model?: boolean;
   evidence_model?: boolean;
   insights_model?: boolean;
   normalize?: boolean;
+  is_continuous_upload?: boolean;
+}
+
+export interface PullEvent {
+  event_id: string;
+  photo_id: number;
+  target: string;
+  completed_at: string;
 }
 
 export interface SearchDisplay {
@@ -305,6 +401,24 @@ export interface SearchDisplay {
   curated_album_id?: number;
 }
 
+export interface SubscriptionActivated {
+  subscription_id: string;
+  status: string;
+  signing_secret: string;
+}
+
+export interface SubscriptionDisplay {
+  id: string;
+  project_table_name: string;
+  callback_url: string;
+  targets: string[];
+  status: string;
+  consecutive_failures: number;
+  last_delivery_at?: string;
+  last_status_code?: number;
+  created_at: string;
+}
+
 export interface UserDisplay {
   id: number;
   company_id: number;
@@ -397,7 +511,7 @@ export class OauthAuthorization {
 export class OauthToken {
   token(body: { grantType: string, code: string, redirectUri: string, clientId: string, codeVerifier: string, refreshToken: string, clientSecret: string }): Promise<Record<string, any>>;
   adminRevokeUserTokens(userId: number): Promise<Record<string, any>>;
-  revoke(body: { token: string, tokenTypeHint: string, clientId: string }): Promise<any>;
+  revoke(body: { token: string, tokenTypeHint: string, clientId: string }): Promise<Record<string, any>>;
 }
 
 export class OauthLogin {
@@ -407,12 +521,14 @@ export class OauthLogin {
 
 export class Person {
   updatePerson(projectTableName: string, personId: string, options?: { personName?: string | string[] }): Promise<any>;
+  removePersonName(projectTableName: string, personId: string): Promise<PhotoPersonLight>;
   combinePersons(projectTableName: string, destinationPersonId: string, oldPersonId: string): Promise<PhotoPersonLight>;
   splitPersons(projectTableName: string, id: number, options?: { newName?: string | string[], destinationPersonId?: string | string[] }): Promise<PhotoPersonLight>;
   getAllPersonsFromProject(projectTableName: string): Promise<PhotoPersonWithS3Link[]>;
   getAllPersonNamesFromProject(projectTableName: string): Promise<any>;
   getPhotoIdsByPersons(projectTableName: string, options?: { personId?: string[] | string[][] }): Promise<any>;
   getAllPersonsFromPhoto(projectTableName: string, photoId: number): Promise<PhotoPersonLight[]>;
+  removePerson(projectTableName: string, personId: string): Promise<Record<string, any>>;
 }
 
 export class Photoupload {
@@ -432,7 +548,7 @@ export class Photos {
 }
 
 export class Projects {
-  createProjectAndRun(name: string, private_?: boolean, type?: number, description?: string, directory?: string, photoUploadVector?: number, thumbnail?: string, runName?: string, options?: { outcomes?: any, models?: any }): Promise<ProjectRunDisplay>;
+  createProjectAndRun(name: string, type: number, private_?: boolean, description?: string, directory?: string, photoUploadVector?: number, thumbnail?: string, runName?: string, options?: { outcomes?: any, models?: any }): Promise<ProjectRunDisplay>;
   markProjectUploadComplete(projectTableName: string, options?: { skippedFileCount?: number | number[] }): Promise<any>;
   checkProjectStatus(projectTableName: string): Promise<any>;
   getProjectPrelimModelRequestTemplate(projectTableName: string): Promise<Record<string, any>>;
@@ -464,6 +580,16 @@ export class Search {
   deleteSavedSearchById(searchId: number): Promise<Record<string, any>>;
 }
 
+export class Subscription {
+  createSubscription(projectTableName: string, callbackUrl: string, targets: string[]): Promise<SubscriptionActivated>;
+  verifySubscription(subscriptionId: string): Promise<SubscriptionActivated>;
+  listSubscriptions(): Promise<SubscriptionDisplay[]>;
+  listSubscriptionEvents(subscriptionId: string, options?: { since?: string | string[], limit?: number | number[] }): Promise<EventPage>;
+  updateSubscription(subscriptionId: string, body?: { callbackUrl?: string, targets?: string[] }): Promise<SubscriptionDisplay>;
+  deleteSubscription(subscriptionId: string): Promise<Record<string, any>>;
+  rotateSubscriptionSecret(subscriptionId: string): Promise<SubscriptionActivated>;
+}
+
 export class Users {
   createUser(name: string, email: string, accountType: number, companyId?: number, profilePicture?: string, paymentPlanType?: string): Promise<UserDisplay>;
   createUserAndCompany(name: string, email: string, password: string, companyId?: number, profilePicture?: string, paymentPlanType?: string, companyName?: string, credits?: number, options?: { inviteToken?: string | string[] }): Promise<UserDisplay>;
@@ -499,6 +625,8 @@ export class MediaViz {
   readonly photos: Photos;
   readonly projects: Projects;
   readonly search: Search;
+  readonly subscription: Subscription;
   readonly users: Users;
+  readonly webhooks: WebhookConsumer;
 }
 

package/dist/sdk.esm.d.ts

@@ -60,6 +60,79 @@ export class ServerError extends ApiError {
 
 export function handleResponse(response: Response): Promise<any>;
 
+export type WebhookAck = 'handled' | 'duplicate' | 'bad_signature';
+
+export interface WebhookDeliveryEvent {
+  event_id: string;
+  event_type: string;
+  schema_version?: string;
+  subscription_id: string;
+  project_table_name: string;
+  photo_id: number;
+  target: string;
+  completed_at?: string;
+  result_location?: string;
+  [key: string]: any;
+}
+
+export interface WebhookStoreLike {
+  markSeen(eventId: string, ttlS: number): boolean;
+  unmarkSeen(eventId: string): void;
+  saveSecret(subscriptionId: string, secret: string): void;
+  rotateSecret(subscriptionId: string, newSecret: string, windowS: number): void;
+  getSecrets(subscriptionId: string): [string | null, string | null];
+  getCursor(subscriptionId: string): string | null;
+  setCursor(subscriptionId: string, cursor: string): void;
+}
+
+export class InMemoryWebhookStore implements WebhookStoreLike {
+  markSeen(eventId: string, ttlS: number): boolean;
+  unmarkSeen(eventId: string): void;
+  saveSecret(subscriptionId: string, secret: string): void;
+  rotateSecret(subscriptionId: string, newSecret: string, windowS: number): void;
+  getSecrets(subscriptionId: string): [string | null, string | null];
+  getCursor(subscriptionId: string): string | null;
+  setCursor(subscriptionId: string, cursor: string): void;
+}
+
+export class WebhookConsumer {
+  constructor(ctx: any, subscriptionApi: any, options?: {
+    store?: WebhookStoreLike;
+    onEvent?: (event: WebhookDeliveryEvent) => void | Promise<void>;
+    skewToleranceS?: number;
+    rotationWindowS?: number;
+    dedupeTtlS?: number;
+    pageLimit?: number;
+  });
+  store: WebhookStoreLike;
+  skewToleranceS: number;
+  rotationWindowS: number;
+  dedupeTtlS: number;
+  pageLimit: number;
+  onEvent(fn: (event: WebhookDeliveryEvent) => void | Promise<void>): (event: WebhookDeliveryEvent) => void | Promise<void>;
+  useStore(store: WebhookStoreLike): void;
+  classifyMessage(body: any): 'verification' | 'delivery' | 'unknown';
+  handleChallenge(body: any): { challenge: string };
+  handleDelivery(headers: any, rawBody: string | Uint8Array | ArrayBuffer): Promise<WebhookAck>;
+  handleRequest(headers: any, rawBody: string | Uint8Array | ArrayBuffer): Promise<{ status: number; body: any }>;
+  register(projectTableName: string, callbackUrl: string, targets: string[]): Promise<any>;
+  confirm(subscriptionId: string): Promise<any>;
+  rotateSecret(subscriptionId: string): Promise<string>;
+  updateCallback(subscriptionId: string, callbackUrl: string): Promise<any>;
+  disable(subscriptionId: string): Promise<any>;
+  listSubscriptions(): Promise<any>;
+  pullEvents(subscriptionId: string, options?: { since?: string; limit?: number }): Promise<any>;
+  reconcile(subscriptionId: string, projectTableName: string): Promise<{ pulled: number; dispatched: number }>;
+  fetchResult(event: WebhookDeliveryEvent): Promise<{ photo: any; selected: Record<string, any> | null }>;
+  saveSecret(subscriptionId: string, secret: string): void;
+}
+
+export function signWebhookPayload(secret: string, timestamp: string, rawBody: string | Uint8Array | ArrayBuffer): Promise<string>;
+export function verifyWebhookSignature(secretCurrent: string | null, secretPrevious: string | null, headers: any, rawBody: string | Uint8Array | ArrayBuffer, options?: { skewToleranceS?: number; now?: number }): Promise<boolean>;
+export function selectResultColumns(photo: any, target: string): Record<string, any> | null;
+export const WEBHOOK_MODEL_COLUMNS: Record<string, string[]>;
+export const WEBHOOK_OUTCOME_MODELS: Record<string, string[]>;
+
 // ── response schemas ──
 export interface AlbumDisplay {
   name?: string;
@@ -107,6 +180,11 @@ export interface CuratedAlbumDisplay {
   confidence_value?: number;
 }
 
+export interface EventPage {
+  events: PullEvent[];
+  next_cursor?: string;
+}
+
 export interface HealthCheck {
   status?: string;
   timestamp?: string;
@@ -190,6 +268,15 @@ export interface PhotoDisplay {
   hue_values?: number[];
   light_values?: number[];
   saturation_values?: number[];
+  aesthetic_appeal?: number;
+  lighting?: number;
+  subject_significance?: number;
+  emotional_intensity?: number;
+  positive_emotion?: number;
+  universal_relatability?: number;
+  memorability?: number;
+  composition?: number;
+  judgment_overall_score?: number;
   user_id: number;
   company_id: number;
   id: number;
@@ -248,7 +335,7 @@ export interface PhotoPersonWithS3Link {
 export interface ProjectRunDisplay {
   name: string;
   private?: boolean;
-  type?: number;
+  type: number;
   description?: string;
   directory?: string;
   photo_upload_vector?: number;
@@ -278,11 +365,20 @@ export interface ProjectRunDisplay {
   image_comparison_model?: boolean;
   image_describe_model?: boolean;
   ocr_model?: boolean;
+  judgment_model?: boolean;
   similarity_model?: boolean;
   personhood_model?: boolean;
   evidence_model?: boolean;
   insights_model?: boolean;
   normalize?: boolean;
+  is_continuous_upload?: boolean;
+}
+
+export interface PullEvent {
+  event_id: string;
+  photo_id: number;
+  target: string;
+  completed_at: string;
 }
 
 export interface SearchDisplay {
@@ -305,6 +401,24 @@ export interface SearchDisplay {
   curated_album_id?: number;
 }
 
+export interface SubscriptionActivated {
+  subscription_id: string;
+  status: string;
+  signing_secret: string;
+}
+
+export interface SubscriptionDisplay {
+  id: string;
+  project_table_name: string;
+  callback_url: string;
+  targets: string[];
+  status: string;
+  consecutive_failures: number;
+  last_delivery_at?: string;
+  last_status_code?: number;
+  created_at: string;
+}
+
 export interface UserDisplay {
   id: number;
   company_id: number;
@@ -397,7 +511,7 @@ export class OauthAuthorization {
 export class OauthToken {
   token(body: { grantType: string, code: string, redirectUri: string, clientId: string, codeVerifier: string, refreshToken: string, clientSecret: string }): Promise<Record<string, any>>;
   adminRevokeUserTokens(userId: number): Promise<Record<string, any>>;
-  revoke(body: { token: string, tokenTypeHint: string, clientId: string }): Promise<any>;
+  revoke(body: { token: string, tokenTypeHint: string, clientId: string }): Promise<Record<string, any>>;
 }
 
 export class OauthLogin {
@@ -407,12 +521,14 @@ export class OauthLogin {
 
 export class Person {
   updatePerson(projectTableName: string, personId: string, options?: { personName?: string | string[] }): Promise<any>;
+  removePersonName(projectTableName: string, personId: string): Promise<PhotoPersonLight>;
   combinePersons(projectTableName: string, destinationPersonId: string, oldPersonId: string): Promise<PhotoPersonLight>;
   splitPersons(projectTableName: string, id: number, options?: { newName?: string | string[], destinationPersonId?: string | string[] }): Promise<PhotoPersonLight>;
   getAllPersonsFromProject(projectTableName: string): Promise<PhotoPersonWithS3Link[]>;
   getAllPersonNamesFromProject(projectTableName: string): Promise<any>;
   getPhotoIdsByPersons(projectTableName: string, options?: { personId?: string[] | string[][] }): Promise<any>;
   getAllPersonsFromPhoto(projectTableName: string, photoId: number): Promise<PhotoPersonLight[]>;
+  removePerson(projectTableName: string, personId: string): Promise<Record<string, any>>;
 }
 
 export class Photoupload {
@@ -432,7 +548,7 @@ export class Photos {
 }
 
 export class Projects {
-  createProjectAndRun(name: string, private_?: boolean, type?: number, description?: string, directory?: string, photoUploadVector?: number, thumbnail?: string, runName?: string, options?: { outcomes?: any, models?: any }): Promise<ProjectRunDisplay>;
+  createProjectAndRun(name: string, type: number, private_?: boolean, description?: string, directory?: string, photoUploadVector?: number, thumbnail?: string, runName?: string, options?: { outcomes?: any, models?: any }): Promise<ProjectRunDisplay>;
   markProjectUploadComplete(projectTableName: string, options?: { skippedFileCount?: number | number[] }): Promise<any>;
   checkProjectStatus(projectTableName: string): Promise<any>;
   getProjectPrelimModelRequestTemplate(projectTableName: string): Promise<Record<string, any>>;
@@ -464,6 +580,16 @@ export class Search {
   deleteSavedSearchById(searchId: number): Promise<Record<string, any>>;
 }
 
+export class Subscription {
+  createSubscription(projectTableName: string, callbackUrl: string, targets: string[]): Promise<SubscriptionActivated>;
+  verifySubscription(subscriptionId: string): Promise<SubscriptionActivated>;
+  listSubscriptions(): Promise<SubscriptionDisplay[]>;
+  listSubscriptionEvents(subscriptionId: string, options?: { since?: string | string[], limit?: number | number[] }): Promise<EventPage>;
+  updateSubscription(subscriptionId: string, body?: { callbackUrl?: string, targets?: string[] }): Promise<SubscriptionDisplay>;
+  deleteSubscription(subscriptionId: string): Promise<Record<string, any>>;
+  rotateSubscriptionSecret(subscriptionId: string): Promise<SubscriptionActivated>;
+}
+
 export class Users {
   createUser(name: string, email: string, accountType: number, companyId?: number, profilePicture?: string, paymentPlanType?: string): Promise<UserDisplay>;
   createUserAndCompany(name: string, email: string, password: string, companyId?: number, profilePicture?: string, paymentPlanType?: string, companyName?: string, credits?: number, options?: { inviteToken?: string | string[] }): Promise<UserDisplay>;
@@ -499,6 +625,8 @@ export class MediaViz {
   readonly photos: Photos;
   readonly projects: Projects;
   readonly search: Search;
+  readonly subscription: Subscription;
   readonly users: Users;
+  readonly webhooks: WebhookConsumer;
 }