naro-js 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Every failure the SDK hands back (spec §15). The Naro worker's errors
+ * (spec §14) arrive as they are; the SDK makes its own only for what never
+ * got a readable answer from the worker, and for queries it can tell are
+ * malformed before sending them. The messages are a contract — spec §15's
+ * "(P1-4 구현 결정)" block quotes them.
+ */
+export type NaroError = {
+    code: string;
+    message: string;
+    details?: unknown;
+};
+/** Spec §14, word for word; `wire.test.ts` compares it with data-core's. */
+export declare const INVALID_QUERY_MESSAGE = "The query is not a valid Naro query.";
+/** Spec §14, word for word; `wire.test.ts` compares it with data-core's. */
+export declare const INVALID_SESSION_MESSAGE = "The session is expired or not valid. Sign in again.";
+/** fetch threw, or the response body broke off: nothing reached us. */
+export declare function networkError(cause: unknown): NaroError;
+/**
+ * A request with a deadline that passed without an answer — the sign-in
+ * code exchange a page runs on load (PR #68 review 10). It is called off.
+ */
+export declare function requestTimeout(ms: number): NaroError;
+/** An answer, but not one a Naro worker gives: HTML, empty, or the wrong shape. */
+export declare function invalidResponse(status: number): NaroError;
+/**
+ * The worker's INVALID_QUERY, raised before sending when the builder can
+ * already tell (an empty column name, a backwards range). `path` names the
+ * AST field or the builder method, as the worker's `details.path` does.
+ */
+export declare function invalidQuery(path: string, reason: string): NaroError;
+/** The worker's INVALID_SESSION, for a stored token get-session no longer knows. */
+export declare function invalidSession(): NaroError;
+/** A code came back to a browser that holds no verifier for it. */
+export declare function codeVerifierMissing(): NaroError;
+/** `updateUser({ password })` with no reset link opened. */
+export declare function passwordRecoveryRequired(): NaroError;
+/** `signInWithOAuth` with a provider the worker does not know. */
+export declare function invalidProvider(): NaroError;
+/** No `crypto.subtle`: an http page that is not localhost. */
+export declare function cryptoUnavailable(): NaroError;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * The error a response carries, or null when it carries none. Every error
+ * under `/_naro/v1` comes as `{ data: null, error: { code, message,
+ * details? } }` — the worker wraps Better Auth's too (spec §14, P1-2 리뷰
+ * 반영). Better Auth's success bodies are not wrapped, so a 2xx without an
+ * `error` is not an error; a failing status without the envelope is not a
+ * Naro answer at all (a proxy's HTML page, the app's own 404).
+ */
+export declare function errorFromBody(status: number, body: unknown): NaroError | null;

package/dist/http.d.ts

@@ -0,0 +1,61 @@
+import type { TokenStore } from "./auth/storage.js";
+import { type NaroError } from "./errors.js";
+/**
+ * What the SDK needs from `fetch`. The global one fits, and so does a plain
+ * function, e.g. one that hands the request to a worker's fetch handler in a
+ * test. It is always called as a plain function, never as a method, so an
+ * unbound `window.fetch` works.
+ */
+export type FetchLike = (input: string, init: RequestInit) => Promise<Response>;
+export type HttpConfig = {
+    /** The project URL without a trailing slash. */
+    baseUrl: string;
+    apiKey: string;
+    fetch: FetchLike | undefined;
+    tokens: TokenStore;
+};
+export type CallOptions = {
+    method: "GET" | "POST";
+    /** Below `/_naro/v1`, e.g. `/data/query`. */
+    path: string;
+    /** Sent as JSON. */
+    body?: unknown;
+    /** Whether to send the stored session token. */
+    withToken: boolean;
+    /**
+     * Give up after this long: the request is aborted (where the runtime has
+     * AbortController) and the call answers TIMEOUT. None by default.
+     */
+    timeoutMs?: number;
+};
+/** A response the SDK could read: a JSON body (or none) and its headers. */
+export type Answer = {
+    status: number;
+    headers: Headers;
+    /** The parsed JSON body; undefined when the body was empty. */
+    body: unknown;
+    /** The token this request carried, if any. */
+    token: string | null;
+};
+export type CallResult = {
+    error: NaroError;
+    answer: Answer | null;
+} | {
+    error: null;
+    answer: Answer;
+};
+/**
+ * One request to the Naro worker (spec §8.3): `apikey` always, `Authorization:
+ * Bearer` when signed in, never cookies. Resolves in every case — a failed
+ * fetch, an unreadable body and a worker error all come back as `error`.
+ *
+ * An INVALID_SESSION answer from any route clears the stored token (spec
+ * §11.1), but only if it is still the token this request carried.
+ */
+export declare function call(config: HttpConfig, options: CallOptions): Promise<CallResult>;
+/**
+ * The worker's two 429s. `RATE_LIMITED` is Better Auth's limiter;
+ * `WRITE_QUOTA_EXCEEDED` (PR C) is the project over its daily database write
+ * limit — Data API writes and sign-up wait for 00:00 UTC, reads still work.
+ */
+export declare const RETRY_AFTER_CODES: ReadonlySet<string>;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createClient, NaroClient, type ClientOptions } from "./client.js";
+export type { AuthClient } from "./auth/client.js";
+export type { AuthStorage } from "./auth/storage.js";
+export type { NaroError } from "./errors.js";
+export type { FetchLike } from "./http.js";
+export type { ArrayValues, FilterGroup, FilterGroupCallback, InsertBuilder, MatchQuery, MutationBuilder, RawFilterValue, SelectBuilder, TableBuilder, } from "./query/builder.js";
+export { quoteFilterValue, type FilterOperatorName } from "./query/filters.js";
+export type { AuthActionResponse, AuthFlowType, AuthResponse, DatabaseShape, EmailRedirectOptions, OAuthProvider, OAuthResponse, SignInWithOAuthOptions, UrlSessionResponse, UserAttributes, GenericTable, GenericView, NaroResponse, OrderOptions, Session, SessionResponse, SignInCredentials, SignOutResponse, SignUpCredentials, UntypedDatabase, User, UserResponse, } from "./types.js";
+export type { Filter, FilterNode, FilterOperator, Order, Query, Row, Value, } from "./wire.js";