stophy 0.1.1

package/dist/index.js

@@ -0,0 +1,249 @@
+import { createClient, createConfig } from '@hey-api/client-fetch';
+
+// src/index.ts
+var client = createClient(createConfig({
+  baseUrl: "https://api.stophy.dev"
+}));
+
+// src/generated/sdk.gen.ts
+var getVideo = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/v1/video",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var searchVideos = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/v1/search",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getChannel = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/v1/channel",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getPlaylist = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/v1/playlist",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getSuggestions = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/v1/suggest",
+    ...options
+  });
+};
+var getCredits = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/v1/credits",
+    ...options
+  });
+};
+var getLogs = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/v1/logs",
+    ...options
+  });
+};
+var getUsage = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/v1/usage",
+    ...options
+  });
+};
+
+// src/index.ts
+var StophyError = class extends Error {
+  code;
+  status;
+  requestId;
+  details;
+  constructor(message, opts) {
+    super(message);
+    this.name = "StophyError";
+    this.status = opts.status;
+    this.code = opts.code;
+    this.requestId = opts.requestId;
+    this.details = opts.details;
+  }
+};
+var Stophy = class {
+  /** The underlying fetch client, if you need lower-level access. */
+  client;
+  constructor(options) {
+    if (!options?.apiKey) {
+      throw new Error("Stophy: `apiKey` is required.");
+    }
+    const baseFetch = options.fetch ?? globalThis.fetch;
+    this.client = createClient(
+      createConfig({
+        baseUrl: options.baseUrl ?? "https://api.stophy.dev",
+        auth: () => options.apiKey,
+        headers: options.headers,
+        fetch: withRetries(
+          baseFetch,
+          options.maxRetries ?? 2,
+          options.retryInitialDelayMs ?? 500
+        )
+      })
+    );
+  }
+  async video(body) {
+    return unwrap(await getVideo({ client: this.client, body }));
+  }
+  /** Search YouTube, optionally filtered by type, sort, date, duration, and features. */
+  async search(body) {
+    return unwrap(await searchVideos({ client: this.client, body }));
+  }
+  /** Channel metadata and content. Switch sections with `tab`. */
+  async channel(body) {
+    return unwrap(await getChannel({ client: this.client, body }));
+  }
+  /** Playlist items. Page through long playlists with `continuationToken`. */
+  async playlist(body) {
+    return unwrap(await getPlaylist({ client: this.client, body }));
+  }
+  /** Search autocomplete suggestions. */
+  async suggest(query) {
+    return unwrap(await getSuggestions({ client: this.client, query }));
+  }
+  /** Your current credit balance. */
+  async credits() {
+    return unwrap(await getCredits({ client: this.client }));
+  }
+  /** Recent API request logs. */
+  async logs(query) {
+    return unwrap(await getLogs({ client: this.client, query }));
+  }
+  /** Daily credit and request counts. */
+  async usage(query) {
+    return unwrap(await getUsage({ client: this.client, query }));
+  }
+};
+var RETRYABLE_STATUS = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+function withRetries(baseFetch, maxRetries, initialDelayMs) {
+  if (maxRetries <= 0) {
+    return baseFetch;
+  }
+  return async (input, init) => {
+    for (let attempt = 0; ; attempt++) {
+      const request = input instanceof Request ? input.clone() : input;
+      try {
+        const response = await baseFetch(request, init);
+        if (attempt < maxRetries && RETRYABLE_STATUS.has(response.status)) {
+          await sleep(retryAfterMs(response) ?? backoffMs(attempt, initialDelayMs));
+          continue;
+        }
+        return response;
+      } catch (error) {
+        if (attempt >= maxRetries) {
+          throw error;
+        }
+        await sleep(backoffMs(attempt, initialDelayMs));
+      }
+    }
+  };
+}
+function backoffMs(attempt, base) {
+  const window = base * 2 ** attempt;
+  return window / 2 + Math.random() * (window / 2);
+}
+function retryAfterMs(response) {
+  const header = response.headers.get("retry-after");
+  if (!header) {
+    return null;
+  }
+  const seconds = Number(header);
+  if (!Number.isNaN(seconds)) {
+    return seconds * 1e3;
+  }
+  const date = Date.parse(header);
+  return Number.isNaN(date) ? null : Math.max(0, date - Date.now());
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function unwrap(result) {
+  if (result.error !== void 0 || result.data === void 0) {
+    const err = result.error ?? {};
+    throw new StophyError(err.error ?? `Stophy request failed with status ${result.response.status}`, {
+      status: result.response.status,
+      code: err.code,
+      requestId: result.response.headers.get("x-request-id") ?? void 0,
+      details: err.details
+    });
+  }
+  return result.data;
+}
+var index_default = Stophy;
+
+export { Stophy, StophyError, index_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generated/client.gen.ts","../src/generated/sdk.gen.ts","../src/index.ts"],"names":["createClient","createConfig"],"mappings":"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","file":"index.js","sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { ClientOptions } from './types.gen';\nimport { type Config, type ClientOptions as DefaultClientOptions, createClient, createConfig } from '@hey-api/client-fetch';\n\n/**\n * The `createClientConfig()` function will be called on client initialization\n * and the returned object will become the client's initial configuration.\n *\n * You may want to initialize your client this way instead of calling\n * `setConfig()`. This is useful for example if you're using Next.js\n * to ensure your client always has the correct values.\n */\nexport type CreateClientConfig<T extends DefaultClientOptions = ClientOptions> = (override?: Config<DefaultClientOptions & T>) => Config<Required<DefaultClientOptions> & T>;\n\nexport const client = createClient(createConfig<ClientOptions>({\n    baseUrl: 'https://api.stophy.dev'\n}));","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';\nimport type { GetVideoData, GetVideoResponse, GetVideoError, SearchVideosData, SearchVideosResponse, SearchVideosError, GetChannelData, GetChannelResponse, GetChannelError, GetPlaylistData, GetPlaylistResponse, GetPlaylistError, GetSuggestionsData, GetSuggestionsResponse, GetSuggestionsError, GetCreditsData, GetCreditsResponse, GetCreditsError, GetLogsData, GetLogsResponse, GetLogsError, GetUsageData, GetUsageResponse, GetUsageError } from './types.gen';\nimport { client as _heyApiClient } from './client.gen';\n\nexport type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {\n    /**\n     * You can provide a client instance returned by `createClient()` instead of\n     * individual options. This might be also useful if you want to implement a\n     * custom client.\n     */\n    client?: Client;\n    /**\n     * You can pass arbitrary values through the `meta` object. This can be\n     * used to access values that aren't defined as part of the SDK function.\n     */\n    meta?: Record<string, unknown>;\n};\n\n/**\n * Video\n * Fetch video details, transcript, comments, replies, or live chat. Pass type: details for metadata, transcript for timestamped captions, comments for top-level comments, replies for a comment thread (pass the repliesToken from a comment as continuationToken), or livechat for live stream chat messages.\n */\nexport const getVideo = <ThrowOnError extends boolean = false>(options: Options<GetVideoData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<GetVideoResponse, GetVideoError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/v1/video',\n        ...options,\n        headers: {\n            'Content-Type': 'application/json',\n            ...options?.headers\n        }\n    });\n};\n\n/**\n * Search\n * Search YouTube with optional filters for content type, sort order, upload date, duration, and features. Returns paginated results.\n */\nexport const searchVideos = <ThrowOnError extends boolean = false>(options: Options<SearchVideosData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<SearchVideosResponse, SearchVideosError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/v1/search',\n        ...options,\n        headers: {\n            'Content-Type': 'application/json',\n            ...options?.headers\n        }\n    });\n};\n\n/**\n * Channel\n * Retrieve channel metadata and content by channelUrl. Use the tab field to switch between videos, shorts, playlists, and about info.\n */\nexport const getChannel = <ThrowOnError extends boolean = false>(options: Options<GetChannelData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<GetChannelResponse, GetChannelError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/v1/channel',\n        ...options,\n        headers: {\n            'Content-Type': 'application/json',\n            ...options?.headers\n        }\n    });\n};\n\n/**\n * Playlist\n * Retrieve items from a YouTube playlist. Use continuationToken to page through long playlists.\n */\nexport const getPlaylist = <ThrowOnError extends boolean = false>(options: Options<GetPlaylistData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<GetPlaylistResponse, GetPlaylistError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/v1/playlist',\n        ...options,\n        headers: {\n            'Content-Type': 'application/json',\n            ...options?.headers\n        }\n    });\n};\n\n/**\n * Suggest\n * Get YouTube search autocomplete suggestions for a query.\n */\nexport const getSuggestions = <ThrowOnError extends boolean = false>(options: Options<GetSuggestionsData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetSuggestionsResponse, GetSuggestionsError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/v1/suggest',\n        ...options\n    });\n};\n\n/**\n * Credits\n * Return the current credit balance for the authenticated API key.\n */\nexport const getCredits = <ThrowOnError extends boolean = false>(options?: Options<GetCreditsData, ThrowOnError>) => {\n    return (options?.client ?? _heyApiClient).get<GetCreditsResponse, GetCreditsError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/v1/credits',\n        ...options\n    });\n};\n\n/**\n * Logs\n * Return recent API request logs for the authenticated key.\n */\nexport const getLogs = <ThrowOnError extends boolean = false>(options?: Options<GetLogsData, ThrowOnError>) => {\n    return (options?.client ?? _heyApiClient).get<GetLogsResponse, GetLogsError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/v1/logs',\n        ...options\n    });\n};\n\n/**\n * Usage\n * Return daily credit and request counts for the authenticated key.\n */\nexport const getUsage = <ThrowOnError extends boolean = false>(options?: Options<GetUsageData, ThrowOnError>) => {\n    return (options?.client ?? _heyApiClient).get<GetUsageResponse, GetUsageError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/v1/usage',\n        ...options\n    });\n};","import { createClient, createConfig, type Client } from \"@hey-api/client-fetch\";\nimport * as ops from \"./generated/sdk.gen\";\nimport type {\n  ErrorResponse,\n  GetVideoData,\n  GetVideoResponse,\n  SearchVideosData,\n  SearchVideosResponse,\n  GetChannelData,\n  GetChannelResponse,\n  GetPlaylistData,\n  GetPlaylistResponse,\n  GetSuggestionsData,\n  GetSuggestionsResponse,\n  GetCreditsResponse,\n  GetLogsData,\n  GetLogsResponse,\n  GetUsageData,\n  GetUsageResponse,\n  VideoDetailsData,\n  TranscriptResult,\n  CommentsData,\n  LiveChatData,\n} from \"./generated/types.gen\";\n\n/** A video response with `data` narrowed to the shape for a given request `type`. */\ntype VideoResponseFor<D> = Omit<GetVideoResponse, \"data\"> & { data: D };\n\nexport * from \"./generated/types.gen\";\n\nexport interface StophyOptions {\n  /** API key from your dashboard. Sent as `Authorization: Bearer <key>`. */\n  apiKey: string;\n  /** Defaults to `https://api.stophy.dev`. */\n  baseUrl?: string;\n  /** Bring your own `fetch` (handy for tests or non-global runtimes). */\n  fetch?: typeof globalThis.fetch;\n  /** Sent with every request. */\n  headers?: Record<string, string>;\n  /**\n   * Retry attempts for transient failures (network errors and\n   * 429/500/502/503/504). Set to `0` to disable. Defaults to `2`.\n   */\n  maxRetries?: number;\n  /** Base delay for backoff, in ms. Defaults to `500`. */\n  retryInitialDelayMs?: number;\n}\n\n/** Thrown when the API responds with a non-2xx status. */\nexport class StophyError extends Error {\n  readonly code?: ErrorResponse[\"code\"];\n  readonly status: number;\n  readonly requestId?: string;\n  readonly details?: unknown;\n\n  constructor(\n    message: string,\n    opts: {\n      status: number;\n      code?: ErrorResponse[\"code\"];\n      requestId?: string;\n      details?: unknown;\n    },\n  ) {\n    super(message);\n    this.name = \"StophyError\";\n    this.status = opts.status;\n    this.code = opts.code;\n    this.requestId = opts.requestId;\n    this.details = opts.details;\n  }\n}\n\n/**\n * Stophy API client — YouTube context API for AI agents.\n *\n * ```ts\n * const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY! });\n * const { data } = await stophy.video({ type: \"transcript\", videoUrl });\n * ```\n */\nexport class Stophy {\n  /** The underlying fetch client, if you need lower-level access. */\n  readonly client: Client;\n\n  constructor(options: StophyOptions) {\n    if (!options?.apiKey) {\n      throw new Error(\"Stophy: `apiKey` is required.\");\n    }\n    const baseFetch = options.fetch ?? globalThis.fetch;\n    this.client = createClient(\n      createConfig({\n        baseUrl: options.baseUrl ?? \"https://api.stophy.dev\",\n        auth: () => options.apiKey,\n        headers: options.headers,\n        fetch: withRetries(\n          baseFetch,\n          options.maxRetries ?? 2,\n          options.retryInitialDelayMs ?? 500,\n        ),\n      }),\n    );\n  }\n\n  /** Video details, transcript, comments, replies, or live chat — pick with `type`. */\n  async video(\n    body: GetVideoData[\"body\"] & { type: \"details\" },\n  ): Promise<VideoResponseFor<VideoDetailsData>>;\n  async video(\n    body: GetVideoData[\"body\"] & { type: \"transcript\" },\n  ): Promise<VideoResponseFor<TranscriptResult>>;\n  async video(\n    body: GetVideoData[\"body\"] & { type: \"comments\" | \"replies\" },\n  ): Promise<VideoResponseFor<CommentsData>>;\n  async video(\n    body: GetVideoData[\"body\"] & { type: \"livechat\" },\n  ): Promise<VideoResponseFor<LiveChatData>>;\n  async video(body: GetVideoData[\"body\"]): Promise<GetVideoResponse>;\n  async video(body: GetVideoData[\"body\"]): Promise<GetVideoResponse> {\n    return unwrap(await ops.getVideo({ client: this.client, body }));\n  }\n\n  /** Search YouTube, optionally filtered by type, sort, date, duration, and features. */\n  async search(body: SearchVideosData[\"body\"]): Promise<SearchVideosResponse> {\n    return unwrap(await ops.searchVideos({ client: this.client, body }));\n  }\n\n  /** Channel metadata and content. Switch sections with `tab`. */\n  async channel(body: GetChannelData[\"body\"]): Promise<GetChannelResponse> {\n    return unwrap(await ops.getChannel({ client: this.client, body }));\n  }\n\n  /** Playlist items. Page through long playlists with `continuationToken`. */\n  async playlist(body: GetPlaylistData[\"body\"]): Promise<GetPlaylistResponse> {\n    return unwrap(await ops.getPlaylist({ client: this.client, body }));\n  }\n\n  /** Search autocomplete suggestions. */\n  async suggest(query: GetSuggestionsData[\"query\"]): Promise<GetSuggestionsResponse> {\n    return unwrap(await ops.getSuggestions({ client: this.client, query }));\n  }\n\n  /** Your current credit balance. */\n  async credits(): Promise<GetCreditsResponse> {\n    return unwrap(await ops.getCredits({ client: this.client }));\n  }\n\n  /** Recent API request logs. */\n  async logs(query?: GetLogsData[\"query\"]): Promise<GetLogsResponse> {\n    return unwrap(await ops.getLogs({ client: this.client, query }));\n  }\n\n  /** Daily credit and request counts. */\n  async usage(query?: GetUsageData[\"query\"]): Promise<GetUsageResponse> {\n    return unwrap(await ops.getUsage({ client: this.client, query }));\n  }\n}\n\nconst RETRYABLE_STATUS = new Set([429, 500, 502, 503, 504]);\n\ntype FetchFn = (input: Request | URL | string, init?: RequestInit) => Promise<Response>;\n\n// Wrap a fetch so transient failures (network errors and retryable statuses)\n// are retried with exponential backoff + jitter, honoring `Retry-After`.\n// Every Stophy endpoint is a read, so retrying is always safe.\nfunction withRetries(\n  baseFetch: typeof globalThis.fetch,\n  maxRetries: number,\n  initialDelayMs: number,\n): FetchFn {\n  if (maxRetries <= 0) {\n    return baseFetch;\n  }\n  return async (input, init) => {\n    for (let attempt = 0; ; attempt++) {\n      // Clone so the body survives a retry when `input` is a Request.\n      const request = input instanceof Request ? input.clone() : input;\n      try {\n        const response = await baseFetch(request, init);\n        if (attempt < maxRetries && RETRYABLE_STATUS.has(response.status)) {\n          await sleep(retryAfterMs(response) ?? backoffMs(attempt, initialDelayMs));\n          continue;\n        }\n        return response;\n      } catch (error) {\n        if (attempt >= maxRetries) {\n          throw error;\n        }\n        await sleep(backoffMs(attempt, initialDelayMs));\n      }\n    }\n  };\n}\n\nfunction backoffMs(attempt: number, base: number): number {\n  const window = base * 2 ** attempt;\n  return window / 2 + Math.random() * (window / 2);\n}\n\nfunction retryAfterMs(response: Response): number | null {\n  const header = response.headers.get(\"retry-after\");\n  if (!header) {\n    return null;\n  }\n  const seconds = Number(header);\n  if (!Number.isNaN(seconds)) {\n    return seconds * 1000;\n  }\n  const date = Date.parse(header);\n  return Number.isNaN(date) ? null : Math.max(0, date - Date.now());\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n// Pull `data` out of a result, or throw a StophyError if the call failed.\nfunction unwrap<T>(result: {\n  data?: T;\n  error?: unknown;\n  response: Response;\n}): T {\n  if (result.error !== undefined || result.data === undefined) {\n    const err = (result.error ?? {}) as Partial<ErrorResponse>;\n    throw new StophyError(err.error ?? `Stophy request failed with status ${result.response.status}`, {\n      status: result.response.status,\n      code: err.code,\n      requestId: result.response.headers.get(\"x-request-id\") ?? undefined,\n      details: err.details,\n    });\n  }\n  return result.data;\n}\n\nexport default Stophy;\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "stophy",
+  "version": "0.1.1",
+  "description": "Official TypeScript SDK for Stophy - The YouTube context API for AI agents.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://stophy.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stophy/typescript-sdk.git"
+  },
+  "keywords": [
+    "stophy",
+    "youtube",
+    "transcript",
+    "sdk",
+    "ai-agents"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "generate": "openapi-ts",
+    "build": "tsup",
+    "test": "bun test ../../test/typescript",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "npm run generate && npm run build"
+  },
+  "devDependencies": {
+    "@hey-api/openapi-ts": "^0.64.0",
+    "@types/bun": "^1.1.14",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "@hey-api/client-fetch": "^0.10.2"
+  }
+}