dunsocial 0.7.0 → 0.8.0

package/README.md

@@ -97,6 +97,7 @@ Tips:
 
 ## Links
 
+- [CLI docs](https://dunsocial.com/docs/cli)
 - [dunsocial.com](https://dunsocial.com)
 - [npm package](https://www.npmjs.com/package/dunsocial)
 

package/dist/index.js

@@ -95,7 +95,7 @@ Env:
 Exit codes:
   0 ok | 1 usage | 2 auth | 3 forbidden | 4 validation | 5 not found | 6 rate limit | 7 network
 
-Docs: https://dunsocial.com
+Docs: https://dunsocial.com/docs/cli
 `;function o(U){return{auth:`dun auth
 
   login [--token]         Device-code browser login (default) or --token for CI
@@ -212,7 +212,7 @@ Env:
 Exit codes:
   0 ok | 1 usage | 2 auth | 3 forbidden | 4 validation | 5 not found | 6 rate limit | 7 network
 
-Docs: https://dunsocial.com
+Docs: https://dunsocial.com/docs/cli
 `}import{mkdir as gU,readFile as c0,writeFile as rU,chmod as lU,unlink as sU}from"node:fs/promises";import{dirname as tU,join as XU}from"node:path";import{homedir as aU}from"node:os";var M="0.4.0";function e(){if(process.env.DUN_CONFIG)return process.env.DUN_CONFIG;let U=process.env.XDG_CONFIG_HOME,D=U?U:XU(aU(),".config");return XU(D,"dunsocial","config.json")}function j(){return e()}async function b(U){let D=e();await gU(tU(D),{recursive:!0});let O={...U,updatedAt:new Date().toISOString()};await rU(D,`${JSON.stringify(O,null,2)}
 `,"utf8");try{await lU(D,384)}catch{}}async function ZU(){let U=e();try{await sU(U)}catch(D){if(D.code!=="ENOENT")throw new Q(`Failed to clear config: ${D.message}`,z.USAGE)}}function N(U){if(!U.token)throw new Q("Not authenticated. Run `dun auth login` (or `dun auth login --token <token>` / set DUN_TOKEN).",z.AUTH);return U.token}function P(U){if(!U.workspaceId)throw new Q("No workspace selected. Run `dun workspace use <id|slug>` or pass --workspace / DUN_WORKSPACE_ID.",z.VALIDATION);return U.workspaceId}var JU=["█▀▀▄ █  █ █▀▀▄ █▀▀▀ █▀▀█ █▀▀▀ ▀█▀ █▀▀█ █","█  █ █  █ █  █ ▀▀▀█ █  █ █     █  █▀▀█ █","▀▀▀▀ ▀▀▀▀ ▀  ▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀ ▀  ▀ ▀▀▀"].join(`
 `),RU=["█▀▀▄ █  █ █▀▀▄","█  █ █  █ █  █","▀▀▀▀ ▀▀▀▀ ▀  ▀","","  DunSocial"].join(`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dunsocial",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"description": "DunSocial agent-first CLI — schedule and publish social posts from the terminal, CI, and coding agents",
 	"type": "module",
 	"license": "MIT",

package/scripts/postinstall.js

@@ -5,6 +5,9 @@
  */
 'use strict';
 
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
 const BANNER_FULL = [
 	'█▀▀▄ █  █ █▀▀▄ █▀▀▀ █▀▀█ █▀▀▀ ▀█▀ █▀▀█ █',
 	'█  █ █  █ █  █ ▀▀▀█ █  █ █     █  █▀▀█ █',
@@ -19,6 +22,9 @@ const BANNER_MINI = [
 	'  DunSocial'
 ].join('\n');
 
+/** Keep in sync with apps/cli/src/commands/help.ts Docs line. */
+export const DOCS_URL = 'https://dunsocial.com/docs/cli';
+
 function isCi() {
 	const env = process.env;
 	return (
@@ -36,13 +42,29 @@ function maxWidth(art) {
 	return Math.max(...art.split('\n').map((line) => line.length));
 }
 
-function renderBanner(columns) {
+export function renderBanner(columns) {
 	const cols = columns > 0 ? columns : 80;
 	if (cols >= maxWidth(BANNER_FULL)) return BANNER_FULL;
 	if (cols >= maxWidth(BANNER_MINI)) return BANNER_MINI;
 	return 'DunSocial';
 }
 
+/** Human tip lines after a global install (exported for tests). */
+export function gettingStartedTip() {
+	return [
+		'Get started:',
+		'  dun auth login',
+		'  dun workspace list',
+		'  dun workspace use <slug>',
+		'  dun accounts list',
+		'  dun posts publish --text "Hello from DunSocial" --accounts ACCOUNT_ID',
+		'',
+		'  dun --help',
+		`  Docs: ${DOCS_URL}`,
+		''
+	].join('\n');
+}
+
 function main() {
 	if (!process.stderr.isTTY || isCi()) return;
 
@@ -55,13 +77,14 @@ function main() {
 	const banner = renderBanner(columns);
 
 	process.stderr.write(`\n${banner}\n\n`);
-	process.stderr.write('  dun auth login\n');
-	process.stderr.write('  dun --help\n');
-	process.stderr.write('  Docs: https://dunsocial.com\n\n');
+	process.stderr.write(`${gettingStartedTip()}\n`);
 }
 
 try {
-	main();
+	const entry = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : '';
+	if (entry && import.meta.url === entry) {
+		main();
+	}
 } catch {
 	// never fail install
 }