@keystrokehq/spotify 0.0.1

package/dist/connection.d.mts

@@ -0,0 +1,2 @@
+import { i as spotifyOfficialIntegration, n as spotify, t as SpotifyCredentials } from "./integration-DQ5Egd4f.mjs";
+export { type SpotifyCredentials, spotify, spotifyOfficialIntegration };

package/dist/connection.mjs

@@ -0,0 +1,3 @@
+import { r as spotifyOfficialIntegration, t as spotify } from "./integration-ykoImsCq.mjs";
+
+export { spotify, spotifyOfficialIntegration };

package/dist/episodes.d.mts

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import * as _keystrokehq_core0 from "@keystrokehq/core";
+import * as _keystrokehq_core_credential_set0 from "@keystrokehq/core/credential-set";
+
+//#region src/episodes.d.ts
+declare const getEpisode: _keystrokehq_core0.Operation<z.ZodObject<{
+  id: z.ZodString;
+  market: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  audioPreviewUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
+  description: z.ZodOptional<z.ZodString>;
+  durationMs: z.ZodNumber;
+  explicit: z.ZodBoolean;
+  externalUrls: z.ZodOptional<z.ZodObject<{
+    spotify: z.ZodOptional<z.ZodURL>;
+  }, z.core.$strip>>;
+  href: z.ZodOptional<z.ZodURL>;
+  htmlDescription: z.ZodOptional<z.ZodString>;
+  id: z.ZodString;
+  images: z.ZodArray<z.ZodObject<{
+    url: z.ZodURL;
+    height: z.ZodNullable<z.ZodNumber>;
+    width: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  isExternallyHosted: z.ZodOptional<z.ZodBoolean>;
+  isPlayable: z.ZodOptional<z.ZodBoolean>;
+  language: z.ZodOptional<z.ZodString>;
+  languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  name: z.ZodString;
+  releaseDate: z.ZodOptional<z.ZodString>;
+  releaseDatePrecision: z.ZodOptional<z.ZodEnum<{
+    year: "year";
+    month: "month";
+    day: "day";
+  }>>;
+  resumePoint: z.ZodOptional<z.ZodObject<{
+    fullyPlayed: z.ZodBoolean;
+    resumePositionMs: z.ZodNumber;
+  }, z.core.$strip>>;
+  restrictions: z.ZodOptional<z.ZodObject<{
+    reason: z.ZodString;
+  }, z.core.$strip>>;
+  show: z.ZodOptional<z.ZodObject<{
+    availableMarkets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    copyrights: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      text: z.ZodString;
+      type: z.ZodString;
+    }, z.core.$strip>>>;
+    description: z.ZodOptional<z.ZodString>;
+    explicit: z.ZodOptional<z.ZodBoolean>;
+    externalUrls: z.ZodOptional<z.ZodObject<{
+      spotify: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    href: z.ZodOptional<z.ZodURL>;
+    id: z.ZodString;
+    images: z.ZodArray<z.ZodObject<{
+      url: z.ZodURL;
+      height: z.ZodNullable<z.ZodNumber>;
+      width: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    mediaType: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    publisher: z.ZodOptional<z.ZodString>;
+    totalEpisodes: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"show">;
+    uri: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  type: z.ZodLiteral<"episode">;
+  uri: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"spotify", z.ZodObject<{
+  SPOTIFY_ACCESS_TOKEN: z.ZodString;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  SPOTIFY_ACCESS_TOKEN: z.ZodString;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const getSeveralEpisodes: _keystrokehq_core0.Operation<z.ZodObject<{
+  ids: z.ZodArray<z.ZodString>;
+  market: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  episodes: z.ZodArray<z.ZodObject<{
+    audioPreviewUrl: z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodNull]>>;
+    description: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodNumber;
+    explicit: z.ZodBoolean;
+    externalUrls: z.ZodOptional<z.ZodObject<{
+      spotify: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    href: z.ZodOptional<z.ZodURL>;
+    htmlDescription: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    images: z.ZodArray<z.ZodObject<{
+      url: z.ZodURL;
+      height: z.ZodNullable<z.ZodNumber>;
+      width: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    isExternallyHosted: z.ZodOptional<z.ZodBoolean>;
+    isPlayable: z.ZodOptional<z.ZodBoolean>;
+    language: z.ZodOptional<z.ZodString>;
+    languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    name: z.ZodString;
+    releaseDate: z.ZodOptional<z.ZodString>;
+    releaseDatePrecision: z.ZodOptional<z.ZodEnum<{
+      year: "year";
+      month: "month";
+      day: "day";
+    }>>;
+    resumePoint: z.ZodOptional<z.ZodObject<{
+      fullyPlayed: z.ZodBoolean;
+      resumePositionMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    restrictions: z.ZodOptional<z.ZodObject<{
+      reason: z.ZodString;
+    }, z.core.$strip>>;
+    show: z.ZodOptional<z.ZodObject<{
+      availableMarkets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      copyrights: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        type: z.ZodString;
+      }, z.core.$strip>>>;
+      description: z.ZodOptional<z.ZodString>;
+      explicit: z.ZodOptional<z.ZodBoolean>;
+      externalUrls: z.ZodOptional<z.ZodObject<{
+        spotify: z.ZodOptional<z.ZodURL>;
+      }, z.core.$strip>>;
+      href: z.ZodOptional<z.ZodURL>;
+      id: z.ZodString;
+      images: z.ZodArray<z.ZodObject<{
+        url: z.ZodURL;
+        height: z.ZodNullable<z.ZodNumber>;
+        width: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>>;
+      languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      mediaType: z.ZodOptional<z.ZodString>;
+      name: z.ZodString;
+      publisher: z.ZodOptional<z.ZodString>;
+      totalEpisodes: z.ZodOptional<z.ZodNumber>;
+      type: z.ZodLiteral<"show">;
+      uri: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"episode">;
+    uri: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"spotify", z.ZodObject<{
+  SPOTIFY_ACCESS_TOKEN: z.ZodString;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  SPOTIFY_ACCESS_TOKEN: z.ZodString;
+}, z.core.$strip>>[] | undefined>], undefined>;
+//#endregion
+export { getEpisode, getSeveralEpisodes };

package/dist/episodes.mjs

@@ -0,0 +1,39 @@
+import { spotifyEpisodeSchema, spotifyIdSchema, spotifyMarketSchema } from "./schemas.mjs";
+import { createSpotifyClient } from "./client.mjs";
+import { t as spotifyOperation } from "./factory-tZba6Hij.mjs";
+import { z } from "zod";
+
+//#region src/episodes.ts
+const severalEpisodeIdsSchema = z.array(spotifyIdSchema).min(1).max(50);
+const episodeLookupInputSchema = z.object({
+	id: spotifyIdSchema,
+	market: spotifyMarketSchema.optional()
+});
+const severalEpisodesInputSchema = z.object({
+	ids: severalEpisodeIdsSchema,
+	market: spotifyMarketSchema.optional()
+});
+const severalEpisodesOutputSchema = z.object({ episodes: z.array(spotifyEpisodeSchema) });
+const getEpisode = spotifyOperation({
+	id: "get_spotify_episode",
+	name: "Get Spotify Episode",
+	description: "Fetch a single Spotify episode by ID.",
+	input: episodeLookupInputSchema,
+	output: spotifyEpisodeSchema,
+	run: async (input, credentials) => {
+		return createSpotifyClient(credentials).episodes.getEpisode(input.id, input.market);
+	}
+});
+const getSeveralEpisodes = spotifyOperation({
+	id: "get_spotify_several_episodes",
+	name: "Get Several Spotify Episodes",
+	description: "Fetch multiple Spotify episodes in a single request.",
+	input: severalEpisodesInputSchema,
+	output: severalEpisodesOutputSchema,
+	run: async (input, credentials) => {
+		return createSpotifyClient(credentials).episodes.getSeveralEpisodes(input.ids, input.market);
+	}
+});
+
+//#endregion
+export { getEpisode, getSeveralEpisodes };

package/dist/errors.d.mts

@@ -0,0 +1,34 @@
+//#region src/errors.d.ts
+declare const spotifyApiErrorKinds: readonly ["http", "rate_limit", "auth", "premium_required", "deprecated", "validation"];
+type SpotifyApiErrorKind = (typeof spotifyApiErrorKinds)[number];
+interface SpotifyApiErrorOptions {
+  readonly kind: SpotifyApiErrorKind;
+  readonly message: string;
+  readonly status?: number;
+  readonly code?: string;
+  readonly requestId?: string;
+  readonly retryAfterSeconds?: number;
+  readonly retryable?: boolean;
+  readonly details?: Record<string, string | number | boolean | null | undefined>;
+}
+declare class SpotifyApiError extends Error {
+  readonly kind: SpotifyApiErrorKind;
+  readonly status?: number;
+  readonly code?: string;
+  readonly requestId?: string;
+  readonly retryAfterSeconds?: number;
+  readonly retryable: boolean;
+  readonly details?: Record<string, string | number | boolean | null | undefined>;
+  constructor(options: SpotifyApiErrorOptions);
+}
+declare function isRetryableStatus(status: number | undefined): boolean;
+declare function classifySpotifyApiError(input: {
+  readonly status?: number;
+  readonly message: string;
+  readonly code?: string;
+  readonly retryAfterSeconds?: number;
+  readonly requestId?: string;
+  readonly details?: Record<string, string | number | boolean | null | undefined>;
+}): SpotifyApiError;
+//#endregion
+export { SpotifyApiError, SpotifyApiErrorKind, SpotifyApiErrorOptions, classifySpotifyApiError, isRetryableStatus, spotifyApiErrorKinds };

package/dist/errors.mjs

@@ -0,0 +1,89 @@
+//#region src/errors.ts
+const spotifyApiErrorKinds = [
+	"http",
+	"rate_limit",
+	"auth",
+	"premium_required",
+	"deprecated",
+	"validation"
+];
+var SpotifyApiError = class extends Error {
+	kind;
+	status;
+	code;
+	requestId;
+	retryAfterSeconds;
+	retryable;
+	details;
+	constructor(options) {
+		super(options.message);
+		this.name = "SpotifyApiError";
+		this.kind = options.kind;
+		this.status = options.status;
+		this.code = options.code;
+		this.requestId = options.requestId;
+		this.retryAfterSeconds = options.retryAfterSeconds;
+		this.retryable = options.retryable ?? isRetryableStatus(options.status);
+		this.details = options.details;
+	}
+};
+function isRetryableStatus(status) {
+	if (status === void 0) return false;
+	return status === 429 || status >= 500;
+}
+function classifySpotifyApiError(input) {
+	const normalizedMessage = input.message.toLowerCase();
+	const normalizedCode = input.code?.toLowerCase();
+	if (input.status === 429) return new SpotifyApiError({
+		kind: "rate_limit",
+		message: input.message,
+		status: input.status,
+		code: input.code,
+		requestId: input.requestId,
+		retryAfterSeconds: input.retryAfterSeconds,
+		retryable: true,
+		details: input.details
+	});
+	if (input.status === 401 || normalizedCode === "invalid_token" || normalizedMessage.includes("invalid access token") || normalizedMessage.includes("authentication")) return new SpotifyApiError({
+		kind: "auth",
+		message: input.message,
+		status: input.status,
+		code: input.code,
+		requestId: input.requestId,
+		retryAfterSeconds: input.retryAfterSeconds,
+		retryable: false,
+		details: input.details
+	});
+	if (input.status === 403 && (normalizedCode === "premium_required" || normalizedMessage.includes("premium required"))) return new SpotifyApiError({
+		kind: "premium_required",
+		message: input.message,
+		status: input.status,
+		code: input.code ?? "PREMIUM_REQUIRED",
+		requestId: input.requestId,
+		retryAfterSeconds: input.retryAfterSeconds,
+		retryable: false,
+		details: input.details
+	});
+	if (input.status === 404 && (normalizedMessage.includes("deprecated") || normalizedMessage.includes("not available to your app") || normalizedMessage.includes("restricted"))) return new SpotifyApiError({
+		kind: "deprecated",
+		message: input.message,
+		status: input.status,
+		code: input.code,
+		requestId: input.requestId,
+		retryAfterSeconds: input.retryAfterSeconds,
+		retryable: false,
+		details: input.details
+	});
+	return new SpotifyApiError({
+		kind: "http",
+		message: input.message,
+		status: input.status,
+		code: input.code,
+		requestId: input.requestId,
+		retryAfterSeconds: input.retryAfterSeconds,
+		details: input.details
+	});
+}
+
+//#endregion
+export { SpotifyApiError, classifySpotifyApiError, isRetryableStatus, spotifyApiErrorKinds };