pixivflow 3.4.3 → 3.6.0

package/dist/config/loader.js

@@ -18,6 +18,7 @@ const path_resolution_1 = require("./path-resolution");
 const environment_1 = require("./environment");
 const placeholders_1 = require("./placeholders");
 const validation_1 = require("./validation");
+const MediaAsset_1 = require("../domain/media/MediaAsset");
 /**
  * Get the resolved configuration file path
  * If no path is specified, automatically selects the first available config file
@@ -128,6 +129,9 @@ function loadConfig(configPath, skipValidation = false, resolveDynamicPlaceholde
     // Apply defaults - use config file directory as base path to ensure paths are resolved correctly
     // This prevents the app from accidentally using paths from the development machine
     const config = (0, path_resolution_1.applyDefaults)(parsed, configDir);
+    // Media-asset id namespace (download.assetNamespace, default 'pixiv').
+    // Applied once per config load so every mediaAssetId() call site picks it up.
+    (0, MediaAsset_1.configureMediaAssetNamespace)(config.download?.assetNamespace);
     // Set log level
     if (config.logLevel) {
         logger_1.logger.setLevel(config.logLevel);

package/dist/config/types.d.ts

@@ -959,6 +959,13 @@ export interface StandaloneConfig {
             unknown?: 'skip' | 'keep';
             probeFailed?: 'skip' | 'keep';
         };
+        /**
+         * Media-asset id namespace prefix (`<namespace>:<workId>:<kind>[:<sourceId>]`).
+         * Default: 'pixiv' (production unchanged; `pixiv:` ids stay valid forever).
+         * A second content source may adopt its own namespace — consumers treat the
+         * prefix as opaque. Lowercase letters/digits/dashes, max 32 chars.
+         */
+        assetNamespace?: string;
     };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/config/validation.js

@@ -715,6 +715,10 @@ function validateConfig(config, location, databasePath) {
             config.download.novelCover.unknown !== 'keep') {
             errors.push(`download.novelCover.unknown: Must be "skip" or "keep" (got ${String(config.download.novelCover.unknown)})`);
         }
+        if (config.download.assetNamespace !== undefined &&
+            !/^[a-z0-9][a-z0-9-]{0,31}$/.test(String(config.download.assetNamespace))) {
+            errors.push(`download.assetNamespace: Must be lowercase letters/digits/dashes, 1-32 chars (got ${String(config.download.assetNamespace)})`);
+        }
         if (config.download.novelCover?.probeFailed !== undefined &&
             config.download.novelCover.probeFailed !== 'skip' &&
             config.download.novelCover.probeFailed !== 'keep') {

package/dist/delivery/DeliveryService.js

@@ -148,6 +148,7 @@ class DeliveryService {
                 pixivId: artifact.pixivId,
                 type: artifact.type,
                 title: artifact.title,
+                ...(artifact.seriesTitle !== undefined ? { seriesTitle: artifact.seriesTitle } : {}),
                 ...(artifact.spoiler !== undefined ? { spoiler: artifact.spoiler } : {}),
             },
             files,
@@ -288,6 +289,7 @@ class DeliveryService {
         return {
             deliveryTarget,
             title: artifact.title,
+            ...(artifact.seriesTitle !== undefined ? { seriesTitle: artifact.seriesTitle } : {}),
             pixivId: artifact.pixivId,
             type: artifact.type,
             targetId: target.id,

package/dist/delivery/HttpMultipartDelivery.js

@@ -425,9 +425,26 @@ function buildTemplateVariables(request) {
             return 'R18G';
         return `XRestrict${xRestrict}`;
     })();
+    // A series novel's `seriesTitle` names its parent series while `title` is the
+    // chapter title. Compose the card headline `《系列名》 章节名` when the work
+    // belongs to a series; fall back to the bare title otherwise (illustrations
+    // and non-series novels never carry a seriesTitle).
+    const displayTitle = c.type === 'novel' && c.seriesTitle
+        ? `《${c.seriesTitle}》 ${c.title}`
+        : c.title;
     return {
         title: c.title,
+        // Composed card headline: `《系列名》 章节名` for series novels, else the
+        // bare work title. Templates should render {{displayTitle}}.
+        displayTitle,
+        // Parent series name for a series novel chapter; empty otherwise. Tempo
+        // templates can render `《{{seriesTitle}}》 {{title}}` themselves.
+        seriesTitle: c.seriesTitle ?? '',
         pixivId: c.pixivId,
+        // Source-neutral alias of pixivId for delivery templates: TelePost's
+        // canonical submission field is work_id (pixiv_id deprecated), so
+        // templates should render {{workId}} going forward. Same value.
+        workId: c.pixivId,
         type: c.type,
         targetId: c.targetId ?? '',
         tag: c.tag ?? '',

package/dist/delivery/types.d.ts

@@ -14,6 +14,12 @@ export interface DownloadedArtifact {
     pixivId: string;
     type: DeliveryItemType;
     title: string;
+    /**
+     * Parent series name for a series-novel chapter, when the API response
+     * carried one. This is distinct from `title`, which holds the chapter title
+     * only. Empty when the work is not part of a Pixiv series.
+     */
+    seriesTitle?: string;
     /**
      * Pixiv author (artist) display name, when the API response carried one.
      *
@@ -57,6 +63,13 @@ export interface DownloadedArtifact {
 export declare function deliveryFilePaths(artifact: DownloadedArtifact): string[];
 export interface DeliveryContext {
     title: string;
+    /**
+     * Series (series novel) name, when the work belongs to a Pixiv series.
+     * A series novel's `title` holds the chapter title only; this carries the
+     * parent series name so templates can render e.g. `《系列名》 章节名`.
+     * Empty when the work is not part of a series.
+     */
+    seriesTitle?: string;
     pixivId: string;
     type: DeliveryItemType;
     /**

package/dist/domain/media/MediaAsset.d.ts

@@ -8,6 +8,21 @@
  * purpose (referenced media may still be unmaterialized).
  */
 export type PixivMediaKind = 'uploadedimage' | 'pixivimage' | 'illust' | 'novelcover';
+/**
+ * Default (and production) namespace prefix of media-asset ids: `pixiv`.
+ * `pixiv:` asset ids stay valid forever — consumers (TelePost) treat the
+ * prefix as opaque; a second source may adopt its own namespace via
+ * `download.assetNamespace` in the config without any consumer change.
+ */
+export declare const DEFAULT_MEDIA_ASSET_NAMESPACE = "pixiv";
+/**
+ * Configure the media-asset id namespace for this process. Called once from
+ * the config loader (`download.assetNamespace`); invalid/empty values fall
+ * back to the default so existing `pixiv:` ids never break.
+ */
+export declare function configureMediaAssetNamespace(namespace?: string): void;
+/** Current media-asset id namespace (default `pixiv`). */
+export declare function getMediaAssetNamespace(): string;
 export interface MediaSourceRef {
     /** Pixiv work id, e.g. the novel/illust id. */
     workId: string;
@@ -33,10 +48,11 @@ export interface MediaAsset {
     sourceRef?: MediaSourceRef;
 }
 /**
- * Deterministic stable identity: `pixiv:<workId>:<pixivKind>[:<sourceId>]`.
+ * Deterministic stable identity: `<namespace>:<workId>:<pixivKind>[:<sourceId>]`
+ * where `namespace` defaults to the configured asset namespace (`pixiv`).
  * Never carries Telegram/thelegraph/catbox ids.
  */
-export declare function mediaAssetId(workId: string, pixivKind: PixivMediaKind, sourceId?: string): string;
+export declare function mediaAssetId(workId: string, pixivKind: PixivMediaKind, sourceId?: string, namespace?: string): string;
 export interface MediaAssetInput {
     workId: string;
     kind: PixivMediaKind;

package/dist/domain/media/MediaAsset.js

@@ -1,16 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MEDIA_ASSET_NAMESPACE = void 0;
+exports.configureMediaAssetNamespace = configureMediaAssetNamespace;
+exports.getMediaAssetNamespace = getMediaAssetNamespace;
 exports.mediaAssetId = mediaAssetId;
 exports.buildMediaAsset = buildMediaAsset;
 /**
- * Deterministic stable identity: `pixiv:<workId>:<pixivKind>[:<sourceId>]`.
+ * Default (and production) namespace prefix of media-asset ids: `pixiv`.
+ * `pixiv:` asset ids stay valid forever — consumers (TelePost) treat the
+ * prefix as opaque; a second source may adopt its own namespace via
+ * `download.assetNamespace` in the config without any consumer change.
+ */
+exports.DEFAULT_MEDIA_ASSET_NAMESPACE = 'pixiv';
+const NAMESPACE_PATTERN = /^[a-z0-9][a-z0-9-]{0,31}$/;
+let assetNamespace = exports.DEFAULT_MEDIA_ASSET_NAMESPACE;
+/**
+ * Configure the media-asset id namespace for this process. Called once from
+ * the config loader (`download.assetNamespace`); invalid/empty values fall
+ * back to the default so existing `pixiv:` ids never break.
+ */
+function configureMediaAssetNamespace(namespace) {
+    const clean = String(namespace ?? '').trim().toLowerCase();
+    assetNamespace = NAMESPACE_PATTERN.test(clean) ? clean : exports.DEFAULT_MEDIA_ASSET_NAMESPACE;
+}
+/** Current media-asset id namespace (default `pixiv`). */
+function getMediaAssetNamespace() {
+    return assetNamespace;
+}
+/**
+ * Deterministic stable identity: `<namespace>:<workId>:<pixivKind>[:<sourceId>]`
+ * where `namespace` defaults to the configured asset namespace (`pixiv`).
  * Never carries Telegram/thelegraph/catbox ids.
  */
-function mediaAssetId(workId, pixivKind, sourceId) {
+function mediaAssetId(workId, pixivKind, sourceId, namespace) {
     const cleanWork = String(workId).trim();
     const cleanKind = String(pixivKind).trim();
     const cleanSource = sourceId ? String(sourceId).trim() : '';
-    return `pixiv:${cleanWork}:${cleanKind}${cleanSource ? `:${cleanSource}` : ''}`;
+    const ns = String(namespace ?? assetNamespace).trim() || exports.DEFAULT_MEDIA_ASSET_NAMESPACE;
+    return `${ns}:${cleanWork}:${cleanKind}${cleanSource ? `:${cleanSource}` : ''}`;
 }
 /** Build a canonical MediaAsset from a resolved Pixiv media reference. */
 function buildMediaAsset(input) {

package/dist/download/NovelDownloader.js

@@ -386,6 +386,7 @@ class NovelDownloader {
             pixivId: workId,
             type: 'novel',
             title: detail.title,
+            seriesTitle: detail.series?.title || undefined,
             // Attribution travels with the artifact: a publishing provider (e.g. the
             // TelePost submission target) renders it into its own fields, so the
             // downloader must not be the only place that knows the author.

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow",
-  "version": "3.4.3",
+  "version": "3.6.0",
   "private": true
 }

package/dist/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BUILD = void 0;
 // GENERATED by scripts/write-version.js — do not edit manually.
-exports.BUILD = { version: '3.4.3', commit: '74ffa4d29ec2' };
+exports.BUILD = { version: '3.6.0', commit: '650a0bacba90' };
 //# sourceMappingURL=version.js.map

package/dist/webui/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow-webui-backend",
-  "version": "3.4.3",
+  "version": "3.6.0",
   "description": "PixivFlow WebUI Backend - CommonJS module"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixivflow",
-  "version": "3.4.3",
+  "version": "3.6.0",
   "description": "🎨 Pixiv 下载、筛选与自动收集工具 - 批量下载插画和小说、按标签/热度/日期筛选、定时任务与可靠 HTTP 交付 | Pixiv downloader and automation toolkit with filtering, scheduling and reliable HTTP delivery",
   "repository": {
     "type": "git",