folderblog 0.0.1

package/README.md

@@ -0,0 +1,88 @@
+# folderblog
+
+TypeScript SDK for **[folder.blog](https://folder.blog)** — git-native blogging.
+
+Zero dependencies. Works in Node.js, Deno, Bun, and browsers.
+
+## Install
+
+```bash
+npm install folderblog
+```
+
+## Usage
+
+```typescript
+import { folderBlog } from 'folderblog';
+
+const blog = folderBlog('yourname.folder.blog');
+
+const posts = await blog.posts.list();
+const post = await blog.posts.get('hello-world');
+const site = await blog.site.get();
+```
+
+## API
+
+### `blog.posts.list()`
+
+```typescript
+const posts = await blog.posts.list();
+
+posts[0].slug     // "hello-world"
+posts[0].title    // "Hello World"
+posts[0].date     // "2024-01-15"
+posts[0].tags     // ["intro"]
+posts[0].excerpt  // "My first post..."
+posts[0].url      // "/api/posts/hello-world"
+```
+
+### `blog.posts.get(slug)`
+
+```typescript
+const post = await blog.posts.get('hello-world');
+
+post.content  // "<p>Full HTML here...</p>"
+post.raw      // "# Hello World\n\nFull markdown..."
+post.images   // ["/posts/images/photo.jpg"]
+```
+
+### `blog.site.get()`
+
+```typescript
+const site = await blog.site.get();
+
+site.site        // "My Blog"
+site.variant     // "light" | "dark" | "serif" | "mono"
+site.postsCount  // 12
+site.url         // "https://yourname.folder.blog"
+```
+
+## Error Handling
+
+```typescript
+import { folderBlog, NotFoundError } from 'folderblog';
+
+try {
+  await blog.posts.get('missing');
+} catch (error) {
+  if (error instanceof NotFoundError) {
+    // 404
+  }
+}
+```
+
+## Types
+
+```typescript
+import type { Post, PostSummary, Site } from 'folderblog';
+```
+
+## Links
+
+- **Website:** [folder.blog](https://folder.blog)
+- **Docs:** [folder.blog/docs](https://folder.blog/docs)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var w=Object.prototype.hasOwnProperty;var y=(r,t)=>{for(var s in t)d(r,s,{get:t[s],enumerable:!0})},P=(r,t,s,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of f(t))!w.call(r,o)&&o!==s&&d(r,o,{get:()=>t[o],enumerable:!(i=g(t,o))||i.enumerable});return r};var x=r=>P(d({},"__esModule",{value:!0}),r);var F={};y(F,{ApiError:()=>c,FolderBlogError:()=>n,NetworkError:()=>p,NotFoundError:()=>a,folderBlog:()=>h});module.exports=x(F);var n=class extends Error{status;url;constructor(t,s){super(t),this.name="FolderBlogError",this.status=s?.status,this.url=s?.url}},a=class extends n{constructor(t,s,i){super(`${t} not found: ${s}`,{status:404,url:i}),this.name="NotFoundError"}},c=class extends n{constructor(t,s,i){super(t,{status:s,url:i}),this.name="ApiError"}},p=class extends n{cause;constructor(t,s){super(t),this.name="NetworkError",this.cause=s}};function E(r){let t=r.trim();return t.endsWith("/")&&(t=t.slice(0,-1)),!t.startsWith("http://")&&!t.startsWith("https://")&&(t=`https://${t}`),t}function h(r,t={}){let s=E(r),i=t.fetch??globalThis.fetch;async function o(l){let e=`${s}${l}`,u;try{u=await i(e,{method:"GET",headers:{Accept:"application/json"}})}catch(m){throw new p(`Failed to fetch ${e}`,m instanceof Error?m:void 0)}if(!u.ok)throw u.status===404?new a("Resource",l,e):new c(`API request failed: ${u.statusText}`,u.status,e);try{return await u.json()}catch{throw new c("Failed to parse JSON response",u.status,e)}}return{posts:{async list(){return(await o("/api/posts")).posts},async get(l){if(!l)throw new n("Post slug is required");try{return await o(`/api/posts/${encodeURIComponent(l)}`)}catch(e){throw e instanceof a?new a("Post",l,e.url):e}}},site:{async get(){return o("/api")}}}}0&&(module.exports={ApiError,FolderBlogError,NetworkError,NotFoundError,folderBlog});

package/dist/index.d.cts

@@ -0,0 +1,99 @@
+/**
+ * Base post fields shared between list and detail responses
+ */
+interface PostBase {
+    slug: string;
+    title: string;
+    date: string;
+    tags: string[];
+    excerpt: string;
+}
+/**
+ * Post summary in list responses
+ */
+interface PostSummary extends PostBase {
+    url: string;
+}
+/**
+ * Full post from detail endpoint
+ */
+interface Post extends PostBase {
+    content: string;
+    raw: string;
+    images: string[];
+}
+/**
+ * Site information
+ */
+interface Site {
+    site: string;
+    variant: "light" | "dark" | "serif" | "mono";
+    postsCount: number;
+    url: string;
+}
+/**
+ * Client options
+ */
+interface FolderBlogOptions {
+    fetch?: typeof fetch;
+}
+/**
+ * The FolderBlog client
+ */
+interface FolderBlogClient {
+    posts: {
+        list(): Promise<PostSummary[]>;
+        get(slug: string): Promise<Post>;
+    };
+    site: {
+        get(): Promise<Site>;
+    };
+}
+
+/**
+ * Create a FolderBlog client
+ *
+ * @example
+ * ```ts
+ * const blog = folderBlog('yourname.folder.blog');
+ * const posts = await blog.posts.list();
+ * const post = await blog.posts.get('hello-world');
+ * const site = await blog.site.get();
+ * ```
+ */
+declare function folderBlog(domain: string, options?: FolderBlogOptions): FolderBlogClient;
+
+/**
+ * Base error class for folder-blog SDK errors
+ */
+declare class FolderBlogError extends Error {
+    /** HTTP status code if applicable */
+    readonly status?: number;
+    /** The URL that was requested */
+    readonly url?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        url?: string;
+    });
+}
+/**
+ * Error thrown when a resource is not found (404)
+ */
+declare class NotFoundError extends FolderBlogError {
+    constructor(resource: string, identifier: string, url?: string);
+}
+/**
+ * Error thrown when the API request fails
+ */
+declare class ApiError extends FolderBlogError {
+    constructor(message: string, status: number, url?: string);
+}
+/**
+ * Error thrown when network/fetch fails
+ */
+declare class NetworkError extends FolderBlogError {
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+
+export { ApiError, type FolderBlogClient, FolderBlogError, type FolderBlogOptions, NetworkError, NotFoundError, type Post, type PostSummary, type Site, folderBlog };

package/dist/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Base post fields shared between list and detail responses
+ */
+interface PostBase {
+    slug: string;
+    title: string;
+    date: string;
+    tags: string[];
+    excerpt: string;
+}
+/**
+ * Post summary in list responses
+ */
+interface PostSummary extends PostBase {
+    url: string;
+}
+/**
+ * Full post from detail endpoint
+ */
+interface Post extends PostBase {
+    content: string;
+    raw: string;
+    images: string[];
+}
+/**
+ * Site information
+ */
+interface Site {
+    site: string;
+    variant: "light" | "dark" | "serif" | "mono";
+    postsCount: number;
+    url: string;
+}
+/**
+ * Client options
+ */
+interface FolderBlogOptions {
+    fetch?: typeof fetch;
+}
+/**
+ * The FolderBlog client
+ */
+interface FolderBlogClient {
+    posts: {
+        list(): Promise<PostSummary[]>;
+        get(slug: string): Promise<Post>;
+    };
+    site: {
+        get(): Promise<Site>;
+    };
+}
+
+/**
+ * Create a FolderBlog client
+ *
+ * @example
+ * ```ts
+ * const blog = folderBlog('yourname.folder.blog');
+ * const posts = await blog.posts.list();
+ * const post = await blog.posts.get('hello-world');
+ * const site = await blog.site.get();
+ * ```
+ */
+declare function folderBlog(domain: string, options?: FolderBlogOptions): FolderBlogClient;
+
+/**
+ * Base error class for folder-blog SDK errors
+ */
+declare class FolderBlogError extends Error {
+    /** HTTP status code if applicable */
+    readonly status?: number;
+    /** The URL that was requested */
+    readonly url?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        url?: string;
+    });
+}
+/**
+ * Error thrown when a resource is not found (404)
+ */
+declare class NotFoundError extends FolderBlogError {
+    constructor(resource: string, identifier: string, url?: string);
+}
+/**
+ * Error thrown when the API request fails
+ */
+declare class ApiError extends FolderBlogError {
+    constructor(message: string, status: number, url?: string);
+}
+/**
+ * Error thrown when network/fetch fails
+ */
+declare class NetworkError extends FolderBlogError {
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+
+export { ApiError, type FolderBlogClient, FolderBlogError, type FolderBlogOptions, NetworkError, NotFoundError, type Post, type PostSummary, type Site, folderBlog };

package/dist/index.js

@@ -0,0 +1 @@
+var o=class extends Error{status;url;constructor(t,r){super(t),this.name="FolderBlogError",this.status=r?.status,this.url=r?.url}},a=class extends o{constructor(t,r,u){super(`${t} not found: ${r}`,{status:404,url:u}),this.name="NotFoundError"}},l=class extends o{constructor(t,r,u){super(t,{status:r,url:u}),this.name="ApiError"}},c=class extends o{cause;constructor(t,r){super(t),this.name="NetworkError",this.cause=r}};function m(e){let t=e.trim();return t.endsWith("/")&&(t=t.slice(0,-1)),!t.startsWith("http://")&&!t.startsWith("https://")&&(t=`https://${t}`),t}function h(e,t={}){let r=m(e),u=t.fetch??globalThis.fetch;async function p(n){let s=`${r}${n}`,i;try{i=await u(s,{method:"GET",headers:{Accept:"application/json"}})}catch(d){throw new c(`Failed to fetch ${s}`,d instanceof Error?d:void 0)}if(!i.ok)throw i.status===404?new a("Resource",n,s):new l(`API request failed: ${i.statusText}`,i.status,s);try{return await i.json()}catch{throw new l("Failed to parse JSON response",i.status,s)}}return{posts:{async list(){return(await p("/api/posts")).posts},async get(n){if(!n)throw new o("Post slug is required");try{return await p(`/api/posts/${encodeURIComponent(n)}`)}catch(s){throw s instanceof a?new a("Post",n,s.url):s}}},site:{async get(){return p("/api")}}}}export{l as ApiError,o as FolderBlogError,c as NetworkError,a as NotFoundError,h as folderBlog};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "folderblog",
+  "version": "0.0.1",
+  "description": "SDK for consuming folder.blog content APIs",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "folderblog",
+    "blog",
+    "cms",
+    "headless",
+    "api",
+    "sdk",
+    "markdown",
+    "static-site"
+  ],
+  "author": "",
+  "license": "MIT",
+  "homepage": "https://folder.blog",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/folderblog"
+  },
+  "sideEffects": false,
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}