arky-sdk 0.3.23 → 0.3.25

package/README.md

@@ -1,114 +1,314 @@
-# @arky/sdk
+# arky-sdk
 
 Official TypeScript SDK for Arky - All-in-one business platform
 
 ## Installation
 
 ```bash
-npm install @arky/sdk
+npm install arky-sdk
 ```
 
 ## Quick Start
 
-### API Client (No State)
-
 ```typescript
-import { initArky } from '@arky/sdk'
+import { createArkySDK } from 'arky-sdk'
 
-initArky({
-  apiUrl: 'https://api.arky.io',
+const arky = createArkySDK({
+  baseUrl: 'https://api.arky.io',
   businessId: 'your-business-id',
-  storageUrl: 'https://storage.arky.io'
+  storageUrl: 'https://storage.arky.io',
+  market: 'us',
+  getToken: () => ({
+    accessToken: localStorage.getItem('accessToken') || '',
+    refreshToken: localStorage.getItem('refreshToken') || '',
+    provider: 'EMAIL',
+    expiresAt: 0,
+  }),
+  setToken: (tokens) => {
+    localStorage.setItem('accessToken', tokens.accessToken);
+    localStorage.setItem('refreshToken', tokens.refreshToken);
+  },
+  logout: () => {
+    localStorage.removeItem('accessToken');
+    localStorage.removeItem('refreshToken');
+  },
+  isAuthenticated: () => !!localStorage.getItem('accessToken'),
 })
 
-// Now use the API
-import { cmsApi } from '@arky/sdk'
+// Now use the SDK
+const collections = await arky.cms.getCollections({});
+const products = await arky.eshop.getProducts({});
+```
+
+## API Methods
+
+The SDK provides the following API modules:
 
-const { getCollection } = cmsApi();
-const collection = await getCollection('website');
+### User Management
+```typescript
+// Authentication
+await arky.user.loginUser({ email, password })
+await arky.user.registerUser({ email, password, name })
+await arky.user.getMe()
+await arky.user.logout()
+
+// Profile
+await arky.user.updateUser({ name, phoneNumber, addresses })
+await arky.user.resetPassword({ oldPassword, newPassword })
 ```
 
-### With Reactive Stores
+### Business
+```typescript
+// Business CRUD
+await arky.business.createBusiness({ name, slug })
+await arky.business.getBusiness()
+await arky.business.updateBusiness({ id, name })
+await arky.business.deleteBusiness({ id })
+
+// Subscriptions
+await arky.business.createSubscription({ planId })
+await arky.business.getSubscription()
+await arky.business.cancelSubscription({ immediately: true })
+```
 
+### CMS & Newsletters
 ```typescript
-import { initArky } from '@arky/sdk/stores'
-import { cartItems, eshopActions } from '@arky/sdk/stores'
+// Collections
+await arky.cms.createCollection({ name, slug, type: 'NEWSLETTER' })
+await arky.cms.getCollections({ type: 'NEWSLETTER' })
+await arky.cms.getCollection({ id })
+await arky.cms.updateCollection({ id, name })
+await arky.cms.deleteCollection({ id })
+
+// Entries (Content)
+await arky.cms.createCollectionEntry({ collectionId, blocks })
+await arky.cms.getCollectionEntries({ collectionId })
+await arky.cms.updateCollectionEntry({ id, blocks })
+await arky.cms.sendEntry({ entryId, scheduledAt })
+
+// Newsletter Subscriptions
+await arky.cms.subscribeToCollection({
+  collectionId: 'newsletter_id',
+  email: 'user@example.com',
+  planId: 'plan_free', // Required
+})
+await arky.cms.getCollectionSubscribers({ id: 'newsletter_id' })
+await arky.cms.unsubscribeFromCollection({ token: 'unsubscribe_token' })
+```
 
-initArky({
-  apiUrl: 'https://api.arky.io',
-  businessId: 'your-business-id'
+### E-shop
+```typescript
+// Products
+await arky.eshop.createProduct({ name, description, variants })
+await arky.eshop.getProducts({ limit: 20, cursor: null })
+await arky.eshop.getProduct({ id })
+await arky.eshop.updateProduct({ id, name })
+
+// Orders
+await arky.eshop.checkout({ items, paymentMethod, shippingMethodId })
+await arky.eshop.getOrders({})
+await arky.eshop.getOrder({ id })
+await arky.eshop.updateOrderStatus({ id, status: 'SHIPPED' })
+
+// Quote
+await arky.eshop.getQuote({
+  items: [{ productId, variantId, quantity }],
+  currency: 'usd',
+  paymentMethod: 'CREDIT_CARD',
 })
+```
 
-// Use stores (framework-agnostic)
-cartItems.subscribe(items => console.log('Cart:', items))
-await eshopActions.addToCart({ productId: 'x', variantId: 'y', quantity: 1 })
+### Reservations
+```typescript
+// Services
+await arky.reservation.createService({ name, duration, price })
+await arky.reservation.getServices({})
+await arky.reservation.getAvailableSlots({ serviceId, start, end })
+
+// Providers
+await arky.reservation.createProvider({ name, serviceIds })
+await arky.reservation.getProviders({})
+
+// Reservations
+await arky.reservation.createReservation({ parts, blocks })
+await arky.reservation.checkout({ parts, paymentMethod })
+await arky.reservation.searchReservations({ start, end })
 ```
 
-## Framework Integration
+### Media
+```typescript
+// Upload files
+const media = await arky.media.uploadBusinessMedia({
+  files: [file1, file2],
+  urls: ['https://example.com/image.jpg'],
+})
+
+// List media
+const { items } = await arky.media.getBusinessMedia({ limit: 20 })
+
+// Delete media
+await arky.media.deleteBusinessMedia({ id: businessId, mediaId })
+```
 
-### Svelte (No adapter needed!)
+### Notifications
+```typescript
+// Get notifications
+const notifications = await arky.notification.getNotifications({
+  limit: 20,
+  previous_id: null,
+})
 
-```svelte
-<script>
-  import { cartItems, eshopActions } from '@arky/sdk/stores'
-</script>
+// Mark as seen
+await arky.notification.updateNotifications({})
 
-<button on:click={() => eshopActions.addToCart(...)}>
-  Cart ({$cartItems.length})
-</button>
+// Delivery stats
+const stats = await arky.notification.getDeliveryStats({})
 ```
 
-### React
+### Analytics
+```typescript
+// Query metrics
+const data = await arky.analytics.getAnalytics({
+  start: '2024-01-01',
+  end: '2024-12-31',
+  metrics: ['revenue', 'orders', 'users'],
+})
 
-```bash
-npm install @nanostores/react
+// Health check
+const health = await arky.analytics.getAnalyticsHealth({})
+```
+
+### Roles & Permissions
+```typescript
+await arky.role.createRole({ name, permissions })
+await arky.role.getRoles({ action: 'READ' })
+await arky.role.updateRole({ id, permissions })
+await arky.user.setRole({ userId, roleId })
 ```
 
+## Utility Functions
+
+The SDK includes helpful utilities accessible via `arky.utils`:
+
+### Block Utilities
 ```typescript
-import { useStore } from '@nanostores/react'
-import { cartItems } from '@arky/sdk/stores'
+// Get image URL from block
+const url = arky.utils.getImageUrl(imageBlock)
 
-function Cart() {
-  const items = useStore(cartItems)
-  return <div>Cart ({items.length})</div>
-}
+// Get block values
+const value = arky.utils.getBlockValue(entry, 'title')
+const values = arky.utils.getBlockValues(entry, 'gallery')
+const text = arky.utils.getBlockTextValue(block, 'en')
+
+// Format blocks
+const formatted = arky.utils.formatBlockValue(block)
+const forSubmit = arky.utils.prepareBlocksForSubmission(blocks)
 ```
 
-### Vue
+### Price Utilities
+```typescript
+// Format prices
+const formatted = arky.utils.formatMinor(999, 'usd') // "$9.99"
+const payment = arky.utils.formatPayment(paymentObject)
 
-```bash
-npm install @nanostores/vue
+// Get market prices
+const price = arky.utils.getMarketPrice(prices, 'US', markets)
+const amount = arky.utils.getPriceAmount(prices, 'US')
+
+// Currency
+const symbol = arky.utils.getCurrencySymbol('USD') // "$"
 ```
 
-```vue
-<script setup>
-import { useStore } from '@nanostores/vue'
-import { cartItems } from '@arky/sdk/stores'
+### Text Utilities
+```typescript
+const slug = arky.utils.slugify('Hello World') // "hello-world"
+const title = arky.utils.humanize('hello-world') // "Hello World"
+const category = arky.utils.categorify('hello-world') // "HELLO WORLD"
+const date = arky.utils.formatDate(timestamp, 'en')
+```
+
+### Validation
+```typescript
+const result = arky.utils.validatePhoneNumber('+1234567890')
+// { isValid: true } or { isValid: false, error: "..." }
+```
+
+### SVG Utilities
+```typescript
+// Fetch SVG content
+const svgString = await arky.utils.fetchSvgContent(mediaBlock)
 
-const items = useStore(cartItems)
-</script>
+// For Astro
+const svg = await arky.utils.getSvgContentForAstro(mediaBlock)
 
-<template>
-  <div>Cart ({{ items.length }})</div>
-</template>
+// Inject into element
+await arky.utils.injectSvgIntoElement(mediaBlock, element, 'custom-class')
 ```
 
 ## Features
 
-- 🚀 TypeScript-first
-- 🎯 Framework-agnostic
-- 📦 Tree-shakeable
-- 🔄 Optional reactive stores (nanostores)
-- ⚡ Tiny bundle size
+- 🚀 **TypeScript-first** - Full type safety and IntelliSense
+- 📦 **Tree-shakeable** - Import only what you need
+- ⚡ **Lightweight** - Minimal bundle size (~120KB)
+- 🔄 **Auto-refresh** - Automatic token refresh
+- 🎯 **Framework-agnostic** - Works with any JavaScript framework
 
 ## Modules
 
-- **CMS** - Headless content management
-- **E-shop** - E-commerce & orders
-- **Reservations** - Booking system
-- **Newsletter** - Email campaigns
-- **Analytics** - Business insights
+- **CMS** - Headless content management, newsletters, AI blocks
+- **E-shop** - E-commerce, products, orders, checkout
+- **Reservations** - Booking system, services, providers
+- **Business** - Multi-tenant business management
+- **User** - Authentication, profiles, roles
+- **Media** - File upload, image management
+- **Notifications** - Push, email, SMS
+- **Analytics** - Business metrics and insights
+- **Payment** - Stripe integration, quotes
+
+## Configuration Options
+
+```typescript
+createArkySDK({
+  // Required
+  baseUrl: string,        // API URL
+  businessId: string,     // Your business ID
+  market: string,         // Market code (e.g., 'us', 'eu')
+
+  // Token management
+  getToken: () => TokenData,
+  setToken: (tokens: TokenData) => void,
+
+  // Optional
+  storageUrl?: string,    // Storage URL (default: https://storage.arky.io/dev)
+  autoGuest?: boolean,    // Auto-create guest token (default: true)
+  logout?: () => void,    // Logout callback
+  isAuthenticated?: () => boolean,
+  navigate?: (path: string) => void,
+  notify?: (notification: { message: string; type: string }) => void,
+})
+```
+
+## TypeScript Support
+
+The SDK is written in TypeScript and provides full type definitions:
+
+```typescript
+import type {
+  HttpClientConfig,
+  ApiResponse,
+  Block,
+  Business,
+  Price,
+  // ... and many more
+} from 'arky-sdk'
+```
 
 ## License
 
 MIT
+
+## Links
+
+- [Documentation](https://docs.arky.io)
+- [GitHub](https://github.com/0xDjole/arky-sdk)
+- [npm](https://www.npmjs.com/package/arky-sdk)

package/dist/index.cjs

@@ -1496,7 +1496,7 @@ async function injectSvgIntoElement(mediaObject, targetElement, className) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.3.21";
+var SDK_VERSION = "0.3.25";
 var SUPPORTED_FRAMEWORKS = [
   "astro",
   "react",