@putdotio/sdk 10.4.0 → 10.4.1

package/dist/index.js

@@ -474,21 +474,24 @@ const OAuthRegeneratedTokenEnvelopeSchema = Schema.Struct({
 	access_token: Schema.String,
 	status: Schema.Literal("OK")
 });
+const OAuthAppIdSchema = Schema.Int.check(Schema.isGreaterThan(0));
+const OAuthAppDescriptionSchema = Schema.String.check(Schema.isMinLength(10));
+const OAuthAppUrlSchema = Schema.String.check(Schema.isMaxLength(255));
 const OAuthAppCreateInputSchema = Schema.Struct({
-	callback: Schema.String,
-	description: Schema.String,
+	callback: OAuthAppUrlSchema,
+	description: OAuthAppDescriptionSchema,
 	hidden: Schema.optional(Schema.Boolean),
 	icon: Schema.optional(Schema.instanceOf(Blob)),
-	name: Schema.String,
-	website: Schema.String
+	name: Schema.String.check(Schema.isMinLength(5)),
+	website: OAuthAppUrlSchema
 });
 const OAuthAppUpdateInputSchema = Schema.Struct({
-	callback: Schema.String,
-	description: Schema.String,
+	callback: OAuthAppUrlSchema,
+	description: OAuthAppDescriptionSchema,
 	hidden: Schema.optional(Schema.Boolean),
 	icon: Schema.optional(Schema.instanceOf(Blob)),
-	id: Schema.Int,
-	website: Schema.String
+	id: OAuthAppIdSchema,
+	website: OAuthAppUrlSchema
 });
 const OAuthSetIconInputSchema = Schema.Struct({ icon: Schema.instanceOf(Blob) });
 const QueryOAuthAppsErrorSpec = definePutioOperationErrorSpec({
@@ -573,46 +576,60 @@ const queryOAuthApps = () => requestJson(OAuthAppsEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/oauth/apps"
 }).pipe(selectJsonField("apps"), withOperationErrors(QueryOAuthAppsErrorSpec));
-const getOAuthApp = (id, options) => requestJson(OAuthAppWithTokenSchema, {
+const getOAuthApp = (id, options) => Schema.decodeUnknownEffect(Schema.Struct({
+	edit: Schema.optional(Schema.Boolean),
+	id: OAuthAppIdSchema
+}))({
+	edit: options?.edit,
+	id
+}).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(OAuthAppWithTokenSchema, {
 	method: "GET",
-	path: options?.edit ? `/v2/oauth/apps/${encodePathSegment(id)}/edit` : `/v2/oauth/apps/${encodePathSegment(id)}`
-}).pipe(withOperationErrors(GetOAuthAppErrorSpec));
+	path: decodedInput.edit ? `/v2/oauth/apps/${encodePathSegment(decodedInput.id)}/edit` : `/v2/oauth/apps/${encodePathSegment(decodedInput.id)}`
+})), withOperationErrors(GetOAuthAppErrorSpec));
 const setOAuthAppIcon = (id, input) => {
-	const formData = new FormData();
-	formData.append("icon", input.icon);
-	return requestJson(OkResponseSchema, {
-		body: {
-			type: "form-data",
-			value: formData
-		},
-		method: "POST",
-		path: `/v2/oauth/apps/${encodePathSegment(id)}/icon`
-	});
+	return Schema.decodeUnknownEffect(Schema.Struct({
+		id: OAuthAppIdSchema,
+		input: OAuthSetIconInputSchema
+	}))({
+		id,
+		input
+	}).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => {
+		const formData = new FormData();
+		formData.append("icon", decodedInput.input.icon);
+		return requestJson(OkResponseSchema, {
+			body: {
+				type: "form-data",
+				value: formData
+			},
+			method: "POST",
+			path: `/v2/oauth/apps/${encodePathSegment(decodedInput.id)}/icon`
+		});
+	}));
 };
-const createOAuthApp = (input) => requestJson(OAuthAppEnvelopeSchema, {
+const createOAuthApp = (input) => Schema.decodeUnknownEffect(OAuthAppCreateInputSchema)(input).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(OAuthAppEnvelopeSchema, {
 	body: {
 		type: "form-data",
-		value: makeCreateOAuthAppFormData(input)
+		value: makeCreateOAuthAppFormData(decodedInput)
 	},
 	method: "POST",
 	path: "/v2/oauth/apps/register"
-}).pipe(withOperationErrors(CreateOAuthAppErrorSpec));
-const updateOAuthApp = (input) => requestJson(OAuthAppWithTokenSchema, {
+})), withOperationErrors(CreateOAuthAppErrorSpec));
+const updateOAuthApp = (input) => Schema.decodeUnknownEffect(OAuthAppUpdateInputSchema)(input).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(OAuthAppWithTokenSchema, {
 	body: {
 		type: "form-data",
-		value: makeUpdateOAuthAppFormData(input)
+		value: makeUpdateOAuthAppFormData(decodedInput)
 	},
 	method: "POST",
-	path: `/v2/oauth/apps/${encodePathSegment(input.id)}`
-}).pipe(withOperationErrors(UpdateOAuthAppErrorSpec));
-const deleteOAuthApp = (id) => requestJson(OkResponseSchema, {
+	path: `/v2/oauth/apps/${encodePathSegment(decodedInput.id)}`
+})), withOperationErrors(UpdateOAuthAppErrorSpec));
+const deleteOAuthApp = (id) => Schema.decodeUnknownEffect(OAuthAppIdSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/oauth/apps/${encodePathSegment(id)}/delete`
-}).pipe(withOperationErrors(DeleteOAuthAppErrorSpec));
-const regenerateOAuthAppToken = (id) => requestJson(OAuthRegeneratedTokenEnvelopeSchema, {
+	path: `/v2/oauth/apps/${encodePathSegment(decodedId)}/delete`
+})), withOperationErrors(DeleteOAuthAppErrorSpec));
+const regenerateOAuthAppToken = (id) => Schema.decodeUnknownEffect(OAuthAppIdSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(OAuthRegeneratedTokenEnvelopeSchema, {
 	method: "POST",
-	path: `/v2/oauth/apps/${encodePathSegment(id)}/regenerate_token`
-}).pipe(selectJsonField("access_token"), withOperationErrors(RegenerateOAuthAppTokenErrorSpec));
+	path: `/v2/oauth/apps/${encodePathSegment(decodedId)}/regenerate_token`
+})), selectJsonField("access_token"), withOperationErrors(RegenerateOAuthAppTokenErrorSpec));
 const getPopularOAuthApps = () => requestJson(PopularOAuthAppsEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/oauth/apps/popular"
@@ -1366,6 +1383,16 @@ const deleteConfigKey = (key) => Schema.decodeUnknownEffect(ConfigKeySchema)(key
 	path: `/v2/config/${encodePathSegment(decodedKey)}`
 })));
 //#endregion
+//#region src/core/validation.ts
+const PositiveIntegerSchema = Schema.Int.check(Schema.isGreaterThan(0));
+const NonEmptyStringSchema = Schema.String.check(Schema.isMinLength(1));
+const decodeAndRun = (schema, input, run) => Schema.decodeUnknownEffect(schema)(input).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap(run));
+const makeCursorSelectionSchema = (idsField, excludeIdsField) => Schema.Struct({
+	cursor: Schema.optional(NonEmptyStringSchema),
+	[excludeIdsField]: Schema.optional(Schema.Array(PositiveIntegerSchema)),
+	[idsField]: Schema.optional(Schema.Array(PositiveIntegerSchema).check(Schema.isMinLength(1)))
+}).check(Schema.makeFilter((input) => input.cursor !== void 0 || input[idsField] !== void 0, { expected: "a non-empty cursor or file ID selection" }));
+//#endregion
 //#region src/domains/download-links.ts
 const DownloadLinksStatusSchema = Schema.Literals([
 	"NEW",
@@ -1373,11 +1400,7 @@ const DownloadLinksStatusSchema = Schema.Literals([
 	"DONE",
 	"ERROR"
 ]);
-const DownloadLinksCreateInputSchema = Schema.Struct({
-	cursor: Schema.optional(Schema.String),
-	excludeIds: Schema.optional(Schema.Array(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))),
-	ids: Schema.optional(Schema.Array(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0))))
-});
+const DownloadLinksCreateInputSchema = makeCursorSelectionSchema("ids", "excludeIds");
 const DownloadLinksPayloadSchema = Schema.Struct({
 	download_links: Schema.Array(Schema.String),
 	media_links: Schema.Array(Schema.String),
@@ -1452,18 +1475,18 @@ const GetDownloadLinksErrorSpec = definePutioOperationErrorSpec({
 		{ statusCode: 404 }
 	]
 });
-const createDownloadLinks = (input = {}) => requestJson(DownloadLinksCreateEnvelopeSchema, {
+const createDownloadLinks = (input = {}) => Schema.decodeUnknownEffect(DownloadLinksCreateInputSchema)(input).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(DownloadLinksCreateEnvelopeSchema, {
 	body: {
 		type: "form",
-		value: toCursorSelectionForm(input)
+		value: toCursorSelectionForm(decodedInput)
 	},
 	method: "POST",
 	path: "/v2/download_links/create"
-}).pipe(selectJsonFields("id"), withOperationErrors(CreateDownloadLinksErrorSpec));
-const getDownloadLinks = (id) => requestJson(DownloadLinksInfoSchema, {
+})), selectJsonFields("id"), withOperationErrors(CreateDownloadLinksErrorSpec));
+const getDownloadLinks = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(DownloadLinksInfoSchema, {
 	method: "GET",
-	path: `/v2/download_links/${encodePathSegment(id)}`
-}).pipe(withOperationErrors(GetDownloadLinksErrorSpec));
+	path: `/v2/download_links/${encodePathSegment(decodedId)}`
+})), withOperationErrors(GetDownloadLinksErrorSpec));
 //#endregion
 //#region src/domains/events.ts
 const HistoryEventBaseSchema = Schema.Struct({
@@ -1612,23 +1635,23 @@ const GetEventTorrentErrorSpec = definePutioOperationErrorSpec({
 		{ statusCode: 500 }
 	]
 });
-const listEvents = (query = {}) => requestJson(EventsListEnvelopeSchema, {
+const listEvents = (query = {}) => Schema.decodeUnknownEffect(EventsListQuerySchema)(query).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedQuery) => requestJson(EventsListEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/events/list",
-	query
-}).pipe(withOperationErrors(ListEventsErrorSpec));
-const deleteEvent = (id) => requestJson(OkResponseSchema, {
+	query: decodedQuery
+})), withOperationErrors(ListEventsErrorSpec));
+const deleteEvent = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/events/delete/${encodePathSegment(id)}`
-}).pipe(withOperationErrors(DeleteEventErrorSpec));
+	path: `/v2/events/delete/${encodePathSegment(decodedId)}`
+})), withOperationErrors(DeleteEventErrorSpec));
 const clearEvents = () => requestJson(OkResponseSchema, {
 	method: "POST",
 	path: "/v2/events/delete"
 }).pipe(withOperationErrors(ClearEventsErrorSpec));
-const getEventTorrent = (id) => requestArrayBuffer({
+const getEventTorrent = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestArrayBuffer({
 	method: "GET",
-	path: `/v2/events/${encodePathSegment(id)}/torrent`
-}).pipe(withOperationErrors(GetEventTorrentErrorSpec));
+	path: `/v2/events/${encodePathSegment(decodedId)}/torrent`
+})), withOperationErrors(GetEventTorrentErrorSpec));
 //#endregion
 //#region src/domains/family.ts
 const NonNegativeIntegerSchema = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
@@ -1747,14 +1770,14 @@ const createFamilyInvite = () => requestJson(FamilyCreateInviteEnvelopeSchema, {
 	method: "POST",
 	path: "/v2/family/sub_account"
 }).pipe(selectJsonFields("code"), withOperationErrors(CreateFamilyInviteErrorSpec));
-const removeFamilyMember = (username) => requestJson(OkResponseSchema, {
+const removeFamilyMember = (username) => Schema.decodeUnknownEffect(NonEmptyStringSchema)(username).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedUsername) => requestJson(OkResponseSchema, {
 	method: "DELETE",
-	path: `/v2/family/sub_account/${encodePathSegment(username)}`
-}).pipe(Effect.asVoid, withOperationErrors(RemoveFamilyMemberErrorSpec));
-const joinFamily = (inviteCode) => requestJson(OkResponseSchema, {
+	path: `/v2/family/sub_account/${encodePathSegment(decodedUsername)}`
+})), Effect.asVoid, withOperationErrors(RemoveFamilyMemberErrorSpec));
+const joinFamily = (inviteCode) => Schema.decodeUnknownEffect(NonEmptyStringSchema)(inviteCode).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInviteCode) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/family/join/${encodePathSegment(inviteCode)}`
-}).pipe(Effect.asVoid, withOperationErrors(JoinFamilyErrorSpec));
+	path: `/v2/family/join/${encodePathSegment(decodedInviteCode)}`
+})), Effect.asVoid, withOperationErrors(JoinFamilyErrorSpec));
 //#endregion
 //#region src/domains/ifttt.ts
 const IFTTTStatusEnvelopeSchema = Schema.Struct({
@@ -2980,14 +3003,15 @@ const FriendSharedFolderErrorSpec = definePutioOperationErrorSpec({
 		{ statusCode: 404 }
 	]
 });
+const decodeUsername = (username) => Schema.decodeUnknownEffect(NonEmptyStringSchema)(username).pipe(Effect.mapError(mapDecodeErrorToValidationError));
 const listFriends = () => requestJson(FriendsListEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/friends/list"
 }).pipe(selectJsonFields("friends", "total"), withOperationErrors(ListFriendsErrorSpec));
-const searchFriends = (username) => requestJson(FriendSearchEnvelopeSchema, {
+const searchFriends = (username) => decodeUsername(username).pipe(Effect.flatMap((decodedUsername) => requestJson(FriendSearchEnvelopeSchema, {
 	method: "GET",
-	path: `/v2/friends/user-search/${encodePathSegment(username)}`
-}).pipe(selectJsonField("users"), withOperationErrors(SearchFriendsErrorSpec));
+	path: `/v2/friends/user-search/${encodePathSegment(decodedUsername)}`
+})), selectJsonField("users"), withOperationErrors(SearchFriendsErrorSpec));
 const listWaitingRequests = () => requestJson(FriendRequestsEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/friends/waiting-requests"
@@ -3000,26 +3024,26 @@ const listSentRequests = () => requestJson(FriendRequestsEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/friends/sent-requests"
 }).pipe(selectJsonField("friends"), withOperationErrors(ListSentRequestsErrorSpec));
-const sendFriendRequest = (username) => requestJson(OkResponseSchema, {
+const sendFriendRequest = (username) => decodeUsername(username).pipe(Effect.flatMap((decodedUsername) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/friends/${encodePathSegment(username)}/request`
-}).pipe(withOperationErrors(SendFriendRequestErrorSpec));
-const removeFriend = (username) => requestJson(OkResponseSchema, {
+	path: `/v2/friends/${encodePathSegment(decodedUsername)}/request`
+})), withOperationErrors(SendFriendRequestErrorSpec));
+const removeFriend = (username) => decodeUsername(username).pipe(Effect.flatMap((decodedUsername) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/friends/${encodePathSegment(username)}/unfriend`
-}).pipe(withOperationErrors(RemoveFriendErrorSpec));
-const approveFriendRequest = (username) => requestJson(OkResponseSchema, {
+	path: `/v2/friends/${encodePathSegment(decodedUsername)}/unfriend`
+})), withOperationErrors(RemoveFriendErrorSpec));
+const approveFriendRequest = (username) => decodeUsername(username).pipe(Effect.flatMap((decodedUsername) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/friends/${encodePathSegment(username)}/approve`
-}).pipe(withOperationErrors(ApproveFriendRequestErrorSpec));
-const denyFriendRequest = (username) => requestJson(OkResponseSchema, {
+	path: `/v2/friends/${encodePathSegment(decodedUsername)}/approve`
+})), withOperationErrors(ApproveFriendRequestErrorSpec));
+const denyFriendRequest = (username) => decodeUsername(username).pipe(Effect.flatMap((decodedUsername) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/friends/${encodePathSegment(username)}/deny`
-}).pipe(withOperationErrors(DenyFriendRequestErrorSpec));
-const getFriendSharedFolder = (username) => requestJson(FriendSharedFolderEnvelopeSchema, {
+	path: `/v2/friends/${encodePathSegment(decodedUsername)}/deny`
+})), withOperationErrors(DenyFriendRequestErrorSpec));
+const getFriendSharedFolder = (username) => decodeUsername(username).pipe(Effect.flatMap((decodedUsername) => requestJson(FriendSharedFolderEnvelopeSchema, {
 	method: "GET",
-	path: `/v2/friends/${encodePathSegment(username)}/files`
-}).pipe(selectJsonField("file"), withOperationErrors(FriendSharedFolderErrorSpec));
+	path: `/v2/friends/${encodePathSegment(decodedUsername)}/files`
+})), selectJsonField("file"), withOperationErrors(FriendSharedFolderErrorSpec));
 //#endregion
 //#region src/domains/payment.ts
 const PaymentPlanTypeSchema = Schema.Literals(["onetime", "subscription"]);
@@ -3746,10 +3770,18 @@ const RssFeedParamsSchema = Schema.Struct({
 	dont_process_whole_feed: Schema.optional(Schema.Boolean),
 	keyword: Schema.optional(Schema.NullOr(Schema.String)),
 	parent_dir_id: Schema.optional(Schema.Union([Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)), Schema.Literal("newf")])),
-	rss_source_url: Schema.String,
-	title: Schema.String,
+	rss_source_url: NonEmptyStringSchema,
+	title: NonEmptyStringSchema,
 	unwanted_keywords: Schema.optional(Schema.String)
 });
+const RssFeedUpdateInputSchema = Schema.Struct({
+	id: PositiveIntegerSchema,
+	params: RssFeedParamsSchema
+});
+const RssFeedItemRetryInputSchema = Schema.Struct({
+	feedId: PositiveIntegerSchema,
+	itemId: PositiveIntegerSchema
+});
 const RssFeedItemBaseSchema = Schema.Struct({
 	detected_date: Schema.String,
 	id: Schema.Int.check(Schema.isGreaterThan(0)),
@@ -3999,54 +4031,60 @@ const listRssFeeds = () => requestJson(RssFeedsEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/rss/list"
 }).pipe(selectJsonField("feeds"), withOperationErrors(ListRssFeedsErrorSpec));
-const getRssFeed = (id) => requestJson(RssFeedEnvelopeSchema, {
+const getRssFeed = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(RssFeedEnvelopeSchema, {
 	method: "GET",
-	path: `/v2/rss/${encodePathSegment(id)}`
-}).pipe(selectJsonField("feed"), withOperationErrors(GetRssFeedErrorSpec));
-const createRssFeed = (params) => requestJson(RssFeedEnvelopeSchema, {
+	path: `/v2/rss/${encodePathSegment(decodedId)}`
+})), selectJsonField("feed"), withOperationErrors(GetRssFeedErrorSpec));
+const createRssFeed = (params) => Schema.decodeUnknownEffect(RssFeedParamsSchema)(params).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedParams) => requestJson(RssFeedEnvelopeSchema, {
 	body: {
 		type: "form",
-		value: toCreateBody(params)
+		value: toCreateBody(decodedParams)
 	},
 	method: "POST",
 	path: "/v2/rss/create"
-}).pipe(selectJsonField("feed"), withOperationErrors(CreateRssFeedErrorSpec));
-const updateRssFeed = (id, params) => requestJson(OkResponseSchema, {
+})), selectJsonField("feed"), withOperationErrors(CreateRssFeedErrorSpec));
+const updateRssFeed = (id, params) => Schema.decodeUnknownEffect(RssFeedUpdateInputSchema)({
+	id,
+	params
+}).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(OkResponseSchema, {
 	body: {
 		type: "form",
-		value: toUpdateBody(params)
+		value: toUpdateBody(decodedInput.params)
 	},
 	method: "POST",
-	path: `/v2/rss/${encodePathSegment(id)}`
-}).pipe(withOperationErrors(UpdateRssFeedErrorSpec));
-const pauseRssFeed = (id) => requestJson(OkResponseSchema, {
+	path: `/v2/rss/${encodePathSegment(decodedInput.id)}`
+})), withOperationErrors(UpdateRssFeedErrorSpec));
+const pauseRssFeed = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/rss/${encodePathSegment(id)}/pause`
-}).pipe(withOperationErrors(PauseRssFeedErrorSpec));
-const resumeRssFeed = (id) => requestJson(OkResponseSchema, {
+	path: `/v2/rss/${encodePathSegment(decodedId)}/pause`
+})), withOperationErrors(PauseRssFeedErrorSpec));
+const resumeRssFeed = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/rss/${encodePathSegment(id)}/resume`
-}).pipe(withOperationErrors(ResumeRssFeedErrorSpec));
-const deleteRssFeed = (id) => requestJson(OkResponseSchema, {
+	path: `/v2/rss/${encodePathSegment(decodedId)}/resume`
+})), withOperationErrors(ResumeRssFeedErrorSpec));
+const deleteRssFeed = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/rss/${encodePathSegment(id)}/delete`
-}).pipe(withOperationErrors(DeleteRssFeedErrorSpec));
-const listRssFeedItems = (id) => requestJson(RssFeedItemsEnvelopeSchema, {
+	path: `/v2/rss/${encodePathSegment(decodedId)}/delete`
+})), withOperationErrors(DeleteRssFeedErrorSpec));
+const listRssFeedItems = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(RssFeedItemsEnvelopeSchema, {
 	method: "GET",
-	path: `/v2/rss/${encodePathSegment(id)}/items`
-}).pipe(selectJsonFields("feed", "items"), withOperationErrors(ListRssFeedItemsErrorSpec));
-const clearRssFeedLogs = (id) => requestJson(OkResponseSchema, {
+	path: `/v2/rss/${encodePathSegment(decodedId)}/items`
+})), selectJsonFields("feed", "items"), withOperationErrors(ListRssFeedItemsErrorSpec));
+const clearRssFeedLogs = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/rss/${encodePathSegment(id)}/clear-log`
-}).pipe(withOperationErrors(ClearRssFeedLogsErrorSpec));
-const retryRssFeedItem = (feedId, itemId) => requestJson(OkResponseSchema, {
+	path: `/v2/rss/${encodePathSegment(decodedId)}/clear-log`
+})), withOperationErrors(ClearRssFeedLogsErrorSpec));
+const retryRssFeedItem = (feedId, itemId) => Schema.decodeUnknownEffect(RssFeedItemRetryInputSchema)({
+	feedId,
+	itemId
+}).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/rss/${encodePathSegment(feedId)}/items/${encodePathSegment(itemId)}/retry`
-}).pipe(withOperationErrors(RetryRssFeedItemErrorSpec));
-const retryAllRssFeedItems = (feedId) => requestJson(OkResponseSchema, {
+	path: `/v2/rss/${encodePathSegment(decodedInput.feedId)}/items/${encodePathSegment(decodedInput.itemId)}/retry`
+})), withOperationErrors(RetryRssFeedItemErrorSpec));
+const retryAllRssFeedItems = (feedId) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(feedId).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedFeedId) => requestJson(OkResponseSchema, {
 	method: "POST",
-	path: `/v2/rss/${encodePathSegment(feedId)}/retry-all`
-}).pipe(withOperationErrors(RetryAllRssFeedItemsErrorSpec));
+	path: `/v2/rss/${encodePathSegment(decodedFeedId)}/retry-all`
+})), withOperationErrors(RetryAllRssFeedItemsErrorSpec));
 //#endregion
 //#region src/domains/sharing.ts
 const SharingCloneStatusSchema = Schema.Literals([
@@ -4056,10 +4094,10 @@ const SharingCloneStatusSchema = Schema.Literals([
 	"ERROR"
 ]);
 const SharingCloneInputSchema = Schema.Struct({
-	cursor: Schema.optional(Schema.String),
-	excludeIds: Schema.optional(Schema.Array(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))),
-	ids: Schema.optional(Schema.Array(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))),
-	parentId: Schema.optional(Schema.Int)
+	cursor: Schema.optional(NonEmptyStringSchema),
+	excludeIds: Schema.optional(Schema.Array(PositiveIntegerSchema)),
+	ids: Schema.optional(Schema.Array(PositiveIntegerSchema)),
+	parentId: Schema.optional(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))
 });
 const SharingCloneEnvelopeSchema = Schema.Struct({
 	id: Schema.Int.check(Schema.isGreaterThan(0)),
@@ -4079,11 +4117,11 @@ const SharingCloneInfoSchema = Schema.Union([Schema.Struct({
 })]);
 const SharedFileSchema = FileBroadSchema.pipe(Schema.fieldsAssign({ shared_with: Schema.Union([Schema.Literal("everyone"), Schema.Int.check(Schema.isGreaterThanOrEqualTo(0))]) }));
 const SharingShareInputSchema = Schema.Struct({
-	cursor: Schema.optional(Schema.String),
-	excludeIds: Schema.optional(Schema.Array(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))),
-	ids: Schema.optional(Schema.Array(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))),
+	cursor: Schema.optional(NonEmptyStringSchema),
+	excludeIds: Schema.optional(Schema.Array(PositiveIntegerSchema)),
+	ids: Schema.optional(Schema.Array(PositiveIntegerSchema)),
 	target: Schema.Union([Schema.Struct({ type: Schema.Literal("everyone") }), Schema.Struct({
-		friendNames: Schema.Array(Schema.String).check(Schema.isMinLength(1)),
+		friendNames: Schema.Array(NonEmptyStringSchema).check(Schema.isMinLength(1)),
 		type: Schema.Literal("friends")
 	})])
 });
@@ -4105,8 +4143,8 @@ const SharedFileSharedWithSchema = Schema.Union([Schema.Struct({
 	status: Schema.optional(Schema.Literal("OK"))
 })]);
 const SharingUnshareInputSchema = Schema.Struct({
-	fileId: Schema.Int.check(Schema.isGreaterThan(0)),
-	shares: Schema.optional(Schema.Array(Schema.Union([Schema.Int, Schema.String])))
+	fileId: PositiveIntegerSchema,
+	shares: Schema.optional(Schema.Array(Schema.Union([PositiveIntegerSchema, NonEmptyStringSchema])))
 });
 const PublicShareSchema = Schema.Struct({
 	created_at: Schema.String,
@@ -4156,7 +4194,7 @@ const PublicShareListQuerySchema = Schema.Struct({
 	hidden: Schema.optional(Schema.Literal(1)),
 	media_info_parent: Schema.optional(Schema.Literal(1)),
 	mp4_status_parent: Schema.optional(Schema.Literal(1)),
-	parent_id: Schema.optional(Schema.Int),
+	parent_id: Schema.optional(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0))),
 	per_page: Schema.optional(Schema.Int.check(Schema.isGreaterThan(0))),
 	sort: Schema.optional(Schema.String),
 	sort_by: Schema.optional(Schema.String),
@@ -4164,6 +4202,10 @@ const PublicShareListQuerySchema = Schema.Struct({
 	total: Schema.optional(Schema.Literal(1)),
 	video_metadata_parent: Schema.optional(Schema.Literal(1))
 });
+const PublicShareContinueInputSchema = Schema.Struct({
+	cursor: NonEmptyStringSchema,
+	query: Schema.Struct({ per_page: Schema.optional(Schema.Int.check(Schema.isGreaterThan(0))) })
+});
 const CreateSharingCloneErrorSpec = definePutioOperationErrorSpec({
 	domain: "sharing",
 	operation: "clone",
@@ -4357,90 +4399,86 @@ const GetPublicShareFileUrlErrorSpec = definePutioOperationErrorSpec({
 		{ statusCode: 404 }
 	]
 });
-const toShareTarget = (target) => {
-	if (target.type === "everyone") return Effect.succeed("everyone");
-	if (target.friendNames.length === 0) return Effect.fail(new PutioValidationError({ cause: "shareFiles target.friendNames must include at least one friend" }));
-	return Effect.succeed(target.friendNames.join(","));
-};
-const cloneSharedFiles = (input = {}) => requestJson(SharingCloneEnvelopeSchema, {
+const toShareTarget = (target) => target.type === "everyone" ? "everyone" : target.friendNames.join(",");
+const cloneSharedFiles = (input = {}) => Schema.decodeUnknownEffect(SharingCloneInputSchema)(input).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(SharingCloneEnvelopeSchema, {
 	body: {
 		type: "form",
 		value: {
-			...toCursorSelectionForm(input),
-			parent_id: input.parentId ?? 0
+			...toCursorSelectionForm(decodedInput),
+			parent_id: decodedInput.parentId ?? 0
 		}
 	},
 	method: "POST",
 	path: "/v2/sharing/clone"
-}).pipe(selectJsonFields("id"), withOperationErrors(CreateSharingCloneErrorSpec));
-const getSharingCloneInfo = (id) => requestJson(SharingCloneInfoSchema, {
+})), selectJsonFields("id"), withOperationErrors(CreateSharingCloneErrorSpec));
+const getSharingCloneInfo = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(SharingCloneInfoSchema, {
 	method: "GET",
-	path: `/v2/sharing/clone/${encodePathSegment(id)}`
-}).pipe(withOperationErrors(GetSharingCloneInfoErrorSpec));
-const shareFiles = (input) => Effect.gen(function* () {
-	const friends = yield* toShareTarget(input.target);
-	return yield* requestJson(OkResponseSchema, {
-		body: {
-			type: "form",
-			value: {
-				...toCursorSelectionForm(input),
-				friends
-			}
-		},
-		method: "POST",
-		path: "/v2/files/share"
-	});
-}).pipe(withOperationErrors(ShareFilesErrorSpec));
+	path: `/v2/sharing/clone/${encodePathSegment(decodedId)}`
+})), withOperationErrors(GetSharingCloneInfoErrorSpec));
+const shareFiles = (input) => Schema.decodeUnknownEffect(SharingShareInputSchema)(input).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(OkResponseSchema, {
+	body: {
+		type: "form",
+		value: {
+			...toCursorSelectionForm(decodedInput),
+			friends: toShareTarget(decodedInput.target)
+		}
+	},
+	method: "POST",
+	path: "/v2/files/share"
+})), withOperationErrors(ShareFilesErrorSpec));
 const listSharedFiles = () => requestJson(SharedFilesEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/files/shared"
 }).pipe(selectJsonField("shared"), withOperationErrors(ListSharedFilesErrorSpec));
-const getSharedWith = (fileId) => requestJson(SharedFileSharedWithSchema, {
+const getSharedWith = (fileId) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(fileId).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedFileId) => requestJson(SharedFileSharedWithSchema, {
 	method: "GET",
-	path: `/v2/files/${encodePathSegment(fileId)}/shared-with-v2`
-}).pipe(withOperationErrors(GetSharedWithErrorSpec));
-const unshareFile = (input) => requestJson(OkResponseSchema, {
+	path: `/v2/files/${encodePathSegment(decodedFileId)}/shared-with-v2`
+})), withOperationErrors(GetSharedWithErrorSpec));
+const unshareFile = (input) => Schema.decodeUnknownEffect(SharingUnshareInputSchema)(input).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(OkResponseSchema, {
 	body: {
 		type: "form",
-		value: { shares: joinCsv(input.shares) ?? "everyone" }
+		value: { shares: joinCsv(decodedInput.shares) ?? "everyone" }
 	},
 	method: "POST",
-	path: `/v2/files/${encodePathSegment(input.fileId)}/unshare`
-}).pipe(withOperationErrors(UnshareFileErrorSpec));
-const createPublicShare = (fileId) => requestJson(PublicShareEnvelopeSchema, {
+	path: `/v2/files/${encodePathSegment(decodedInput.fileId)}/unshare`
+})), withOperationErrors(UnshareFileErrorSpec));
+const createPublicShare = (fileId) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(fileId).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedFileId) => requestJson(PublicShareEnvelopeSchema, {
 	method: "POST",
-	path: `/v2/public_share/${encodePathSegment(fileId)}`
-}).pipe(selectJsonField("public_share"), withOperationErrors(CreatePublicShareErrorSpec));
+	path: `/v2/public_share/${encodePathSegment(decodedFileId)}`
+})), selectJsonField("public_share"), withOperationErrors(CreatePublicShareErrorSpec));
 const listPublicShares = () => requestJson(PublicSharesEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/public_share/list"
 }).pipe(selectJsonField("public_shares"), withOperationErrors(ListPublicSharesErrorSpec));
-const deletePublicShare = (id) => requestJson(OkResponseSchema, {
+const deletePublicShare = (id) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(id).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedId) => requestJson(OkResponseSchema, {
 	method: "DELETE",
-	path: `/v2/public_share/${encodePathSegment(id)}`
-}).pipe(withOperationErrors(DeletePublicShareErrorSpec));
+	path: `/v2/public_share/${encodePathSegment(decodedId)}`
+})), withOperationErrors(DeletePublicShareErrorSpec));
 const getPublicShare = () => requestJson(PublicShareEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/public_share"
 }).pipe(selectJsonField("public_share"), withOperationErrors(GetPublicShareErrorSpec));
-const listPublicShareFiles = (query = {}) => requestJson(PublicShareFileListEnvelopeSchema, {
+const listPublicShareFiles = (query = {}) => Schema.decodeUnknownEffect(PublicShareListQuerySchema)(query).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedQuery) => requestJson(PublicShareFileListEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/public_share/files/list",
+	query: decodedQuery
+})), withOperationErrors(ListPublicShareFilesErrorSpec));
+const continuePublicShareFiles = (cursor, query = {}) => Schema.decodeUnknownEffect(PublicShareContinueInputSchema)({
+	cursor,
 	query
-}).pipe(withOperationErrors(ListPublicShareFilesErrorSpec));
-const continuePublicShareFiles = (cursor, query = {}) => requestJson(PublicShareFileListContinueEnvelopeSchema, {
+}).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedInput) => requestJson(PublicShareFileListContinueEnvelopeSchema, {
 	body: {
 		type: "form",
-		value: { cursor }
+		value: { cursor: decodedInput.cursor }
 	},
 	method: "POST",
 	path: "/v2/public_share/files/list/continue",
-	query
-}).pipe(withOperationErrors(ContinuePublicShareFilesErrorSpec));
-const getPublicShareFileUrl = (fileId) => requestJson(PublicShareFileUrlEnvelopeSchema, {
+	query: decodedInput.query
+})), withOperationErrors(ContinuePublicShareFilesErrorSpec));
+const getPublicShareFileUrl = (fileId) => Schema.decodeUnknownEffect(PositiveIntegerSchema)(fileId).pipe(Effect.mapError(mapDecodeErrorToValidationError), Effect.flatMap((decodedFileId) => requestJson(PublicShareFileUrlEnvelopeSchema, {
 	method: "GET",
-	path: `/v2/public_share/files/${encodePathSegment(fileId)}/url`
-}).pipe(selectJsonField("url"), withOperationErrors(GetPublicShareFileUrlErrorSpec));
+	path: `/v2/public_share/files/${encodePathSegment(decodedFileId)}/url`
+})), selectJsonField("url"), withOperationErrors(GetPublicShareFileUrlErrorSpec));
 //#endregion
 //#region src/domains/trash.ts
 const TrashFileSchema = Schema.Struct({
@@ -4471,6 +4509,22 @@ const TrashContinueEnvelopeSchema = Schema.Struct({
 	files: Schema.Array(TrashFileSchema),
 	status: Schema.Literal("OK")
 });
+const TrashListQuerySchema = Schema.Struct({ per_page: Schema.optional(PositiveIntegerSchema) });
+const TrashCursorBulkInputSchema = Schema.Struct({
+	cursor: NonEmptyStringSchema,
+	file_ids: Schema.optional(Schema.Never),
+	useCursor: Schema.Literal(true)
+});
+const TrashIdsBulkInputSchema = Schema.Struct({
+	cursor: Schema.optional(Schema.Never),
+	file_ids: Schema.Array(PositiveIntegerSchema).check(Schema.isMinLength(1)),
+	useCursor: Schema.optional(Schema.Literal(false))
+});
+const TrashBulkInputSchema = Schema.Union([TrashCursorBulkInputSchema, TrashIdsBulkInputSchema]);
+const TrashContinueInputSchema = Schema.Struct({
+	cursor: NonEmptyStringSchema,
+	query: TrashListQuerySchema
+});
 const RestrictedReadError = {
 	errorType: "invalid_scope",
 	statusCode: 401
@@ -4540,46 +4594,48 @@ const EmptyTrashErrorSpec = definePutioOperationErrorSpec({
 	}, RestrictedWriteError]
 });
 const toBulkTrashBody = (input) => {
-	if (input.useCursor) return {
+	if (input.useCursor === true) return {
 		cursor: input.cursor,
 		file_ids: void 0
 	};
-	if (!input.file_ids) throw new Error("trash bulk file_ids are required when useCursor is not set");
 	return {
 		cursor: void 0,
 		file_ids: joinCsv(input.file_ids)
 	};
 };
-const listTrash = (query) => requestJson(TrashListEnvelopeSchema, {
+const listTrash = (query = {}) => decodeAndRun(TrashListQuerySchema, query, (decodedQuery) => requestJson(TrashListEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/trash/list",
+	query: decodedQuery
+})).pipe(withOperationErrors(ListTrashErrorSpec));
+const continueTrash = (cursor, query = {}) => decodeAndRun(TrashContinueInputSchema, {
+	cursor,
 	query
-}).pipe(withOperationErrors(ListTrashErrorSpec));
-const continueTrash = (cursor, query) => requestJson(TrashContinueEnvelopeSchema, {
+}, (decodedInput) => requestJson(TrashContinueEnvelopeSchema, {
 	body: {
 		type: "form",
-		value: { cursor }
+		value: { cursor: decodedInput.cursor }
 	},
 	method: "POST",
 	path: "/v2/trash/list/continue",
-	query
-}).pipe(withOperationErrors(ContinueTrashErrorSpec));
-const restoreTrash = (input) => requestJson(OkResponseSchema, {
+	query: decodedInput.query
+})).pipe(withOperationErrors(ContinueTrashErrorSpec));
+const restoreTrash = (input) => decodeAndRun(TrashBulkInputSchema, input, (decodedInput) => requestJson(OkResponseSchema, {
 	body: {
 		type: "form",
-		value: toBulkTrashBody(input)
+		value: toBulkTrashBody(decodedInput)
 	},
 	method: "POST",
 	path: "/v2/trash/restore"
-}).pipe(Effect.asVoid, withOperationErrors(RestoreTrashErrorSpec));
-const deleteTrash = (input) => requestJson(OkResponseSchema, {
+})).pipe(Effect.asVoid, withOperationErrors(RestoreTrashErrorSpec));
+const deleteTrash = (input) => decodeAndRun(TrashBulkInputSchema, input, (decodedInput) => requestJson(OkResponseSchema, {
 	body: {
 		type: "form",
-		value: toBulkTrashBody(input)
+		value: toBulkTrashBody(decodedInput)
 	},
 	method: "POST",
 	path: "/v2/trash/delete"
-}).pipe(Effect.asVoid, withOperationErrors(DeleteTrashErrorSpec));
+})).pipe(Effect.asVoid, withOperationErrors(DeleteTrashErrorSpec));
 const emptyTrash = () => requestJson(OkResponseSchema, {
 	method: "POST",
 	path: "/v2/trash/empty"
@@ -5086,6 +5142,7 @@ const ZipInfoSchema = Schema.Union([
 	ZipInfoErrorSchema,
 	ZipInfoDoneSchema
 ]);
+const CreateZipInputSchema = makeCursorSelectionSchema("file_ids", "exclude_ids");
 const FilesReadScopeError = {
 	errorType: "invalid_scope",
 	statusCode: 401
@@ -5147,26 +5204,26 @@ const listZips = () => requestJson(ZipsListEnvelopeSchema, {
 	method: "GET",
 	path: "/v2/zips/list"
 }).pipe(selectJsonField("zips"), withOperationErrors(ListZipsErrorSpec));
-const createZip = (input) => requestJson(ZipCreateEnvelopeSchema, {
+const createZip = (input) => decodeAndRun(CreateZipInputSchema, input, (decodedInput) => requestJson(ZipCreateEnvelopeSchema, {
 	body: {
 		type: "form",
 		value: { ...toCursorSelectionForm({
-			cursor: input.cursor,
-			excludeIds: input.exclude_ids,
-			ids: input.file_ids
+			cursor: decodedInput.cursor,
+			excludeIds: decodedInput.exclude_ids,
+			ids: decodedInput.file_ids
 		}) }
 	},
 	method: "POST",
 	path: "/v2/zips/create"
-}).pipe(selectJsonField("zip_id"), withOperationErrors(CreateZipErrorSpec));
-const getZip = (id) => requestJson(ZipInfoSchema, {
+})).pipe(selectJsonField("zip_id"), withOperationErrors(CreateZipErrorSpec));
+const getZip = (id) => decodeAndRun(PositiveIntegerSchema, id, (decodedId) => requestJson(ZipInfoSchema, {
 	method: "GET",
-	path: `/v2/zips/${encodePathSegment(id)}`
-}).pipe(withOperationErrors(GetZipErrorSpec));
-const cancelZip = (id) => requestJson(OkResponseSchema, {
+	path: `/v2/zips/${encodePathSegment(decodedId)}`
+})).pipe(withOperationErrors(GetZipErrorSpec));
+const cancelZip = (id) => decodeAndRun(PositiveIntegerSchema, id, (decodedId) => requestJson(OkResponseSchema, {
 	method: "GET",
-	path: `/v2/zips/${encodePathSegment(id)}/cancel`
-}).pipe(Effect.asVoid, withOperationErrors(CancelZipErrorSpec));
+	path: `/v2/zips/${encodePathSegment(decodedId)}/cancel`
+})).pipe(Effect.asVoid, withOperationErrors(CancelZipErrorSpec));
 //#endregion
 //#region src/core/client.ts
 const promiseClientRuntimeCache = /* @__PURE__ */ new WeakMap();