@sellhapi/studio-runtime 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Storefront data types for @sellhapi/studio-runtime
+ *
+ * These are the shapes returned by hooks and consumed by components.
+ * All monetary values are in kobo (integer × 100 = Naira).
+ */
+export interface StoreProduct {
+    id: string;
+    name: string;
+    description: string | null;
+    price: number;
+    priceKobo: number;
+    imageUrl: string | null;
+    type: "physical" | "digital";
+    slug: string | null;
+    categoryId: string | null;
+}
+export interface StoreProductVariant {
+    id: string;
+    name: string;
+    priceKobo: number;
+    sku: string | null;
+    stock: number | null;
+}
+export interface StoreProductDetail extends StoreProduct {
+    variants: StoreProductVariant[];
+}
+export interface StorefrontTicketType {
+    id: string;
+    name: string;
+    priceKobo: number;
+    capacity: number | null;
+    sold: number;
+    available: number | null;
+}
+export interface StorefrontEvent {
+    id: string;
+    title: string;
+    description: string | null;
+    startsAt: string;
+    endsAt: string | null;
+    location: string | null;
+    imageUrl: string | null;
+    status: string;
+    ticketTypes: StorefrontTicketType[];
+}
+export interface StorefrontMembershipTier {
+    id: string;
+    name: string;
+    description: string | null;
+    priceKobo: number;
+    billingPeriod: "monthly" | "yearly";
+    benefits: string[];
+    isActive: boolean;
+}
+export interface StorefrontService {
+    id: string;
+    name: string;
+    description: string | null;
+    priceKobo: number;
+    durationMinutes: number;
+    isActive: boolean;
+    imageUrl: string | null;
+}
+export interface StorefrontArticle {
+    id: string;
+    title: string;
+    slug: string;
+    excerpt: string | null;
+    coverUrl: string | null;
+    publishedAt: string;
+    author: {
+        name: string;
+        avatarUrl: string | null;
+    } | null;
+    category: {
+        name: string;
+        slug: string;
+    } | null;
+    tags: string[];
+}
+export interface StorefrontDonationCampaign {
+    id: string;
+    title: string;
+    description: string | null;
+    coverImageUrl: string | null;
+    status: "active" | "paused" | "ended";
+    goalAmountKobo: number | null;
+    raisedAmountKobo: number;
+    donorCount: number;
+    /**
+     * Fixed-amount mode. When non-null, the contributor pays exactly this amount —
+     * no amount input is shown on the storefront. null = open-amount mode.
+     */
+    fixedAmountKobo: number | null;
+    minDonationKobo: number;
+    maxDonationKobo: number | null;
+    presetAmounts: number[];
+    isAnonymousAllowed: boolean;
+    showGoalProgress: boolean;
+    showDonorCount: boolean;
+    endsAt: string | null;
+}
+export interface RSVPInput {
+    eventId: string;
+    name: string;
+    email: string;
+    phone?: string;
+}
+export interface CommerceCustomer {
+    name: string;
+    email: string;
+    phone: string;
+    address?: string;
+}
+/** Returned by all commerce action hooks after initiate() resolves */
+export interface CommerceActionResult {
+    paymentLink: string;
+    orderId?: string;
+    reference?: string;
+}
+export interface AvailabilitySlot {
+    id: string;
+    startTime: string;
+    endTime: string;
+    available: boolean;
+}
+export interface BookAppointmentInput {
+    serviceId: string;
+    staffMemberId: string;
+    slotId: string;
+    customer: CommerceCustomer;
+    note?: string;
+}
+export interface TicketOrder {
+    ticketTypeId: string;
+    quantity: number;
+}
+export interface PurchaseTicketsInput {
+    eventId: string;
+    ticketOrders: TicketOrder[];
+    customer: CommerceCustomer;
+}
+export interface DonateInput {
+    campaignId: string;
+    amountKobo: number;
+    customer: CommerceCustomer;
+    isAnonymous?: boolean;
+    donorMessage?: string;
+}
+export interface SubscribeMembershipInput {
+    tierId: string;
+    customer: CommerceCustomer;
+}
+export interface ProductCheckoutInput {
+    productId: string;
+    quantity: number;
+    variantId?: string;
+    customer: CommerceCustomer;
+    deliveryMethod?: "delivery" | "pickup";
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@sellhapi/studio-runtime",
+  "version": "0.1.0",
+  "description": "SellHapi Studio Runtime — hooks and components for AI-generated storefronts",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "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":      "node build.mjs",
+    "prepublish": "node build.mjs"
+  },
+  "peerDependencies": {
+    "react":     ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/react":     "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "esbuild":          "^0.25.12",
+    "typescript":       "^6.0.3"
+  },
+  "keywords": ["sellhapi", "studio", "runtime", "storefront", "hooks", "components"],
+  "author": "SellHapi",
+  "license": "MIT"
+}