pixivflow 3.5.0 → 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/HttpMultipartDelivery.js

@@ -441,6 +441,10 @@ function buildTemplateVariables(request) {
         // 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/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/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow",
-  "version": "3.5.0",
+  "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.5.0', commit: '644b3dfb5551' };
+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.5.0",
+  "version": "3.6.0",
   "description": "PixivFlow WebUI Backend - CommonJS module"
 }

package/package.json

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