publishport-opencli 1.0.0

package/clis/slock/task-create.js

@@ -0,0 +1,24 @@
+import{cli as h,Strategy as l}from"@jackwener/opencli/registry";import{ArgumentError as i}from"@jackwener/opencli/errors";import{authHeadersFragment as u,channelResolveFragment as p}from"./in-page.js";import{dispatchEvaluateResult as m}from"./errors.js";import{SLOCK_SITE as k,SLOCK_DOMAIN as f,SLOCK_HOME_URL as w,SLOCK_API_BASE as b}from"./shared.js";h({site:k,name:"task-create",access:"write",description:"Create a task in a channel (single title; batch 1-50 is server-supported but client surface is single — see backlog R4).",domain:f,strategy:l.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"channel",positional:!0,required:!0,help:"channelId UUID or #name"},{name:"title",positional:!0,required:!0,help:"Task title (single; batch TODO via R4)"},{name:"desc",help:"Optional description body for the task"},{name:"server",help:"Override active server"}],columns:["id","taskNumber","title","taskStatus","channelId"],func:async(a,t)=>{const r=String(t.channel??"").trim();if(!r)throw new i("channel required");const s=String(t.title??"").trim();if(!s)throw new i("title required (non-empty)");const n=t.desc!=null?String(t.desc):"";await a.goto(w);const o=n?{title:s,description:n}:{title:s},c=`
+      ${u({serverScoped:!0,serverIdOverride:t.server})}
+      ${p(r)}
+      // Body is always a batch array — N=1 here because the CLI exposes one
+      // title at a time (R4 will widen this). Keep the wrapper so the server
+      // sees the same shape as a real batch and we don't fork the contract.
+      const body = { tasks: [${JSON.stringify(o)}] };
+      const res = await fetch('${b}/tasks/channel/' + encodeURIComponent(channelId), {
+        method:'POST', credentials:'include', headers, body: JSON.stringify(body),
+      });
+      if (res.status === 400) {
+        const j = await res.json().catch(() => ({}));
+        return { kind: 'http', status: 400, where: '/tasks/channel/:id (bad request: ' + (j.error || j.message || 'title/limit/shape') + ')' };
+      }
+      if (res.status === 403) return { kind: 'http', status: 403, where: '/tasks/channel/:id (forbidden — channel archived or not a member)' };
+      if (res.status === 404) return { kind: 'http', status: 404, where: '/tasks/channel/:id (channel not found)' };
+      if (res.status === 409) return { kind: 'http', status: 409, where: '/tasks/channel/:id (conflict — thread channels do not accept tasks; pick the parent channel)' };
+      if (!res.ok) return { kind: res.status===401?'auth':'http', status: res.status, where:'/tasks/channel/:id' };
+      const data = await res.json().catch(() => ({}));
+      if (!data || !Array.isArray(data.tasks)) {
+        return { kind: 'http', status: 200, where: '/tasks/channel/:id (expected {tasks:[]}, got drift)' };
+      }
+      return { kind: 'ok', rows: data.tasks };
+    `,d=await a.evaluate(`(async () => { ${c} })()`);return m(d).map((e)=>({id:e.id??"",taskNumber:e.taskNumber??null,title:e.content??e.title??s,taskStatus:e.taskStatus??"todo",channelId:e.channelId??null}))}});

package/clis/slock/task-delete.js

@@ -0,0 +1,9 @@
+import{cli as Q,Strategy as V}from"@jackwener/opencli/registry";import{ArgumentError as W}from"@jackwener/opencli/errors";import{authHeadersFragment as X}from"./in-page.js";import{dispatchEvaluateResult as Y}from"./errors.js";import{SLOCK_SITE as Z,SLOCK_DOMAIN as $,SLOCK_HOME_URL as x,SLOCK_API_BASE as B}from"./shared.js";import{assertMessageIdShape as D}from"./resolve.js";Q({site:Z,name:"task-delete",access:"write",description:"Delete a chat task (DELETE /tasks/:taskId). Requires --confirm — destructive, irreversible.",domain:$,strategy:V.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"taskId",positional:!0,required:!0,help:"Full task UUID (= message id; short ids rejected)"},{name:"confirm",type:"bool",default:!1,help:"Required acknowledgement: deletion is irreversible"},{name:"server",help:"Override active server"}],columns:["taskId","deleted"],func:async(z,q)=>{let b;try{b=D(String(q.taskId??""))}catch(f){throw new W(f.message)}if(!q.confirm)return[{taskId:b,deleted:!1,note:"no-op: pass --confirm to actually delete (irreversible)"}];await z.goto(x);const G=`
+      ${X({serverScoped:!0,serverIdOverride:q.server})}
+      const res = await fetch('${B}/tasks/' + encodeURIComponent(${JSON.stringify(b)}), { method:'DELETE', credentials:'include', headers });
+      if (res.status === 403) return { kind: 'http', status: 403, where: '/tasks/:taskId (forbidden — not the owner/admin or channel archived)' };
+      if (res.status === 404) return { kind: 'http', status: 404, where: '/tasks/:taskId (task not found)' };
+      if (!res.ok) return { kind: res.status===401?'auth':'http', status: res.status, where:'/tasks/:taskId' };
+      // 204 No Content is common for DELETE; tolerate empty body.
+      return { kind: 'ok', rows: [{ taskId: ${JSON.stringify(b)}, deleted: true }] };
+    `,J=await z.evaluate(`(async () => { ${G} })()`);return Y(J).map((f)=>({taskId:f.taskId??b,deleted:f.deleted??!0}))}});

package/clis/slock/task-get.js

@@ -0,0 +1,11 @@
+import{cli as c,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as i}from"@jackwener/opencli/errors";import{authHeadersFragment as d,channelResolveFragment as h}from"./in-page.js";import{dispatchEvaluateResult as l}from"./errors.js";import{SLOCK_SITE as k,SLOCK_DOMAIN as p,SLOCK_HOME_URL as b,SLOCK_API_BASE as g}from"./shared.js";import{parsePositiveInteger as S}from"./resolve.js";c({site:k,name:"task-get",access:"read",description:"Fetch a task by channel + taskNumber (GET /tasks/channel/:channelId/number/:taskNumber).",domain:p,strategy:m.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"channel",positional:!0,required:!0,help:"channelId UUID or #name"},{name:"number",positional:!0,required:!0,help:'taskNumber (per-channel integer, as shown in "task #N")'},{name:"server",help:"Override active server"}],columns:["id","taskNumber","title","taskStatus","assigneeId"],func:async(r,t)=>{const s=String(t.channel??"").trim();if(!s)throw new i("channel required");const n=String(t.number??"").trim();if(!/^\d+$/.test(n))throw new i(`number "${n}" is not a positive integer`);const a=S(n,"number");await r.goto(b);const o=`
+      ${d({serverScoped:!0,serverIdOverride:t.server})}
+      ${h(s)}
+      const res = await fetch('${g}/tasks/channel/' + encodeURIComponent(channelId) + '/number/' + encodeURIComponent(${JSON.stringify(String(a))}), { credentials:'include', headers });
+      if (res.status === 404) return { kind: 'http', status: 404, where: '/tasks/channel/:id/number/:n (task #' + ${JSON.stringify(a)} + ' not found in channel)' };
+      if (!res.ok) return { kind: res.status===401?'auth':'http', status: res.status, where:'/tasks/channel/:id/number/:n' };
+      const data = await res.json().catch(() => ({}));
+      // Single object or {task: ...} wrapped — accept either.
+      const task = data && data.task ? data.task : data;
+      return { kind: 'ok', rows: [task] };
+    `,u=await r.evaluate(`(async () => { ${o} })()`);return l(u).map((e)=>({id:e.id??"",taskNumber:e.taskNumber??a,title:e.content??e.title??"",taskStatus:e.taskStatus??e.status??"",assigneeId:e.claimedById??e.assigneeId??null}))}});

package/clis/slock/task-list-server.js

@@ -0,0 +1,12 @@
+import{cli as u,Strategy as c}from"@jackwener/opencli/registry";import{ArgumentError as d,CommandExecutionError as l}from"@jackwener/opencli/errors";import{authHeadersFragment as m}from"./in-page.js";import{dispatchEvaluateResult as h}from"./errors.js";import{SLOCK_SITE as p,SLOCK_DOMAIN as v,SLOCK_HOME_URL as k,SLOCK_API_BASE as f}from"./shared.js";const a=["todo","in_progress","in_review","done","closed"];u({site:p,name:"task-list-server",access:"read",description:"List tasks across all channels in the active server (GET /tasks/server). Optional --status filter.",domain:v,strategy:c.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"status",help:`Filter by status: ${a.join("|")}`},{name:"server",help:"Override active server"}],columns:["id","taskNumber","title","taskStatus","channelId","assigneeId"],func:async(n,e)=>{const t=e.status?String(e.status).trim():"";if(t&&!a.includes(t))throw new d(`status "${t}" not in {${a.join("|")}}`);await n.goto(k);const i=`
+      ${m({serverScoped:!0,serverIdOverride:e.server})}
+      const status = ${JSON.stringify(t)};
+      const qs = status ? ('?status=' + encodeURIComponent(status)) : '';
+      const res = await fetch('${f}/tasks/server' + qs, { credentials:'include', headers });
+      if (!res.ok) return { kind: res.status===401?'auth':'http', status: res.status, where: '/tasks/server' };
+      const data = await res.json();
+      if (!data || !Array.isArray(data.tasks)) {
+        return { kind: 'http', status: 200, where: '/tasks/server (expected {tasks:[]}, got drift)' };
+      }
+      return { kind: 'ok', rows: data.tasks };
+    `,o=await n.evaluate(`(async () => { ${i} })()`),r=h(o);if(!Array.isArray(r))throw new l(`expected array of rows from server, got ${typeof r} (contract drift?)`);return r.map((s)=>({id:s.id??"",taskNumber:s.taskNumber??null,title:s.content??s.title??"",taskStatus:s.taskStatus??s.status??"",channelId:s.channelId??null,assigneeId:s.claimedById??s.assigneeId??null}))}});

package/clis/slock/task-list.js

@@ -0,0 +1,14 @@
+import{cli as u,Strategy as l}from"@jackwener/opencli/registry";import{ArgumentError as o,CommandExecutionError as h}from"@jackwener/opencli/errors";import{authHeadersFragment as m,channelResolveFragment as p}from"./in-page.js";import{dispatchEvaluateResult as k}from"./errors.js";import{SLOCK_SITE as f,SLOCK_DOMAIN as S,SLOCK_HOME_URL as v,SLOCK_API_BASE as w}from"./shared.js";const r=["todo","in_progress","in_review","done","closed"];u({site:f,name:"task-list",access:"read",description:"List tasks (chat tasks = messages with task fields) attached to a channel. Optional --status filter.",domain:S,strategy:l.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"channel",positional:!0,required:!0,help:"channelId UUID or #name"},{name:"status",help:`Filter by status: ${r.join("|")}`},{name:"server",help:"Override active server"}],columns:["id","taskNumber","title","taskStatus","assigneeId"],func:async(n,s)=>{const i=String(s.channel??"").trim();if(!i)throw new o("channel required");const e=s.status?String(s.status).trim():"";if(e&&!r.includes(e))throw new o(`status "${e}" not in {${r.join("|")}}`);await n.goto(v);const d=`
+      ${m({serverScoped:!0,serverIdOverride:s.server})}
+      ${p(i)}
+      const status = ${JSON.stringify(e)};
+      const qs = status ? ('?status=' + encodeURIComponent(status)) : '';
+      const tres = await fetch('${w}/tasks/channel/' + encodeURIComponent(channelId) + qs, { credentials:'include', headers });
+      if (!tres.ok) return { kind: tres.status===401?'auth':'http', status: tres.status, where: '/tasks/channel/:id' };
+      const data = await tres.json();
+      // Server contract: { tasks: [...] }. Reject anything else as drift.
+      if (!data || !Array.isArray(data.tasks)) {
+        return { kind: 'http', status: 200, where: '/tasks/channel/:id (expected {tasks:[]}, got drift)' };
+      }
+      return { kind: 'ok', rows: data.tasks };
+    `,c=await n.evaluate(`(async () => { ${d} })()`),a=k(c);if(!Array.isArray(a))throw new h(`expected array of rows from server, got ${typeof a} (contract drift?)`);return a.map((t)=>({id:t.id??"",taskNumber:t.taskNumber??null,title:t.content??t.title??"",taskStatus:t.taskStatus??t.status??"",assigneeId:t.claimedById??t.assigneeId??null}))}});

package/clis/slock/task-status.js

@@ -0,0 +1,19 @@
+import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{ArgumentError as d,CommandExecutionError as i}from"@jackwener/opencli/errors";import{authHeadersFragment as h}from"./in-page.js";import{dispatchEvaluateResult as m}from"./errors.js";import{SLOCK_SITE as f,SLOCK_DOMAIN as S,SLOCK_HOME_URL as p,SLOCK_API_BASE as w}from"./shared.js";import{assertMessageIdShape as I}from"./resolve.js";const o=["todo","in_progress","in_review","done","closed"];c({site:f,name:"task-status",access:"write",description:`Set a task's status (PATCH /tasks/:taskId/status, body {status}). One of ${o.join("|")}.`,domain:S,strategy:l.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"taskId",positional:!0,required:!0,help:"Full task UUID (= message id; short ids rejected)"},{name:"status",positional:!0,required:!0,help:`One of: ${o.join("|")}`},{name:"server",help:"Override active server"}],columns:["taskId","taskStatus","assigneeId","taskNumber"],func:async(e,s)=>{let a;try{a=I(String(s.taskId??""))}catch(n){throw new d(n.message)}const t=String(s.status??"").trim();if(!o.includes(t))throw new d(`status "${t}" not in {${o.join("|")}} — pre-network reject (saves a 400 round-trip).`);await e.goto(p);const r=`
+      ${h({serverScoped:!0,serverIdOverride:s.server})}
+      const res = await fetch('${w}/tasks/' + encodeURIComponent(${JSON.stringify(a)}) + '/status', {
+        method:'PATCH', credentials:'include', headers,
+        body: JSON.stringify({ status: ${JSON.stringify(t)} }),
+      });
+      if (res.status === 400) {
+        const j = await res.json().catch(() => ({}));
+        return { kind: 'http', status: 400, where: '/tasks/:taskId/status (bad request: ' + (j.error || j.message || 'invalid status transition') + ')' };
+      }
+      if (res.status === 403) return { kind: 'http', status: 403, where: '/tasks/:taskId/status (forbidden — terminal status (done/closed), not the assignee, or channel archived)' };
+      if (res.status === 404) return { kind: 'http', status: 404, where: '/tasks/:taskId/status (task not found)' };
+      // F6 — actionable hint for repeat-set 409 ("status already X").
+      if (res.status === 409) return { kind: 'http', status: 409, where: '/tasks/:taskId/status (conflict — task is already in status ' + ${JSON.stringify(t)} + '; no-op set rejected)' };
+      if (!res.ok) return { kind: res.status===401?'auth':'http', status: res.status, where:'/tasks/:taskId/status' };
+      const data = await res.json().catch(() => ({}));
+      const t = (data && data.task) ? data.task : data;
+      return { kind: 'ok', rows: [t] };
+    `,k=await e.evaluate(`(async () => { ${r} })()`);return m(k).map((n)=>{const u=g(n,a,t);return{taskId:u.taskId,taskStatus:u.taskStatus,assigneeId:n.claimedById??n.assigneeId??null,taskNumber:n.taskNumber??null}})}});function g(e,s,a){const t=e?.id;if(!t)throw new i(`Slock task-status succeeded without returning task id ${s}; refusing to report a status row.`);if(t!==s)throw new i(`Slock task-status returned task id ${t}, expected ${s}.`);const r=e.taskStatus??e.status;if(!r)throw new i(`Slock task-status returned task ${s} without taskStatus.`);if(r!==a)throw new i(`Slock task-status returned status ${r}, expected ${a}.`);return{taskId:t,taskStatus:r}}

package/clis/slock/task-unclaim.js

@@ -0,0 +1,13 @@
+import{cli as o,Strategy as u}from"@jackwener/opencli/registry";import{ArgumentError as d,CommandExecutionError as n}from"@jackwener/opencli/errors";import{authHeadersFragment as c}from"./in-page.js";import{dispatchEvaluateResult as l}from"./errors.js";import{SLOCK_SITE as m,SLOCK_DOMAIN as k,SLOCK_HOME_URL as h,SLOCK_API_BASE as p}from"./shared.js";import{assertMessageIdShape as f}from"./resolve.js";o({site:m,name:"task-unclaim",access:"write",description:"Release ownership of a chat task (PATCH /tasks/:id/unclaim).",domain:k,strategy:u.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"taskId",positional:!0,required:!0,help:"Full task UUID (= message id; short ids rejected)"},{name:"server",help:"Override active server"}],columns:["taskId","taskStatus","assigneeId","taskNumber"],func:async(r,s)=>{let e;try{e=f(String(s.taskId??""))}catch(t){throw new d(t.message)}await r.goto(h);const a=`
+      ${c({serverScoped:!0,serverIdOverride:s.server})}
+      const res = await fetch('${p}/tasks/' + encodeURIComponent(${JSON.stringify(e)}) + '/unclaim', { method:'PATCH', credentials:'include', headers });
+      if (res.status === 404) return { kind: 'http', status: 404, where: '/tasks/:id/unclaim (task not found)' };
+      if (res.status === 403) return { kind: 'http', status: 403, where: '/tasks/:id/unclaim (forbidden — not the assignee, terminal status, or channel archived)' };
+      // F6 — actionable hint for the most common reason this 409s (task already
+      // unclaimed, or terminal state). Bare "HTTP 409" was confusing.
+      if (res.status === 409) return { kind: 'http', status: 409, where: '/tasks/:id/unclaim (conflict — task is not claimed, or already in a terminal state (done/closed))' };
+      if (!res.ok) return { kind: res.status===401?'auth':'http', status: res.status, where:'/tasks/:id/unclaim' };
+      const data = await res.json().catch(() => ({}));
+      const t = (data && data.task) ? data.task : data;
+      return { kind: 'ok', rows: [t] };
+    `,i=await r.evaluate(`(async () => { ${a} })()`);return l(i).map((t)=>({taskId:w(t,e,"task-unclaim"),taskStatus:t.taskStatus??t.status??"",assigneeId:t.claimedById??t.assigneeId??null,taskNumber:t.taskNumber??null}))}});function w(r,s,e){const a=r?.id;if(!a)throw new n(`Slock ${e} succeeded without returning task id ${s}; refusing to report a task row.`);if(a!==s)throw new n(`Slock ${e} returned task id ${a}, expected ${s}.`);return a}

package/clis/slock/thread-done.js

@@ -0,0 +1 @@
+import{makeThreadStateCommand as e}from"./thread-state.js";e({name:"thread-done",verb:"done",resultLabel:"done",description:"Mark a thread as done / hide it from the active list (POST /channels/threads/done)"});

package/clis/slock/thread-follow.js

@@ -0,0 +1 @@
+import{cli as W,Strategy as X}from"@jackwener/opencli/registry";import{ArgumentError as Y,CommandExecutionError as Z}from"@jackwener/opencli/errors";import{buildFetchSnippet as $}from"./in-page.js";import{dispatchEvaluateResult as b}from"./errors.js";import{SLOCK_SITE as f,SLOCK_DOMAIN as x,SLOCK_HOME_URL as D}from"./shared.js";import{assertMessageIdShape as F}from"./resolve.js";W({site:f,name:"thread-follow",access:"write",description:"Follow the thread on a parent message (POST /channels/threads/follow)",domain:x,strategy:X.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"parentMessageId",positional:!0,required:!0,help:"Full parent messageId UUID (short ids rejected)"},{name:"server",help:"Override active server"}],columns:["parentMessageId","threadChannelId","result"],func:async(B,G)=>{let q;try{q=F(String(G.parentMessageId??""))}catch(V){throw new Y(V.message)}await B.goto(D);const P=$({method:"POST",path:"/channels/threads/follow",body:{parentMessageId:q},serverScoped:!0,serverIdOverride:G.server}),Q=await B.evaluate(`(async () => { ${P} })()`),z=b(Q),J=z?.threadChannelId??z?.channelId??z?.id;if(!J)throw new Z(`Slock thread-follow succeeded without returning a thread channel id for parent message ${q}.`);return[{parentMessageId:q,threadChannelId:J,result:"followed"}]}});

package/clis/slock/thread-list.js

@@ -0,0 +1 @@
+import{cli as d,Strategy as l}from"@jackwener/opencli/registry";import{CommandExecutionError as i}from"@jackwener/opencli/errors";import{buildFetchSnippet as p}from"./in-page.js";import{dispatchEvaluateResult as u}from"./errors.js";import{SLOCK_SITE as h,SLOCK_DOMAIN as c,SLOCK_HOME_URL as m}from"./shared.js";d({site:h,name:"thread-list",access:"read",description:"List followed threads in the active server (GET /channels/threads/followed)",domain:c,strategy:l.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"server",help:"Override active server"}],columns:["threadChannelId","parentMessageId","parentChannelName","unreadCount","replyCount","lastReplyAt"],func:async(a,n)=>{await a.goto(m);const s=p({method:"GET",path:"/channels/threads/followed",serverScoped:!0,serverIdOverride:n.server}),o=await a.evaluate(`(async () => { ${s} })()`),r=u(o),t=Array.isArray(r)?r:r.threads||[];if(!Array.isArray(t))throw new i(`expected threads array, got ${typeof t} (contract drift?)`);return t.map((e)=>({threadChannelId:e.threadChannelId??e.id??"",parentMessageId:e.parentMessageId??"",parentChannelName:e.parentChannelName??"",unreadCount:typeof e.unreadCount==="number"?e.unreadCount:0,replyCount:typeof e.replyCount==="number"?e.replyCount:null,lastReplyAt:e.lastReplyAt??null}))}});

package/clis/slock/thread-state.js

@@ -0,0 +1 @@
+import{cli as W,Strategy as X}from"@jackwener/opencli/registry";import{ArgumentError as Y}from"@jackwener/opencli/errors";import{buildFetchSnippet as Z}from"./in-page.js";import{dispatchEvaluateResult as $}from"./errors.js";import{SLOCK_SITE as F,SLOCK_DOMAIN as H,SLOCK_HOME_URL as N}from"./shared.js";import{UUID_RE as T}from"./resolve.js";export function makeThreadStateCommand({name:B,verb:G,resultLabel:J,description:P}){W({site:F,name:B,access:"write",description:P,domain:H,strategy:X.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"threadChannelId",positional:!0,required:!0,help:"Thread channel UUID (from thread-list / message-read)"},{name:"server",help:"Override active server"}],columns:["threadChannelId","result"],func:async(x,z)=>{const q=String(z.threadChannelId??"").trim();if(!T.test(q))throw new Y(`threadChannelId must be a full UUID (got "${q}"). Get it from thread-list or message-read's threadChannelId column.`);await x.goto(N);const Q=Z({method:"POST",path:`/channels/threads/${G}`,body:{threadChannelId:q},serverScoped:!0,serverIdOverride:z.server}),V=await x.evaluate(`(async () => { ${Q} })()`);$(V);return[{threadChannelId:q,result:J}]}})}

package/clis/slock/thread-undone.js

@@ -0,0 +1 @@
+import{makeThreadStateCommand as e}from"./thread-state.js";e({name:"thread-undone",verb:"undone",resultLabel:"undone",description:"Restore a done thread to the active list (POST /channels/threads/undone)"});

package/clis/slock/thread-unfollow.js

@@ -0,0 +1 @@
+import{makeThreadStateCommand as o}from"./thread-state.js";o({name:"thread-unfollow",verb:"unfollow",resultLabel:"unfollowed",description:"Stop following a thread (POST /channels/threads/unfollow)"});

package/clis/slock/unread-summary.js

@@ -0,0 +1,18 @@
+import{cli as X,Strategy as Y}from"@jackwener/opencli/registry";import{CommandExecutionError as Z}from"@jackwener/opencli/errors";import{authHeadersFragment as $}from"./in-page.js";import{dispatchEvaluateResult as b}from"./errors.js";import{SLOCK_SITE as f,SLOCK_DOMAIN as q,SLOCK_HOME_URL as x,SLOCK_API_BASE as Q}from"./shared.js";X({site:f,name:"unread-summary",access:"read",description:"Global unread counts across every server you belong to.",domain:q,strategy:Y.COOKIE,browser:!0,siteSession:"persistent",args:[],columns:["serverId","slug","name","unreadCount"],func:async(J)=>{await J.goto(x);const V=`
+      ${$({serverScoped:!1})}
+      const sres = await fetch('${Q}/servers/', { credentials:'include', headers });
+      if (sres.status === 401) return { kind: 'auth', detail: '/servers/ returned 401' };
+      if (!sres.ok) return { kind: 'http', status: sres.status, where:'/servers/' };
+      const servers = await sres.json();
+      const ures = await fetch('${Q}/servers/unread-summary', { credentials:'include', headers });
+      if (ures.status === 401) return { kind: 'auth', detail: '/servers/unread-summary returned 401' };
+      if (!ures.ok) return { kind: 'http', status: ures.status, where:'/servers/unread-summary' };
+      const summary = await ures.json();
+      const byId = {};
+      (Array.isArray(servers) ? servers : []).forEach((s) => { if (s && s.id) byId[s.id] = s; });
+      const rows = (Array.isArray(summary) ? summary : []).map((u) => {
+        const s = byId[u.serverId] || {};
+        return { serverId: u.serverId, slug: s.slug || '', name: s.name || '', unreadCount: u.unreadCount || 0 };
+      });
+      return { kind: 'ok', rows };
+    `,W=await J.evaluate(`(async () => { ${V} })()`),z=b(W);if(!Array.isArray(z))throw new Z(`expected array of summary rows, got ${typeof z} (contract drift?)`);return z}});

package/clis/slock/whoami.js

@@ -0,0 +1 @@
+import{registerSiteAuthCommands as e}from"../_shared/site-auth.js";import{SLOCK_SITE as o,SLOCK_DOMAIN as r,SLOCK_HOME_URL as m}from"./shared.js";import{verifySlockSession as s}from"./auth-verify.js";e({site:o,domain:r,loginUrl:m,verify:(i)=>s(i),columns:["id","name","email"]});

package/clis/smzdm/search.js

@@ -0,0 +1,71 @@
+import{cli as O,Strategy as P}from"@jackwener/opencli/registry";import{ArgumentError as D,CommandExecutionError as Q}from"@jackwener/opencli/errors";function F(f){if(f&&!Array.isArray(f)&&typeof f==="object"&&"session"in f&&"data"in f)return f.data;return f}function G(f){const B=F(f);if(!Array.isArray(B))throw new Q("Unexpected SMZDM search extraction payload shape; expected an array of rows.");return B}function H(f){let B;if(f==null)B=20;else if(typeof f==="number")B=f;else if(typeof f==="string"&&/^[0-9]+$/.test(f))B=Number(f);else B=NaN;if(!Number.isFinite(B)||!Number.isInteger(B))throw new D(`--limit must be an integer between 1 and 100, got ${JSON.stringify(f)}`);if(B<1||B>100)throw new D(`--limit must be between 1 and 100, got ${B}`);return B}function I(f){return`
+      (() => {
+        const limit = ${f};
+        const items = document.querySelectorAll('li.feed-row-wide');
+        const results = [];
+        const normalizeCount = (text) => {
+          const raw = (text || '').replace(/,/g, '').trim();
+          const match = raw.match(/(\\d+(?:\\.\\d+)?)\\s*([万kK]?)/);
+          if (!match) return 0;
+          const base = Number(match[1]);
+          if (!Number.isFinite(base)) return 0;
+          const unit = match[2];
+          if (unit === '万') return Math.round(base * 10000);
+          if (unit === 'k' || unit === 'K') return Math.round(base * 1000);
+          return Math.round(base);
+        };
+        const intFrom = (el) => {
+          if (!el) return 0;
+          return normalizeCount(el.textContent || '');
+        };
+        const trustedSmzdmUrl = (raw) => {
+          const text = (raw || '').trim();
+          if (!text) return '';
+          let url;
+          try {
+            url = text.startsWith('/')
+              ? new URL(text, 'https://www.smzdm.com')
+              : new URL(text, location.href);
+          } catch {
+            return '';
+          }
+          const hostname = url.hostname.toLowerCase();
+          if (url.protocol !== 'https:' || (hostname !== 'www.smzdm.com' && hostname !== 'post.smzdm.com')) {
+            return '';
+          }
+          return url.toString();
+        };
+        items.forEach((li) => {
+          if (results.length >= limit) return;
+          const titleEl = li.querySelector('h5.feed-block-title > a')
+                       || li.querySelector('h5 > a');
+          if (!titleEl) return;
+          const title = (titleEl.getAttribute('title') || titleEl.textContent || '').trim();
+          const url = trustedSmzdmUrl(titleEl.getAttribute('href') || titleEl.href || '');
+          if (!title || !url) return;
+          const priceEl = li.querySelector('.z-highlight');
+          const price = priceEl ? priceEl.textContent.trim() : '';
+          let mall = '';
+          const mallEl = li.querySelector('.z-feed-foot-r .feed-block-extras span')
+                      || li.querySelector('.z-feed-foot-r span');
+          if (mallEl) mall = mallEl.textContent.trim();
+          // Update time lives as the direct text node(s) of .feed-block-extras,
+          // alongside the nested mall <span> which we exclude here.
+          let updated_at = '';
+          const extrasEl = li.querySelector('.z-feed-foot-r .feed-block-extras');
+          if (extrasEl) {
+            updated_at = Array.from(extrasEl.childNodes)
+              .filter((node) => node.nodeType === 3)
+              .map((node) => (node.textContent || '').trim())
+              .filter(Boolean)
+              .join(' ');
+          }
+          const zhi_count = intFrom(li.querySelector('.price-btn-up .unvoted-wrap span'));
+          const buzhi_count = intFrom(li.querySelector('.price-btn-down .unvoted-wrap span'));
+          const favorite_count = intFrom(li.querySelector('.feed-btn-fav span'));
+          const comments = intFrom(li.querySelector('.feed-btn-comment'));
+          results.push({ rank: results.length + 1, title, price, mall, updated_at, zhi_count, buzhi_count, favorite_count, comments, url });
+        });
+        return results;
+      })()
+    `}export const smzdmSearchCommand=O({site:"smzdm",name:"search",access:"read",description:"什么值得买搜索好价",domain:"www.smzdm.com",strategy:P.COOKIE,args:[{name:"query",required:!0,positional:!0,help:"Search keyword"},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["rank","title","price","mall","updated_at","zhi_count","buzhi_count","favorite_count","comments","url"],func:async(f,B)=>{const K=encodeURIComponent(B.query),M=H(B.limit);await f.goto(`https://search.smzdm.com/?c=home&s=${K}&v=b`);return G(await f.evaluate(I(M)))}}),__test__={buildSmzdmSearchJs:I,parseLimit:H,requireSearchRows:G,unwrapEvaluateResult:F};

package/clis/sohu/article.js

@@ -0,0 +1 @@
+import{CliError as $,CommandExecutionError as v}from"@jackwener/opencli/errors";import{cli as N,Strategy as b}from"@jackwener/opencli/registry";import{publishArticle as f,gotoWritePage as P}from"../_shared/article/publish.js";import{SOHU_MPBP_HEADERS_JS as R}from"./mpbp.js";function k(){const Q="0123456789abcdef";let K="";for(let z=0;z<32;z++)K+=Q[Math.floor(Math.random()*Q.length)];return K}export const sohuProfile={home:"https://mp.sohu.com/mpfe/v3/main/first/page?newsType=1",outputFormat:"html",preprocessConfig:{},checkAuth:async(Q)=>{try{const z=await(await fetch("https://mp.sohu.com/mpbp/bp/account/list?_="+Date.now(),{method:"GET",credentials:"include"})).json();if(z.code!==2000000||!z.data?.data?.length)return{isAuthenticated:!1};const L=[];for(const V of z.data.data)if(V.accounts)L.push(...V.accounts);if(!L.length)return{isAuthenticated:!1};const G=L[0],X=L.length>1?G.nickName+"（共"+L.length+"个子账号）":G.nickName;return{isAuthenticated:!0,userId:String(G.id),username:X,avatar:G.avatar||""}}catch(K){return{isAuthenticated:!1,error:String(K&&K.message||K)}}},image:{skip:["sohu.com"],uploadFn:async(Q,K)=>{const L=await(await fetch("https://mp.sohu.com/mpbp/bp/account/list?_="+Date.now(),{method:"GET",credentials:"include"})).json();if(L.code!==2000000||!L.data?.data?.length)throw Error("获取搜狐账号信息失败，请确认已登录搜狐号");const G=[];for(const H of L.data.data)if(H.accounts)G.push(...H.accounts);if(!G.length)throw Error("搜狐号子账号列表为空");const X=String(G[0].id),V=await fetch(Q,{credentials:"omit"});if(!V.ok)throw Error("图片下载失败（"+V.status+"）："+Q);const Y=await V.blob(),M=new FormData;M.append("file",Y,"image.jpg");M.append("accountId",X);const W=await(await fetch("https://mp.sohu.com/commons/front/outerUpload/image/file?accountId="+X,{method:"POST",credentials:"include",body:M})).json();if(!W.url)throw Error("搜狐图片上传失败："+(W.msg||JSON.stringify(W).slice(0,100)));return{url:W.url}}},publish:async(Q,K)=>{const z=Q.params||{},L=await fetch("https://mp.sohu.com/mpbp/bp/account/list?_="+Date.now(),{method:"GET",credentials:"include"}),G=await L.json();if(G.code!==2000000||!G.data?.data?.length)return{ok:!1,stage:"auth",status:L.status,message:"获取搜狐账号信息失败，请确认已登录搜狐号"};const X=[];for(const F of G.data.data)if(F.accounts)X.push(...F.accounts);if(!X.length)return{ok:!1,stage:"auth",status:0,message:"搜狐号子账号列表为空"};const V=Number(X[0].id),Y="0123456789abcdef";let M="";for(let F=0;F<32;F++)M+=Y[Math.floor(Math.random()*Y.length)];const B="100-"+Date.now()+"-"+M,W=Number(z.channelId);if(!Number.isFinite(W)||W<=0)return{ok:!1,stage:"params",status:0,message:"缺少合法 channelId（频道 id），请先用 `sohu channels` 取值"};const H=z.categoryId==null||z.categoryId===""?-1:Number(z.categoryId),_={title:Q.title,brief:typeof z.brief==="string"?z.brief:"",content:Q.content,channelId:W,categoryId:H,id:0,userColumnId:z.userColumnId==null||z.userColumnId==-1?0:Number(z.userColumnId),columnNewsIds:Array.isArray(z.columnNewsIds)?z.columnNewsIds:[],businessCode:0,declareOriginal:Boolean(z.declareOriginal),cover:typeof z.cover==="string"?z.cover:"",topicIds:Array.isArray(z.topicIds)?z.topicIds:[],isAd:0,userLabels:"[]",reprint:!1,customTags:typeof z.customTags==="string"?z.customTags:"",infoResource:0,sourceUrl:"",visibleToLoginedUsers:0,attrIds:Array.isArray(z.attrIds)?z.attrIds:[],accountId:V};if(Q.draftOnly){const F=Object.assign({},_,{auto:!0}),q=await fetch("https://mp.sohu.com/mpbp/bp/news/v4/news/draft/v2?accountId="+V,{method:"POST",credentials:"include",headers:{"Content-Type":"application/json","X-Requested-With":"XMLHttpRequest","dv-id":M,"sp-cm":B},body:JSON.stringify(F)}),x=await q.text();let D=null;try{D=JSON.parse(x)}catch(i){}if(!q.ok||!D||!D.success)return{ok:!1,stage:"draft",status:q.status,message:D&&D.msg||x.slice(0,300)};const A=String(D.data),E="https://mp.sohu.com/mpfe/v4/contentManagement/news/addarticle?spm=smmp.articlelist.0.0&contentStatus=2&id="+A;return{ok:!0,id:A,url:E,draft:!0}}const U=await fetch("https://mp.sohu.com/mpbp/bp/news/v4/news/publish/v2?accountId="+V,{method:"POST",credentials:"include",headers:{"Content-Type":"application/json","X-Requested-With":"XMLHttpRequest","dv-id":M,"sp-cm":B},body:JSON.stringify(_)}),S=await U.text();let Z=null;try{Z=JSON.parse(S)}catch(F){}if(!U.ok||!Z||Z.code!==2000000){let F=Z&&(Z.msg||Z.message)||"";if(!F){const q=[];if(H!==-1)q.push("--category");if(Array.isArray(z.topicIds)&&z.topicIds.length>0)q.push("--topics");if(_.cover)q.push("--cover");F="搜狐发布接口返回非 JSON 错误页（HTTP "+U.status+"）。"+(q.length?"实测该 500 多由可选参数触发——去掉 "+q.join(" / ")+"、只保留必填 --channel 重试即可。":"稍后重试；若持续失败，用 `sohu stats` 确认是否已产生重复内容。")}return{ok:!1,stage:"publish",status:U.status,message:F}}if(Z.data!=null&&Object.prototype.toString.call(Z.data)==="[object Object]")return{ok:!1,stage:"origin_check",status:U.status,message:"声明原创触发了原创校验（需在搜狐后台完成原创确认）："+JSON.stringify(Z.data).slice(0,200)};const J=String(Z.data),T="https://mp.sohu.com/mpfe/v4/contentManagement/news/addarticle?spm=smmp.articlelist.0.0&contentStatus=1&id="+J;return{ok:!0,id:J,url:T,draft:!1}}},sohuAuthProfile={home:sohuProfile.home,checkAuth:sohuProfile.checkAuth};function y(Q){if(!Q.execute)throw new $("INVALID_INPUT","此命令需要 --execute 才会真正写入。注意：本报错仅表示缺少 --execute，并未校验其余参数，不能当 dry-run 预览用")}async function j(Q){const K=typeof Q.text==="string"?Q.text:void 0,z=typeof Q.file==="string"?Q.file:void 0;if(K&&z)throw new $("INVALID_INPUT","text 和 --file 只能二选一");let L=K??"";if(z){const{readFile:G,stat:X}=await import("node:fs/promises");let V;try{V=await X(z)}catch{throw new $("INVALID_INPUT","文件不存在："+z)}if(!V.isFile())throw new $("INVALID_INPUT","路径不是可读文本文件："+z);let Y;try{Y=await G(z)}catch{throw new $("INVALID_INPUT","文件读取失败："+z)}try{L=new TextDecoder("utf-8",{fatal:!0}).decode(Y)}catch{throw new $("INVALID_INPUT","文件不是合法 UTF-8 编码："+z)}}if(!L.trim())throw new $("INVALID_INPUT","正文不能为空");return L}function C(Q,K,z,L,G={}){return[{status:"success",outcome:L,message:Q,target_type:K,target:z,...G}]}async function O(Q,K,z){const L="(async () => {try {"+R+"const r = await fetch("+JSON.stringify(K)+', { method: "GET", credentials: "include", headers: HDRS });const t = await r.text();let j = null; try { j = JSON.parse(t); } catch (e) {}return { ok: r.ok, status: r.status, json: j, text: t.slice(0, 300) };} catch (e) { return { ok: false, status: 0, json: null, text: String((e && e.message) || e) }; }})()',G=await Q.evaluate(L);if(!G||!G.ok||!G.json)throw new $("INVALID_INPUT","搜狐"+z+"接口请求失败（HTTP "+(G?G.status:"?")+"）："+(G?G.text:""));if(G.json.success===!1||G.json.code!=null&&G.json.code!==2000000&&G.json.code!==2000)throw new $("INVALID_INPUT","搜狐"+z+"接口返回错误："+(G.json.msg||G.json.message||"未登录或无权限"));return G.json}async function m(Q){const K=await O(Q,"https://mp.sohu.com/mpbp/bp/account/list?_="+Date.now(),"账号列表"),z=K.data&&K.data.data||[],L=[];for(const G of z)if(G.accounts)L.push(...G.accounts);if(!L.length)throw new $("INVALID_INPUT","搜狐号子账号列表为空，请确认已登录搜狐号");return String(L[0].id)}async function I(Q,K,z){const L=await O(Q,"https://mp.sohu.com/mpbp/bp/account/common/channels-data-api?status=1&accountId="+encodeURIComponent(K),"频道列举"),G=Array.isArray(L)?L:L.data||[],X=G.find((V)=>String(V.name)===String(z));if(!X)throw new $("INVALID_INPUT","未找到频道「"+z+"」，可选："+(G.map((V)=>V.name).join(" / ")||"（空）")+"。用 `sohu channels` 查看完整列表。");return Number(X.id!=null?X.id:X.channelId)}async function h(Q,K,z,L){const G=await O(Q,"https://mp.sohu.com/mpbp/bp/account/common/channels/"+z+"/categories?accountId="+encodeURIComponent(K),"分类列举"),X=Array.isArray(G)?G:G.data||[],V=X.find((Y)=>String(Y.name)===String(L));if(!V)throw new $("INVALID_INPUT","频道（id="+z+"）下未找到分类「"+L+"」，可选："+(X.map((Y)=>Y.name).join(" / ")||"（该频道无分类）")+"。用 `sohu categories --channel <频道名>` 查看。");return Number(V.id)}async function w(Q,K,z){const L=await O(Q,"https://mp.sohu.com/mpbp/bp/account/column/v2/list?accountId="+encodeURIComponent(K)+"&page=1&size=100","专栏列举"),G=Array.isArray(L)?L:L.data&&(L.data.data||L.data)||L.data||[],X=Array.isArray(G)?G:[],V=X.find((Y)=>String(Y.name)===String(z));if(!V)throw new $("INVALID_INPUT","未找到专栏「"+z+"」，可选："+(X.map((Y)=>Y.name).join(" / ")||"（你还没有任何专栏）")+"。用 `sohu columns` 查看。");return Number(V.id)}async function d(Q,K,z){const L=z.split(",").map((X)=>X.trim()).filter(Boolean);if(!L.length)return[];const G=[];for(const X of L){const V=await O(Q,"https://mp.sohu.com/mpbp/bp/news/v4/label/topic/search?accountId="+K+"&keyword="+encodeURIComponent(X),"话题搜索"),M=(Array.isArray(V)?V:V.data||[]).find((B)=>String(B.name)===String(X));if(!M)throw new $("INVALID_INPUT","未找到话题「"+X+"」，请用 `sohu topics --keyword "+X+"` 搜索确认确切名称。");G.push(M.id)}return G}N({site:"sohu",name:"article",access:"write",description:"发布文章到搜狐号（HTML 格式，外链图片自动转存到搜狐图床）。默认正式发布，加 --draft 仅存草稿。频道必填，合法值用 `sohu channels` 取。",domain:"mp.sohu.com",strategy:b.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题"},{name:"text",positional:!0,help:"文章正文（默认 Markdown，传 --html 则视为 HTML）"},{name:"file",help:"正文文件路径（UTF-8，Markdown 或 HTML）"},{name:"html",type:"boolean",help:"将正文视为原始 HTML 而非 Markdown"},{name:"channel",help:"频道名（精确匹配，必填），合法值用 `sohu channels` 列举"},{name:"category",help:"分类名（精确匹配，依赖所选频道），合法值用 `sohu categories --channel <频道名>` 列举；不传=不限"},{name:"column",help:"专栏名（精确匹配），合法值用 `sohu columns` 列举；不传=不归属专栏"},{name:"topics",help:"话题名，逗号分隔（每个精确匹配），用 `sohu topics` 搜索取确切名"},{name:"cover",help:"封面图 URL（须为搜狐图床地址）；可空"},{name:"brief",help:"文章摘要；可空"},{name:"declare-original",type:"boolean",help:"声明原创（会触发搜狐原创校验，发布将被拦到原创确认流程）"},{name:"draft",type:"boolean",help:"仅保存草稿，不正式发布"},{name:"execute",type:"boolean",help:"实际执行写入操作；不加此参数则拒绝写入（干跑保护）"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(Q,K)=>{if(!Q)throw new v("搜狐号文章发布需要浏览器会话");y(K);const z=String(K.title??"").trim();if(!z)throw new $("INVALID_INPUT","文章标题不能为空");const L=await j(K),G=Boolean(K.draft),X=typeof K.channel==="string"?K.channel.trim():"";if(!X)throw new $("INVALID_INPUT","缺少 --channel（频道名）。请先运行 `sohu channels` 取合法频道名再传入，不提供默认值。");await P(Q,sohuProfile.home);const V=await m(Q),Y=await I(Q,V,X);let M=-1;const B=typeof K.category==="string"?K.category.trim():"";if(B)M=await h(Q,V,Y,B);let W=0;const H=typeof K.column==="string"?K.column.trim():"";if(H)W=await w(Q,V,H);let _=[];const U=typeof K.topics==="string"?K.topics.trim():"";if(U)_=await d(Q,V,U);const S={channelId:Y,categoryId:M,userColumnId:W,topicIds:_,cover:typeof K.cover==="string"?K.cover.trim():"",brief:typeof K.brief==="string"?K.brief:"",declareOriginal:Boolean(K["declare-original"])},Z=await f(Q,{title:z,body:L,format:K.html?"html":"markdown",draftOnly:G,profile:sohuProfile,publishParams:S}),J=Z.images.uploaded.length|0,T=Z.images.failed.length|0;let F=Z.draft?"已保存搜狐号草稿":"已正式发布到搜狐号";if(J||T)F+=`；图片：${J} 张已转存${T?`，${T} 张失败`:""}`;return C(F,"article","",Z.draft?"draft":"created",{created_target:(Z.draft?"draft:":"article:")+Z.id,created_url:Z.url})}});export const __test__={sohuProfile,requireExecute:y,buildResultRow:C,resolvePayload:j,generateDeviceId:k};

package/clis/sohu/attributes.js

@@ -0,0 +1 @@
+import{cli as z,Strategy as A}from"@jackwener/opencli/registry";import{CommandExecutionError as B}from"@jackwener/opencli/errors";import{gotoWritePage as D}from"../_shared/article/publish.js";import{sohuProfile as F}from"./article.js";z({site:"sohu",name:"attributes",access:"read",description:"列出搜狐号文章属性候选（id + 名称），供发布时选择文章属性。",domain:"mp.sohu.com",strategy:A.COOKIE,browser:!0,columns:["attr_id","attr_name"],func:async(q)=>{if(!q)throw new B("搜狐号文章属性列举需要浏览器会话");await D(q,F.home);const v=await q.evaluate("(async () => {const r = await fetch('https://mp.sohu.com/mpbp/bp/news/v4/news/attribute', { method: 'GET', credentials: 'include' });const j = await r.json();"+"if (!j || j.success === false) throw new Error('文章属性列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const raw = (j && j.data) || [];const list = Array.isArray(raw) ? raw : (Array.isArray(raw.data) ? raw.data : []);return list.map(a => ({ attr_id: String(a.id), attr_name: a.name || a.attrName || '' }));})()");return Array.isArray(v)?v:[]}});

package/clis/sohu/categories.js

@@ -0,0 +1 @@
+import{cli as G,Strategy as K}from"@jackwener/opencli/registry";import{CliError as L,CommandExecutionError as Q}from"@jackwener/opencli/errors";import{gotoWritePage as T}from"../_shared/article/publish.js";import{sohuProfile as V}from"./article.js";import{SOHU_MPBP_HEADERS_JS as X}from"./mpbp.js";G({site:"sohu",name:"categories",access:"read",description:"列出某个搜狐号频道下的分类（id + 名称），供 `sohu article --category` 取合法分类名。须用 --channel 指定频道名。",domain:"mp.sohu.com",strategy:K.COOKIE,browser:!0,args:[{name:"channel",required:!0,help:"频道名（精确匹配），合法值用 `sohu channels` 列举"}],columns:["category_id","category_name"],func:async(q,F)=>{if(!q)throw new Q("搜狐号分类列举需要浏览器会话");const v=String(F.channel??"").trim();if(!v)throw new L("INVALID_INPUT","请用 --channel 指定频道名");await T(q,V.home);const z=await q.evaluate("(async () => {"+X+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const cr = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels-data-api?status=1&accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const cj = await cr.json();"+"if (!cj || cj.success === false) throw new Error('频道列举失败：' + ((cj && cj.msg) || '未登录或无权限'));"+"const channels = Array.isArray(cj) ? cj : ((cj && cj.data) || []);const ch = channels.find(c => String(c.name) === "+JSON.stringify(v)+");"+"if (!ch) throw new Error('未找到频道「"+v.replace(/"/g,"\\\"")+"」，可选：' + (channels.map(c => c.name).join(' / ') || '（空）'));"+"const channelId = ch.id != null ? ch.id : ch.channelId;const r = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels/' + channelId + '/categories?accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('分类列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(c => ({ category_id: String(c.id), category_name: c.name || '' }));})()");return Array.isArray(z)?z:[]}});

package/clis/sohu/channels.js

@@ -0,0 +1 @@
+import{cli as z,Strategy as F}from"@jackwener/opencli/registry";import{CommandExecutionError as G}from"@jackwener/opencli/errors";import{gotoWritePage as I}from"../_shared/article/publish.js";import{sohuProfile as K}from"./article.js";import{SOHU_MPBP_HEADERS_JS as L}from"./mpbp.js";z({site:"sohu",name:"channels",access:"read",description:"列出当前搜狐号可发布的频道（id + 名称），供 `sohu article --channel` 取合法频道名。",domain:"mp.sohu.com",strategy:F.COOKIE,browser:!0,columns:["channel_id","channel_name"],func:async(q)=>{if(!q)throw new G("搜狐号频道列举需要浏览器会话");await I(q,K.home);const v=await q.evaluate("(async () => {"+L+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const r = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels-data-api?status=1&accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('频道列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(c => ({ channel_id: String(c.id != null ? c.id : c.channelId), channel_name: c.name || '' }));})()");return Array.isArray(v)?v:[]}});

package/clis/sohu/columns.js

@@ -0,0 +1 @@
+import{cli as z,Strategy as F}from"@jackwener/opencli/registry";import{CommandExecutionError as G}from"@jackwener/opencli/errors";import{gotoWritePage as I}from"../_shared/article/publish.js";import{sohuProfile as K}from"./article.js";import{SOHU_MPBP_HEADERS_JS as L}from"./mpbp.js";z({site:"sohu",name:"columns",access:"read",description:"列出当前搜狐号的专栏（id + 名称），供 `sohu article --column` 取合法专栏名。",domain:"mp.sohu.com",strategy:F.COOKIE,browser:!0,columns:["column_id","column_name"],func:async(q)=>{if(!q)throw new G("搜狐号专栏列举需要浏览器会话");await I(q,K.home);const v=await q.evaluate("(async () => {"+L+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const r = await fetch('https://mp.sohu.com/mpbp/bp/account/column/v2/list?accountId=' + accountId + '&page=1&size=100', { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('专栏列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const raw = Array.isArray(j) ? j : ((j && j.data) || []);const list = Array.isArray(raw) ? raw : (Array.isArray(raw.data) ? raw.data : []);return list.map(c => ({ column_id: String(c.id), column_name: c.name || '' }));})()");return Array.isArray(v)?v:[]}});

package/clis/sohu/login.js

@@ -0,0 +1 @@
+import{registerArticleLogin as k}from"../_shared/article/login.js";import{sohuAuthProfile as b}from"./article.js";k({site:"sohu",domain:"mp.sohu.com",profile:{home:b.home,checkAuth:b.checkAuth},loginDescription:"打开搜狐号登录页并等待浏览器完成登录（供桌面客户端引导登录）。"});

package/clis/sohu/mpbp.js

@@ -0,0 +1 @@
+export const SOHU_MPBP_HEADERS_JS="let __dvId = '', __spCm = '';try { __dvId = localStorage.getItem('preview-dv-id') || ''; __spCm = localStorage.getItem('preview-sp-cm') || ''; } catch (e) {}if (!__dvId || !__spCm) {  const __chars = '0123456789abcdef'; let __gen = '';  for (let __i = 0; __i < 32; __i++) __gen += __chars[Math.floor(Math.random() * 16)];  if (!__dvId) __dvId = __gen;  if (!__spCm) __spCm = '100-' + Date.now() + '-' + __gen;}const HDRS = { 'X-Requested-With': 'XMLHttpRequest', 'dv-id': __dvId, 'sp-cm': __spCm };";

package/clis/sohu/stats.js

@@ -0,0 +1,95 @@
+import{cli as A,Strategy as C}from"@jackwener/opencli/registry";import{CommandExecutionError as L,EmptyResultError as G}from"@jackwener/opencli/errors";import{gotoWritePage as P}from"../_shared/article/publish.js";const T="https://mp.sohu.com/mpfe/v4/contentManagement/news/articlelist",_=10;function R(M){if(!M)return"";const F=new Date(M+28800000),J=(Q)=>String(Q).padStart(2,"0");return`${F.getUTCFullYear()}-${J(F.getUTCMonth()+1)}-${J(F.getUTCDate())} ${J(F.getUTCHours())}:${J(F.getUTCMinutes())}`}function W(M){const F=new Date(Date.now()+28800000-M*86400000),J=(Q)=>String(Q).padStart(2,"0");return`${F.getUTCFullYear()}-${J(F.getUTCMonth()+1)}-${J(F.getUTCDate())}`}A({site:"sohu",name:"stats",access:"read",description:"搜狐号文章数据（每篇阅读/评论/播放等全量运营指标；点赞/分享/投票仅覆盖最近30天已发布内容）",domain:"mp.sohu.com",strategy:C.COOKIE,browser:!0,args:[{name:"limit",type:"number",default:20,help:"返回条数"}],columns:["id","type","title","url","published_at","status","views","likes","comments","collects","shares","video_plays","votes","extra"],func:async(M,F)=>{if(!M)throw new L("搜狐号文章数据需要浏览器会话");const J=Number(F.limit)>0?Math.floor(Number(F.limit)):20;await P(M,T);const Q={limit:J,pageSize:_,startDate:W(30),endDate:W(0)},H=await M.evaluate(`(async () => {
+            const P = ${JSON.stringify(Q)};
+
+            // ── 请求头：dv-id / sp-cm 优先取页面自己存的值，逐字复刻 ──
+            let dvId = '', spCm = '';
+            try {
+                dvId = localStorage.getItem('preview-dv-id') || '';
+                spCm = localStorage.getItem('preview-sp-cm') || '';
+            } catch (e) {}
+            if (!dvId || !spCm) {
+                const chars = '0123456789abcdef';
+                let gen = '';
+                for (let i = 0; i < 32; i++) gen += chars[Math.floor(Math.random() * chars.length)];
+                if (!dvId) dvId = gen;
+                if (!spCm) spCm = '100-' + Date.now() + '-' + gen;
+            }
+            const HDRS = { 'X-Requested-With': 'XMLHttpRequest', 'dv-id': dvId, 'sp-cm': spCm };
+
+            const getJson = async (url) => {
+                const r = await fetch(url, { method: 'GET', credentials: 'include', headers: HDRS });
+                const t = await r.text();
+                let j = null;
+                try { j = JSON.parse(t); } catch (e) {}
+                if (!r.ok || !j || j.success === false || (j.code != null && j.code !== 2000000)) {
+                    throw new Error('HTTP ' + r.status + ' ' + ((j && (j.msg || j.message)) || t.slice(0, 150)));
+                }
+                return j;
+            };
+
+            // ── accountId（与 article.js checkAuth 同一接口）──
+            let accountId = '';
+            try {
+                const auth = await getJson('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now());
+                const accounts = [];
+                for (const g of (auth.data && auth.data.data) || []) {
+                    if (g.accounts) accounts.push(...g.accounts);
+                }
+                if (!accounts.length) return { err: '搜狐号子账号列表为空，请确认已登录搜狐号' };
+                accountId = String(accounts[0].id);
+            } catch (e) {
+                return { err: '获取搜狐账号信息失败（可能未登录搜狐号）：' + String((e && e.message) || e) };
+            }
+
+            // ── 内容列表：statusType=1（全部），按页面原样 psize=10 翻页 ──
+            const listUrl = (statusType, pno) =>
+                'https://mp.sohu.com/mpbp/bp/news/v4/users/news?psize=' + P.pageSize
+                + '&newsType=0&statusType=' + statusType + '&columnId=&pno=' + pno
+                + '&streamId=&accountId=' + accountId + '&_=' + Date.now();
+            const news = [];
+            let total = 0;
+            try {
+                for (let pno = 1; news.length < P.limit; pno++) {
+                    const j = await getJson(listUrl(1, pno));
+                    const rows = (j.data && j.data.news) || [];
+                    total = (j.data && j.data.totalCount) || total;
+                    news.push(...rows);
+                    if (!rows.length || news.length >= total) break;
+                }
+            } catch (e) {
+                return { err: '搜狐号内容列表接口请求失败：' + String((e && e.message) || e) };
+            }
+
+            // ── 已发布集合：statusType=2（「已发布」tab，同样为观测值）──
+            const publishedIds = [];
+            try {
+                for (let pno = 1; ; pno++) {
+                    const j = await getJson(listUrl(2, pno));
+                    const rows = (j.data && j.data.news) || [];
+                    for (const r of rows) publishedIds.push(String(r.id));
+                    const tc = (j.data && j.data.totalCount) || 0;
+                    if (!rows.length || publishedIds.length >= tc || pno >= 20) break;
+                }
+            } catch (e) { /* 已发布集合仅用于 status 标注，失败不阻断（下方 status 回落为空） */ }
+
+            // ── 单篇统计（最近30天，实时）：{data:{news:[...], totalCount}} ──
+            const statRows = [];
+            let statError = '';
+            try {
+                for (let pg = 1; pg <= 20; pg++) {
+                    const j = await getJson(
+                        'https://mp.sohu.com/mpbp/bp/news/v4/users/stat/single/list?page=' + pg
+                        + '&type=0&startDate=' + P.startDate + '&endDate=' + P.endDate
+                        + '&accountId=' + accountId,
+                    );
+                    const rows = (j.data && j.data.news) || [];
+                    statRows.push(...rows);
+                    const tc = (j.data && j.data.totalCount) || 0;
+                    if (!rows.length || statRows.length >= tc) break;
+                }
+            } catch (e) {
+                statError = String((e && e.message) || e);
+            }
+
+            return { accountId, news: news.slice(0, P.limit), totalCount: total, publishedIds, statRows, statError };
+        })()`);if(!H||H.err)throw new L(H&&H.err||"搜狐号文章数据获取失败：页面未返回任何数据（请确认已登录 mp.sohu.com）");const V=Array.isArray(H.news)?H.news:[];if(!V.length)throw new G("sohu stats","该搜狐号名下没有任何内容（或列表接口返回为空）。请先在 mp.sohu.com 发布内容后再查数据。");const X=new Map,Y=new Map;for(const q of Array.isArray(H.statRows)?H.statRows:[]){if(q&&q.id!=null)X.set(String(q.id),q);if(q&&typeof q.title==="string"&&q.title)Y.set(q.title,q)}const U=(q,O)=>{if(!q)return"";for(const K of O)if(typeof q[K]==="number")return q[K];return""},Z=new Set(Array.isArray(H.publishedIds)?H.publishedIds:[]);return V.map((q)=>{const O=q.id!=null?String(q.id):"",K=X.get(O)||Y.get(q.title||"")||null,$=Z.has(O),z={};if(q.auditStatus!=null)z.audit_status=q.auditStatus;if(q.status!=null)z.status_raw=q.status;if(q.rejectReason)z.reject_reason=q.rejectReason;if(q.original!=null)z.original=q.original;if(q.star!=null)z.star=q.star;if(q.secureScore!=null)z.secure_score=q.secureScore;if(q.channelId!=null)z.channel_id=q.channelId;if(q.modifiedTime)z.modified_at=R(q.modifiedTime);if(q.brief)z.brief=String(q.brief).slice(0,80);if(K)z.stat=K;if(H.statError)z.stat_error="单篇统计接口失败："+H.statError;return{id:O,type:q.type!=null?String(q.type):"",title:q.title||q.mobileTitle||"",url:O?"https://mp.sohu.com/mpfe/v4/contentManagement/news/addarticle?spm=smmp.articlelist.0.0&contentStatus="+($?1:2)+"&id="+O:"",published_at:R(q.postTime||q.createdTime),status:$?"已发布":"未发布",views:typeof q.pv==="number"?q.pv:"",likes:U(K,["digg","diggCount","like","likeCount","praise","zan"]),comments:typeof q.cmt==="number"?q.cmt:U(K,["cmt","comment","commentCount"]),collects:"",shares:U(K,["share","shareCount","forward","forwardCount"]),video_plays:typeof q.videoPlayPv==="number"?q.videoPlayPv:"",votes:U(K,["vote","voteCount"]),extra:Object.keys(z).length?JSON.stringify(z):""}})}});

package/clis/sohu/topics.js

@@ -0,0 +1 @@
+import{cli as G,Strategy as I}from"@jackwener/opencli/registry";import{CommandExecutionError as K}from"@jackwener/opencli/errors";import{gotoWritePage as L}from"../_shared/article/publish.js";import{sohuProfile as N}from"./article.js";import{SOHU_MPBP_HEADERS_JS as Q}from"./mpbp.js";G({site:"sohu",name:"topics",access:"read",description:"列举/搜索搜狐号话题（id + 名称 + 类型），供 `sohu article --topics` 取确切话题名。不传 --keyword 为推荐话题，传则按关键词搜索。",domain:"mp.sohu.com",strategy:I.COOKIE,browser:!0,args:[{name:"keyword",help:"搜索关键词；不传则返回推荐话题列表"}],columns:["topic_id","topic_name","topic_type"],func:async(q,v)=>{if(!q)throw new K("搜狐号话题列举需要浏览器会话");const F=typeof v.keyword==="string"?v.keyword.trim():"";await L(q,N.home);const z=await q.evaluate("(async () => {"+Q+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const kw = "+JSON.stringify(F)+";const url = kw  ? 'https://mp.sohu.com/mpbp/bp/news/v4/label/topic/search?accountId=' + accountId + '&keyword=' + encodeURIComponent(kw)  : 'https://mp.sohu.com/mpbp/bp/news/v4/label/topic/list?accountId=' + accountId;const r = await fetch(url, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('话题接口失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(t => ({ topic_id: String(t.id), topic_name: t.name || '', topic_type: t.type != null ? String(t.type) : '' }));})()");return Array.isArray(z)?z:[]}});

package/clis/sohu/whoami.js

@@ -0,0 +1 @@
+import{cli as q,Strategy as v}from"@jackwener/opencli/registry";import{checkLogin as x,cookieQuickCheck as z}from"../_shared/article/auth.js";import{sohuAuthProfile as B}from"./article.js";q({site:"sohu",name:"whoami",access:"read",description:"查看当前搜狐号登录账号信息（用户名、用户 ID）。",domain:"mp.sohu.com",strategy:v.COOKIE,browser:!0,columns:["logged_in","user_id","username"],authStatus:{quickCheck:z("https://mp.sohu.com",["pprdig"])},func:async(m)=>{const b=await x(m,B);return[{logged_in:b.isAuthenticated,user_id:b.userId||"",username:b.username||""}]}});

package/clis/spotify/spotify.js

@@ -0,0 +1 @@
+import{cli as X,Strategy as Y}from"@jackwener/opencli/registry";import{CliError as Z}from"@jackwener/opencli/errors";import{readFileSync as q,writeFileSync as j,mkdirSync as R,existsSync as f}from"fs";import{createServer as h}from"http";import{homedir as P}from"os";import{join as x}from"path";import{exec as m}from"child_process";import{assertSpotifyCredentialsConfigured as I,getFirstSpotifyTrack as v,mapSpotifyTrackResults as p,parseDotEnv as u,resolveSpotifyCredentials as C}from"./utils.js";const K=x(P(),".opencli","spotify.env");function w(){if(!f(K))return{};return u(q(K,"utf-8"))}const T=w(),O=C(T),V=O.clientId,D=O.clientSecret,U="http://127.0.0.1:8888/callback",S=["user-read-playback-state","user-modify-playback-state","user-read-currently-playing","playlist-read-private"].join(" "),F=x(P(),".opencli","spotify-tokens.json");function y(){try{return JSON.parse(q(F,"utf-8"))}catch{return null}}function L(z){R(x(P(),".opencli"),{recursive:!0});j(F,JSON.stringify(z,null,2))}async function E(z){const G=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${V}:${D}`).toString("base64")},body:new URLSearchParams({grant_type:"refresh_token",refresh_token:z})});if(!G.ok){const J=await G.json().catch(()=>({}));throw new Z("REFRESH_FAILED",J?.error_description||`Token refresh failed (${G.status})`)}const H=await G.json(),M={access_token:H.access_token,refresh_token:H.refresh_token||z,expires_at:Date.now()+H.expires_in*1000};L(M);return M.access_token}async function g(){const z=y();if(!z)throw new Z("AUTH_REQUIRED","Not authenticated. Run: opencli spotify auth");if(!z.access_token||!z.refresh_token||!(z.expires_at>0))throw new Z("AUTH_CORRUPTED","Token file is corrupted. Run: opencli spotify auth");if(Date.now()>z.expires_at-60000)return E(z.refresh_token);return z.access_token}async function Q(z,G,H){const M=await g(),J=await fetch(`https://api.spotify.com/v1${G}`,{method:z,headers:{Authorization:`Bearer ${M}`,"Content-Type":"application/json"},body:H?JSON.stringify(H):void 0});if(J.status===204||J.status===202)return null;if(!J.ok){const W=await J.json().catch(()=>({}));throw new Z("API_ERROR",W?.error?.message||`Spotify API error ${J.status}`)}return J.json()}async function N(z){const G=await Q("GET",`/search?q=${encodeURIComponent(z)}&type=track&limit=1`),H=v(G);if(!H)throw new Z("EMPTY_RESULT",`No track found for: ${z}`);return H}function d(z){const G=process.platform==="win32"?`start "" "${z}"`:process.platform==="darwin"?`open "${z}"`:`xdg-open "${z}"`;m(G)}X({site:"spotify",name:"auth",access:"write",description:"Authenticate with Spotify (OAuth — run once)",strategy:Y.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{I(O,K);return new Promise((z,G)=>{const H=h(async(J,W)=>{try{const $=new URL(J.url,"http://localhost:8888");if($.pathname!=="/callback"){W.end();return}const b=$.searchParams.get("code");if(!b){W.end("Missing code");return}const A=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${V}:${D}`).toString("base64")},body:new URLSearchParams({grant_type:"authorization_code",code:b,redirect_uri:U})});if(!A.ok){const _=await A.json().catch(()=>({}));H.close();G(new Z("AUTH_FAILED",_?.error_description||`Token exchange failed (${A.status})`));return}const B=await A.json();L({access_token:B.access_token,refresh_token:B.refresh_token,expires_at:Date.now()+B.expires_in*1000});W.writeHead(200,{"Content-Type":"text/html"});W.end("<h2>Spotify authenticated! You can close this tab.</h2>");H.close();z([{status:"Authenticated successfully"}])}catch($){H.close();G($)}});H.on("error",(J)=>{if(J.code==="EADDRINUSE")G(new Z("PORT_IN_USE","Port 8888 is already in use. Stop the other process and retry."));else G(J)});const M=setTimeout(()=>{H.close();G(new Z("AUTH_TIMEOUT","Authentication timed out after 5 minutes"))},300000);H.listen(8888,()=>{const J=`https://accounts.spotify.com/authorize?${new URLSearchParams({client_id:V,response_type:"code",redirect_uri:U,scope:S})}`;console.log("Opening browser for Spotify login...");console.log("If it does not open, visit:",J);d(J)});H.on("close",()=>clearTimeout(M))})}});X({site:"spotify",name:"status",access:"read",description:"Show current playback status",strategy:Y.PUBLIC,browser:!1,args:[],columns:["track","artist","album","status","progress"],func:async()=>{const z=await Q("GET","/me/player");if(!z||!z.item)return[{track:"Nothing playing",artist:"",album:"",status:"",progress:""}];const G=z.item;if(G.type!=="track")return[{track:G.name,artist:"",album:G.show?.name??"",status:z.is_playing?"playing":"paused",progress:""}];const H=(z.progress_ms??0)/1000|0,M=G.duration_ms/1000|0,J=(W)=>`${W/60|0}:${String(W%60).padStart(2,"0")}`;return[{track:G.name,artist:G.artists.map((W)=>W.name).join(", "),album:G.album.name,status:z.is_playing?"playing":"paused",progress:`${J(H)} / ${J(M)}`}]}});X({site:"spotify",name:"play",access:"write",description:"Resume playback or search and play a track/artist",strategy:Y.PUBLIC,browser:!1,args:[{name:"query",type:"str",default:"",positional:!0,help:"Track or artist to play (optional)"}],columns:["track","artist","status"],func:async(z)=>{if(z.query){const{uri:G,name:H,artist:M}=await N(z.query);await Q("PUT","/me/player/play",{uris:[G]});return[{track:H,artist:M,status:"playing"}]}await Q("PUT","/me/player/play");return[{track:"",artist:"",status:"resumed"}]}});X({site:"spotify",name:"pause",access:"write",description:"Pause playback",strategy:Y.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await Q("PUT","/me/player/pause");return[{status:"paused"}]}});X({site:"spotify",name:"next",access:"write",description:"Skip to next track",strategy:Y.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await Q("POST","/me/player/next");return[{status:"skipped to next"}]}});X({site:"spotify",name:"prev",access:"write",description:"Skip to previous track",strategy:Y.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await Q("POST","/me/player/previous");return[{status:"skipped to previous"}]}});X({site:"spotify",name:"volume",access:"write",description:"Set playback volume (0-100)",strategy:Y.PUBLIC,browser:!1,args:[{name:"level",type:"int",default:50,positional:!0,required:!0,help:"Volume 0–100"}],columns:["volume"],func:async(z)=>{const G=Math.round(z.level);if(G<0||G>100)throw new Z("INVALID_ARGS","Volume must be between 0 and 100");await Q("PUT",`/me/player/volume?volume_percent=${G}`);return[{volume:`${G}%`}]}});X({site:"spotify",name:"search",access:"read",description:"Search for tracks",strategy:Y.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (default: 10)"}],columns:["track","artist","album","uri"],func:async(z)=>{const G=Math.min(50,Math.max(1,Math.round(z.limit))),H=await Q("GET",`/search?q=${encodeURIComponent(z.query)}&type=track&limit=${G}`),M=p(H);if(!M.length)throw new Z("EMPTY_RESULT",`No results found for: ${z.query}`);return M}});X({site:"spotify",name:"queue",access:"write",description:"Add a track to the playback queue",strategy:Y.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Track to add to queue"}],columns:["track","artist","status"],func:async(z)=>{const{uri:G,name:H,artist:M}=await N(z.query);await Q("POST",`/me/player/queue?uri=${encodeURIComponent(G)}`);return[{track:H,artist:M,status:"added to queue"}]}});X({site:"spotify",name:"shuffle",access:"write",description:"Toggle shuffle on/off",strategy:Y.PUBLIC,browser:!1,args:[{name:"state",type:"str",default:"on",positional:!0,choices:["on","off"],help:"on or off"}],columns:["shuffle"],func:async(z)=>{await Q("PUT",`/me/player/shuffle?state=${z.state==="on"}`);return[{shuffle:z.state}]}});X({site:"spotify",name:"repeat",access:"write",description:"Set repeat mode (off / track / context)",strategy:Y.PUBLIC,browser:!1,args:[{name:"mode",type:"str",default:"context",positional:!0,choices:["off","track","context"],help:"off / track / context"}],columns:["repeat"],func:async(z)=>{await Q("PUT",`/me/player/repeat?state=${z.mode}`);return[{repeat:z.mode}]}});

package/clis/spotify/utils.js

@@ -0,0 +1,8 @@
+import{CliError as n}from"@jackwener/opencli/errors";const o=[/^your_spotify_client_id_here$/i,/^your_spotify_client_secret_here$/i,/^your_.+_here$/i];export function parseDotEnv(r){return Object.fromEntries(r.split(/\r?\n/).map((t)=>t.trim()).filter((t)=>t&&!t.startsWith("#")&&t.includes("=")).map((t)=>{const e=t.indexOf("=");return[t.slice(0,e).trim(),t.slice(e+1).trim()]}))}export function resolveSpotifyCredentials(r,t=process.env){return{clientId:t.SPOTIFY_CLIENT_ID||r.SPOTIFY_CLIENT_ID||"",clientSecret:t.SPOTIFY_CLIENT_SECRET||r.SPOTIFY_CLIENT_SECRET||""}}export function isPlaceholderCredential(r){const t=r?.trim()||"";if(!t)return!1;return o.some((e)=>e.test(t))}export function hasConfiguredSpotifyCredentials(r){return Boolean(r.clientId.trim())&&Boolean(r.clientSecret.trim())&&!isPlaceholderCredential(r.clientId)&&!isPlaceholderCredential(r.clientSecret)}export function assertSpotifyCredentialsConfigured(r,t){if(hasConfiguredSpotifyCredentials(r))return;throw new n("CONFIG",`Missing Spotify credentials.
+
+1. Go to https://developer.spotify.com/dashboard and create an app
+2. Add http://127.0.0.1:8888/callback as a Redirect URI
+3. Copy your Client ID and Client Secret
+4. Open the file: ${t}
+5. Fill in SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET, then save
+6. Run: opencli spotify auth`)}export function mapSpotifyTrackResults(r){const t=r?.tracks?.items;if(!Array.isArray(t))return[];return t.map((e)=>({track:e?.name||"",artist:Array.isArray(e?.artists)?e.artists.map((i)=>i.name).join(", "):"",album:e?.album?.name||"",uri:e?.uri||""}))}export function getFirstSpotifyTrack(r){const t=mapSpotifyTrackResults(r)[0];if(!t)return null;return{uri:t.uri,name:t.track,artist:t.artist}}

package/clis/stackoverflow/bounties.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"stackoverflow",name:"bounties",access:"read",description:"Active bounties on Stack Overflow",domain:"stackoverflow.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:10,help:"Max number of results"}],columns:["rank","id","bounty","title","score","answers","views","is_answered","tags","author","creation_date","url"],pipeline:[{fetch:{url:"https://api.stackexchange.com/2.3/questions/featured?order=desc&sort=activity&site=stackoverflow&pagesize=${{ args.limit }}"}},{select:"items"},{map:{rank:"${{ index + 1 }}",id:"${{ item.question_id }}",bounty:"${{ item.bounty_amount }}",title:"${{ item.title }}",score:"${{ item.score }}",answers:"${{ item.answer_count }}",views:"${{ item.view_count }}",is_answered:"${{ item.is_answered }}",tags:"${{ item.tags | join(', ') }}",author:"${{ item.owner.display_name }}",creation_date:"${{ item.creation_date }}",url:"${{ item.link }}"}},{limit:"${{ args.limit }}"}]});

package/clis/stackoverflow/hot.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"stackoverflow",name:"hot",access:"read",description:"Hot Stack Overflow questions",domain:"stackoverflow.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:10,help:"Max number of results"}],columns:["rank","id","title","score","answers","views","is_answered","tags","author","creation_date","url"],pipeline:[{fetch:{url:"https://api.stackexchange.com/2.3/questions?order=desc&sort=hot&site=stackoverflow&pagesize=${{ args.limit }}"}},{select:"items"},{map:{rank:"${{ index + 1 }}",id:"${{ item.question_id }}",title:"${{ item.title }}",score:"${{ item.score }}",answers:"${{ item.answer_count }}",views:"${{ item.view_count }}",is_answered:"${{ item.is_answered }}",tags:"${{ item.tags | join(', ') }}",author:"${{ item.owner.display_name }}",creation_date:"${{ item.creation_date }}",url:"${{ item.link }}"}},{limit:"${{ args.limit }}"}]});

package/clis/stackoverflow/read.js

@@ -0,0 +1,13 @@
+import{cli as h,Strategy as x}from"@jackwener/opencli/registry";import{ArgumentError as f,CommandExecutionError as G,EmptyResultError as B}from"@jackwener/opencli/errors";const O="https://api.stackexchange.com/2.3",R="stackoverflow",M=100;async function X(F,H){let V;try{V=await fetch(F)}catch(Y){const $=Y instanceof Error?Y.message:String(Y);throw new G(`Network failure fetching ${H}: ${$}`,"Check connectivity to api.stackexchange.com")}if(V.status===404)throw new B(H,`${H} not found`);if(!V.ok)throw new G(`Stack Exchange API HTTP ${V.status} for ${H}`,"Check the question id and quota (300/day per IP)");let K;try{K=await V.json()}catch(Y){const $=Y instanceof Error?Y.message:String(Y);throw new G(`Malformed JSON from Stack Exchange API for ${H}: ${$}`,"The API returned a non-JSON body — likely a transient outage")}if(K&&K.error_id)throw new G(`Stack Exchange API error ${K.error_id} (${K.error_name}) for ${H}: ${K.error_message||""}`,"Common causes: invalid filter, throttled, or quota exhausted");return K}function v(F){if(F===void 0||F===null||F==="")return NaN;const H=typeof F==="number"?F:Number(F);return Number.isFinite(H)&&Number.isInteger(H)?H:NaN}function A(F,H,V){const K=v(F);if(!Number.isInteger(K)||K<H)throw new f(`${V} must be an integer >= ${H}, got ${JSON.stringify(F)}`);return K}function C(F,H,V,K){const Y=v(F);if(!Number.isInteger(Y)||Y<H||Y>V)throw new f(`${K} must be an integer between ${H} and ${V}, got ${JSON.stringify(F)}`);return Y}function E(F,H){const V=F.accepted_answer_id;return H.slice().sort((K,Y)=>{const $=K.is_accepted||V&&K.answer_id===V,W=Y.is_accepted||V&&Y.answer_id===V;if($!==W)return $?-1:1;return(Y.score??0)-(K.score??0)})}async function u(F,H,V){const K=F.accepted_answer_id;if(!K||H.some((W)=>W.answer_id===K))return H;const $=((await X(`${O}/answers/${K}?site=${R}&filter=withbody`,`${V}/accepted-answer`)).items||[])[0];return $?H.concat($):H}async function w(F,H,V){const K=new Map;if(F.length===0)return K;const Y=F.map((Q)=>Q.answer_id).join(";"),$=Math.min(M,F.length*H),W=await X(`${O}/answers/${Y}/comments?site=${R}&filter=withbody&order=asc&sort=creation&pagesize=${$}`,`${V}/answer-comments`);for(const Q of W.items||[]){if(!Q.post_id)continue;if(!K.has(Q.post_id))K.set(Q.post_id,[]);K.get(Q.post_id).push(Q)}if(W.has_more){if(F.some((z)=>{return(K.get(z.answer_id)||[]).length<H}))throw new G(`Stack Exchange answer comments for ${V} exceed one API page`,"Lower --answers-limit or --comments-limit; refusing to return a partial answer-comment set.")}return K}const d={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" ",hellip:"…",mdash:"—",ndash:"–",laquo:"«",raquo:"»",copy:"©",reg:"®",trade:"™",euro:"€",pound:"£",yen:"¥",rsquo:"’",lsquo:"‘",rdquo:"”",ldquo:"“"};function L(F){if(!F)return"";return String(F).replace(/&#x([0-9a-fA-F]+);/g,(H,V)=>{const K=parseInt(V,16);return Number.isFinite(K)?String.fromCodePoint(K):""}).replace(/&#(\d+);/g,(H,V)=>{const K=parseInt(V,10);return Number.isFinite(K)?String.fromCodePoint(K):""}).replace(/&([a-zA-Z]+);/g,(H,V)=>d[V]??H)}function Z(F){if(!F)return"";const H=String(F).replace(/<pre[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>/gi,`
+$1
+`).replace(/<code[^>]*>(.*?)<\/code>/gi,"`$1`").replace(/<p[^>]*>/gi,`
+
+`).replace(/<\/p>/gi,"").replace(/<br\s*\/?>/gi,`
+`).replace(/<li[^>]*>/gi,`
+- `).replace(/<\/li>/gi,"").replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi,"$2 ($1)").replace(/<[^>]+>/g,"");return L(H).replace(/\n{3,}/g,`
+
+`).trim()}function J(F){return L(F?.display_name||"")||"[deleted]"}function D(F,H){if(!F||F.length<=H)return F||"";return F.slice(0,H)+" ... [truncated]"}function T(F,H){if(H===0)return F;const K=`${"  ".repeat(H)}> `;return F.split(`
+`).map((Y)=>K+Y).join(`
+`)}h({site:"stackoverflow",name:"read",access:"read",description:"Read a Stack Overflow question with answers and comments",domain:"stackoverflow.com",strategy:x.PUBLIC,browser:!1,args:[{name:"id",required:!0,positional:!0,help:"Stack Overflow question id (numeric, e.g. 79935770)"},{name:"answers-limit",type:"int",default:10,help:"Max answers to include (1-100; accepted answer always included first)"},{name:"comments-limit",type:"int",default:5,help:"Max comments per question/answer (1-100)"},{name:"max-length",type:"int",default:4000,help:"Max characters per body / answer / comment (min 100)"}],columns:["type","author","score","accepted","text"],func:async(F)=>{const H=String(F.id||"").trim();if(!/^\d+$/.test(H))throw new f(`Invalid Stack Overflow question id: ${F.id}`,"Pass a numeric id like 79935770");const V=C(F["answers-limit"]??10,1,M,"stackoverflow read --answers-limit"),K=C(F["comments-limit"]??5,1,M,"stackoverflow read --comments-limit"),Y=A(F["max-length"]??4000,100,"stackoverflow read --max-length"),$=`stackoverflow/${H}`,W=`${O}/questions/${H}?site=${R}&filter=withbody`,z=((await X(W,$)).items||[])[0];if(!z)throw new B($,"Question not found");const[P,q]=await Promise.all([X(`${O}/questions/${H}/comments?site=${R}&filter=withbody&order=asc&sort=creation&pagesize=${K}`,`${$}/comments`),X(`${O}/questions/${H}/answers?site=${R}&filter=withbody&order=desc&sort=votes&pagesize=${V}`,`${$}/answers`)]),g=await u(z,q.items||[],$),y=E(z,g).slice(0,V),_=await w(y,K,$),k=[],p=Z(z.body||""),S=[z.title||"",p,z.link||""].filter(Boolean);k.push({type:"POST",author:J(z.owner),score:z.score??0,accepted:"",text:D(S.join(`
+
+`),Y)});const I=(P.items||[]).slice(0,K);for(const U of I){const j=T(Z(U.body||""),1);k.push({type:"Q-COMMENT",author:J(U.owner),score:U.score??0,accepted:"",text:D(j,Y)})}for(const U of y){k.push({type:"ANSWER",author:J(U.owner),score:U.score??0,accepted:U.is_accepted?"true":"",text:D(Z(U.body||""),Y)});const j=(_.get(U.answer_id)||[]).slice(0,K);for(const N of j){const b=T(Z(N.body||""),1);k.push({type:"A-COMMENT",author:J(N.owner),score:N.score??0,accepted:"",text:D(b,Y)})}}return k}});

package/clis/stackoverflow/related.js

@@ -0,0 +1 @@
+import{cli as u,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as a}from"@jackwener/opencli/errors";import{seFetch as w,normalizeLimit as f,epochToDate as n,ensureItems as p,decodeHtmlEntities as l}from"./utils.js";const r=["rank","activity","votes","creation"];u({site:"stackoverflow",name:"related",access:"read",description:"List Stack Overflow questions related to a given question id.",domain:"stackoverflow.com",strategy:m.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,type:"string",help:"Stack Overflow question id (numeric, e.g. 79935770)."},{name:"sort",type:"string",default:"rank",help:`Sort key: ${r.join(", ")} (rank = SO relevance default).`},{name:"limit",type:"int",default:20,help:"Max related questions (1-100)."}],columns:["rank","id","title","score","answers","views","isAnswered","tags","author","createdAt","lastActivityAt","url"],func:async(t)=>{const i=String(t.id??"").trim();if(!/^\d+$/.test(i))throw new a(`stackoverflow related id must be a numeric question id, got ${JSON.stringify(t.id)}`);const s=String(t.sort??"rank").toLowerCase();if(!r.includes(s))throw new a(`stackoverflow related sort must be one of ${r.join(", ")}`);const o=f(t.limit,20,100,"limit"),c=await w(`/questions/${encodeURIComponent(i)}/related`,{searchParams:{order:"desc",sort:s,pagesize:o}});return p(c,`stackoverflow related ${i}`).slice(0,o).map((e,d)=>({rank:d+1,id:e.question_id,title:l(e.title||""),score:e.score??0,answers:e.answer_count??0,views:e.view_count??0,isAnswered:Boolean(e.is_answered),tags:Array.isArray(e.tags)?e.tags.join(", "):"",author:l(e.owner?.display_name||""),createdAt:n(e.creation_date),lastActivityAt:n(e.last_activity_date),url:e.link||(e.question_id?`https://stackoverflow.com/questions/${e.question_id}`:"")}))}});

package/clis/stackoverflow/search.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"stackoverflow",name:"search",access:"read",description:"Search Stack Overflow questions",domain:"stackoverflow.com",strategy:t.PUBLIC,browser:!1,args:[{name:"query",type:"string",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Max number of results"}],columns:["rank","id","title","score","answers","views","is_answered","tags","author","creation_date","url"],pipeline:[{fetch:{url:"https://api.stackexchange.com/2.3/search/advanced?order=desc&sort=relevance&q=${{ args.query }}&site=stackoverflow&pagesize=${{ args.limit }}"}},{select:"items"},{map:{rank:"${{ index + 1 }}",id:"${{ item.question_id }}",title:"${{ item.title }}",score:"${{ item.score }}",answers:"${{ item.answer_count }}",views:"${{ item.view_count }}",is_answered:"${{ item.is_answered }}",tags:"${{ item.tags | join(', ') }}",author:"${{ item.owner.display_name }}",creation_date:"${{ item.creation_date }}",url:"${{ item.link }}"}},{limit:"${{ args.limit }}"}]});

package/clis/stackoverflow/tag.js

@@ -0,0 +1 @@
+import{cli as m,Strategy as g}from"@jackwener/opencli/registry";import{ArgumentError as u}from"@jackwener/opencli/errors";import{seFetch as d,normalizeLimit as w,requireString as v,epochToDate as r,ensureItems as p,decodeHtmlEntities as n}from"./utils.js";const i=["activity","votes","creation","hot","week","month"];m({site:"stackoverflow",name:"tag",access:"read",description:"List Stack Overflow questions tagged with a given tag (most active first).",domain:"stackoverflow.com",strategy:g.PUBLIC,browser:!1,args:[{name:"tag",positional:!0,required:!0,type:"string",help:"Tag slug (e.g. python, rust, typescript)."},{name:"sort",type:"string",default:"activity",help:`Sort key: ${i.join(", ")}`},{name:"limit",type:"int",default:20,help:"Max questions to return (max 100)."}],columns:["rank","id","title","score","answers","views","isAnswered","tags","author","createdAt","lastActivityAt","url"],func:async(e)=>{const s=v(e.tag,"tag").toLowerCase(),a=String(e.sort??"activity").toLowerCase();if(!i.includes(a))throw new u(`sort must be one of ${i.join(", ")}`);const o=w(e.limit,20,100,"limit"),c=await d("/questions",{searchParams:{tagged:s,order:"desc",sort:a,pagesize:o}});return p(c,`stackoverflow tag "${s}"`).slice(0,o).map((t,l)=>({rank:l+1,id:t.question_id,title:n(t.title||""),score:t.score??0,answers:t.answer_count??0,views:t.view_count??0,isAnswered:Boolean(t.is_answered),tags:Array.isArray(t.tags)?t.tags.join(", "):"",author:n(t.owner?.display_name||""),createdAt:r(t.creation_date),lastActivityAt:r(t.last_activity_date),url:t.link||(t.question_id?`https://stackoverflow.com/questions/${t.question_id}`:"")}))}});

package/clis/stackoverflow/unanswered.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"stackoverflow",name:"unanswered",access:"read",description:"Top voted unanswered questions on Stack Overflow",domain:"stackoverflow.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:10,help:"Max number of results"}],columns:["rank","id","title","score","answers","views","tags","author","creation_date","url"],pipeline:[{fetch:{url:"https://api.stackexchange.com/2.3/questions/unanswered?order=desc&sort=votes&site=stackoverflow&pagesize=${{ args.limit }}"}},{select:"items"},{map:{rank:"${{ index + 1 }}",id:"${{ item.question_id }}",title:"${{ item.title }}",score:"${{ item.score }}",answers:"${{ item.answer_count }}",views:"${{ item.view_count }}",tags:"${{ item.tags | join(', ') }}",author:"${{ item.owner.display_name }}",creation_date:"${{ item.creation_date }}",url:"${{ item.link }}"}},{limit:"${{ args.limit }}"}]});

package/clis/stackoverflow/user.js

@@ -0,0 +1 @@
+import{cli as n,Strategy as c}from"@jackwener/opencli/registry";import{seFetch as l,normalizeLimit as d,requireString as m,epochToDate as a,ensureItems as u,decodeHtmlEntities as r}from"./utils.js";n({site:"stackoverflow",name:"user",access:"read",description:"Find Stack Overflow users by display name (highest reputation first).",domain:"stackoverflow.com",strategy:c.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,type:"string",help:"Display name (or substring) to search."},{name:"limit",type:"int",default:10,help:"Max users to return (max 100)."}],columns:["userId","displayName","reputation","goldBadges","silverBadges","bronzeBadges","location","createdAt","lastAccessAt","url"],func:async(s)=>{const i=m(s.name,"name"),t=d(s.limit,10,100,"limit"),o=await l("/users",{searchParams:{inname:i,order:"desc",sort:"reputation",pagesize:t}});return u(o,"stackoverflow user").slice(0,t).map((e)=>({userId:e.user_id,displayName:r(e.display_name||""),reputation:e.reputation??0,goldBadges:e.badge_counts?.gold??0,silverBadges:e.badge_counts?.silver??0,bronzeBadges:e.badge_counts?.bronze??0,location:r(e.location||""),createdAt:a(e.creation_date),lastAccessAt:a(e.last_access_date),url:e.link||(e.user_id?`https://stackoverflow.com/users/${e.user_id}`:"")}))}});

package/clis/stackoverflow/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as W,CommandExecutionError as O,EmptyResultError as X}from"@jackwener/opencli/errors";export const SE_API="https://api.stackexchange.com/2.3",SE_SITE="stackoverflow";const Z="opencli-stackoverflow (+https://github.com/jackwener/opencli)";export function normalizeLimit(q,z,B,G="limit"){const F=Number(q??z);if(!Number.isInteger(F)||F<=0)throw new W(`${G} must be a positive integer`);if(F>B)throw new W(`${G} must be <= ${B}`);return F}export function requireString(q,z){const B=String(q??"").trim();if(!B)throw new W(`${z} cannot be empty`);return B}export async function seFetch(q,{searchParams:z}={}){const B=new URL(q.startsWith("http")?q:`${SE_API}${q.startsWith("/")?"":"/"}${q}`);if(z)for(const[F,Q]of Object.entries(z)){if(Q==null||Q==="")continue;B.searchParams.set(F,String(Q))}if(!B.searchParams.has("site"))B.searchParams.set("site",SE_SITE);let G;try{G=await fetch(B,{headers:{Accept:"application/json","Accept-Encoding":"gzip","User-Agent":Z}})}catch(F){throw new O(`stack exchange request failed: ${F?.message||F}`)}if(G.status===429)throw new O("stack exchange returned HTTP 429 (rate limited)","Wait a few seconds and retry, or lower --limit.");if(!G.ok){let F="";try{F=(await G.json())?.error_message||""}catch{}throw new O(`stack exchange HTTP ${G.status}: ${F||G.statusText}`)}let K;try{K=await G.json()}catch(F){throw new O(`stack exchange returned malformed JSON: ${F?.message||F}`)}if(K?.error_id)throw new O(`stack exchange API error: ${K.error_message||K.error_name}`,"Inspect the URL in a browser for the canonical error context.");return K}export function epochToDate(q){if(q==null||q==="")return"";const z=Number(q);if(!Number.isFinite(z)||z<=0)return"";return new Date(z*1000).toISOString().slice(0,10)}export function ensureItems(q,z){const B=Array.isArray(q?.items)?q.items:[];if(B.length===0)throw new X(z,`${z} returned no items.`);return B}const $={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'","&apos;":"'","&nbsp;":" "};export function decodeHtmlEntities(q){if(q==null)return"";return String(q).replace(/&#x([0-9a-fA-F]+);/g,(z,B)=>String.fromCodePoint(parseInt(B,16))).replace(/&#(\d+);/g,(z,B)=>String.fromCodePoint(parseInt(B,10))).replace(/&(amp|lt|gt|quot|#39|apos|nbsp);/g,(z)=>$[z]||z)}