feat: prepare server 1.7.0

build.gradle.kts

@@ -25,8 +25,9 @@ repositories {
 }
 
 dependencies {
-    implementation(platform("com.fasterxml.jackson:jackson-bom:2.22.1"))
-    implementation(platform("io.netty:netty-bom:4.2.16.Final"))
+    implementation(platform("com.fasterxml.jackson:jackson-bom:2.22.2"))
+    implementation("com.fasterxml.jackson.core:jackson-core")
+    implementation(platform("io.netty:netty-bom:4.2.17.Final"))
     constraints {
         implementation("org.jsoup:jsoup:1.23.1") {
             because("CVE-2026-71497 affects PipePipeExtractor's transitive jsoup version")
@@ -42,12 +43,12 @@ dependencies {
     implementation("io.ktor:ktor-server-status-pages-jvm")
     implementation("io.ktor:ktor-server-call-logging-jvm")
     implementation("io.ktor:ktor-server-rate-limit-jvm")
-    implementation("ch.qos.logback:logback-classic:1.6.1")
+    implementation("ch.qos.logback:logback-classic:1.6.3")
     implementation("com.github.Priveetee.PipePipeExtractor:extractor:f156813dd4bbebf3b4dffe541fee6c27ae1dd294")
     compileOnly("com.github.TeamNewPipe:nanojson:1d9e1aea9049fc9f85e68b43ba39fe7be1c1f751")
-    implementation("org.json:json:20260719")
-    implementation("com.squareup.okhttp3:okhttp:5.4.0")
-    implementation("io.lettuce:lettuce-core:7.6.0.RELEASE")
+    implementation("org.json:json:20260814")
+    implementation("com.squareup.okhttp3:okhttp:5.5.0")
+    implementation("io.lettuce:lettuce-core:7.7.0.RELEASE")
     implementation("org.jetbrains.exposed:exposed-core:1.4.0")
     implementation("org.jetbrains.exposed:exposed-jdbc:1.4.0")
     implementation("com.zaxxer:HikariCP:7.1.0")

gradle.properties

@@ -1,5 +1,5 @@
 org.gradle.jvmargs=-Xmx2g -XX:+UseG1GC
 kotlin.code.style=official
-appVersion=1.6.0
+appVersion=1.7.0
 systemProp.sun.net.client.defaultReadTimeout=180000
 systemProp.sun.net.client.defaultConnectTimeout=60000

openapi.yaml

@@ -17,6 +17,7 @@ tags:
   - name: youtube-session
   - name: user-data
   - name: rss
+  - name: portability
 paths:
   /health: { $ref: ./openapi/paths/health.yaml#/Health }
   /instance: { $ref: ./openapi/paths/metadata.yaml#/Instance }
@@ -44,6 +45,7 @@ paths:
   /saved-playlists: { $ref: ./openapi/paths/saved-playlists.yaml#/SavedPlaylists }
   /saved-playlists/{id}: { $ref: ./openapi/paths/saved-playlists.yaml#/SavedPlaylist }
   /subscriptions: { $ref: ./openapi/paths/subscriptions.yaml#/Subscriptions }
+  /subscriptions/group-memberships: { $ref: ./openapi/paths/subscriptions.yaml#/SubscriptionGroupMemberships }
   /subscriptions/groups: { $ref: ./openapi/paths/subscriptions.yaml#/SubscriptionGroups }
   /subscriptions/groups/{groupId}: { $ref: ./openapi/paths/subscriptions.yaml#/SubscriptionGroup }
   /subscriptions/groups/{groupId}/channels: { $ref: ./openapi/paths/subscriptions.yaml#/SubscriptionGroupChannels }
@@ -56,6 +58,14 @@ paths:
   /settings: { $ref: ./openapi/paths/access-control.yaml#/Settings }
   /backup/typetype: { $ref: ./openapi/paths/user-backup.yaml#/TypeTypeBackup }
   /restore/typetype: { $ref: ./openapi/paths/user-backup.yaml#/TypeTypeRestore }
+  /portability/formats: { $ref: ./openapi/paths/portability.yaml#/PortabilityFormats }
+  /portability/imports: { $ref: ./openapi/paths/portability.yaml#/PortabilityImports }
+  /portability/exports: { $ref: ./openapi/paths/portability.yaml#/PortabilityExports }
+  /portability/jobs/{id}: { $ref: ./openapi/paths/portability.yaml#/PortabilityJob }
+  /portability/jobs/{id}/apply: { $ref: ./openapi/paths/portability.yaml#/PortabilityApply }
+  /portability/jobs/{id}/cancel: { $ref: ./openapi/paths/portability.yaml#/PortabilityCancel }
+  /portability/jobs/{id}/report: { $ref: ./openapi/paths/portability.yaml#/PortabilityReport }
+  /portability/jobs/{id}/artifact: { $ref: ./openapi/paths/portability.yaml#/PortabilityArtifact }
   /blocked/keywords: { $ref: ./openapi/paths/user-backup.yaml#/BlockedKeywords }
   /blocked/keywords/{keyword}: { $ref: ./openapi/paths/user-backup.yaml#/BlockedKeyword }
   /allowed/channels: { $ref: ./openapi/paths/access-control.yaml#/AllowedChannels }
@@ -151,9 +161,11 @@ components:
     SavedPlaylistItem: { $ref: ./openapi/components/media.yaml#/SavedPlaylistItem }
     SavedPlaylistRequest: { $ref: ./openapi/components/media.yaml#/SavedPlaylistRequest }
     SubscriptionItem: { $ref: ./openapi/components/subscriptions.yaml#/SubscriptionItem }
+    SubscriptionGroupMembershipItem: { $ref: ./openapi/components/subscriptions.yaml#/SubscriptionGroupMembershipItem }
     SubscriptionGroupItem: { $ref: ./openapi/components/subscriptions.yaml#/SubscriptionGroupItem }
     SubscriptionGroupRequest: { $ref: ./openapi/components/subscriptions.yaml#/SubscriptionGroupRequest }
     SubscriptionGroupMembershipRequest: { $ref: ./openapi/components/subscriptions.yaml#/SubscriptionGroupMembershipRequest }
+    SubscriptionGroupMembershipBatchRequest: { $ref: ./openapi/components/subscriptions.yaml#/SubscriptionGroupMembershipBatchRequest }
     SubscriptionFeedResponse: { $ref: ./openapi/components/subscriptions.yaml#/SubscriptionFeedResponse }
     SubscriptionFeedPreparingResponse: { $ref: ./openapi/components/subscriptions.yaml#/SubscriptionFeedPreparingResponse }
     RssFeedRequest: { $ref: ./openapi/components/rss.yaml#/RssFeedRequest }
@@ -163,6 +175,11 @@ components:
     SettingsItem: { $ref: ./openapi/components/access-control.yaml#/SettingsItem }
     TypeTypeBackupItem: { $ref: ./openapi/components/user-backup.yaml#/TypeTypeBackupItem }
     TypeTypeRestoreSummary: { $ref: ./openapi/components/user-backup.yaml#/TypeTypeRestoreSummary }
+    PortabilityAdapterDescriptor: { $ref: ./openapi/components/portability.yaml#/PortabilityAdapterDescriptor }
+    PortabilityJobSnapshot: { $ref: ./openapi/components/portability.yaml#/PortabilityJobSnapshot }
+    PortabilityJobReport: { $ref: ./openapi/components/portability.yaml#/PortabilityJobReport }
+    PortabilityImportRequest: { $ref: ./openapi/components/portability.yaml#/PortabilityImportRequest }
+    PortabilityExportRequest: { $ref: ./openapi/components/portability.yaml#/PortabilityExportRequest }
     BlockedKeywordItem: { $ref: ./openapi/components/user-backup.yaml#/BlockedKeywordItem }
     AdminSettingsItem: { $ref: ./openapi/components/access-control.yaml#/AdminSettingsItem }
     AllowedChannelItem: { $ref: ./openapi/components/access-control.yaml#/AllowedChannelItem }

openapi/components/instance.yaml

@@ -20,6 +20,7 @@ InstanceResponse:
     - oidcAutoRedirect
     - youtubeRemoteLoginEnabled
     - youtubeRemoteLoginReady
+    - parentalControlsEnabled
     - rss
   properties:
     name: { type: string, example: TypeType }
@@ -50,6 +51,9 @@ InstanceResponse:
       type: string
       nullable: true
       enum: [disabled, not_configured, token_unreachable]
+    parentalControlsEnabled:
+      type: boolean
+      description: True when the instance-wide allow-list policy is enabled.
     rss:
       $ref: '#/RssInstanceCapability'
 RssInstanceCapability:

openapi/components/portability.yaml

@@ -0,0 +1,125 @@
+PortabilityFormat:
+  type: string
+  enum: [typetype, pipepipe, newpipe, invidious, piped, libretube, viewtube, materialious, youtube-local, flow, skytube, grayjay, youtube-takeout, opml]
+PortabilityCategory:
+  type: string
+  enum: [subscriptions, subscriptionGroups, history, playlists, watchLater, favorites, progress, searchHistory, savedPlaylists, settings, contentFilters]
+PortabilityCapability:
+  type: object
+  required: [category, directions, fidelity]
+  properties:
+    category: { $ref: '#/PortabilityCategory' }
+    directions:
+      type: array
+      uniqueItems: true
+      items: { type: string, enum: [import, export] }
+    fidelity: { type: string, enum: [complete, partial] }
+PortabilityAdapterDescriptor:
+  type: object
+  required: [format, adapterVersion, capabilities, defaultExtension, contentType]
+  properties:
+    format: { $ref: '#/PortabilityFormat' }
+    adapterVersion: { type: integer, minimum: 1 }
+    capabilities:
+      type: array
+      uniqueItems: true
+      items: { $ref: '#/PortabilityCapability' }
+    defaultExtension: { type: string }
+    contentType: { type: string }
+PortabilityIssue:
+  type: object
+  required: [category, code, message, count]
+  properties:
+    category:
+      allOf: [{ $ref: '#/PortabilityCategory' }]
+      nullable: true
+    code: { type: string }
+    message: { type: string }
+    count: { type: integer, format: int64, minimum: 1 }
+PortabilityDetection:
+  type: object
+  required: [format, formatVersion, adapterVersion, confidence, evidence]
+  properties:
+    format: { $ref: '#/PortabilityFormat' }
+    formatVersion: { type: string, nullable: true }
+    adapterVersion: { type: integer, minimum: 1 }
+    confidence: { type: integer, minimum: 1, maximum: 100 }
+    evidence: { type: string }
+PortabilityPreview:
+  type: object
+  required: [detection, counts, duplicates, issues]
+  properties:
+    detection: { $ref: '#/PortabilityDetection' }
+    counts:
+      type: object
+      additionalProperties: { type: integer, format: int64, minimum: 0 }
+    duplicates: { type: integer, format: int64, minimum: 0 }
+    issues:
+      type: array
+      items: { $ref: '#/PortabilityIssue' }
+PortabilityJobSnapshot:
+  type: object
+  required: [id, kind, state, createdAt, updatedAt]
+  properties:
+    id: { type: string, format: uuid }
+    kind: { type: string, enum: [import, export] }
+    state: { type: string, enum: [queued, analyzing, ready, applying, encoding, completed, failed, cancelled] }
+    createdAt: { type: integer, format: int64 }
+    updatedAt: { type: integer, format: int64 }
+    requestId: { type: string, nullable: true }
+    preview:
+      allOf: [{ $ref: '#/PortabilityPreview' }]
+      nullable: true
+    result:
+      type: object
+      nullable: true
+      additionalProperties: { type: integer, format: int64, minimum: 0 }
+    progress:
+      allOf: [{ $ref: '#/PortabilityJobProgress' }]
+      nullable: true
+    errorCode: { type: string, nullable: true }
+    errorMessage: { type: string, nullable: true }
+PortabilityJobProgress:
+  type: object
+  required: [phase, unit, processed, total]
+  properties:
+    phase: { type: string, enum: [analyzing, collecting, applying, encoding] }
+    unit: { type: string, enum: [records, categories, bytes] }
+    processed: { type: integer, format: int64, minimum: 0 }
+    total: { type: integer, format: int64, minimum: 0, nullable: true }
+PortabilityJobReport:
+  type: object
+  required: [id, state]
+  properties:
+    id: { type: string, format: uuid }
+    state: { type: string, enum: [queued, analyzing, ready, applying, encoding, completed, failed, cancelled] }
+    requestId: { type: string, nullable: true }
+    preview:
+      allOf: [{ $ref: '#/PortabilityPreview' }]
+      nullable: true
+    result:
+      type: object
+      nullable: true
+      additionalProperties: { type: integer, format: int64, minimum: 0 }
+    errorCode: { type: string, nullable: true }
+    errorMessage: { type: string, nullable: true }
+PortabilityImportRequest:
+  type: object
+  required: [categories]
+  properties:
+    categories:
+      type: array
+      minItems: 1
+      uniqueItems: true
+      items: { $ref: '#/PortabilityCategory' }
+    duplicatePolicy: { type: string, enum: [skip, replace], default: skip }
+PortabilityExportRequest:
+  type: object
+  required: [format, categories]
+  properties:
+    format: { $ref: '#/PortabilityFormat' }
+    categories:
+      type: array
+      minItems: 1
+      uniqueItems: true
+      items: { $ref: '#/PortabilityCategory' }

openapi/components/subscriptions.yaml

@@ -6,6 +6,18 @@ SubscriptionItem:
     name: { type: string }
     avatarUrl: { type: string }
     subscribedAt: { type: integer, format: int64 }
+SubscriptionGroupMembershipItem:
+  type: object
+  required: [channelUrl, name, avatarUrl, subscribedAt, groupIds]
+  properties:
+    channelUrl: { type: string, minLength: 1 }
+    name: { type: string }
+    avatarUrl: { type: string }
+    subscribedAt: { type: integer, format: int64 }
+    groupIds:
+      type: array
+      uniqueItems: true
+      items: { type: string, format: uuid }
 SubscriptionCreateRequest:
   type: object
   required: [channelUrl, name, avatarUrl]
@@ -31,7 +43,16 @@ SubscriptionGroupMembershipRequest:
   type: object
   required: [channelUrl]
   properties:
-    channelUrl: { type: string, minLength: 1 }
+    channelUrl: { type: string, minLength: 1, maxLength: 2048 }
+SubscriptionGroupMembershipBatchRequest:
+  type: object
+  required: [channelUrls]
+  properties:
+    channelUrls:
+      type: array
+      minItems: 1
+      maxItems: 500
+      items: { type: string, minLength: 1, maxLength: 2048 }
 SubscriptionFeedResponse:
   type: object
   required: [videos, nextpage, generation, generatedAt, refreshing]

openapi/paths/downloader.yaml

@@ -89,6 +89,16 @@ JobArtifact:
       '200': { description: Artifact bytes. }
       '206': { description: Partial artifact bytes. }
       '302': { description: Redirect to public artifact storage. }
+      '416': { description: Requested byte range is outside the artifact. }
+      '404': { $ref: ../components/common.yaml#/JsonError }
+  head:
+    tags: [downloader]
+    summary: Inspect a completed artifact without transferring its body
+    responses:
+      '200': { description: Artifact metadata. }
+      '206': { description: Partial artifact metadata. }
+      '302': { description: Redirect to public artifact storage. }
+      '416': { description: Requested byte range is outside the artifact. }
       '404': { $ref: ../components/common.yaml#/JsonError }
 JobCancel:
   parameters: