youtube-knowledge-mcp 2.1.0 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +153 -38
- package/dist/brain-schemas.d.ts +10 -10
- package/dist/brain-schemas.d.ts.map +1 -1
- package/dist/brain-schemas.js +0 -4
- package/dist/brain-schemas.js.map +1 -1
- package/dist/harvest-schemas.d.ts +75 -0
- package/dist/harvest-schemas.d.ts.map +1 -0
- package/dist/harvest-schemas.js +106 -0
- package/dist/harvest-schemas.js.map +1 -0
- package/dist/http/app.d.ts +16 -0
- package/dist/http/app.d.ts.map +1 -0
- package/dist/http/app.js +176 -0
- package/dist/http/app.js.map +1 -0
- package/dist/http/auth.d.ts +38 -0
- package/dist/http/auth.d.ts.map +1 -0
- package/dist/http/auth.js +79 -0
- package/dist/http/auth.js.map +1 -0
- package/dist/http/config.d.ts +41 -0
- package/dist/http/config.d.ts.map +1 -0
- package/dist/http/config.js +65 -0
- package/dist/http/config.js.map +1 -0
- package/dist/http/rate-limiter.d.ts +24 -0
- package/dist/http/rate-limiter.d.ts.map +1 -0
- package/dist/http/rate-limiter.js +55 -0
- package/dist/http/rate-limiter.js.map +1 -0
- package/dist/http/sessions.d.ts +34 -0
- package/dist/http/sessions.d.ts.map +1 -0
- package/dist/http/sessions.js +62 -0
- package/dist/http/sessions.js.map +1 -0
- package/dist/http.d.ts +6 -48
- package/dist/http.d.ts.map +1 -1
- package/dist/http.js +35 -252
- package/dist/http.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +11 -517
- package/dist/index.js.map +1 -1
- package/dist/prompts-brain.d.ts +4 -0
- package/dist/prompts-brain.d.ts.map +1 -0
- package/dist/prompts-brain.js +48 -0
- package/dist/prompts-brain.js.map +1 -0
- package/dist/prompts-research.d.ts +4 -0
- package/dist/prompts-research.d.ts.map +1 -0
- package/dist/prompts-research.js +74 -0
- package/dist/prompts-research.js.map +1 -0
- package/dist/prompts-shared.d.ts +13 -0
- package/dist/prompts-shared.d.ts.map +1 -0
- package/dist/prompts-shared.js +7 -0
- package/dist/prompts-shared.js.map +1 -0
- package/dist/prompts.d.ts.map +1 -1
- package/dist/prompts.js +5 -100
- package/dist/prompts.js.map +1 -1
- package/dist/registry/brain-tools.d.ts +4 -0
- package/dist/registry/brain-tools.d.ts.map +1 -0
- package/dist/registry/brain-tools.js +104 -0
- package/dist/registry/brain-tools.js.map +1 -0
- package/dist/registry/channel-tools.d.ts +4 -0
- package/dist/registry/channel-tools.d.ts.map +1 -0
- package/dist/registry/channel-tools.js +53 -0
- package/dist/registry/channel-tools.js.map +1 -0
- package/dist/registry/harvest-tools.d.ts +10 -0
- package/dist/registry/harvest-tools.d.ts.map +1 -0
- package/dist/registry/harvest-tools.js +109 -0
- package/dist/registry/harvest-tools.js.map +1 -0
- package/dist/registry/health-tools.d.ts +4 -0
- package/dist/registry/health-tools.d.ts.map +1 -0
- package/dist/registry/health-tools.js +39 -0
- package/dist/registry/health-tools.js.map +1 -0
- package/dist/registry/index.d.ts +8 -0
- package/dist/registry/index.d.ts.map +1 -0
- package/dist/registry/index.js +29 -0
- package/dist/registry/index.js.map +1 -0
- package/dist/registry/library-tools.d.ts +4 -0
- package/dist/registry/library-tools.d.ts.map +1 -0
- package/dist/registry/library-tools.js +116 -0
- package/dist/registry/library-tools.js.map +1 -0
- package/dist/registry/media-tools.d.ts +4 -0
- package/dist/registry/media-tools.d.ts.map +1 -0
- package/dist/registry/media-tools.js +100 -0
- package/dist/registry/media-tools.js.map +1 -0
- package/dist/registry/thumbnail-tools.d.ts +7 -0
- package/dist/registry/thumbnail-tools.d.ts.map +1 -0
- package/dist/registry/thumbnail-tools.js +72 -0
- package/dist/registry/thumbnail-tools.js.map +1 -0
- package/dist/registry/transcript-tools.d.ts +4 -0
- package/dist/registry/transcript-tools.d.ts.map +1 -0
- package/dist/registry/transcript-tools.js +68 -0
- package/dist/registry/transcript-tools.js.map +1 -0
- package/dist/registry/types.d.ts +41 -0
- package/dist/registry/types.d.ts.map +1 -0
- package/dist/registry/types.js +17 -0
- package/dist/registry/types.js.map +1 -0
- package/dist/registry/video-tools.d.ts +4 -0
- package/dist/registry/video-tools.d.ts.map +1 -0
- package/dist/registry/video-tools.js +101 -0
- package/dist/registry/video-tools.js.map +1 -0
- package/dist/resources.d.ts.map +1 -1
- package/dist/resources.js +13 -10
- package/dist/resources.js.map +1 -1
- package/dist/schemas.d.ts +250 -2
- package/dist/schemas.d.ts.map +1 -1
- package/dist/schemas.js +61 -0
- package/dist/schemas.js.map +1 -1
- package/dist/thumbnail-resource.d.ts +8 -0
- package/dist/thumbnail-resource.d.ts.map +1 -0
- package/dist/thumbnail-resource.js +38 -0
- package/dist/thumbnail-resource.js.map +1 -0
- package/dist/thumbnail-schemas.d.ts +512 -0
- package/dist/thumbnail-schemas.d.ts.map +1 -0
- package/dist/thumbnail-schemas.js +95 -0
- package/dist/thumbnail-schemas.js.map +1 -0
- package/dist/tools/ask-brain.js +1 -1
- package/dist/tools/ask-brain.js.map +1 -1
- package/dist/tools/batch.js +1 -1
- package/dist/tools/batch.js.map +1 -1
- package/dist/tools/brain-info.js +1 -1
- package/dist/tools/brain-info.js.map +1 -1
- package/dist/tools/build-brain.js +1 -1
- package/dist/tools/build-brain.js.map +1 -1
- package/dist/tools/check-health.d.ts +61 -0
- package/dist/tools/check-health.d.ts.map +1 -1
- package/dist/tools/check-health.js +94 -6
- package/dist/tools/check-health.js.map +1 -1
- package/dist/tools/clips.d.ts +9 -41
- package/dist/tools/clips.d.ts.map +1 -1
- package/dist/tools/clips.js +52 -128
- package/dist/tools/clips.js.map +1 -1
- package/dist/tools/fetch-channel-thumbnails.d.ts +179 -0
- package/dist/tools/fetch-channel-thumbnails.d.ts.map +1 -0
- package/dist/tools/fetch-channel-thumbnails.js +123 -0
- package/dist/tools/fetch-channel-thumbnails.js.map +1 -0
- package/dist/tools/fetch-videos.d.ts +18 -4
- package/dist/tools/fetch-videos.d.ts.map +1 -1
- package/dist/tools/fetch-videos.js +64 -20
- package/dist/tools/fetch-videos.js.map +1 -1
- package/dist/tools/frames-subtitles.d.ts +44 -0
- package/dist/tools/frames-subtitles.d.ts.map +1 -0
- package/dist/tools/frames-subtitles.js +104 -0
- package/dist/tools/frames-subtitles.js.map +1 -0
- package/dist/tools/get-channel-info.d.ts +2 -0
- package/dist/tools/get-channel-info.d.ts.map +1 -1
- package/dist/tools/get-channel-info.js +8 -1
- package/dist/tools/get-channel-info.js.map +1 -1
- package/dist/tools/get-comments.d.ts +238 -6
- package/dist/tools/get-comments.d.ts.map +1 -1
- package/dist/tools/get-comments.js +85 -21
- package/dist/tools/get-comments.js.map +1 -1
- package/dist/tools/get-coverage.d.ts +122 -0
- package/dist/tools/get-coverage.d.ts.map +1 -0
- package/dist/tools/get-coverage.js +105 -0
- package/dist/tools/get-coverage.js.map +1 -0
- package/dist/tools/get-playlist-info.d.ts.map +1 -1
- package/dist/tools/get-playlist-info.js +1 -0
- package/dist/tools/get-playlist-info.js.map +1 -1
- package/dist/tools/get-thumbnail.d.ts +38 -0
- package/dist/tools/get-thumbnail.d.ts.map +1 -0
- package/dist/tools/get-thumbnail.js +152 -0
- package/dist/tools/get-thumbnail.js.map +1 -0
- package/dist/tools/get-transcript.d.ts.map +1 -1
- package/dist/tools/get-transcript.js +2 -14
- package/dist/tools/get-transcript.js.map +1 -1
- package/dist/tools/harvest-channel.d.ts +92 -0
- package/dist/tools/harvest-channel.d.ts.map +1 -0
- package/dist/tools/harvest-channel.js +62 -0
- package/dist/tools/harvest-channel.js.map +1 -0
- package/dist/tools/harvest-comments.d.ts +81 -0
- package/dist/tools/harvest-comments.d.ts.map +1 -0
- package/dist/tools/harvest-comments.js +115 -0
- package/dist/tools/harvest-comments.js.map +1 -0
- package/dist/tools/library.d.ts.map +1 -1
- package/dist/tools/library.js +14 -4
- package/dist/tools/library.js.map +1 -1
- package/dist/tools/list-channel-thumbnails.d.ts +235 -0
- package/dist/tools/list-channel-thumbnails.d.ts.map +1 -0
- package/dist/tools/list-channel-thumbnails.js +79 -0
- package/dist/tools/list-channel-thumbnails.js.map +1 -0
- package/dist/tools/list-library.js +1 -1
- package/dist/tools/list-library.js.map +1 -1
- package/dist/tools/prune-harvest.d.ts +59 -0
- package/dist/tools/prune-harvest.d.ts.map +1 -0
- package/dist/tools/prune-harvest.js +108 -0
- package/dist/tools/prune-harvest.js.map +1 -0
- package/dist/tools/query-comments.d.ts +125 -0
- package/dist/tools/query-comments.d.ts.map +1 -0
- package/dist/tools/query-comments.js +106 -0
- package/dist/tools/query-comments.js.map +1 -0
- package/dist/tools/query-videos.d.ts +118 -0
- package/dist/tools/query-videos.d.ts.map +1 -0
- package/dist/tools/query-videos.js +97 -0
- package/dist/tools/query-videos.js.map +1 -0
- package/dist/tools/repair-store.d.ts +34 -0
- package/dist/tools/repair-store.d.ts.map +1 -0
- package/dist/tools/repair-store.js +58 -0
- package/dist/tools/repair-store.js.map +1 -0
- package/dist/tools/save-to-library.d.ts.map +1 -1
- package/dist/tools/save-to-library.js +5 -1
- package/dist/tools/save-to-library.js.map +1 -1
- package/dist/tools/search-channels.d.ts +6 -0
- package/dist/tools/search-channels.d.ts.map +1 -1
- package/dist/tools/search-channels.js +5 -1
- package/dist/tools/search-channels.js.map +1 -1
- package/dist/tools/search-transcript.d.ts.map +1 -1
- package/dist/tools/search-transcript.js +6 -13
- package/dist/tools/search-transcript.js.map +1 -1
- package/dist/tools/search-videos.d.ts +3 -0
- package/dist/tools/search-videos.d.ts.map +1 -1
- package/dist/tools/search-videos.js +1 -1
- package/dist/tools/search-videos.js.map +1 -1
- package/dist/utils/batches.d.ts +15 -0
- package/dist/utils/batches.d.ts.map +1 -0
- package/dist/utils/batches.js +31 -0
- package/dist/utils/batches.js.map +1 -0
- package/dist/utils/brain-build.d.ts.map +1 -1
- package/dist/utils/brain-build.js +1 -12
- package/dist/utils/brain-build.js.map +1 -1
- package/dist/utils/brain-index.d.ts.map +1 -1
- package/dist/utils/brain-index.js +3 -2
- package/dist/utils/brain-index.js.map +1 -1
- package/dist/utils/brain-lock.d.ts +2 -18
- package/dist/utils/brain-lock.d.ts.map +1 -1
- package/dist/utils/brain-lock.js +4 -80
- package/dist/utils/brain-lock.js.map +1 -1
- package/dist/utils/brain-lookup.d.ts +8 -0
- package/dist/utils/brain-lookup.d.ts.map +1 -1
- package/dist/utils/brain-lookup.js +5 -31
- package/dist/utils/brain-lookup.js.map +1 -1
- package/dist/utils/brain-storage.d.ts.map +1 -1
- package/dist/utils/brain-storage.js +5 -5
- package/dist/utils/brain-storage.js.map +1 -1
- package/dist/utils/caption-probe.d.ts +7 -0
- package/dist/utils/caption-probe.d.ts.map +1 -0
- package/dist/utils/caption-probe.js +36 -0
- package/dist/utils/caption-probe.js.map +1 -0
- package/dist/utils/channel-images.d.ts +16 -0
- package/dist/utils/channel-images.d.ts.map +1 -0
- package/dist/utils/channel-images.js +35 -0
- package/dist/utils/channel-images.js.map +1 -0
- package/dist/utils/channel-lookup.d.ts +5 -0
- package/dist/utils/channel-lookup.d.ts.map +1 -0
- package/dist/utils/channel-lookup.js +37 -0
- package/dist/utils/channel-lookup.js.map +1 -0
- package/dist/utils/chapters.d.ts +11 -0
- package/dist/utils/chapters.d.ts.map +1 -0
- package/dist/utils/chapters.js +24 -0
- package/dist/utils/chapters.js.map +1 -0
- package/dist/utils/clips.d.ts.map +1 -1
- package/dist/utils/clips.js +18 -26
- package/dist/utils/clips.js.map +1 -1
- package/dist/utils/comment-store.d.ts +71 -0
- package/dist/utils/comment-store.d.ts.map +1 -0
- package/dist/utils/comment-store.js +129 -0
- package/dist/utils/comment-store.js.map +1 -0
- package/dist/utils/comment-threads.d.ts +51 -0
- package/dist/utils/comment-threads.d.ts.map +1 -0
- package/dist/utils/comment-threads.js +76 -0
- package/dist/utils/comment-threads.js.map +1 -0
- package/dist/utils/coverage-text.d.ts +3 -0
- package/dist/utils/coverage-text.d.ts.map +1 -0
- package/dist/utils/coverage-text.js +62 -0
- package/dist/utils/coverage-text.js.map +1 -0
- package/dist/utils/coverage.d.ts +57 -0
- package/dist/utils/coverage.d.ts.map +1 -0
- package/dist/utils/coverage.js +142 -0
- package/dist/utils/coverage.js.map +1 -0
- package/dist/utils/env.d.ts +26 -0
- package/dist/utils/env.d.ts.map +1 -0
- package/dist/utils/env.js +72 -0
- package/dist/utils/env.js.map +1 -0
- package/dist/utils/errors.d.ts +1 -1
- package/dist/utils/errors.d.ts.map +1 -1
- package/dist/utils/errors.js +28 -2
- package/dist/utils/errors.js.map +1 -1
- package/dist/utils/file-lock.d.ts +34 -0
- package/dist/utils/file-lock.d.ts.map +1 -0
- package/dist/utils/file-lock.js +91 -0
- package/dist/utils/file-lock.js.map +1 -0
- package/dist/utils/flat-listing.d.ts +89 -0
- package/dist/utils/flat-listing.d.ts.map +1 -0
- package/dist/utils/flat-listing.js +68 -0
- package/dist/utils/flat-listing.js.map +1 -0
- package/dist/utils/format.d.ts +18 -4
- package/dist/utils/format.d.ts.map +1 -1
- package/dist/utils/format.js +2 -6
- package/dist/utils/format.js.map +1 -1
- package/dist/utils/guard.d.ts +21 -0
- package/dist/utils/guard.d.ts.map +1 -0
- package/dist/utils/guard.js +105 -0
- package/dist/utils/guard.js.map +1 -0
- package/dist/utils/harvest-catalog.d.ts +44 -0
- package/dist/utils/harvest-catalog.d.ts.map +1 -0
- package/dist/utils/harvest-catalog.js +164 -0
- package/dist/utils/harvest-catalog.js.map +1 -0
- package/dist/utils/harvest-lock.d.ts +3 -0
- package/dist/utils/harvest-lock.d.ts.map +1 -0
- package/dist/utils/harvest-lock.js +26 -0
- package/dist/utils/harvest-lock.js.map +1 -0
- package/dist/utils/harvest-receipts.d.ts +14 -0
- package/dist/utils/harvest-receipts.d.ts.map +1 -0
- package/dist/utils/harvest-receipts.js +110 -0
- package/dist/utils/harvest-receipts.js.map +1 -0
- package/dist/utils/image-dimensions.d.ts +19 -0
- package/dist/utils/image-dimensions.d.ts.map +1 -0
- package/dist/utils/image-dimensions.js +93 -0
- package/dist/utils/image-dimensions.js.map +1 -0
- package/dist/utils/image-fetch.d.ts +31 -0
- package/dist/utils/image-fetch.d.ts.map +1 -0
- package/dist/utils/image-fetch.js +141 -0
- package/dist/utils/image-fetch.js.map +1 -0
- package/dist/utils/json-file.d.ts +14 -5
- package/dist/utils/json-file.d.ts.map +1 -1
- package/dist/utils/json-file.js +24 -9
- package/dist/utils/json-file.js.map +1 -1
- package/dist/utils/listing-cursor.d.ts +31 -0
- package/dist/utils/listing-cursor.d.ts.map +1 -0
- package/dist/utils/listing-cursor.js +39 -0
- package/dist/utils/listing-cursor.js.map +1 -0
- package/dist/utils/paths.d.ts +10 -0
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +14 -0
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/pattern.d.ts +30 -0
- package/dist/utils/pattern.d.ts.map +1 -0
- package/dist/utils/pattern.js +130 -0
- package/dist/utils/pattern.js.map +1 -0
- package/dist/utils/pot-preflight.d.ts +53 -0
- package/dist/utils/pot-preflight.d.ts.map +1 -0
- package/dist/utils/pot-preflight.js +146 -0
- package/dist/utils/pot-preflight.js.map +1 -0
- package/dist/utils/search-index.d.ts.map +1 -1
- package/dist/utils/search-index.js +9 -4
- package/dist/utils/search-index.js.map +1 -1
- package/dist/utils/sleep.d.ts +9 -0
- package/dist/utils/sleep.d.ts.map +1 -0
- package/dist/utils/sleep.js +25 -0
- package/dist/utils/sleep.js.map +1 -0
- package/dist/utils/storage.d.ts.map +1 -1
- package/dist/utils/storage.js +14 -8
- package/dist/utils/storage.js.map +1 -1
- package/dist/utils/store-health.d.ts +37 -0
- package/dist/utils/store-health.d.ts.map +1 -0
- package/dist/utils/store-health.js +92 -0
- package/dist/utils/store-health.js.map +1 -0
- package/dist/utils/store-migrations.d.ts +33 -0
- package/dist/utils/store-migrations.d.ts.map +1 -0
- package/dist/utils/store-migrations.js +41 -0
- package/dist/utils/store-migrations.js.map +1 -0
- package/dist/utils/store-paths.d.ts +33 -0
- package/dist/utils/store-paths.d.ts.map +1 -0
- package/dist/utils/store-paths.js +48 -0
- package/dist/utils/store-paths.js.map +1 -0
- package/dist/utils/store-rows.d.ts +22 -0
- package/dist/utils/store-rows.d.ts.map +1 -0
- package/dist/utils/store-rows.js +62 -0
- package/dist/utils/store-rows.js.map +1 -0
- package/dist/utils/store-schema.d.ts +16 -0
- package/dist/utils/store-schema.d.ts.map +1 -0
- package/dist/utils/store-schema.js +168 -0
- package/dist/utils/store-schema.js.map +1 -0
- package/dist/utils/store.d.ts +34 -0
- package/dist/utils/store.d.ts.map +1 -0
- package/dist/utils/store.js +157 -0
- package/dist/utils/store.js.map +1 -0
- package/dist/utils/subtitles.d.ts +7 -0
- package/dist/utils/subtitles.d.ts.map +1 -0
- package/dist/utils/subtitles.js +30 -0
- package/dist/utils/subtitles.js.map +1 -0
- package/dist/utils/thumbnail-entry.d.ts +19 -0
- package/dist/utils/thumbnail-entry.d.ts.map +1 -0
- package/dist/utils/thumbnail-entry.js +119 -0
- package/dist/utils/thumbnail-entry.js.map +1 -0
- package/dist/utils/thumbnail-fetch.d.ts +37 -0
- package/dist/utils/thumbnail-fetch.d.ts.map +1 -0
- package/dist/utils/thumbnail-fetch.js +89 -0
- package/dist/utils/thumbnail-fetch.js.map +1 -0
- package/dist/utils/thumbnail-ladder.d.ts +44 -0
- package/dist/utils/thumbnail-ladder.d.ts.map +1 -0
- package/dist/utils/thumbnail-ladder.js +68 -0
- package/dist/utils/thumbnail-ladder.js.map +1 -0
- package/dist/utils/thumbnail-listing.d.ts +16 -0
- package/dist/utils/thumbnail-listing.d.ts.map +1 -0
- package/dist/utils/thumbnail-listing.js +26 -0
- package/dist/utils/thumbnail-listing.js.map +1 -0
- package/dist/utils/thumbnail-paths.d.ts +20 -0
- package/dist/utils/thumbnail-paths.d.ts.map +1 -0
- package/dist/utils/thumbnail-paths.js +35 -0
- package/dist/utils/thumbnail-paths.js.map +1 -0
- package/dist/utils/thumbnail-store.d.ts +19 -0
- package/dist/utils/thumbnail-store.d.ts.map +1 -0
- package/dist/utils/thumbnail-store.js +125 -0
- package/dist/utils/thumbnail-store.js.map +1 -0
- package/dist/utils/transcript-cache.d.ts +20 -0
- package/dist/utils/transcript-cache.d.ts.map +1 -0
- package/dist/utils/transcript-cache.js +127 -0
- package/dist/utils/transcript-cache.js.map +1 -0
- package/dist/utils/transcript-search.d.ts +20 -0
- package/dist/utils/transcript-search.d.ts.map +1 -0
- package/dist/utils/transcript-search.js +35 -0
- package/dist/utils/transcript-search.js.map +1 -0
- package/dist/utils/transcript.d.ts +10 -31
- package/dist/utils/transcript.d.ts.map +1 -1
- package/dist/utils/transcript.js +2 -64
- package/dist/utils/transcript.js.map +1 -1
- package/dist/utils/validate-youtube.d.ts +35 -0
- package/dist/utils/validate-youtube.d.ts.map +1 -0
- package/dist/utils/validate-youtube.js +87 -0
- package/dist/utils/validate-youtube.js.map +1 -0
- package/dist/utils/validate.d.ts +11 -4
- package/dist/utils/validate.d.ts.map +1 -1
- package/dist/utils/validate.js +43 -36
- package/dist/utils/validate.js.map +1 -1
- package/dist/utils/version.d.ts +2 -0
- package/dist/utils/version.d.ts.map +1 -0
- package/dist/utils/version.js +19 -0
- package/dist/utils/version.js.map +1 -0
- package/dist/utils/video-stats-cache.d.ts +16 -0
- package/dist/utils/video-stats-cache.d.ts.map +1 -0
- package/dist/utils/video-stats-cache.js +81 -0
- package/dist/utils/video-stats-cache.js.map +1 -0
- package/dist/utils/video-stats.d.ts +186 -0
- package/dist/utils/video-stats.d.ts.map +1 -0
- package/dist/utils/video-stats.js +168 -0
- package/dist/utils/video-stats.js.map +1 -0
- package/dist/utils/video-store.d.ts +69 -0
- package/dist/utils/video-store.d.ts.map +1 -0
- package/dist/utils/video-store.js +77 -0
- package/dist/utils/video-store.js.map +1 -0
- package/dist/utils/youtube-channel.d.ts +51 -0
- package/dist/utils/youtube-channel.d.ts.map +1 -0
- package/dist/utils/youtube-channel.js +91 -0
- package/dist/utils/youtube-channel.js.map +1 -0
- package/dist/utils/youtube-download.d.ts +27 -0
- package/dist/utils/youtube-download.d.ts.map +1 -0
- package/dist/utils/youtube-download.js +118 -0
- package/dist/utils/youtube-download.js.map +1 -0
- package/dist/utils/youtube-schemas.d.ts +492 -0
- package/dist/utils/youtube-schemas.d.ts.map +1 -0
- package/dist/utils/youtube-schemas.js +148 -0
- package/dist/utils/youtube-schemas.js.map +1 -0
- package/dist/utils/youtube-search.d.ts +14 -0
- package/dist/utils/youtube-search.d.ts.map +1 -0
- package/dist/utils/youtube-search.js +39 -0
- package/dist/utils/youtube-search.js.map +1 -0
- package/dist/utils/youtube-url.d.ts +25 -0
- package/dist/utils/youtube-url.d.ts.map +1 -0
- package/dist/utils/youtube-url.js +75 -0
- package/dist/utils/youtube-url.js.map +1 -0
- package/dist/utils/youtube-video.d.ts +68 -0
- package/dist/utils/youtube-video.d.ts.map +1 -0
- package/dist/utils/youtube-video.js +110 -0
- package/dist/utils/youtube-video.js.map +1 -0
- package/dist/utils/youtube.d.ts +10 -122
- package/dist/utils/youtube.d.ts.map +1 -1
- package/dist/utils/youtube.js +11 -486
- package/dist/utils/youtube.js.map +1 -1
- package/dist/utils/ytdlp-env.d.ts +33 -0
- package/dist/utils/ytdlp-env.d.ts.map +1 -0
- package/dist/utils/ytdlp-env.js +121 -0
- package/dist/utils/ytdlp-env.js.map +1 -0
- package/dist/utils/ytdlp-limiter.d.ts +27 -0
- package/dist/utils/ytdlp-limiter.d.ts.map +1 -0
- package/dist/utils/ytdlp-limiter.js +85 -0
- package/dist/utils/ytdlp-limiter.js.map +1 -0
- package/dist/utils/ytdlp-pacer.d.ts +64 -0
- package/dist/utils/ytdlp-pacer.d.ts.map +1 -0
- package/dist/utils/ytdlp-pacer.js +165 -0
- package/dist/utils/ytdlp-pacer.js.map +1 -0
- package/dist/utils/ytdlp-parse.d.ts +13 -0
- package/dist/utils/ytdlp-parse.d.ts.map +1 -0
- package/dist/utils/ytdlp-parse.js +48 -0
- package/dist/utils/ytdlp-parse.js.map +1 -0
- package/dist/utils/ytdlp-stream.d.ts +32 -0
- package/dist/utils/ytdlp-stream.d.ts.map +1 -0
- package/dist/utils/ytdlp-stream.js +61 -0
- package/dist/utils/ytdlp-stream.js.map +1 -0
- package/dist/utils/ytdlp.d.ts +23 -18
- package/dist/utils/ytdlp.d.ts.map +1 -1
- package/dist/utils/ytdlp.js +56 -134
- package/dist/utils/ytdlp.js.map +1 -1
- package/package.json +3 -2
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import type { DatabaseSync } from 'node:sqlite';
|
|
2
|
+
import { z } from 'zod';
|
|
3
|
+
/**
|
|
4
|
+
* Reading the catalogued videos back.
|
|
5
|
+
*
|
|
6
|
+
* `upload_date` is NULL, never '', for a video only ever seen in a flat
|
|
7
|
+
* listing — flat entries carry no publication date. A date filter therefore
|
|
8
|
+
* excludes those rows rather than silently treating them as ancient.
|
|
9
|
+
*/
|
|
10
|
+
declare const videoRowSchema: z.ZodObject<{
|
|
11
|
+
video_id: z.ZodString;
|
|
12
|
+
channel_id: z.ZodNullable<z.ZodString>;
|
|
13
|
+
title: z.ZodString;
|
|
14
|
+
duration_s: z.ZodNullable<z.ZodNumber>;
|
|
15
|
+
upload_date: z.ZodNullable<z.ZodString>;
|
|
16
|
+
view_count: z.ZodNullable<z.ZodNumber>;
|
|
17
|
+
comment_count: z.ZodNullable<z.ZodNumber>;
|
|
18
|
+
live_status: z.ZodNullable<z.ZodString>;
|
|
19
|
+
thumbnail_url: z.ZodNullable<z.ZodString>;
|
|
20
|
+
tab: z.ZodNullable<z.ZodString>;
|
|
21
|
+
also_in_tabs: z.ZodString;
|
|
22
|
+
detail_at: z.ZodNullable<z.ZodNumber>;
|
|
23
|
+
stored_comments: z.ZodNumber;
|
|
24
|
+
}, "strip", z.ZodTypeAny, {
|
|
25
|
+
title: string;
|
|
26
|
+
upload_date: string | null;
|
|
27
|
+
view_count: number | null;
|
|
28
|
+
comment_count: number | null;
|
|
29
|
+
live_status: string | null;
|
|
30
|
+
channel_id: string | null;
|
|
31
|
+
tab: string | null;
|
|
32
|
+
video_id: string;
|
|
33
|
+
duration_s: number | null;
|
|
34
|
+
thumbnail_url: string | null;
|
|
35
|
+
also_in_tabs: string;
|
|
36
|
+
detail_at: number | null;
|
|
37
|
+
stored_comments: number;
|
|
38
|
+
}, {
|
|
39
|
+
title: string;
|
|
40
|
+
upload_date: string | null;
|
|
41
|
+
view_count: number | null;
|
|
42
|
+
comment_count: number | null;
|
|
43
|
+
live_status: string | null;
|
|
44
|
+
channel_id: string | null;
|
|
45
|
+
tab: string | null;
|
|
46
|
+
video_id: string;
|
|
47
|
+
duration_s: number | null;
|
|
48
|
+
thumbnail_url: string | null;
|
|
49
|
+
also_in_tabs: string;
|
|
50
|
+
detail_at: number | null;
|
|
51
|
+
stored_comments: number;
|
|
52
|
+
}>;
|
|
53
|
+
export type StoredVideo = z.infer<typeof videoRowSchema>;
|
|
54
|
+
export interface VideoQuery {
|
|
55
|
+
channelId?: string;
|
|
56
|
+
match?: string;
|
|
57
|
+
since?: string;
|
|
58
|
+
until?: string;
|
|
59
|
+
minDurationSeconds?: number;
|
|
60
|
+
detailedOnly?: boolean;
|
|
61
|
+
withComments?: boolean;
|
|
62
|
+
order?: 'newest' | 'oldest' | 'views' | 'comments' | 'catalog';
|
|
63
|
+
limit?: number;
|
|
64
|
+
offset?: number;
|
|
65
|
+
}
|
|
66
|
+
export declare function queryVideos(database: DatabaseSync, query: VideoQuery): StoredVideo[];
|
|
67
|
+
export declare function countVideos(database: DatabaseSync, query: VideoQuery): number;
|
|
68
|
+
export {};
|
|
69
|
+
//# sourceMappingURL=video-store.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"video-store.d.ts","sourceRoot":"","sources":["../../src/utils/video-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AAEH,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAclB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiDD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE,CAYpF;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAQ7E"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { queryRows } from './store-rows.js';
|
|
3
|
+
/**
|
|
4
|
+
* Reading the catalogued videos back.
|
|
5
|
+
*
|
|
6
|
+
* `upload_date` is NULL, never '', for a video only ever seen in a flat
|
|
7
|
+
* listing — flat entries carry no publication date. A date filter therefore
|
|
8
|
+
* excludes those rows rather than silently treating them as ancient.
|
|
9
|
+
*/
|
|
10
|
+
const videoRowSchema = z.object({
|
|
11
|
+
video_id: z.string(),
|
|
12
|
+
channel_id: z.string().nullable(),
|
|
13
|
+
title: z.string(),
|
|
14
|
+
duration_s: z.number().nullable(),
|
|
15
|
+
upload_date: z.string().nullable(),
|
|
16
|
+
view_count: z.number().nullable(),
|
|
17
|
+
comment_count: z.number().nullable(),
|
|
18
|
+
live_status: z.string().nullable(),
|
|
19
|
+
thumbnail_url: z.string().nullable(),
|
|
20
|
+
tab: z.string().nullable(),
|
|
21
|
+
also_in_tabs: z.string(),
|
|
22
|
+
detail_at: z.number().nullable(),
|
|
23
|
+
stored_comments: z.number(),
|
|
24
|
+
});
|
|
25
|
+
function buildWhere(query) {
|
|
26
|
+
const clauses = [];
|
|
27
|
+
const params = [];
|
|
28
|
+
if (query.channelId !== undefined) {
|
|
29
|
+
clauses.push('v.channel_id = ?');
|
|
30
|
+
params.push(query.channelId);
|
|
31
|
+
}
|
|
32
|
+
if (query.match !== undefined && query.match !== '') {
|
|
33
|
+
clauses.push('lower(v.title) LIKE ?');
|
|
34
|
+
params.push(`%${query.match.toLowerCase()}%`);
|
|
35
|
+
}
|
|
36
|
+
if (query.since !== undefined) {
|
|
37
|
+
clauses.push('v.upload_date IS NOT NULL AND v.upload_date >= ?');
|
|
38
|
+
params.push(query.since.replace(/-/g, ''));
|
|
39
|
+
}
|
|
40
|
+
if (query.until !== undefined) {
|
|
41
|
+
clauses.push('v.upload_date IS NOT NULL AND v.upload_date <= ?');
|
|
42
|
+
params.push(query.until.replace(/-/g, ''));
|
|
43
|
+
}
|
|
44
|
+
if (query.minDurationSeconds !== undefined && query.minDurationSeconds > 0) {
|
|
45
|
+
clauses.push('v.duration_s >= ?');
|
|
46
|
+
params.push(query.minDurationSeconds);
|
|
47
|
+
}
|
|
48
|
+
if (query.detailedOnly === true)
|
|
49
|
+
clauses.push('v.detail_at IS NOT NULL');
|
|
50
|
+
if (query.withComments === true) {
|
|
51
|
+
clauses.push('EXISTS (SELECT 1 FROM comment c WHERE c.video_id = v.video_id)');
|
|
52
|
+
}
|
|
53
|
+
return { sql: clauses.length === 0 ? '' : ` WHERE ${clauses.join(' AND ')}`, params };
|
|
54
|
+
}
|
|
55
|
+
const ORDER = {
|
|
56
|
+
// NULLS LAST so an un-dated video sorts as unknown rather than oldest.
|
|
57
|
+
newest: 'v.upload_date DESC NULLS LAST, v.video_id',
|
|
58
|
+
oldest: 'v.upload_date ASC NULLS LAST, v.video_id',
|
|
59
|
+
views: 'v.view_count DESC NULLS LAST, v.video_id',
|
|
60
|
+
comments: 'stored_comments DESC, v.video_id',
|
|
61
|
+
catalog: 'v.catalog_rank ASC NULLS LAST, v.video_id',
|
|
62
|
+
};
|
|
63
|
+
const SELECT = `
|
|
64
|
+
SELECT v.video_id, v.channel_id, v.title, v.duration_s, v.upload_date, v.view_count,
|
|
65
|
+
v.comment_count, v.live_status, v.thumbnail_url, v.tab, v.also_in_tabs, v.detail_at,
|
|
66
|
+
(SELECT COUNT(*) FROM comment c WHERE c.video_id = v.video_id) AS stored_comments
|
|
67
|
+
FROM video v`;
|
|
68
|
+
export function queryVideos(database, query) {
|
|
69
|
+
const where = buildWhere(query);
|
|
70
|
+
return queryRows(database.prepare(`${SELECT}${where.sql} ORDER BY ${ORDER[query.order ?? 'newest']} LIMIT ? OFFSET ?`), videoRowSchema, ...where.params, query.limit ?? 25, query.offset ?? 0);
|
|
71
|
+
}
|
|
72
|
+
export function countVideos(database, query) {
|
|
73
|
+
const where = buildWhere(query);
|
|
74
|
+
const rows = queryRows(database.prepare(`SELECT COUNT(*) AS n FROM video v${where.sql}`), z.object({ n: z.number() }), ...where.params);
|
|
75
|
+
return rows[0]?.n ?? 0;
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=video-store.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"video-store.js","sourceRoot":"","sources":["../../src/utils/video-store.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { type ListedImage } from './flat-listing.js';
|
|
2
|
+
export interface VideoListItem {
|
|
3
|
+
id: string;
|
|
4
|
+
title: string;
|
|
5
|
+
duration: number;
|
|
6
|
+
durationFormatted: string;
|
|
7
|
+
/** Empty for a flat listing, which carries no publication date. */
|
|
8
|
+
uploadDate: string;
|
|
9
|
+
url: string;
|
|
10
|
+
/** The largest thumbnail the listing offered. */
|
|
11
|
+
thumbnailUrl?: string;
|
|
12
|
+
/** Every thumbnail the listing offered, with sizes where known. */
|
|
13
|
+
thumbnails?: ListedImage[];
|
|
14
|
+
viewCount?: number;
|
|
15
|
+
liveStatus?: string;
|
|
16
|
+
}
|
|
17
|
+
export interface ChannelInfo {
|
|
18
|
+
name: string;
|
|
19
|
+
channelId: string;
|
|
20
|
+
handle: string;
|
|
21
|
+
subscriberCount: number;
|
|
22
|
+
channelUrl: string;
|
|
23
|
+
description: string;
|
|
24
|
+
/** The channel's uncropped avatar, when yt-dlp listed one. */
|
|
25
|
+
avatarUrl?: string;
|
|
26
|
+
/** The channel's uncropped banner, when yt-dlp listed one. */
|
|
27
|
+
bannerUrl?: string;
|
|
28
|
+
}
|
|
29
|
+
export interface PlaylistInfo {
|
|
30
|
+
id: string;
|
|
31
|
+
title: string;
|
|
32
|
+
channel: string;
|
|
33
|
+
handle: string;
|
|
34
|
+
channelUrl: string;
|
|
35
|
+
videoCount: number;
|
|
36
|
+
lastModified: string;
|
|
37
|
+
url: string;
|
|
38
|
+
description: string;
|
|
39
|
+
}
|
|
40
|
+
export declare function listVideos(urlOrChannel: string, limit?: number, start?: number): Promise<VideoListItem[]>;
|
|
41
|
+
/**
|
|
42
|
+
* How many videos a listing says it has, when it says anything.
|
|
43
|
+
*
|
|
44
|
+
* `playlist_count` is populated for playlists and routinely null for channel
|
|
45
|
+
* tabs, so this returns undefined rather than a guess. One extra cheap call —
|
|
46
|
+
* the same `--playlist-items 0` metadata read getPlaylistInfo already does.
|
|
47
|
+
*/
|
|
48
|
+
export declare function playlistTotal(urlOrChannel: string): Promise<number | undefined>;
|
|
49
|
+
export declare function getPlaylistInfo(playlistUrl: string): Promise<PlaylistInfo>;
|
|
50
|
+
export declare function getChannelInfo(channel: string): Promise<ChannelInfo>;
|
|
51
|
+
//# sourceMappingURL=youtube-channel.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"youtube-channel.d.ts","sourceRoot":"","sources":["../../src/utils/youtube-channel.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAS3B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,KAAK,SAAK,EACV,KAAK,SAAI,GACR,OAAO,CAAC,aAAa,EAAE,CAAC,CAsB1B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiBrF;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAwBhF;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwB1E"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { formatYouTubeDate } from './format.js';
|
|
3
|
+
import { TIMEOUTS, parseYtDlpJson, parseYtDlpJsonLines, runYtDlp } from './ytdlp.js';
|
|
4
|
+
import { FLAT_PRINT_TEMPLATE, flatEntrySchema, toVideoListItem, } from './flat-listing.js';
|
|
5
|
+
import { selectChannelImages } from './channel-images.js';
|
|
6
|
+
import { channelMetaSchema, playlistMetaSchema } from './youtube-schemas.js';
|
|
7
|
+
import { channelUrlFor, resolveListTarget } from './youtube-url.js';
|
|
8
|
+
/** Listings and metadata for channels and playlists. */
|
|
9
|
+
const playlistCountSchema = z.object({ playlist_count: z.number().nullish() });
|
|
10
|
+
export async function listVideos(urlOrChannel, limit = 20, start = 1) {
|
|
11
|
+
const stdout = await runYtDlp([
|
|
12
|
+
'--skip-download',
|
|
13
|
+
'--flat-playlist',
|
|
14
|
+
'--lazy-playlist',
|
|
15
|
+
'--print',
|
|
16
|
+
FLAT_PRINT_TEMPLATE,
|
|
17
|
+
// `-I start:end` rather than --playlist-end so a later page can begin
|
|
18
|
+
// where the previous one stopped. YouTube still walks from the top to
|
|
19
|
+
// reach `start`, which is why the caller caches instead of paging deep.
|
|
20
|
+
'--playlist-items',
|
|
21
|
+
`${String(start)}:${String(start + limit - 1)}`,
|
|
22
|
+
], {
|
|
23
|
+
label: 'fetch_videos',
|
|
24
|
+
timeoutMs: TIMEOUTS.transcript,
|
|
25
|
+
target: resolveListTarget(urlOrChannel),
|
|
26
|
+
});
|
|
27
|
+
return parseYtDlpJsonLines(stdout, flatEntrySchema).map(toVideoListItem);
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* How many videos a listing says it has, when it says anything.
|
|
31
|
+
*
|
|
32
|
+
* `playlist_count` is populated for playlists and routinely null for channel
|
|
33
|
+
* tabs, so this returns undefined rather than a guess. One extra cheap call —
|
|
34
|
+
* the same `--playlist-items 0` metadata read getPlaylistInfo already does.
|
|
35
|
+
*/
|
|
36
|
+
export async function playlistTotal(urlOrChannel) {
|
|
37
|
+
try {
|
|
38
|
+
const stdout = await runYtDlp(['--dump-single-json', '--flat-playlist', '--playlist-items', '0'], {
|
|
39
|
+
label: 'fetch_videos:count',
|
|
40
|
+
timeoutMs: TIMEOUTS.metadata,
|
|
41
|
+
target: resolveListTarget(urlOrChannel),
|
|
42
|
+
});
|
|
43
|
+
const parsed = parseYtDlpJson(stdout, playlistCountSchema, 'a playlist count');
|
|
44
|
+
return parsed.playlist_count ?? undefined;
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
// A total is a nicety; failing to get one must not fail the page. Its
|
|
48
|
+
// absence is already meaningful — "unknown", which is the truth here.
|
|
49
|
+
return undefined;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
export async function getPlaylistInfo(playlistUrl) {
|
|
53
|
+
const target = resolveListTarget(playlistUrl);
|
|
54
|
+
const stdout = await runYtDlp(['--dump-single-json', '--flat-playlist', '--playlist-items', '0'], {
|
|
55
|
+
label: 'get_playlist_info',
|
|
56
|
+
target,
|
|
57
|
+
});
|
|
58
|
+
const data = parseYtDlpJson(stdout, playlistMetaSchema, 'playlist metadata');
|
|
59
|
+
const modDate = data.modified_date ?? '';
|
|
60
|
+
return {
|
|
61
|
+
id: data.id ?? '',
|
|
62
|
+
title: data.title ?? 'Unknown',
|
|
63
|
+
channel: data.channel ?? '',
|
|
64
|
+
handle: data.uploader_id ?? '',
|
|
65
|
+
channelUrl: data.channel_url ?? '',
|
|
66
|
+
videoCount: data.playlist_count ?? 0,
|
|
67
|
+
lastModified: formatYouTubeDate(modDate),
|
|
68
|
+
url: data.webpage_url ?? playlistUrl,
|
|
69
|
+
description: data.description ?? '',
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
export async function getChannelInfo(channel) {
|
|
73
|
+
const channelUrl = channelUrlFor(channel);
|
|
74
|
+
const stdout = await runYtDlp(['--dump-single-json', '--flat-playlist', '--playlist-items', '0'], {
|
|
75
|
+
label: 'get_channel_info',
|
|
76
|
+
target: channelUrl,
|
|
77
|
+
});
|
|
78
|
+
const data = parseYtDlpJson(stdout, channelMetaSchema, 'channel metadata');
|
|
79
|
+
return {
|
|
80
|
+
name: data.channel ?? 'Unknown',
|
|
81
|
+
channelId: data.channel_id ?? '',
|
|
82
|
+
handle: data.uploader_id ?? '',
|
|
83
|
+
subscriberCount: data.channel_follower_count ?? 0,
|
|
84
|
+
channelUrl: data.channel_url ?? channelUrl,
|
|
85
|
+
description: data.description ?? '',
|
|
86
|
+
// The same listing carries the avatar and banner; they were discarded here
|
|
87
|
+
// for two releases.
|
|
88
|
+
...selectChannelImages(data.thumbnails),
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
//# sourceMappingURL=youtube-channel.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"youtube-channel.js","sourceRoot":"","sources":["../../src/utils/youtube-channel.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
export interface VideoFormat {
|
|
2
|
+
formatId: string;
|
|
3
|
+
ext: string;
|
|
4
|
+
resolution: string;
|
|
5
|
+
fps?: number;
|
|
6
|
+
vcodec: string;
|
|
7
|
+
acodec: string;
|
|
8
|
+
filesize?: number;
|
|
9
|
+
note: string;
|
|
10
|
+
}
|
|
11
|
+
export interface DownloadResult {
|
|
12
|
+
videoId: string;
|
|
13
|
+
title: string;
|
|
14
|
+
filePath: string;
|
|
15
|
+
format: string;
|
|
16
|
+
}
|
|
17
|
+
export declare function listFormats(urlOrId: string): Promise<VideoFormat[]>;
|
|
18
|
+
export type VideoQuality = 'best' | '2160p' | '1440p' | '1080p' | '720p' | '480p' | '360p' | 'audio';
|
|
19
|
+
export declare const QUALITY_FORMAT_SELECTORS: Record<VideoQuality, string>;
|
|
20
|
+
export declare function downloadVideo(urlOrId: string, formatId: string, outputDir?: string, quality?: VideoQuality): Promise<DownloadResult>;
|
|
21
|
+
/** The after_move print: the last JSON line yt-dlp wrote, with the path it wrote to. */
|
|
22
|
+
export declare const AFTER_MOVE_TEMPLATE = "after_move:%(.{title,filepath})j";
|
|
23
|
+
export declare function readAfterMove(stdout: string): {
|
|
24
|
+
title: string | undefined;
|
|
25
|
+
filepath: string;
|
|
26
|
+
};
|
|
27
|
+
//# sourceMappingURL=youtube-download.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"youtube-download.d.ts","sourceRoot":"","sources":["../../src/utils/youtube-download.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAyBzE;AAED,MAAM,MAAM,YAAY,GACtB,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAG5E,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAejE,CAAC;AAEF,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC,CA+DzB;AAED,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,qCAAqC,CAAC;AAEtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa7F"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
import { join } from 'path';
|
|
2
|
+
import { mkdir } from 'fs/promises';
|
|
3
|
+
import { TIMEOUTS, parseYtDlpJson, runYtDlp } from './ytdlp.js';
|
|
4
|
+
import { YouTubeError } from './errors.js';
|
|
5
|
+
import { afterMoveRowSchema, formatsRowSchema } from './youtube-schemas.js';
|
|
6
|
+
import { resolveOutputDir } from './validate.js';
|
|
7
|
+
import { log } from './context.js';
|
|
8
|
+
import { dataDir } from './paths.js';
|
|
9
|
+
import { extractVideoId, watchUrl } from './youtube-url.js';
|
|
10
|
+
/** Format listing and whole-video downloads. */
|
|
11
|
+
const DOWNLOADS_DIR = dataDir('downloads');
|
|
12
|
+
export async function listFormats(urlOrId) {
|
|
13
|
+
const videoId = extractVideoId(urlOrId);
|
|
14
|
+
const url = watchUrl(videoId);
|
|
15
|
+
const stdout = await runYtDlp(['-j', '--skip-download'], { label: 'list_formats', target: url });
|
|
16
|
+
const data = parseYtDlpJson(stdout, formatsRowSchema, 'video formats');
|
|
17
|
+
const formats = data.formats ?? [];
|
|
18
|
+
return formats
|
|
19
|
+
.filter((f) => !f.format_id.startsWith('sb')) // skip storyboards
|
|
20
|
+
.map((f) => {
|
|
21
|
+
const resolution = f.resolution ?? (f.width && f.height ? `${f.width}x${f.height}` : 'audio only');
|
|
22
|
+
return {
|
|
23
|
+
formatId: f.format_id,
|
|
24
|
+
ext: f.ext,
|
|
25
|
+
resolution,
|
|
26
|
+
fps: f.fps ?? undefined,
|
|
27
|
+
vcodec: f.vcodec ?? 'none',
|
|
28
|
+
acodec: f.acodec ?? 'none',
|
|
29
|
+
filesize: f.filesize ?? f.filesize_approx ?? undefined,
|
|
30
|
+
note: f.format_note ?? '',
|
|
31
|
+
};
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
// Smart format selectors that use yt-dlp's fallback syntax
|
|
35
|
+
export const QUALITY_FORMAT_SELECTORS = {
|
|
36
|
+
best: 'bestvideo*+bestaudio/best',
|
|
37
|
+
'2160p': 'bestvideo[height<=2160]+bestaudio/bestvideo*[height<=2160]+bestaudio/best[height<=2160]/bestvideo+bestaudio/best',
|
|
38
|
+
'1440p': 'bestvideo[height<=1440]+bestaudio/bestvideo*[height<=1440]+bestaudio/best[height<=1440]/bestvideo+bestaudio/best',
|
|
39
|
+
'1080p': 'bestvideo[height<=1080]+bestaudio/bestvideo*[height<=1080]+bestaudio/best[height<=1080]/bestvideo+bestaudio/best',
|
|
40
|
+
'720p': 'bestvideo[height<=720]+bestaudio/bestvideo*[height<=720]+bestaudio/best[height<=720]/bestvideo+bestaudio/best',
|
|
41
|
+
'480p': 'bestvideo[height<=480]+bestaudio/bestvideo*[height<=480]+bestaudio/best[height<=480]/bestvideo+bestaudio/best',
|
|
42
|
+
'360p': 'bestvideo[height<=360]+bestaudio/bestvideo*[height<=360]+bestaudio/best[height<=360]/bestvideo+bestaudio/best',
|
|
43
|
+
audio: 'bestaudio/best',
|
|
44
|
+
};
|
|
45
|
+
export async function downloadVideo(urlOrId, formatId, outputDir, quality) {
|
|
46
|
+
const videoId = extractVideoId(urlOrId);
|
|
47
|
+
const url = watchUrl(videoId);
|
|
48
|
+
const targetDir = resolveOutputDir(outputDir, DOWNLOADS_DIR);
|
|
49
|
+
// Ensure download directory exists
|
|
50
|
+
await mkdir(targetDir, { recursive: true });
|
|
51
|
+
// Download with specified format
|
|
52
|
+
const outputTemplate = join(targetDir, '%(title)s.%(ext)s');
|
|
53
|
+
// A quality preset always wins over formatId; that is what the tool schema
|
|
54
|
+
// promises, and the two are resolved in exactly one place.
|
|
55
|
+
const formatSelector = quality ? QUALITY_FORMAT_SELECTORS[quality] : formatId;
|
|
56
|
+
// -S vcodec:h264,acodec:m4a prefers H.264+AAC, which merge cleanly into MP4.
|
|
57
|
+
// The after_move print reports the title and the final path from the same
|
|
58
|
+
// run, once the merge has produced the file, so nothing is spawned twice.
|
|
59
|
+
const commonArgs = (selector) => [
|
|
60
|
+
'-f',
|
|
61
|
+
selector,
|
|
62
|
+
'-S',
|
|
63
|
+
'vcodec:h264,acodec:m4a',
|
|
64
|
+
'-o',
|
|
65
|
+
outputTemplate,
|
|
66
|
+
'--no-playlist',
|
|
67
|
+
'--merge-output-format',
|
|
68
|
+
'mp4',
|
|
69
|
+
'--print',
|
|
70
|
+
AFTER_MOVE_TEMPLATE,
|
|
71
|
+
];
|
|
72
|
+
// Transfers are not retried automatically: a partial file on disk plus a
|
|
73
|
+
// silent second attempt is worse than one clear failure.
|
|
74
|
+
const downloadOptions = {
|
|
75
|
+
label: 'download_video',
|
|
76
|
+
timeoutMs: TIMEOUTS.download,
|
|
77
|
+
retry: false,
|
|
78
|
+
target: url,
|
|
79
|
+
};
|
|
80
|
+
let stdout;
|
|
81
|
+
try {
|
|
82
|
+
stdout = await runYtDlp(commonArgs(formatSelector), downloadOptions);
|
|
83
|
+
}
|
|
84
|
+
catch (error) {
|
|
85
|
+
// An explicitly requested format may simply not exist for this video, so
|
|
86
|
+
// falling back to "best" is worth one attempt. A preset failing is not:
|
|
87
|
+
// presets already encode their own fallback chain, and "best" failing
|
|
88
|
+
// leaves nothing to fall back to.
|
|
89
|
+
const alreadyBroadest = quality !== undefined || formatId === 'best';
|
|
90
|
+
if (alreadyBroadest)
|
|
91
|
+
throw error;
|
|
92
|
+
log('warning', `format ${formatId} unavailable, falling back to best`);
|
|
93
|
+
stdout = await runYtDlp(commonArgs(QUALITY_FORMAT_SELECTORS.best), downloadOptions);
|
|
94
|
+
}
|
|
95
|
+
const moved = readAfterMove(stdout);
|
|
96
|
+
return {
|
|
97
|
+
videoId,
|
|
98
|
+
title: moved.title ?? '',
|
|
99
|
+
filePath: moved.filepath,
|
|
100
|
+
format: quality ?? formatId,
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
/** The after_move print: the last JSON line yt-dlp wrote, with the path it wrote to. */
|
|
104
|
+
export const AFTER_MOVE_TEMPLATE = 'after_move:%(.{title,filepath})j';
|
|
105
|
+
export function readAfterMove(stdout) {
|
|
106
|
+
const line = stdout.trim().split('\n').filter(Boolean).at(-1) ?? '';
|
|
107
|
+
const row = line === '' ? { title: undefined, filepath: undefined } : parseAfterMove(line);
|
|
108
|
+
if (typeof row.filepath !== 'string' || row.filepath === '') {
|
|
109
|
+
throw new YouTubeError('YTDLP_FAILED', 'yt-dlp finished without reporting where it wrote the file.', {
|
|
110
|
+
nextStep: 'Run `yt-dlp -U`; older versions do not print the after_move stage.',
|
|
111
|
+
});
|
|
112
|
+
}
|
|
113
|
+
return { title: row.title ?? undefined, filepath: row.filepath };
|
|
114
|
+
}
|
|
115
|
+
function parseAfterMove(line) {
|
|
116
|
+
return parseYtDlpJson(line, afterMoveRowSchema, 'download result');
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=youtube-download.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"youtube-download.js","sourceRoot":"","sources":["../../src/utils/youtube-download.ts"],"names":[],"mappings":"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"}
|