chore: only push readme to remote

Author: smeijer

.github/sync.yml

@@ -1,3 +1,4 @@
 magicbell/magicbell:
   - source: docs-dist
-    dest: src/go/app/site/docs/mdx/03-libraries/magicbell-java-user-client
+    dest: src/go/app/site/docs/mdx/03-libraries/magicbell-java-user-client
+    deleteOrphaned: true

package.json

@@ -15,6 +15,7 @@
     "@types/node": "^22.10.2",
     "glob": "^11.0.0",
     "replace-in-file": "^8.2.0",
-    "tsx": "^4.19.2"
+    "tsx": "^4.19.2",
+    "url-join": "^5.0.0"
   }
 }

scripts/liblab-docs.ts

@@ -1,24 +1,21 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
-import { exists, getDirs } from '@magicbell/codegen/fs';
 import * as md from '@magicbell/codegen/markdown';
 import * as glob from 'glob';
-
-function pascalToHyphenCase(str: string): string {
-  return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
-}
-
-function rewriteHref(url: string) {
-  if (!url.endsWith('.md')) return url;
-  return url.replace(/^documentation\//, '').replace(/([^/]+)\.md$/, (_, fileName) => pascalToHyphenCase(fileName));
-}
+import urlJoin from 'url-join';
 
 const root = process.cwd();
 const outdir = path.join(root, 'docs-dist');
 await fs.rm(outdir, { recursive: true, force: true });
 
 const pkg = JSON.parse(await fs.readFile('package.json', 'utf-8'));
+const repoUrl = 'https://github.com/magicbell/magicbell-java-user-client/blob/main'
+
+function rewriteHref(url: string) {
+  if (url.startsWith('http://') || url.startsWith('https://')) return url;
+  return urlJoin(repoUrl, url);
+}
 
 // process readme
 const [readme] = glob.sync('README.md', { cwd: root });
@@ -29,29 +26,3 @@ md.mapLinks(readmeAst, rewriteHref);
 md.insertFrontMatter(readmeAst, { title: pkg.name });
 
 await md.write(readmeAst, path.join(outdir, 'index.mdx'));
-
-// process pages
-const docs = glob.sync('**/*.md', {
-  cwd: path.join(root, 'documentation'),
-});
-
-for (const file of docs) {
-  const ast = await md.read(path.join(root, 'documentation', file));
-
-  md.reIndentHeadings(ast, 1);
-  md.mapLinks(ast, rewriteHref);
-
-  const title = md.getTitle(ast);
-  md.insertFrontMatter(ast, { title });
-  md.removeFirstHeading(ast);
-
-  await md.write(ast, path.join(outdir, pascalToHyphenCase(file) + 'x'));
-}
-
-for (const dir of getDirs(docs)) {
-  const file = path.join(outdir, dir, 'index.mdx');
-  if (await exists(file)) continue;
-  const ast: md.Root = { type: 'root', children: [] };
-  md.insertFrontMatter(ast, { title: path.basename(dir) });
-  await md.write(ast, file);
-}

yarn.lock

@@ -2326,6 +2326,11 @@ uri-js@^4.2.2:
   dependencies:
     punycode "^2.1.0"
 
+url-join@^5.0.0:
+  version "5.0.0"
+  resolved "https://registry.yarnpkg.com/url-join/-/url-join-5.0.0.tgz#c2f1e5cbd95fa91082a93b58a1f42fecb4bdbcf1"
+  integrity sha512-n2huDr9h9yzd6exQVnH/jU5mr+Pfx08LRXXZhkLLetAMESRj+anQsTAh940iMrIetKAmry9coFuZQ2jY8/p3WA==
+
 validate.io-array@^1.0.3:
   version "1.0.6"
   resolved "https://registry.yarnpkg.com/validate.io-array/-/validate.io-array-1.0.6.tgz#5b5a2cafd8f8b85abb2f886ba153f2d93a27774d"