lifeastroapi 0.9.1 → 0.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -0
- package/dist/index.cjs +39 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +37 -2
- package/dist/index.d.ts +37 -2
- package/dist/index.js +39 -2
- package/dist/index.js.map +1 -1
- package/package.json +8 -2
package/README.md
CHANGED
|
@@ -298,6 +298,38 @@ const controller = new AbortController();
|
|
|
298
298
|
await client.chart.planets(birth, { signal: controller.signal, timeoutMs: 5000 });
|
|
299
299
|
```
|
|
300
300
|
|
|
301
|
+
## Credits, rate limit and request id
|
|
302
|
+
|
|
303
|
+
Every response carries your credit balance, your plan's rate limit and a request id in its
|
|
304
|
+
headers. `onResponse` hands them to you, for every call (client option) or for one call:
|
|
305
|
+
|
|
306
|
+
```ts
|
|
307
|
+
const client = new LifeAstro({
|
|
308
|
+
onResponse: (info) => {
|
|
309
|
+
if (info.creditsRemaining !== undefined && info.creditsRemaining < 5_000) {
|
|
310
|
+
console.warn(`LifeAstroAPI credits low: ${info.creditsRemaining}`);
|
|
311
|
+
}
|
|
312
|
+
},
|
|
313
|
+
});
|
|
314
|
+
|
|
315
|
+
await client.panchang.basic({ lat: 19.076, lon: 72.8777, tz: "Asia/Kolkata" }, {
|
|
316
|
+
onResponse: (info) => console.log(info.requestId, info.rateLimit?.remaining),
|
|
317
|
+
});
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
| Field | From header | Meaning |
|
|
321
|
+
|---|---|---|
|
|
322
|
+
| `status` | | HTTP status |
|
|
323
|
+
| `path` | | Endpoint path, e.g. `/v1/panchang/basic` |
|
|
324
|
+
| `requestId` | `X-Request-ID` | Quote it to support |
|
|
325
|
+
| `creditsRemaining` | `X-Credits-Remaining` | Balance after the call; unchanged after a failed call (failed calls are free). Absent on the free tier, whose allowance is daily/monthly rather than a balance |
|
|
326
|
+
| `rateLimit` | `X-RateLimit-*` | `{ limit, remaining, resetAt }` per minute for your plan |
|
|
327
|
+
| `cache` | `X-Cache` | `HIT` when the API answered from its cache (billed the same) |
|
|
328
|
+
| `language` | `Content-Language` | Language of the answer |
|
|
329
|
+
|
|
330
|
+
The hook runs once per call with the final response, success or error (not for retried attempts
|
|
331
|
+
or network failures). An exception thrown inside it is ignored, so logging can never break a call.
|
|
332
|
+
|
|
301
333
|
## Branded PDF reports
|
|
302
334
|
|
|
303
335
|
The `lifeastroapi/pdf` subpath turns the JSON from `client.reports.*` into
|
|
@@ -562,6 +594,15 @@ restricted network egress to avoid requests to internal hosts (SSRF).
|
|
|
562
594
|
|
|
563
595
|
## React Native and Expo
|
|
564
596
|
|
|
597
|
+
**A working starter** (Expo app + the small backend that holds the key) is in
|
|
598
|
+
[`examples/react-native-expo`](examples/react-native-expo).
|
|
599
|
+
|
|
600
|
+
| Part | Node.js (server) | React Native / Expo | Browser |
|
|
601
|
+
|---|---|---|---|
|
|
602
|
+
| `lifeastroapi` client (all methods, `lang`, retries, errors, `onResponse`) | yes | yes, but call it from your backend so the key stays secret | yes, same caveat |
|
|
603
|
+
| `lifeastroapi/pdf-html` (report HTML, `A4_PRINT_OPTIONS`) | yes | yes; print with `expo-print` | yes; print with the browser |
|
|
604
|
+
| `lifeastroapi/pdf` (Puppeteer PDFs, Brihad table of contents and bookmarks) | yes | no | no |
|
|
605
|
+
|
|
565
606
|
The SDK runs in React Native as it does in Node: the client uses the platform `fetch`,
|
|
566
607
|
and `lifeastroapi/pdf-html` builds the report HTML with no Puppeteer and no Node code.
|
|
567
608
|
The device's own print engine turns that HTML into a PDF, so the report is rendered on
|
package/dist/index.cjs
CHANGED
|
@@ -102,6 +102,40 @@ function httpStatusCode(status) {
|
|
|
102
102
|
}
|
|
103
103
|
|
|
104
104
|
// src/http.ts
|
|
105
|
+
function responseInfo(res, path) {
|
|
106
|
+
const h = res.headers;
|
|
107
|
+
const num = (name) => {
|
|
108
|
+
const v = h.get(name);
|
|
109
|
+
if (v === null || v.trim() === "") return void 0;
|
|
110
|
+
const n = Number(v);
|
|
111
|
+
return Number.isFinite(n) ? n : void 0;
|
|
112
|
+
};
|
|
113
|
+
const info = { status: res.status, path };
|
|
114
|
+
const rid = h.get("x-request-id");
|
|
115
|
+
if (rid) info.requestId = rid;
|
|
116
|
+
const credits = num("x-credits-remaining");
|
|
117
|
+
if (credits !== void 0) info.creditsRemaining = credits;
|
|
118
|
+
const limit = num("x-ratelimit-limit");
|
|
119
|
+
const remaining = num("x-ratelimit-remaining");
|
|
120
|
+
const reset = num("x-ratelimit-reset");
|
|
121
|
+
if (limit !== void 0 && remaining !== void 0 && reset !== void 0) {
|
|
122
|
+
info.rateLimit = { limit, remaining, resetAt: new Date(reset * 1e3) };
|
|
123
|
+
}
|
|
124
|
+
const cache = h.get("x-cache");
|
|
125
|
+
if (cache) info.cache = cache;
|
|
126
|
+
const lang = h.get("content-language");
|
|
127
|
+
if (lang) info.language = lang;
|
|
128
|
+
return info;
|
|
129
|
+
}
|
|
130
|
+
function emit(hooks, info) {
|
|
131
|
+
for (const hook of hooks) {
|
|
132
|
+
if (!hook) continue;
|
|
133
|
+
try {
|
|
134
|
+
hook(info);
|
|
135
|
+
} catch {
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
|
105
139
|
var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 425, 429, 500, 502, 503, 504]);
|
|
106
140
|
function encodeQuery(params) {
|
|
107
141
|
const usp = new URLSearchParams();
|
|
@@ -203,6 +237,7 @@ async function performRequest(config, path, query, opts = {}) {
|
|
|
203
237
|
body = text;
|
|
204
238
|
}
|
|
205
239
|
if (res.ok) {
|
|
240
|
+
emit([config.onResponse, opts.onResponse], responseInfo(res, path));
|
|
206
241
|
if (opts.raw) return body;
|
|
207
242
|
const envelope = body;
|
|
208
243
|
if (envelope && typeof envelope === "object" && "data" in envelope) {
|
|
@@ -216,6 +251,7 @@ async function performRequest(config, path, query, opts = {}) {
|
|
|
216
251
|
await sleep(backoffMs(attempt, retryAfter), opts.signal);
|
|
217
252
|
continue;
|
|
218
253
|
}
|
|
254
|
+
emit([config.onResponse, opts.onResponse], responseInfo(res, path));
|
|
219
255
|
throw lastError;
|
|
220
256
|
}
|
|
221
257
|
throw lastError ?? new LifeAstroConnectionError("Request failed after retries");
|
|
@@ -2012,7 +2048,7 @@ var Resources = class {
|
|
|
2012
2048
|
};
|
|
2013
2049
|
|
|
2014
2050
|
// src/client.ts
|
|
2015
|
-
var VERSION = "0.
|
|
2051
|
+
var VERSION = "0.12.0";
|
|
2016
2052
|
var DEFAULT_BASE_URL = "https://api.lifeastroapi.com";
|
|
2017
2053
|
function resolveConfig(options) {
|
|
2018
2054
|
const opts = typeof options === "string" ? { apiKey: options } : options ?? {};
|
|
@@ -2036,7 +2072,8 @@ function resolveConfig(options) {
|
|
|
2036
2072
|
maxRetries: Math.max(0, opts.maxRetries ?? 2),
|
|
2037
2073
|
fetch: fetchImpl,
|
|
2038
2074
|
userAgent: `lifeastroapi-node/${VERSION}`,
|
|
2039
|
-
defaultHeaders: opts.defaultHeaders ?? {}
|
|
2075
|
+
defaultHeaders: opts.defaultHeaders ?? {},
|
|
2076
|
+
onResponse: opts.onResponse
|
|
2040
2077
|
};
|
|
2041
2078
|
}
|
|
2042
2079
|
var LifeAstro = class extends Resources {
|