@pagesolver/sdk 1.0.0

package/README.md

@@ -0,0 +1,189 @@
+# PageSolver SDK
+
+Official TypeScript/JavaScript SDK for the PageSolver API.
+
+## Installation
+
+```bash
+npm install @pagesolver/sdk
+# or
+bun add @pagesolver/sdk
+# or
+yarn add @pagesolver/sdk
+```
+
+## Quick Start
+
+```typescript
+import { PageSolverClient } from "@pagesolver/sdk";
+
+const client = new PageSolverClient("your-business-key");
+
+// Get comparisons
+const comparisons = await client.getComparisons();
+if (comparisons.data) {
+  console.log(comparisons.data.comparisons);
+}
+
+// Get showcases
+const showcases = await client.getShowcases();
+if (showcases.data) {
+  console.log(showcases.data.showcases);
+}
+
+// Send contact form
+const contactResult = await client.contact({
+  name: "John Doe",
+  email: "john@example.com",
+  message: "Hello from the SDK!",
+});
+
+if (contactResult.data?.success) {
+  console.log("Contact form sent successfully!");
+}
+```
+
+## API Reference
+
+### PageSolverClient
+
+#### Constructor
+
+```typescript
+new PageSolverClient(businessKey: string)
+```
+
+- `businessKey`: Your PageSolver business API key
+
+#### Methods
+
+##### `getComparisons()`
+
+Retrieves all comparison images for your business.
+
+```typescript
+const result = await client.getComparisons();
+// Returns: ApiResponse<{ comparisons: ComparisonImage[] }>
+```
+
+##### `getShowcases()`
+
+Retrieves all showcase images for your business.
+
+```typescript
+const result = await client.getShowcases();
+// Returns: ApiResponse<{ showcases: ShowcaseImage[] }>
+```
+
+##### `contact(data: ContactData)`
+
+Sends a contact form submission.
+
+```typescript
+const result = await client.contact({
+  name: "John Doe",
+  email: "john@example.com",
+  phone: "+1234567890", // optional
+  message: "Hello!", // optional
+});
+// Returns: ApiResponse<ContactResponse>
+```
+
+## Types
+
+### ComparisonImage
+
+```typescript
+interface ComparisonImage {
+  id: string;
+  url: string;
+  title?: string;
+  description?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+```
+
+### ShowcaseImage
+
+```typescript
+interface ShowcaseImage {
+  id: string;
+  url: string;
+  title?: string;
+  description?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+```
+
+### ContactData
+
+```typescript
+interface ContactData {
+  name: string;
+  email: string;
+  phone?: string;
+  message?: string;
+}
+```
+
+### ApiResponse
+
+```typescript
+interface ApiResponse<T> {
+  data?: T;
+  error?: string;
+  status: number;
+}
+```
+
+## Error Handling
+
+All methods return an `ApiResponse<T>` object that contains either:
+
+- `data`: The successful response data
+- `error`: An error message if the request failed
+- `status`: HTTP status code
+
+```typescript
+const result = await client.getComparisons();
+
+if (result.error) {
+  console.error("Error:", result.error);
+  console.error("Status:", result.status);
+} else {
+  console.log("Success:", result.data);
+}
+```
+
+## Development
+
+### Building
+
+```bash
+bun run build
+```
+
+### Testing
+
+```bash
+bun test
+```
+
+### Linting
+
+```bash
+bun run lint
+bun run lint:fix
+```
+
+### Type Checking
+
+```bash
+bun run type-check
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,3 @@
+class o{baseUrl="https://pagesolver.com/api/v1";businessKey;constructor(e){this.businessKey=e}async request(e,t={}){try{let n=`${this.baseUrl}${e}`,i={"Content-Type":"application/json","x-business-key":this.businessKey,...t.headers},s=await fetch(n,{...t,headers:i}),r;if(s.headers.get("Content-Type")?.includes("application/json"))r=await s.json();else r=await s.text();if(!s.ok)return{error:r?.error||"An unknown error occurred",status:s.status};return{data:r,status:s.status}}catch(n){return{error:n instanceof Error?n.message:"Network error",status:500}}}async getComparisons(){return this.request("/business/comparisons")}async getShowcases(){return this.request("/business/showcases")}async getQuickQuotes(){return this.request("/business/quick-quotes")}async createQuickQuote(e){return this.request("/business/quick-quotes",{method:"POST",body:JSON.stringify(e)})}async updateQuickQuote(e,t){return this.request(`/business/quick-quotes/${e}`,{method:"PUT",body:JSON.stringify(t)})}async deleteQuickQuote(e){return this.request(`/business/quick-quotes/${e}`,{method:"DELETE"})}async contact(e){return this.request("/business/contact",{method:"POST",body:JSON.stringify(e)})}}export{o as PageSolverClient};
+
+//# debugId=5AFD190CD8D6E0B664756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "// Database schema types\nexport interface ComparisonImage {\n  id: string;\n  businessId: string;\n  beforeUrl: string;\n  afterUrl: string;\n  description: string | null;\n  createdAt: Date;\n  title: string;\n}\n\nexport interface ShowcaseImage {\n  id: string;\n  businessId: string;\n  blobUrl: string[];\n  createdAt: Date;\n  description: string | null;\n  title: string;\n}\n\nexport interface QuickQuote {\n  id: string;\n  businessId: string;\n  parentId: string | null;\n  name: string;\n  description: string | null;\n  basePrice: string | null;\n  enabled: boolean;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\ninterface ApiResponse<T> {\n  data?: T;\n  error?: string;\n  status: number;\n}\n\ninterface ContactData {\n  name: string;\n  email: string;\n  phone?: string;\n  message?: string;\n}\n\ninterface ContactResponse {\n  success: boolean;\n}\n\ninterface QuickQuoteRequestData {\n  name: string;\n  description?: string;\n  basePrice?: string;\n  parentId?: string;\n  enabled?: boolean;\n}\n\nexport class PageSolverClient {\n  private baseUrl = \"https://pagesolver.com/api/v1\";\n  private businessKey: string;\n\n  constructor(businessKey: string) {\n    this.businessKey = businessKey;\n  }\n\n  private async request<T>(\n    endpoint: string,\n    options: RequestInit = {}\n  ): Promise<ApiResponse<T>> {\n    try {\n      const url = `${this.baseUrl}${endpoint}`;\n\n      const headers = {\n        \"Content-Type\": \"application/json\",\n        \"x-business-key\": this.businessKey,\n        ...options.headers,\n      };\n\n      const response = await fetch(url, {\n        ...options,\n        headers,\n      });\n\n      let data: unknown;\n      const contentType = response.headers.get(\"Content-Type\");\n      if (contentType?.includes(\"application/json\")) {\n        data = await response.json();\n      } else {\n        data = await response.text();\n      }\n\n      if (!response.ok) {\n        return {\n          error:\n            (data as { error?: string })?.error || \"An unknown error occurred\",\n          status: response.status,\n        };\n      }\n\n      return {\n        data: data as T,\n        status: response.status,\n      };\n    } catch (error) {\n      return {\n        error: error instanceof Error ? error.message : \"Network error\",\n        status: 500,\n      };\n    }\n  }\n\n  // Comparison Images\n  async getComparisons(): Promise<\n    ApiResponse<{ comparisons: ComparisonImage[] }>\n  > {\n    return this.request<{ comparisons: ComparisonImage[] }>(\n      \"/business/comparisons\"\n    );\n  }\n\n  // Showcase Images\n  async getShowcases(): Promise<ApiResponse<{ showcases: ShowcaseImage[] }>> {\n    return this.request<{ showcases: ShowcaseImage[] }>(\"/business/showcases\");\n  }\n\n  // Quick Quotes\n  async getQuickQuotes(): Promise<ApiResponse<{ quotes: QuickQuote[] }>> {\n    return this.request<{ quotes: QuickQuote[] }>(\"/business/quick-quotes\");\n  }\n\n  async createQuickQuote(\n    data: QuickQuoteRequestData\n  ): Promise<ApiResponse<QuickQuote>> {\n    return this.request<QuickQuote>(\"/business/quick-quotes\", {\n      method: \"POST\",\n      body: JSON.stringify(data),\n    });\n  }\n\n  async updateQuickQuote(\n    id: string,\n    data: Partial<QuickQuoteRequestData>\n  ): Promise<ApiResponse<QuickQuote>> {\n    return this.request<QuickQuote>(`/business/quick-quotes/${id}`, {\n      method: \"PUT\",\n      body: JSON.stringify(data),\n    });\n  }\n\n  async deleteQuickQuote(\n    id: string\n  ): Promise<ApiResponse<{ success: boolean }>> {\n    return this.request<{ success: boolean }>(`/business/quick-quotes/${id}`, {\n      method: \"DELETE\",\n    });\n  }\n\n  // Contact\n  async contact(data: ContactData): Promise<ApiResponse<ContactResponse>> {\n    return this.request<ContactResponse>(\"/business/contact\", {\n      method: \"POST\",\n      body: JSON.stringify(data),\n    });\n  }\n}\n\n// Export types for consumers\nexport type {\n  ApiResponse,\n  ContactData,\n  ContactResponse,\n  QuickQuoteRequestData,\n};\n"
+  ],
+  "mappings": "AAyDO,MAAM,CAAiB,CACpB,QAAU,gCACV,YAER,WAAW,CAAC,EAAqB,CAC/B,KAAK,YAAc,OAGP,QAAU,CACtB,EACA,EAAuB,CAAC,EACC,CACzB,GAAI,CACF,IAAM,EAAM,GAAG,KAAK,UAAU,IAExB,EAAU,CACd,eAAgB,mBAChB,iBAAkB,KAAK,eACpB,EAAQ,OACb,EAEM,EAAW,MAAM,MAAM,EAAK,IAC7B,EACH,SACF,CAAC,EAEG,EAEJ,GADoB,EAAS,QAAQ,IAAI,cAAc,GACtC,SAAS,kBAAkB,EAC1C,EAAO,MAAM,EAAS,KAAK,EAE3B,OAAO,MAAM,EAAS,KAAK,EAG7B,IAAK,EAAS,GACZ,MAAO,CACL,MACG,GAA6B,OAAS,4BACzC,OAAQ,EAAS,MACnB,EAGF,MAAO,CACL,KAAM,EACN,OAAQ,EAAS,MACnB,EACA,MAAO,EAAO,CACd,MAAO,CACL,MAAO,aAAiB,MAAQ,EAAM,QAAU,gBAChD,OAAQ,GACV,QAKE,eAAc,EAElB,CACA,OAAO,KAAK,QACV,uBACF,OAII,aAAY,EAAyD,CACzE,OAAO,KAAK,QAAwC,qBAAqB,OAIrE,eAAc,EAAmD,CACrE,OAAO,KAAK,QAAkC,wBAAwB,OAGlE,iBAAgB,CACpB,EACkC,CAClC,OAAO,KAAK,QAAoB,yBAA0B,CACxD,OAAQ,OACR,KAAM,KAAK,UAAU,CAAI,CAC3B,CAAC,OAGG,iBAAgB,CACpB,EACA,EACkC,CAClC,OAAO,KAAK,QAAoB,0BAA0B,IAAM,CAC9D,OAAQ,MACR,KAAM,KAAK,UAAU,CAAI,CAC3B,CAAC,OAGG,iBAAgB,CACpB,EAC4C,CAC5C,OAAO,KAAK,QAA8B,0BAA0B,IAAM,CACxE,OAAQ,QACV,CAAC,OAIG,QAAO,CAAC,EAA0D,CACtE,OAAO,KAAK,QAAyB,oBAAqB,CACxD,OAAQ,OACR,KAAM,KAAK,UAAU,CAAI,CAC3B,CAAC,EAEL",
+  "debugId": "5AFD190CD8D6E0B664756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@pagesolver/sdk",
+  "version": "1.0.0",
+  "description": "Official SDK for PageSolver API",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target node --minify --sourcemap=external && bun run build:types",
+    "build:types": "bunx tsc --emitDeclarationOnly --outDir dist",
+    "dev": "bun --watch src/index.ts",
+    "test": "bun test",
+    "lint": "bunx @biomejs/biome check src",
+    "lint:fix": "bunx @biomejs/biome check --apply src",
+    "type-check": "bunx tsc --noEmit",
+    "prepare": "bun run build",
+    "prepublishOnly": "bun run lint && bun run type-check && bun run test && bun run build"
+  },
+  "keywords": [
+    "pagesolver",
+    "api",
+    "sdk",
+    "typescript",
+    "web-development"
+  ],
+  "author": "PageSolver Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pagesolver/pagesolver-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pagesolver/pagesolver-sdk/issues"
+  },
+  "homepage": "https://github.com/pagesolver/pagesolver-sdk#readme",
+  "devDependencies": {
+    "@biomejs/biome": "^1.8.3",
+    "@types/bun": "latest",
+    "typescript": "^5.5.2"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "bun": ">=1.0.0"
+  }
+}