@chunkify/chunkify 0.5.0

package/src/internal/utils/values.ts

@@ -0,0 +1,105 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { ChunkifyError } from '../../core/error';
+
+// https://url.spec.whatwg.org/#url-scheme-string
+const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
+
+export const isAbsoluteURL = (url: string): boolean => {
+  return startsWithSchemeRegexp.test(url);
+};
+
+export let isArray = (val: unknown): val is unknown[] => ((isArray = Array.isArray), isArray(val));
+export let isReadonlyArray = isArray as (val: unknown) => val is readonly unknown[];
+
+/** Returns an object if the given value isn't an object, otherwise returns as-is */
+export function maybeObj(x: unknown): object {
+  if (typeof x !== 'object') {
+    return {};
+  }
+
+  return x ?? {};
+}
+
+// https://stackoverflow.com/a/34491287
+export function isEmptyObj(obj: Object | null | undefined): boolean {
+  if (!obj) return true;
+  for (const _k in obj) return false;
+  return true;
+}
+
+// https://eslint.org/docs/latest/rules/no-prototype-builtins
+export function hasOwn<T extends object = object>(obj: T, key: PropertyKey): key is keyof T {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+
+export function isObj(obj: unknown): obj is Record<string, unknown> {
+  return obj != null && typeof obj === 'object' && !Array.isArray(obj);
+}
+
+export const ensurePresent = <T>(value: T | null | undefined): T => {
+  if (value == null) {
+    throw new ChunkifyError(`Expected a value to be given but received ${value} instead.`);
+  }
+
+  return value;
+};
+
+export const validatePositiveInteger = (name: string, n: unknown): number => {
+  if (typeof n !== 'number' || !Number.isInteger(n)) {
+    throw new ChunkifyError(`${name} must be an integer`);
+  }
+  if (n < 0) {
+    throw new ChunkifyError(`${name} must be a positive integer`);
+  }
+  return n;
+};
+
+export const coerceInteger = (value: unknown): number => {
+  if (typeof value === 'number') return Math.round(value);
+  if (typeof value === 'string') return parseInt(value, 10);
+
+  throw new ChunkifyError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceFloat = (value: unknown): number => {
+  if (typeof value === 'number') return value;
+  if (typeof value === 'string') return parseFloat(value);
+
+  throw new ChunkifyError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceBoolean = (value: unknown): boolean => {
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'string') return value === 'true';
+  return Boolean(value);
+};
+
+export const maybeCoerceInteger = (value: unknown): number | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceInteger(value);
+};
+
+export const maybeCoerceFloat = (value: unknown): number | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceFloat(value);
+};
+
+export const maybeCoerceBoolean = (value: unknown): boolean | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceBoolean(value);
+};
+
+export const safeJSON = (text: string) => {
+  try {
+    return JSON.parse(text);
+  } catch (err) {
+    return undefined;
+  }
+};

package/src/internal/utils.ts

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './utils/values';
+export * from './utils/base64';
+export * from './utils/env';
+export * from './utils/log';
+export * from './utils/uuid';
+export * from './utils/sleep';

package/src/lib/.keep

@@ -0,0 +1,4 @@
+File generated from our OpenAPI spec by Stainless.
+
+This directory can be used to store custom files to expand the SDK.
+It is ignored by Stainless code generation and its content (other than this keep file) won't be touched.

package/src/pagination.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/pagination instead */
+export * from './core/pagination';

package/src/resource.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/resource instead */
+export * from './core/resource';

package/src/resources/files.ts

@@ -0,0 +1,315 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { PagePromise, PaginatedResults, type PaginatedResultsParams } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Files extends APIResource {
+  /**
+   * Retrieve details of a specific file by its ID, including metadata, media
+   * properties, and associated jobs.
+   */
+  retrieve(fileID: string, options?: RequestOptions): APIPromise<APIFile> {
+    return (
+      this._client.get(path`/api/files/${fileID}`, options) as APIPromise<{ data: APIFile }>
+    )._thenUnwrap((obj) => obj.data);
+  }
+
+  /**
+   * Retrieve a list of files with optional filtering and pagination
+   */
+  list(
+    query: FileListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<APIFilesPaginatedResults, APIFile> {
+    return this._client.getAPIList('/api/files', PaginatedResults<APIFile>, { query, ...options });
+  }
+
+  /**
+   * Delete a file. It will fail if there are processing jobs using this file.
+   */
+  delete(fileID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/api/files/${fileID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type APIFilesPaginatedResults = PaginatedResults<APIFile>;
+
+export interface APIFile {
+  /**
+   * Unique identifier of the file
+   */
+  id: string;
+
+  /**
+   * Audio bitrate in bits per second
+   */
+  audio_bitrate: number;
+
+  /**
+   * Audio codec used
+   */
+  audio_codec: string;
+
+  /**
+   * Timestamp when the file was created
+   */
+  created_at: string;
+
+  /**
+   * Duration of the video in seconds
+   */
+  duration: number;
+
+  /**
+   * Height of the video in pixels
+   */
+  height: number;
+
+  /**
+   * ID of the job that created this file
+   */
+  job_id: string;
+
+  /**
+   * MIME type of the file
+   */
+  mime_type: string;
+
+  /**
+   * Path to the file in storage
+   */
+  path: string;
+
+  /**
+   * Size of the file in bytes
+   */
+  size: number;
+
+  /**
+   * StorageId identifier where the file is stored
+   */
+  storage_id: string;
+
+  /**
+   * Pre-signed URL to directly access the file (only included when available)
+   */
+  url: string;
+
+  /**
+   * Video bitrate in bits per second
+   */
+  video_bitrate: number;
+
+  /**
+   * Video codec used
+   */
+  video_codec: string;
+
+  /**
+   * Video framerate in frames per second
+   */
+  video_framerate: number;
+
+  /**
+   * Width of the video in pixels
+   */
+  width: number;
+}
+
+export interface FileListParams extends PaginatedResultsParams {
+  /**
+   * Filter by file ID
+   */
+  id?: string;
+
+  /**
+   * Filter by audio codec
+   */
+  audio_codec?: string;
+
+  created?: FileListParams.Created;
+
+  duration?: FileListParams.Duration;
+
+  height?: FileListParams.Height;
+
+  /**
+   * Filter by job ID
+   */
+  job_id?: string;
+
+  /**
+   * Filter by mime type
+   */
+  mime_type?: string;
+
+  path?: FileListParams.Path;
+
+  size?: FileListParams.Size;
+
+  /**
+   * Filter by storage ID
+   */
+  storage_id?: string;
+
+  /**
+   * Filter by video codec
+   */
+  video_codec?: string;
+
+  width?: FileListParams.Width;
+}
+
+export namespace FileListParams {
+  export interface Created {
+    /**
+     * Filter by creation date greater than or equal (UNIX epoch time)
+     */
+    gte?: number;
+
+    /**
+     * Filter by creation date less than or equal (UNIX epoch time)
+     */
+    lte?: number;
+
+    /**
+     * Sort by creation date (asc/desc)
+     */
+    sort?: 'asc' | 'desc';
+  }
+
+  export interface Duration {
+    /**
+     * Filter by exact duration
+     */
+    eq?: number;
+
+    /**
+     * Filter by duration greater than
+     */
+    gt?: number;
+
+    /**
+     * Filter by duration greater than or equal
+     */
+    gte?: number;
+
+    /**
+     * Filter by duration less than
+     */
+    lt?: number;
+
+    /**
+     * Filter by duration less than or equal
+     */
+    lte?: number;
+  }
+
+  export interface Height {
+    /**
+     * Filter by exact height
+     */
+    eq?: number;
+
+    /**
+     * Filter by height greater than
+     */
+    gt?: number;
+
+    /**
+     * Filter by height greater than or equal
+     */
+    gte?: number;
+
+    /**
+     * Filter by height less than
+     */
+    lt?: number;
+
+    /**
+     * Filter by height less than or equal
+     */
+    lte?: number;
+  }
+
+  export interface Path {
+    /**
+     * Filter by path
+     */
+    eq?: string;
+
+    /**
+     * Filter by path (case insensitive)
+     */
+    ilike?: string;
+  }
+
+  export interface Size {
+    /**
+     * Filter by exact file size
+     */
+    eq?: number;
+
+    /**
+     * Filter by file size greater than
+     */
+    gt?: number;
+
+    /**
+     * Filter by file size greater than or equal
+     */
+    gte?: number;
+
+    /**
+     * Filter by file size less than
+     */
+    lt?: number;
+
+    /**
+     * Filter by file size less than or equal
+     */
+    lte?: number;
+  }
+
+  export interface Width {
+    /**
+     * Filter by exact width
+     */
+    eq?: number;
+
+    /**
+     * Filter by width greater than
+     */
+    gt?: number;
+
+    /**
+     * Filter by width greater than or equal
+     */
+    gte?: number;
+
+    /**
+     * Filter by width less than
+     */
+    lt?: number;
+
+    /**
+     * Filter by width less than or equal
+     */
+    lte?: number;
+  }
+}
+
+export declare namespace Files {
+  export {
+    type APIFile as APIFile,
+    type APIFilesPaginatedResults as APIFilesPaginatedResults,
+    type FileListParams as FileListParams,
+  };
+}

package/src/resources/index.ts

@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './shared';
+export { Files, type APIFile, type FileListParams, type APIFilesPaginatedResults } from './files';
+export {
+  Jobs,
+  type HlsAv1,
+  type HlsH264,
+  type HlsH265,
+  type Job,
+  type Jpg,
+  type MP4Av1,
+  type MP4H264,
+  type MP4H265,
+  type WebmVp9,
+  type JobCreateParams,
+  type JobListParams,
+  type JobsPaginatedResults,
+} from './jobs/jobs';
+export {
+  Notifications,
+  type Notification,
+  type NotificationCreateParams,
+  type NotificationListParams,
+  type NotificationsPaginatedResults,
+} from './notifications';
+export {
+  Projects,
+  type Project,
+  type ProjectListResponse,
+  type ProjectCreateParams,
+  type ProjectUpdateParams,
+  type ProjectListParams,
+} from './projects';
+export {
+  Sources,
+  type Source,
+  type SourceCreateParams,
+  type SourceListParams,
+  type SourcesPaginatedResults,
+} from './sources';
+export { Storages, type Storage, type StorageListResponse, type StorageCreateParams } from './storages';
+export { Tokens, type Token, type TokenListResponse, type TokenCreateParams } from './tokens';
+export {
+  Uploads,
+  type Upload,
+  type UploadCreateParams,
+  type UploadListParams,
+  type UploadsPaginatedResults,
+} from './uploads';
+export {
+  Webhooks,
+  type Webhook,
+  type WebhookListResponse,
+  type NewEventWebhookEvent,
+  type UnwrapWebhookEvent,
+  type WebhookCreateParams,
+  type WebhookUpdateParams,
+} from './webhooks';

package/src/resources/jobs/files.ts

@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as FilesAPI from '../files';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Files extends APIResource {
+  /**
+   * Retrieve all files associated with a specific job
+   */
+  list(jobID: string, options?: RequestOptions): APIPromise<FileListResponse> {
+    return this._client.get(path`/api/jobs/${jobID}/files`, options);
+  }
+}
+
+/**
+ * Response containing a list of files for a job
+ */
+export interface FileListResponse {
+  data: Array<FilesAPI.APIFile>;
+
+  /**
+   * Status indicates the response status "success"
+   */
+  status: 'success';
+}
+
+export declare namespace Files {
+  export { type FileListResponse as FileListResponse };
+}

package/src/resources/jobs/index.ts

@@ -0,0 +1,20 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Files, type FileListResponse } from './files';
+export {
+  Jobs,
+  type HlsAv1,
+  type HlsH264,
+  type HlsH265,
+  type Job,
+  type Jpg,
+  type MP4Av1,
+  type MP4H264,
+  type MP4H265,
+  type WebmVp9,
+  type JobCreateParams,
+  type JobListParams,
+  type JobsPaginatedResults,
+} from './jobs';
+export { Logs, type LogListResponse, type LogListParams } from './logs';
+export { Transcoders, type TranscoderListResponse } from './transcoders';