@siyaqi/react-native 0.1.0

package/README.md

@@ -0,0 +1,29 @@
+# @siyaqi/react-native
+
+Expo / React Native publisher module. Calls **Fly serve only**.
+
+```bash
+npm install @siyaqi/react-native
+```
+
+```tsx
+import { SiyaqiAd } from "@siyaqi/react-native";
+
+<SiyaqiAd
+  serveBase="https://siyaqi-prod.fly.dev"
+  placementId="plc_YOUR_ID"
+/>
+```
+
+Hook form (same contract):
+
+```tsx
+import { useSiyaqiAd } from "@siyaqi/react-native";
+
+const { ad, isLoading } = useSiyaqiAd({
+  placementId: "plc_YOUR_ID",
+  serveUrl: "https://siyaqi-prod.fly.dev",
+});
+```
+
+Peer deps: `react`, `react-native`. MCP for advertiser campaign ops stays in-repo (`npx tsx apps/mcp/src/index.ts`) — it is not published to npm.

package/dist/SiyaqiAd.d.ts

@@ -0,0 +1,14 @@
+import { type TextStyle, type ViewStyle } from "react-native";
+export type SiyaqiAdProps = {
+    serveBase: string;
+    placementId: string;
+    context?: string;
+    style?: ViewStyle;
+    textStyle?: TextStyle;
+    ctaStyle?: TextStyle;
+};
+/**
+ * Lightweight text ad unit for Expo / React Native publishers.
+ * Talks only to Fly serve (`serveBase`), never Railway portal APIs.
+ */
+export declare function SiyaqiAd({ serveBase, placementId, context, style, textStyle, ctaStyle, }: SiyaqiAdProps): import("react").JSX.Element;

package/dist/SiyaqiAd.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from "react";
+import { Pressable, StyleSheet, Text, View, } from "react-native";
+import { fetchAd, reportClick } from "./api.js";
+/**
+ * Lightweight text ad unit for Expo / React Native publishers.
+ * Talks only to Fly serve (`serveBase`), never Railway portal APIs.
+ */
+export function SiyaqiAd({ serveBase, placementId, context, style, textStyle, ctaStyle, }) {
+    const [ad, setAd] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        let cancelled = false;
+        void (async () => {
+            try {
+                const next = await fetchAd(serveBase, placementId, context);
+                if (!cancelled)
+                    setAd(next);
+            }
+            catch {
+                if (!cancelled)
+                    setError("Failed to load ad");
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [serveBase, placementId, context]);
+    const onPress = useCallback(() => {
+        if (!ad)
+            return;
+        void reportClick(serveBase, ad);
+    }, [ad, serveBase]);
+    if (error) {
+        return (_jsx(View, { style: [styles.box, style], children: _jsx(Text, { style: styles.muted, children: error }) }));
+    }
+    if (!ad) {
+        return (_jsx(View, { style: [styles.box, style], children: _jsx(Text, { style: styles.muted, children: "Loading\u2026" }) }));
+    }
+    return (_jsxs(Pressable, { onPress: onPress, style: [styles.box, style], children: [_jsx(Text, { style: [styles.text, textStyle], children: ad.text }), _jsx(Text, { style: [styles.cta, ctaStyle], children: ad.cta })] }));
+}
+const styles = StyleSheet.create({
+    box: { padding: 12 },
+    text: { fontSize: 15, color: "#111" },
+    cta: { marginTop: 8, fontSize: 14, fontWeight: "600", color: "#0B6E4F" },
+    muted: { fontSize: 13, color: "#666" },
+});

package/dist/api.d.ts

@@ -0,0 +1,13 @@
+export declare function serveUrl(serveBase: string, placementId: string, context?: string): string;
+export declare function clickUrl(serveBase: string): string;
+export declare function impressionUrl(serveBase: string): string;
+export type ServedCreative = {
+    trackingId: string;
+    campaignId: string;
+    variantId: string;
+    placementId: string;
+    text: string;
+    cta: string;
+};
+export declare function fetchAd(serveBase: string, placementId: string, context?: string, fetchImpl?: typeof fetch): Promise<ServedCreative | null>;
+export declare function reportClick(serveBase: string, ad: ServedCreative, fetchImpl?: typeof fetch): Promise<void>;

package/dist/api.js

@@ -0,0 +1,39 @@
+/** Vendored serve paths — keep in sync with packages/shared `API`. */
+const SERVE = {
+    serveAd: "/v1/ads/serve",
+    impression: "/v1/ads/impression",
+    click: "/v1/ads/click",
+};
+export function serveUrl(serveBase, placementId, context) {
+    const base = serveBase.replace(/\/$/, "");
+    const u = new URL(`${base}${SERVE.serveAd}`);
+    u.searchParams.set("placementId", placementId);
+    if (context)
+        u.searchParams.set("context", context);
+    return u.toString();
+}
+export function clickUrl(serveBase) {
+    return `${serveBase.replace(/\/$/, "")}${SERVE.click}`;
+}
+export function impressionUrl(serveBase) {
+    return `${serveBase.replace(/\/$/, "")}${SERVE.impression}`;
+}
+export async function fetchAd(serveBase, placementId, context, fetchImpl = fetch) {
+    const res = await fetchImpl(serveUrl(serveBase, placementId, context));
+    if (!res.ok)
+        return null;
+    const data = (await res.json());
+    return data.ad ?? null;
+}
+export async function reportClick(serveBase, ad, fetchImpl = fetch) {
+    await fetchImpl(clickUrl(serveBase), {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            trackingId: ad.trackingId,
+            campaignId: ad.campaignId,
+            variantId: ad.variantId,
+            placementId: ad.placementId,
+        }),
+    });
+}

package/dist/api.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/api.test.js

@@ -0,0 +1,17 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { clickUrl, serveUrl } from "./api.js";
+describe("siyaqi-react-native api helpers", () => {
+    it("builds serve URL", () => {
+        expect(serveUrl("https://siyaqi-prod.fly.dev", "plc_1")).toBe("https://siyaqi-prod.fly.dev/v1/ads/serve?placementId=plc_1");
+    });
+    it("builds click URL", () => {
+        expect(clickUrl("https://siyaqi-prod.fly.dev/")).toBe("https://siyaqi-prod.fly.dev/v1/ads/click");
+    });
+    it("does not import @siyaqi/shared", () => {
+        const src = readFileSync(join(dirname(fileURLToPath(import.meta.url)), "api.ts"), "utf8");
+        expect(src).not.toContain("@siyaqi/shared");
+    });
+});

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { SiyaqiAd, type SiyaqiAdProps } from "./SiyaqiAd.js";
+export { useSiyaqiAd, type UseSiyaqiAdOptions, } from "./useSiyaqiAd.js";
+export { fetchAd, reportClick, serveUrl, clickUrl, impressionUrl, type ServedCreative, } from "./api.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { SiyaqiAd } from "./SiyaqiAd.js";
+export { useSiyaqiAd, } from "./useSiyaqiAd.js";
+export { fetchAd, reportClick, serveUrl, clickUrl, impressionUrl, } from "./api.js";

package/dist/useSiyaqiAd.d.ts

@@ -0,0 +1,13 @@
+import { type ServedCreative } from "./api.js";
+export type UseSiyaqiAdOptions = {
+    placementId: string;
+    serveBase?: string;
+    /** Alias used in generated portal snippets. */
+    serveUrl?: string;
+    context?: string;
+};
+export declare function useSiyaqiAd(options: UseSiyaqiAdOptions): {
+    ad: ServedCreative | null;
+    isLoading: boolean;
+    error: string | null;
+};

package/dist/useSiyaqiAd.js

@@ -0,0 +1,38 @@
+import { useEffect, useState } from "react";
+import { fetchAd } from "./api.js";
+export function useSiyaqiAd(options) {
+    const serveBase = options.serveBase ?? options.serveUrl ?? "";
+    const { placementId, context } = options;
+    const [ad, setAd] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        let cancelled = false;
+        setIsLoading(true);
+        void (async () => {
+            try {
+                const next = serveBase
+                    ? await fetchAd(serveBase, placementId, context)
+                    : null;
+                if (!cancelled) {
+                    setAd(next);
+                    setError(null);
+                }
+            }
+            catch {
+                if (!cancelled) {
+                    setAd(null);
+                    setError("Failed to load ad");
+                }
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [serveBase, placementId, context]);
+    return { ad, isLoading, error };
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@siyaqi/react-native",
+  "version": "0.1.0",
+  "private": false,
+  "license": "MIT",
+  "description": "Expo / React Native publisher module for Siyaqi text ads (Fly serve /v1).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Siyaqi-AI/Siyaqi.git",
+    "directory": "packages/siyaqi-react-native"
+  },
+  "homepage": "https://github.com/Siyaqi-AI/Siyaqi/tree/main/packages/siyaqi-react-native",
+  "bugs": {
+    "url": "https://github.com/Siyaqi-AI/Siyaqi/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-native": ">=0.73"
+  },
+  "devDependencies": {
+    "@types/react": "^19",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  }
+}