arky-sdk 0.2.0 → 0.3.1

package/README.md

@@ -0,0 +1,114 @@
+# @arky/sdk
+
+Official TypeScript SDK for Arky - All-in-one business platform
+
+## Installation
+
+```bash
+npm install @arky/sdk
+```
+
+## Quick Start
+
+### API Client (No State)
+
+```typescript
+import { initArky } from '@arky/sdk'
+
+initArky({
+  apiUrl: 'https://api.arky.io',
+  businessId: 'your-business-id',
+  storageUrl: 'https://storage.arky.io'
+})
+
+// Now use the API
+import { cmsApi } from '@arky/sdk'
+
+const { getCollection } = cmsApi();
+const collection = await getCollection('website');
+```
+
+### With Reactive Stores
+
+```typescript
+import { initArky } from '@arky/sdk/stores'
+import { cartItems, eshopActions } from '@arky/sdk/stores'
+
+initArky({
+  apiUrl: 'https://api.arky.io',
+  businessId: 'your-business-id'
+})
+
+// Use stores (framework-agnostic)
+cartItems.subscribe(items => console.log('Cart:', items))
+await eshopActions.addToCart({ productId: 'x', variantId: 'y', quantity: 1 })
+```
+
+## Framework Integration
+
+### Svelte (No adapter needed!)
+
+```svelte
+<script>
+  import { cartItems, eshopActions } from '@arky/sdk/stores'
+</script>
+
+<button on:click={() => eshopActions.addToCart(...)}>
+  Cart ({$cartItems.length})
+</button>
+```
+
+### React
+
+```bash
+npm install @nanostores/react
+```
+
+```typescript
+import { useStore } from '@nanostores/react'
+import { cartItems } from '@arky/sdk/stores'
+
+function Cart() {
+  const items = useStore(cartItems)
+  return <div>Cart ({items.length})</div>
+}
+```
+
+### Vue
+
+```bash
+npm install @nanostores/vue
+```
+
+```vue
+<script setup>
+import { useStore } from '@nanostores/vue'
+import { cartItems } from '@arky/sdk/stores'
+
+const items = useStore(cartItems)
+</script>
+
+<template>
+  <div>Cart ({{ items.length }})</div>
+</template>
+```
+
+## Features
+
+- 🚀 TypeScript-first
+- 🎯 Framework-agnostic
+- 📦 Tree-shakeable
+- 🔄 Optional reactive stores (nanostores)
+- ⚡ Tiny bundle size
+
+## Modules
+
+- **CMS** - Headless content management
+- **E-shop** - E-commerce & orders
+- **Reservations** - Booking system
+- **Newsletter** - Email campaigns
+- **Analytics** - Business insights
+
+## License
+
+MIT

package/dist/{validation-C9UAYKke.d.cts → index-DEmVFs0E.d.ts}

@@ -1,4 +1,4 @@
-import { Payment, Price } from './types.cjs';
+import { Price, Payment } from './types.js';
 
 interface Block {
     id: string;
@@ -25,11 +25,24 @@ declare const getBlockValue: (entry: any, blockKey: string) => any;
 declare const getBlockValues: (entry: any, blockKey: string) => any;
 declare const getBlockObjectValues: (entry: any, blockKey: string, locale?: string) => any;
 declare const getBlockFromArray: (entry: any, blockKey: string, locale?: string) => any;
-declare const getImageUrl: (imageBlock: any, isBlock?: boolean) => any;
+declare const getImageUrl: (imageBlock: any, isBlock?: boolean, storageUrl?: string) => any;
 declare function getGalleryThumbnail(gallery: any): any;
-declare function thumbnailUrl(service: any): string;
+declare function thumbnailUrl(service: any, storageUrl?: string): string;
 declare const translateMap: (labels: any, lang: string, fallback?: string) => any;
 
+/**
+ * Maps currency codes to their display symbols
+ */
+declare function getCurrencySymbol(currency: string): string;
+/**
+ * List of currencies where the symbol appears after the amount
+ */
+declare const SYMBOL_AFTER_CURRENCIES: string[];
+/**
+ * Check if currency symbol should be placed after the amount
+ */
+declare function isSymbolAfterCurrency(currency: string): boolean;
+
 declare const ERROR_CODES: {
     "GENERAL.001": string;
     "GENERAL.002": string;
@@ -98,18 +111,17 @@ declare const ERROR_CONSTANTS: {
     };
 };
 type ServerError = {
+    message: string;
     error: string;
-    reason: string;
-    code: string;
     statusCode: number;
     validationErrors: {
         field: string;
-        code: string;
+        error: string;
     }[];
 };
 type ValidationError = {
     field: string;
-    message: string;
+    error: string;
 };
 type RequestError = {
     validationErrors: ValidationError[];
@@ -152,7 +164,6 @@ declare const errors: {
 
 declare function convertToMajor(minorAmount: number): number;
 declare function convertToMinor(majorAmount: number): number;
-declare function getSymbol(currency: string): string;
 declare function getCurrencyFromMarket(marketId: string): string;
 declare function formatCurrencyAmount(amount: number, currency: string, options?: {
     showSymbols?: boolean;
@@ -242,4 +253,4 @@ declare function validateEmail(email: string): ValidationResult;
 declare function validateVerificationCode(code: string): ValidationResult;
 declare function validateRequired(value: any, fieldName?: string): ValidationResult;
 
-export { getBlockObjectValues as A, getBlockFromArray as B, type Collection as C, getGalleryThumbnail as D, ERROR_CODES as E, translateMap as F, transformErrors as G, convertServerErrorToRequestError as H, errors as I, convertToMajor as J, convertToMinor as K, getSymbol as L, getCurrencyFromMarket as M, formatCurrencyAmount as N, formatMinor as O, formatPayment as P, getMarketPrice as Q, type RequestError as R, type ServerError as S, getPriceAmount as T, createPaymentForCheckout as U, type ValidationError as V, type ValidationResult as W, type Block as X, validateEmail as a, validateVerificationCode as b, validateRequired as c, getBlockTextValue as d, getBlockValue as e, getBlockValues as f, getBlockLabel as g, getImageUrl as h, fetchSvgContent as i, getSvgContentForAstro as j, injectSvgIntoElement as k, humanize as l, categorify as m, formatDate as n, findTimeZone as o, tzGroups as p, getErrorMessage as q, isErrorCode as r, slugify as s, thumbnailUrl as t, ERROR_CONSTANTS as u, validatePhoneNumber as v, type CollectionEntry as w, formatBlockValue as x, prepareBlocksForSubmission as y, extractBlockValues as z };
+export { isErrorCode as A, transformErrors as B, type Collection as C, convertServerErrorToRequestError as D, ERROR_CODES as E, errors as F, convertToMajor as G, convertToMinor as H, getCurrencyFromMarket as I, formatCurrencyAmount as J, fetchSvgContent as K, getSvgContentForAstro as L, injectSvgIntoElement as M, slugify as N, humanize as O, categorify as P, formatDate as Q, type RequestError as R, SYMBOL_AFTER_CURRENCIES as S, tzGroups as T, type ValidationResult as U, type ValidationError as V, validateEmail as W, validateVerificationCode as X, validateRequired as Y, type Block as Z, getMarketPrice as a, getPriceAmount as b, formatMinor as c, createPaymentForCheckout as d, getCurrencySymbol as e, formatPayment as f, getGalleryThumbnail as g, findTimeZone as h, type CollectionEntry as i, getBlockLabel as j, formatBlockValue as k, extractBlockValues as l, getBlockTextValue as m, getBlockValue as n, getBlockValues as o, prepareBlocksForSubmission as p, getBlockObjectValues as q, getBlockFromArray as r, getImageUrl as s, thumbnailUrl as t, translateMap as u, validatePhoneNumber as v, isSymbolAfterCurrency as w, ERROR_CONSTANTS as x, type ServerError as y, getErrorMessage as z };

package/dist/{validation-DIvAzYjG.d.ts → index-DOEos-hV.d.cts}

@@ -1,4 +1,4 @@
-import { Payment, Price } from './types.js';
+import { Price, Payment } from './types.cjs';
 
 interface Block {
     id: string;
@@ -25,11 +25,24 @@ declare const getBlockValue: (entry: any, blockKey: string) => any;
 declare const getBlockValues: (entry: any, blockKey: string) => any;
 declare const getBlockObjectValues: (entry: any, blockKey: string, locale?: string) => any;
 declare const getBlockFromArray: (entry: any, blockKey: string, locale?: string) => any;
-declare const getImageUrl: (imageBlock: any, isBlock?: boolean) => any;
+declare const getImageUrl: (imageBlock: any, isBlock?: boolean, storageUrl?: string) => any;
 declare function getGalleryThumbnail(gallery: any): any;
-declare function thumbnailUrl(service: any): string;
+declare function thumbnailUrl(service: any, storageUrl?: string): string;
 declare const translateMap: (labels: any, lang: string, fallback?: string) => any;
 
+/**
+ * Maps currency codes to their display symbols
+ */
+declare function getCurrencySymbol(currency: string): string;
+/**
+ * List of currencies where the symbol appears after the amount
+ */
+declare const SYMBOL_AFTER_CURRENCIES: string[];
+/**
+ * Check if currency symbol should be placed after the amount
+ */
+declare function isSymbolAfterCurrency(currency: string): boolean;
+
 declare const ERROR_CODES: {
     "GENERAL.001": string;
     "GENERAL.002": string;
@@ -98,18 +111,17 @@ declare const ERROR_CONSTANTS: {
     };
 };
 type ServerError = {
+    message: string;
     error: string;
-    reason: string;
-    code: string;
     statusCode: number;
     validationErrors: {
         field: string;
-        code: string;
+        error: string;
     }[];
 };
 type ValidationError = {
     field: string;
-    message: string;
+    error: string;
 };
 type RequestError = {
     validationErrors: ValidationError[];
@@ -152,7 +164,6 @@ declare const errors: {
 
 declare function convertToMajor(minorAmount: number): number;
 declare function convertToMinor(majorAmount: number): number;
-declare function getSymbol(currency: string): string;
 declare function getCurrencyFromMarket(marketId: string): string;
 declare function formatCurrencyAmount(amount: number, currency: string, options?: {
     showSymbols?: boolean;
@@ -242,4 +253,4 @@ declare function validateEmail(email: string): ValidationResult;
 declare function validateVerificationCode(code: string): ValidationResult;
 declare function validateRequired(value: any, fieldName?: string): ValidationResult;
 
-export { getBlockObjectValues as A, getBlockFromArray as B, type Collection as C, getGalleryThumbnail as D, ERROR_CODES as E, translateMap as F, transformErrors as G, convertServerErrorToRequestError as H, errors as I, convertToMajor as J, convertToMinor as K, getSymbol as L, getCurrencyFromMarket as M, formatCurrencyAmount as N, formatMinor as O, formatPayment as P, getMarketPrice as Q, type RequestError as R, type ServerError as S, getPriceAmount as T, createPaymentForCheckout as U, type ValidationError as V, type ValidationResult as W, type Block as X, validateEmail as a, validateVerificationCode as b, validateRequired as c, getBlockTextValue as d, getBlockValue as e, getBlockValues as f, getBlockLabel as g, getImageUrl as h, fetchSvgContent as i, getSvgContentForAstro as j, injectSvgIntoElement as k, humanize as l, categorify as m, formatDate as n, findTimeZone as o, tzGroups as p, getErrorMessage as q, isErrorCode as r, slugify as s, thumbnailUrl as t, ERROR_CONSTANTS as u, validatePhoneNumber as v, type CollectionEntry as w, formatBlockValue as x, prepareBlocksForSubmission as y, extractBlockValues as z };
+export { isErrorCode as A, transformErrors as B, type Collection as C, convertServerErrorToRequestError as D, ERROR_CODES as E, errors as F, convertToMajor as G, convertToMinor as H, getCurrencyFromMarket as I, formatCurrencyAmount as J, fetchSvgContent as K, getSvgContentForAstro as L, injectSvgIntoElement as M, slugify as N, humanize as O, categorify as P, formatDate as Q, type RequestError as R, SYMBOL_AFTER_CURRENCIES as S, tzGroups as T, type ValidationResult as U, type ValidationError as V, validateEmail as W, validateVerificationCode as X, validateRequired as Y, type Block as Z, getMarketPrice as a, getPriceAmount as b, formatMinor as c, createPaymentForCheckout as d, getCurrencySymbol as e, formatPayment as f, getGalleryThumbnail as g, findTimeZone as h, type CollectionEntry as i, getBlockLabel as j, formatBlockValue as k, extractBlockValues as l, getBlockTextValue as m, getBlockValue as n, getBlockValues as o, prepareBlocksForSubmission as p, getBlockObjectValues as q, getBlockFromArray as r, getImageUrl as s, thumbnailUrl as t, translateMap as u, validatePhoneNumber as v, isSymbolAfterCurrency as w, ERROR_CONSTANTS as x, type ServerError as y, getErrorMessage as z };