@gobing-ai/knowledge-kit 0.0.22 → 0.0.24

package/plugins/publishings/podcast-pub/dist/index.js

@@ -14642,6 +14642,72 @@ var init_zod = __esm(() => {
   init_external();
 });
 
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/errors.js
+var ErrorCode;
+var init_errors3 = __esm(() => {
+  ErrorCode = {
+    NotFound: "NOT_FOUND",
+    Validation: "VALIDATION",
+    Conflict: "CONFLICT",
+    Internal: "INTERNAL"
+  };
+});
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/api-response.js
+var API_ERROR_CODES, ERROR_CODE_TO_HTTP, CLIENT_SAFE_CODES;
+var init_api_response = __esm(() => {
+  init_errors3();
+  API_ERROR_CODES = {
+    SUCCESS: 0,
+    NOT_FOUND: 404,
+    VALIDATION_ERROR: 422,
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    CONFLICT: 409,
+    INTERNAL_ERROR: 500
+  };
+  ERROR_CODE_TO_HTTP = {
+    [ErrorCode.NotFound]: API_ERROR_CODES.NOT_FOUND,
+    [ErrorCode.Validation]: API_ERROR_CODES.VALIDATION_ERROR,
+    [ErrorCode.Conflict]: API_ERROR_CODES.CONFLICT,
+    [ErrorCode.Internal]: API_ERROR_CODES.INTERNAL_ERROR
+  };
+  CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
+});
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/cursor.js
+var init_cursor = () => {};
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
+var init_event_severity = () => {};
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/output.js
+function processStream(name) {
+  const proc = globalThis.process;
+  const stream = proc?.[name];
+  if (stream === undefined) {
+    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
+  }
+  return stream;
+}
+function writeLine(message, target) {
+  target.write(`${message}
+`);
+}
+function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
+  writeLine(message, target);
+}
+var defaultStderrTarget;
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/index.js
+var init_dist = __esm(() => {
+  init_api_response();
+  init_cursor();
+  init_errors3();
+  init_event_severity();
+});
+
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -17546,15 +17612,15 @@ var require_timestamp = __commonJS((exports) => {
         throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");
       const [, year, month, day, hour, minute, second] = match.map(Number);
       const millisec = match[7] ? Number((match[7] + "00").substr(1, 3)) : 0;
-      let date5 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
+      let date6 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
       const tz = match[8];
       if (tz && tz !== "Z") {
         let d = parseSexagesimal(tz, false);
         if (Math.abs(d) < 30)
           d *= 60;
-        date5 -= 60000 * d;
+        date6 -= 60000 * d;
       }
-      return new Date(date5);
+      return new Date(date6);
     },
     stringify: ({ value }) => value?.toISOString().replace(/(T00:00:00)?\.000Z$/, "") ?? ""
   };
@@ -19414,7 +19480,7 @@ var require_composer = __commonJS((exports) => {
   var node_process = __require("process");
   var directives = require_directives();
   var Document = require_Document();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var identity = require_identity();
   var composeDoc = require_compose_doc();
   var resolveEnd = require_resolve_end();
@@ -19465,9 +19531,9 @@ var require_composer = __commonJS((exports) => {
       this.onError = (source, code, message, warning) => {
         const pos = getErrorPos(source);
         if (warning)
-          this.warnings.push(new errors3.YAMLWarning(pos, code, message));
+          this.warnings.push(new errors4.YAMLWarning(pos, code, message));
         else
-          this.errors.push(new errors3.YAMLParseError(pos, code, message));
+          this.errors.push(new errors4.YAMLParseError(pos, code, message));
       };
       this.directives = new directives.Directives({ version: options.version || "1.2" });
       this.options = options;
@@ -19553,7 +19619,7 @@ ${cb}` : comment;
           break;
         case "error": {
           const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-          const error51 = new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+          const error51 = new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
           if (this.atDirectives || !this.doc)
             this.errors.push(error51);
           else
@@ -19563,7 +19629,7 @@ ${cb}` : comment;
         case "doc-end": {
           if (!this.doc) {
             const msg = "Unexpected doc-end without preceding document";
-            this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+            this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
             break;
           }
           this.doc.directives.docEnd = true;
@@ -19578,7 +19644,7 @@ ${end.comment}` : end.comment;
           break;
         }
         default:
-          this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+          this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
       }
     }
     *end(forceDoc = false, endOffset = -1) {
@@ -19604,7 +19670,7 @@ ${end.comment}` : end.comment;
 var require_cst_scalar = __commonJS((exports) => {
   var resolveBlockScalar = require_resolve_block_scalar();
   var resolveFlowScalar = require_resolve_flow_scalar();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var stringifyString = require_stringifyString();
   function resolveAsScalar(token, strict = true, onError) {
     if (token) {
@@ -19613,7 +19679,7 @@ var require_cst_scalar = __commonJS((exports) => {
         if (onError)
           onError(offset, code, message);
         else
-          throw new errors3.YAMLParseError([offset, offset + 1], code, message);
+          throw new errors4.YAMLParseError([offset, offset + 1], code, message);
       };
       switch (token.type) {
         case "scalar":
@@ -21493,7 +21559,7 @@ var require_parser = __commonJS((exports) => {
 var require_public_api = __commonJS((exports) => {
   var composer = require_composer();
   var Document = require_Document();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var log = require_log();
   var identity = require_identity();
   var lineCounter = require_line_counter();
@@ -21510,8 +21576,8 @@ var require_public_api = __commonJS((exports) => {
     const docs = Array.from(composer$1.compose(parser$1.parse(source)));
     if (prettyErrors && lineCounter2)
       for (const doc2 of docs) {
-        doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
-        doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
+        doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
+        doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
       }
     if (docs.length > 0)
       return docs;
@@ -21526,13 +21592,13 @@ var require_public_api = __commonJS((exports) => {
       if (!doc2)
         doc2 = _doc;
       else if (doc2.options.logLevel !== "silent") {
-        doc2.errors.push(new errors3.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+        doc2.errors.push(new errors4.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
         break;
       }
     }
     if (prettyErrors && lineCounter2) {
-      doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
-      doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
+      doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
+      doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
     }
     return doc2;
   }
@@ -21584,12 +21650,12 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/index.js
-var composer, Document, Schema, errors3, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
-var init_dist = __esm(() => {
+var composer, Document, Schema, errors4, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
+var init_dist2 = __esm(() => {
   composer = require_composer();
   Document = require_Document();
   Schema = require_Schema();
-  errors3 = require_errors();
+  errors4 = require_errors();
   Alias = require_Alias();
   identity = require_identity();
   Pair = require_Pair();
@@ -21605,9 +21671,9 @@ var init_dist = __esm(() => {
   $Composer = composer.Composer;
   $Document = Document.Document;
   $Schema = Schema.Schema;
-  $YAMLError = errors3.YAMLError;
-  $YAMLParseError = errors3.YAMLParseError;
-  $YAMLWarning = errors3.YAMLWarning;
+  $YAMLError = errors4.YAMLError;
+  $YAMLParseError = errors4.YAMLParseError;
+  $YAMLWarning = errors4.YAMLWarning;
   $Alias = Alias.Alias;
   $isAlias = identity.isAlias;
   $isCollection = identity.isCollection;
@@ -21632,10 +21698,10 @@ var init_dist = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/config.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/config.js
 var configSchema;
 var init_config = __esm(() => {
-  init_dist();
+  init_dist2();
   init_zod();
   configSchema = exports_external.object({
     app: exports_external.object({
@@ -21656,7 +21722,7 @@ var init_config = __esm(() => {
   });
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
 import { appendFileSync, cpSync, createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 function createNodeFileSystem(root, paths) {
@@ -21836,28 +21902,10 @@ var PluginManifestSchema = exports_external.looseObject({
   description: exports_external.string().optional(),
   operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
 });
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.67/node_modules/@gobing-ai/ts-utils/dist/output.js
-var defaultStderrTarget;
-function processStream(name) {
-  const proc = globalThis.process;
-  const stream = proc?.[name];
-  if (stream === undefined) {
-    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
-  }
-  return stream;
-}
-function writeLine(message, target) {
-  target.write(`${message}
-`);
-}
-function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
-  writeLine(message, target);
-}
-
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
 // ../../packages/publish-harness/src/index.ts
@@ -21934,6 +21982,9 @@ class FakeBrowserTransport {
   }
 }
 
+// ../../plugins/publishings/podcast-pub/src/index.ts
+init_dist();
+
 // ../../plugins/publishings/podcast-pub/src/map.ts
 import { extname } from "path";
 
@@ -21984,14 +22035,14 @@ function computeAudioOffsets(docs, segments) {
     elapsed += s.duration ?? 0;
     return { at, text: normalizeForMatch(s.transcription ?? "") };
   });
-  let cursor = 1;
+  let cursor2 = 1;
   for (const d of docs) {
     const title = normalizeForMatch(d.title ?? "");
     const needle = title.slice(0, 12);
-    const hit = needle.length >= 4 ? marks.findIndex((m, i) => i >= cursor && m.text.includes(needle)) : -1;
+    const hit = needle.length >= 4 ? marks.findIndex((m, i) => i >= cursor2 && m.text.includes(needle)) : -1;
     if (hit >= 0) {
       starts.push(marks[hit]?.at ?? 0);
-      cursor = hit + 1;
+      cursor2 = hit + 1;
     } else {
       starts.push(Number.NaN);
     }
@@ -22114,7 +22165,8 @@ function renderShowNotesMarkdown(docs, opts) {
   const segments = opts.articlePostPath?.split(/[\\/]/).filter((s) => s.length > 0) ?? [];
   const postSlug = segments.length >= 2 ? segments[segments.length - 2] ?? "" : "";
   const postLocale = segments.find((s) => ["zh", "en", "ja"].includes(s)) ?? "zh";
-  const articleUrl = postSlug.length > 0 ? `${baseUrl}/${postLocale}/posts/${postSlug}` : `${baseUrl}/zh/posts/${opts.runDate}-${slugify2(opts.title)}`;
+  const localePrefix = postLocale === "en" ? "" : `/${postLocale}`;
+  const articleUrl = postSlug.length > 0 ? `${baseUrl}${localePrefix}/posts/${postSlug}` : `${baseUrl}/zh/posts/${opts.runDate}-${slugify2(opts.title)}`;
   const briefMode = opts.briefMode === true && postSlug.length > 0;
   const sourceLabel = (d) => {
     const m = d.metadata ?? {};
@@ -22147,13 +22199,21 @@ var COVER_EXTS = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif"]);
 var AUDIO_MIME_BY_EXTENSION = {
   ".mp3": "audio/mpeg",
   ".wav": "audio/wav",
-  ".m4a": "audio/mp4",
+  ".m4a": "audio/x-m4a",
   ".aac": "audio/aac",
   ".ogg": "audio/ogg",
   ".oga": "audio/ogg",
   ".flac": "audio/flac",
   ".opus": "audio/opus"
 };
+var APPLE_AUDIO_MIME = new Set([
+  "audio/mpeg",
+  "audio/x-m4a",
+  "audio/mp4",
+  "video/mp4",
+  "video/quicktime",
+  "video/x-m4v"
+]);
 function resolveAudioMimeType(reference, mimeType) {
   if (typeof mimeType === "string" && mimeType.trim().length > 0) {
     return mimeType.trim();
@@ -22225,15 +22285,15 @@ function mapContentToEpisode(content) {
       ...typeof rec.block === "boolean" ? { block: rec.block } : {}
     };
   }
+  const audioMimeType = resolveAudioMimeType(audioFile ?? audioUrl, metadata.mimeType);
+  if (!APPLE_AUDIO_MIME.has(audioMimeType)) {
+    throw new Error(`unsupported audio MIME type "${audioMimeType}" for Apple Podcasts: expected one of ${[...APPLE_AUDIO_MIME].join(", ")}`);
+  }
   return {
     title,
     contentHtml: showNotes && showNotes.length > 0 ? renderShowNotesHtml(showNotes) : content.format === "html" ? content.body : renderShowNotesHtml(content.body),
     status,
-    audio: audioFile ? { kind: "file", path: audioFile, mimeType: resolveAudioMimeType(audioFile, metadata.mimeType) } : {
-      kind: "url",
-      url: audioUrl,
-      mimeType: resolveAudioMimeType(audioUrl, metadata.mimeType)
-    },
+    audio: audioFile ? { kind: "file", path: audioFile, mimeType: audioMimeType } : { kind: "url", url: audioUrl, mimeType: audioMimeType },
     durationSeconds: duration3,
     ...imageUrl ? { imageUrl } : {},
     ...imagePath ? { imagePath } : {},

package/plugins/publishings/podcast-pub/src/map.ts

@@ -40,7 +40,7 @@ export interface EpisodeMapping {
 const AUDIO_MIME_BY_EXTENSION: Record<string, string> = {
     '.mp3': 'audio/mpeg',
     '.wav': 'audio/wav',
-    '.m4a': 'audio/mp4',
+    '.m4a': 'audio/x-m4a',
     '.aac': 'audio/aac',
     '.ogg': 'audio/ogg',
     '.oga': 'audio/ogg',
@@ -48,6 +48,20 @@ const AUDIO_MIME_BY_EXTENSION: Record<string, string> = {
     '.opus': 'audio/opus',
 };
 
+/**
+ * Audio MIME types Apple Podcasts accepts for an enclosure. microfeed stores and serves
+ * whatever MIME it is given, so anything outside this set must be refused here — before
+ * any network call — rather than shipping an enclosure Apple cannot ingest.
+ */
+const APPLE_AUDIO_MIME: ReadonlySet<string> = new Set([
+    'audio/mpeg',
+    'audio/x-m4a',
+    'audio/mp4',
+    'video/mp4',
+    'video/quicktime',
+    'video/x-m4v',
+]);
+
 /**
  * Resolves the audio MIME type from `metadata.mimeType` or the file extension
  * (`.wav` → `audio/wav`); unknown extensions fall back to `application/octet-stream`.
@@ -65,9 +79,9 @@ export function resolveAudioMimeType(reference: string, mimeType?: unknown): str
 
 /**
  * Maps Content + episode metadata into microfeed item fields (design D6).
- * Validates only the plugin's own requirements — title resolvable and exactly one
- * audio reference — before any network call (R5); microfeed's `validate` endpoint
- * and server 400s surface everything else (R4 error path).
+ * Validates only the plugin's own requirements — title resolvable, exactly one audio
+ * reference, and an Apple-compatible audio MIME — before any network call (R5);
+ * microfeed's `validate` endpoint and server 400s surface everything else (R4 error path).
  * Throws with a diagnostic when the Content is not publishable.
  */
 export function mapContentToEpisode(content: Content): EpisodeMapping {
@@ -150,6 +164,16 @@ export function mapContentToEpisode(content: Content): EpisodeMapping {
         };
     }
 
+    // Resolved once so the Apple-compatibility guard also covers a `metadata.mimeType`
+    // override; `AUDIO_MIME_BY_EXTENSION` still says what a file is, the allowlist decides
+    // what is publishable.
+    const audioMimeType = resolveAudioMimeType(audioFile ?? (audioUrl as string), metadata.mimeType);
+    if (!APPLE_AUDIO_MIME.has(audioMimeType)) {
+        throw new Error(
+            `unsupported audio MIME type "${audioMimeType}" for Apple Podcasts: expected one of ${[...APPLE_AUDIO_MIME].join(', ')}`,
+        );
+    }
+
     return {
         title,
         contentHtml:
@@ -160,12 +184,8 @@ export function mapContentToEpisode(content: Content): EpisodeMapping {
                   : renderShowNotesHtml(content.body),
         status,
         audio: audioFile
-            ? { kind: 'file', path: audioFile, mimeType: resolveAudioMimeType(audioFile, metadata.mimeType) }
-            : {
-                  kind: 'url',
-                  url: audioUrl as string,
-                  mimeType: resolveAudioMimeType(audioUrl as string, metadata.mimeType),
-              },
+            ? { kind: 'file', path: audioFile, mimeType: audioMimeType }
+            : { kind: 'url', url: audioUrl as string, mimeType: audioMimeType },
         durationSeconds: duration as number | undefined,
         ...(imageUrl ? { imageUrl } : {}),
         ...(imagePath ? { imagePath } : {}),

package/plugins/publishings/podcast-pub/src/show-notes.ts

@@ -309,9 +309,14 @@ export function renderShowNotesMarkdown(docs: Doc[], opts: ShowNotesRenderOption
     const segments = opts.articlePostPath?.split(/[\\/]/).filter((s) => s.length > 0) ?? [];
     const postSlug = segments.length >= 2 ? (segments[segments.length - 2] ?? '') : '';
     const postLocale = segments.find((s) => ['zh', 'en', 'ja'].includes(s)) ?? 'zh';
+    // URL shape mirrors surfdash's localePathPrefix (surfdash/src/lib/seo.ts):
+    // en is served at the site root, zh/ja carry a /<locale> prefix. A bare
+    // /<locale>/posts/<slug> 404s en posts. Fallback stays zh — the podcast
+    // is zh-only today.
+    const localePrefix = postLocale === 'en' ? '' : `/${postLocale}`;
     const articleUrl =
         postSlug.length > 0
-            ? `${baseUrl}/${postLocale}/posts/${postSlug}`
+            ? `${baseUrl}${localePrefix}/posts/${postSlug}`
             : `${baseUrl}/zh/posts/${opts.runDate}-${slugify(opts.title)}`;
     const briefMode = opts.briefMode === true && postSlug.length > 0;
     const sourceLabel = (d: Doc): string => {