@insforge/sdk 1.3.0 → 1.3.2-razorpay.0

package/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing to InsForge SDK
+
+Thanks for helping improve the InsForge JavaScript SDK.
+
+## Development Setup
+
+1. Fork and clone this repository.
+2. Install dependencies:
+
+```bash
+npm install
+```
+
+3. Run the relevant checks before opening a pull request:
+
+```bash
+npm run typecheck
+npm run lint
+npm run test:run
+```
+
+## Pull Requests
+
+- Keep changes focused and describe the user-facing impact.
+- Add or update tests when changing SDK behavior.
+- Update `README.md` or `SDK-REFERENCE.md` when changing public APIs.
+- Link related issues in the pull request description.

package/README.md

@@ -74,10 +74,13 @@ const { data, error } = await insforge.auth.signInWithPassword({
 });
 
 // OAuth authentication (built-in or custom provider key)
-await insforge.auth.signInWithOAuth({
-  provider: "google", // e.g. built-in: "google", custom: "auth0-acme"
+await insforge.auth.signInWithOAuth("google", {
   redirectTo: "http://localhost:3000/dashboard",
+  additionalParams: { prompt: "select_account" },
 });
+// additionalParams is for provider-specific hints only.
+// Do not pass client_id, scope, redirect_uri, code_challenge, state, or response_type;
+// InsForge sets server-owned OAuth fields and ignores colliding client-provided keys.
 
 // Get current user (call this during browser app startup)
 const { data: currentUser } = await insforge.auth.getCurrentUser();
@@ -203,13 +206,16 @@ const { data, error } = await insforge.functions.invoke("my-function", {
 
 ```javascript
 // Create and redirect to a Stripe Checkout Session
-const { data, error } = await insforge.payments.createCheckoutSession("test", {
-  mode: "payment",
-  lineItems: [{ stripePriceId: "price_123", quantity: 1 }],
-  successUrl: `${window.location.origin}/success`,
-  cancelUrl: `${window.location.origin}/pricing`,
-  idempotencyKey: "cart_123",
-});
+const { data, error } = await insforge.payments.stripe.createCheckoutSession(
+  "test",
+  {
+    mode: "payment",
+    lineItems: [{ priceId: "price_123", quantity: 1 }],
+    successUrl: `${window.location.origin}/success`,
+    cancelUrl: `${window.location.origin}/pricing`,
+    idempotencyKey: "cart_123",
+  },
+);
 
 if (!error && data?.checkoutSession.url) {
   window.location.assign(data.checkoutSession.url);
@@ -217,10 +223,10 @@ if (!error && data?.checkoutSession.url) {
 
 // Create a subscription checkout for an app billing subject
 const { data: subscriptionCheckout } =
-  await insforge.payments.createCheckoutSession("test", {
+  await insforge.payments.stripe.createCheckoutSession("test", {
     mode: "subscription",
     subject: { type: "team", id: "team_123" },
-    lineItems: [{ stripePriceId: "price_monthly_123", quantity: 1 }],
+    lineItems: [{ priceId: "price_monthly_123", quantity: 1 }],
     successUrl: `${window.location.origin}/billing/success`,
     cancelUrl: `${window.location.origin}/billing`,
   });
@@ -230,33 +236,82 @@ if (subscriptionCheckout?.checkoutSession.url) {
 }
 
 // Let an authenticated customer manage their subscription in Stripe Billing Portal
-const { data: portal } = await insforge.payments.createCustomerPortalSession(
-  "test",
-  {
+const { data: portal } =
+  await insforge.payments.stripe.createCustomerPortalSession("test", {
     subject: { type: "team", id: "team_123" },
     returnUrl: `${window.location.origin}/billing`,
-  },
-);
+  });
 
 if (portal?.customerPortalSession.url) {
   window.location.assign(portal.customerPortalSession.url);
 }
+
+// Create a Razorpay order, then pass checkoutOptions to Razorpay Checkout.js
+const { data: order } = await insforge.payments.razorpay.createOrder("test", {
+  amount: 200000,
+  currency: "INR",
+  subject: { type: "team", id: "team_123" },
+  customerEmail: "ada@example.com",
+});
+
+if (order) {
+  const checkout = new Razorpay({
+    ...order.checkoutOptions,
+    handler: async (response) => {
+      await insforge.payments.razorpay.verifyOrder("test", {
+        orderId: response.razorpay_order_id,
+        paymentId: response.razorpay_payment_id,
+        signature: response.razorpay_signature,
+      });
+    },
+  });
+  checkout.open();
+}
+
+// Create a Razorpay subscription checkout for an app billing subject
+const { data: subscription } =
+  await insforge.payments.razorpay.createSubscription("test", {
+    planId: "plan_123",
+    totalCount: 12,
+    subject: { type: "team", id: "team_123" },
+  });
 ```
 
 ### AI Integration
 
+AI methods return an OpenAI-like response object directly (not the `{ data, error }` envelope used by the other modules) and throw on failure.
+
 ```javascript
-// Generate text completion
-const { data, error } = await insforge.ai.completion({
-  model: "gpt-3.5-turbo",
-  prompt: "Write a hello world program",
+// Chat completion
+const completion = await insforge.ai.chat.completions.create({
+  model: "anthropic/claude-3.5-haiku",
+  messages: [{ role: "user", content: "Write a hello world program" }],
+});
+console.log(completion.choices[0].message.content);
+
+// Streaming chat — returns an async iterable of chunks
+const stream = await insforge.ai.chat.completions.create({
+  model: "anthropic/claude-3.5-haiku",
+  messages: [{ role: "user", content: "Tell me a story" }],
+  stream: true,
+});
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
+}
+
+// Generate an image — returns base64-encoded image data
+const image = await insforge.ai.images.generate({
+  model: "google/gemini-3-pro-image-preview",
+  prompt: "A sunset over mountains",
 });
+const base64Png = image.data[0].b64_json;
 
-// Analyze an image
-const { data, error } = await insforge.ai.vision({
-  imageUrl: "https://example.com/image.jpg",
-  prompt: "Describe this image",
+// Create embeddings
+const embeddings = await insforge.ai.embeddings.create({
+  model: "openai/text-embedding-3-small",
+  input: "Hello world",
 });
+console.log(embeddings.data[0].embedding); // number[]
 ```
 
 ## Documentation