@pawabase/client 0.0.0-stage → 0.1.3

package/dist/esm/manage/automation.d.ts

@@ -0,0 +1,106 @@
+import { Definitions, Service, type Api, type Body } from "./base.js";
+/** Flows: graphs of blocks that run on a trigger (HTTP, event, schedule, resource change, webhook, manual). */
+export declare class Flows extends Definitions {
+    protected readonly kind = "flows";
+    /** Run a flow now as an operator (or `asUser`): `{ status, run_id, result, response, trace }`. `entry` picks a trigger node. */
+    run(name: string, input?: unknown, options?: {
+        asUser?: Body;
+        entry?: string;
+    }): Promise<Api>;
+    /** Check a flow's graph without saving it: the problems, node by node. */
+    validate(definition: Body): Promise<Api>;
+    /** The catalogue of blocks a flow can use, with their configuration fields. */
+    blocks(): Promise<Api>;
+    runs(options?: {
+        flow?: string;
+        status?: string;
+        limit?: number;
+        after?: string;
+    }): Promise<Api>;
+    /** One run with its per-block trace. */
+    runDetail(runId: string): Promise<Api>;
+}
+/** Cron and interval schedules that run a flow or function, or emit an event. */
+export declare class Schedules extends Definitions {
+    protected readonly kind = "schedules";
+    /** Fire a schedule now, exactly as the scheduler would. */
+    run(name: string): Promise<Api>;
+}
+/** Event subscriptions: which events run which flow or function, or reach which realtime channel. */
+export declare class Subscriptions extends Definitions {
+    protected readonly kind = "subscriptions";
+}
+/** The event bus: emit, and inspect what happened to each event. */
+export declare class Events extends Service {
+    /** Publish an event: every subscription, flow and webhook listening for it runs. */
+    emit(name: string, payload?: unknown): Promise<Api>;
+    list(options?: {
+        name?: string;
+        limit?: number;
+        after?: string;
+    }): Promise<Api>;
+    /** One event with every consumer it reached and how that went. */
+    detail(eventId: string): Promise<Api>;
+    /** Which event names exist and who consumes each. */
+    graph(): Promise<Api>;
+}
+/** Outbound webhooks: endpoints that receive signed events, with retries. */
+export declare class Webhooks extends Definitions {
+    protected readonly kind = "webhooks";
+    /** Send one test event to an endpoint (one attempt, not retried). */
+    test(name: string): Promise<Api>;
+    /** Delivery history. `status`: `pending`, `retrying`, `delivered`, `failed`. */
+    deliveries(options?: {
+        status?: string;
+        endpoint?: string;
+        limit?: number;
+    }): Promise<Api>;
+    redeliver(deliveryId: string): Promise<Api>;
+    /** Send many again: by `ids`, or every delivery matching a filter (up to `limit`, 100 by default). `dryRun` only counts. */
+    redeliverMany(options?: {
+        ids?: string[];
+        status?: string;
+        endpoint?: string;
+        event?: string;
+        sinceMinutes?: number;
+        limit?: number;
+        dryRun?: boolean;
+    }): Promise<Api>;
+}
+/** Inbound hooks: URLs other services call (signature-checked), each starting a flow or function. */
+export declare class InboundHooks extends Definitions {
+    protected readonly kind = "inbound-hooks";
+    /** The public URL to give the sender. */
+    url(slug: string): Promise<Api>;
+}
+/** Background work: jobs, failures and replays, queues, workers and how failed work is retried. */
+export declare class Jobs extends Service {
+    /** `status`: `queued`, `active`, `retrying`, `succeeded`, `failed`. */
+    list(options?: {
+        status?: string;
+        queue?: string;
+        limit?: number;
+    }): Promise<Api>;
+    detail(jobId: string): Promise<Api>;
+    retry(jobId: string): Promise<Api>;
+    /** Queue recorded jobs again: named `ids`, or every job matching the filter (failed by default; `limit` 200). `dryRun` only counts. */
+    replay(options?: {
+        ids?: string[];
+        status?: string;
+        queue?: string;
+        job?: string;
+        sinceMinutes?: number;
+        limit?: number;
+        dryRun?: boolean;
+    }): Promise<Api>;
+    /** Jobs that gave up after their retries. */
+    failed(): Promise<Api>;
+    dismissFailed(jobId: string): Promise<Api>;
+    /** Queues with depth and job counts. */
+    queues(): Promise<Api>;
+    /** The processes taking jobs (installation-wide). */
+    workers(): Promise<Api>;
+    /** How each kind of background work is retried: attempts and the wait before each retry. */
+    retryPolicies(): Promise<Api>;
+}
+//# sourceMappingURL=automation.d.ts.map

package/dist/esm/manage/automation.d.ts.map

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

package/dist/esm/manage/automation.js

@@ -0,0 +1,134 @@
+import { Definitions, Service, seg } from "./base.js";
+/** Flows: graphs of blocks that run on a trigger (HTTP, event, schedule, resource change, webhook, manual). */
+export class Flows extends Definitions {
+    kind = "flows";
+    /** Run a flow now as an operator (or `asUser`): `{ status, run_id, result, response, trace }`. `entry` picks a trigger node. */
+    run(name, input, options = {}) {
+        return this.post(seg(this.kind, name, "run"), { input, as_user: options.asUser ?? null, entry: options.entry ?? null });
+    }
+    /** Check a flow's graph without saving it: the problems, node by node. */
+    validate(definition) {
+        return this.project("POST", "/flows/validate", { body: { definition } });
+    }
+    /** The catalogue of blocks a flow can use, with their configuration fields. */
+    blocks() {
+        return this.project("GET", "/blocks");
+    }
+    runs(options = {}) {
+        return this.get("/flow-runs", options);
+    }
+    /** One run with its per-block trace. */
+    runDetail(runId) {
+        return this.get(seg("flow-runs", runId));
+    }
+}
+/** Cron and interval schedules that run a flow or function, or emit an event. */
+export class Schedules extends Definitions {
+    kind = "schedules";
+    /** Fire a schedule now, exactly as the scheduler would. */
+    run(name) {
+        return this.post(seg(this.kind, name, "run"));
+    }
+}
+/** Event subscriptions: which events run which flow or function, or reach which realtime channel. */
+export class Subscriptions extends Definitions {
+    kind = "subscriptions";
+}
+/** The event bus: emit, and inspect what happened to each event. */
+export class Events extends Service {
+    /** Publish an event: every subscription, flow and webhook listening for it runs. */
+    emit(name, payload) {
+        return this.post("/events", { name, payload });
+    }
+    list(options = {}) {
+        return this.get("/events", options);
+    }
+    /** One event with every consumer it reached and how that went. */
+    detail(eventId) {
+        return this.get(seg("events", eventId));
+    }
+    /** Which event names exist and who consumes each. */
+    graph() {
+        return this.get("/events-graph");
+    }
+}
+/** Outbound webhooks: endpoints that receive signed events, with retries. */
+export class Webhooks extends Definitions {
+    kind = "webhooks";
+    /** Send one test event to an endpoint (one attempt, not retried). */
+    test(name) {
+        return this.post(seg(this.kind, name, "test"));
+    }
+    /** Delivery history. `status`: `pending`, `retrying`, `delivered`, `failed`. */
+    deliveries(options = {}) {
+        return this.get("/webhook-deliveries", options);
+    }
+    redeliver(deliveryId) {
+        return this.post(seg("webhook-deliveries", deliveryId, "redeliver"));
+    }
+    /** Send many again: by `ids`, or every delivery matching a filter (up to `limit`, 100 by default). `dryRun` only counts. */
+    redeliverMany(options = {}) {
+        return this.post("/webhook-deliveries/redeliver", {
+            ids: options.ids,
+            status: options.status ?? "failed",
+            endpoint: options.endpoint,
+            event: options.event,
+            since_minutes: options.sinceMinutes,
+            limit: options.limit ?? 100,
+            dry_run: options.dryRun ?? false,
+        });
+    }
+}
+/** Inbound hooks: URLs other services call (signature-checked), each starting a flow or function. */
+export class InboundHooks extends Definitions {
+    kind = "inbound-hooks";
+    /** The public URL to give the sender. */
+    url(slug) {
+        return this.get(seg(this.kind, slug, "url"));
+    }
+}
+/** Background work: jobs, failures and replays, queues, workers and how failed work is retried. */
+export class Jobs extends Service {
+    /** `status`: `queued`, `active`, `retrying`, `succeeded`, `failed`. */
+    list(options = {}) {
+        return this.get("/jobs", options);
+    }
+    detail(jobId) {
+        return this.get(seg("jobs", jobId));
+    }
+    retry(jobId) {
+        return this.post(seg("jobs", jobId, "retry"));
+    }
+    /** Queue recorded jobs again: named `ids`, or every job matching the filter (failed by default; `limit` 200). `dryRun` only counts. */
+    replay(options = {}) {
+        return this.post("/jobs/replay", {
+            ids: options.ids ?? [],
+            status: options.status ?? "failed",
+            queue: options.queue,
+            job: options.job,
+            since_minutes: options.sinceMinutes,
+            limit: options.limit ?? 200,
+            dry_run: options.dryRun ?? false,
+        });
+    }
+    /** Jobs that gave up after their retries. */
+    failed() {
+        return this.get("/failed-jobs");
+    }
+    dismissFailed(jobId) {
+        return this.del(seg("failed-jobs", jobId));
+    }
+    /** Queues with depth and job counts. */
+    queues() {
+        return this.get("/queues");
+    }
+    /** The processes taking jobs (installation-wide). */
+    workers() {
+        return this.project("GET", "/workers");
+    }
+    /** How each kind of background work is retried: attempts and the wait before each retry. */
+    retryPolicies() {
+        return this.project("GET", "/retry-policies");
+    }
+}
+//# sourceMappingURL=automation.js.map

package/dist/esm/manage/automation.js.map

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

package/dist/esm/manage/base.d.ts

@@ -0,0 +1,52 @@
+import type { HttpClient } from "../http.js";
+import type { QueryValue } from "../util.js";
+/** What the management plane answers: a JSON document (lists are `{ data: [...] }`). */
+export type Api = Record<string, any>;
+export type Query = Record<string, QueryValue | QueryValue[]>;
+export type Body = Record<string, unknown>;
+/** URL path segments, each encoded: `seg("flows", name, "run")` → `/flows/<name>/run`. */
+export declare function seg(...parts: Array<string | number>): string;
+/** Everything a management service shares: the environment a call is for, and the five verbs. */
+export declare class Service {
+    protected readonly http: HttpClient;
+    private readonly environmentName;
+    constructor(http: HttpClient, environmentName: string);
+    /** The environment this service manages. */
+    get environment(): string;
+    protected path(suffix?: string): string;
+    protected get<T = Api>(suffix?: string, query?: Query): Promise<T>;
+    protected post<T = Api>(suffix?: string, body?: unknown, query?: Query): Promise<T>;
+    protected put<T = Api>(suffix: string, body?: unknown, query?: Query): Promise<T>;
+    protected patch<T = Api>(suffix: string, body?: unknown, query?: Query): Promise<T>;
+    protected del<T = Api>(suffix: string, query?: Query, body?: unknown): Promise<T>;
+    /** A call that is not scoped to an environment (`/platform/v1/...`). */
+    protected project<T = Api>(method: string, suffix: string, options?: {
+        body?: unknown;
+        query?: Query;
+        parse?: "json" | "text" | "response";
+    }): Promise<T>;
+}
+/**
+ * A kind of definition an environment holds (`flows`, `policies`, `webhooks`…): list, get, create, replace, remove.
+ * Pass `branch` to work on a feature branch's draft instead of the live environment. A definition is addressed by its name
+ * (inbound hooks: their slug).
+ */
+export declare class Definitions extends Service {
+    protected readonly kind: string;
+    list(options?: {
+        branch?: string;
+    }): Promise<Api>;
+    getOne(key: string, options?: {
+        branch?: string;
+    }): Promise<Api>;
+    create(body: Body, options?: {
+        branch?: string;
+    }): Promise<Api>;
+    replace(key: string, body: Body, options?: {
+        branch?: string;
+    }): Promise<Api>;
+    remove(key: string, options?: {
+        branch?: string;
+    }): Promise<Api>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/manage/base.d.ts.map

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

package/dist/esm/manage/base.js

@@ -0,0 +1,63 @@
+/** URL path segments, each encoded: `seg("flows", name, "run")` → `/flows/<name>/run`. */
+export function seg(...parts) {
+    return "/" + parts.map((part) => encodeURIComponent(String(part))).join("/");
+}
+/** Everything a management service shares: the environment a call is for, and the five verbs. */
+export class Service {
+    http;
+    environmentName;
+    constructor(http, environmentName) {
+        this.http = http;
+        this.environmentName = environmentName;
+    }
+    /** The environment this service manages. */
+    get environment() {
+        return this.environmentName;
+    }
+    path(suffix = "") {
+        return `/platform/v1/envs/${encodeURIComponent(this.environmentName)}${suffix}`;
+    }
+    get(suffix = "", query) {
+        return this.http.request({ path: this.path(suffix), ...(query ? { query } : {}) });
+    }
+    post(suffix = "", body, query) {
+        return this.http.request({ method: "POST", path: this.path(suffix), body, ...(query ? { query } : {}) });
+    }
+    put(suffix, body, query) {
+        return this.http.request({ method: "PUT", path: this.path(suffix), body, ...(query ? { query } : {}) });
+    }
+    patch(suffix, body, query) {
+        return this.http.request({ method: "PATCH", path: this.path(suffix), body, ...(query ? { query } : {}) });
+    }
+    del(suffix, query, body) {
+        return this.http.request({ method: "DELETE", path: this.path(suffix), ...(query ? { query } : {}), ...(body !== undefined ? { body } : {}) });
+    }
+    /** A call that is not scoped to an environment (`/platform/v1/...`). */
+    project(method, suffix, options = {}) {
+        return this.http.request({ method, path: `/platform/v1${suffix}`, ...options });
+    }
+}
+/**
+ * A kind of definition an environment holds (`flows`, `policies`, `webhooks`…): list, get, create, replace, remove.
+ * Pass `branch` to work on a feature branch's draft instead of the live environment. A definition is addressed by its name
+ * (inbound hooks: their slug).
+ */
+export class Definitions extends Service {
+    kind = "";
+    list(options = {}) {
+        return this.get(seg(this.kind), { branch: options.branch });
+    }
+    getOne(key, options = {}) {
+        return this.get(seg(this.kind, key), { branch: options.branch });
+    }
+    create(body, options = {}) {
+        return this.post(seg(this.kind), body, { branch: options.branch });
+    }
+    replace(key, body, options = {}) {
+        return this.put(seg(this.kind, key), body, { branch: options.branch });
+    }
+    remove(key, options = {}) {
+        return this.del(seg(this.kind, key), { branch: options.branch });
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/manage/base.js.map

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

package/dist/esm/manage/data.d.ts

@@ -0,0 +1,100 @@
+import { Definitions, Service, type Api, type Body, type Query } from "./base.js";
+/**
+ * Resources: the tables your API serves, with fields, relations, per-operation policies and indexes.
+ *
+ * ```ts
+ * await m.resources.create({ name: "posts", fields: [{ name: "title", type: "string", required: true }],
+ *                            operations: { list: { enabled: true, policy: "public" } } });
+ * await m.resources.migrate("posts");
+ * ```
+ */
+export declare class Resources extends Definitions {
+    protected readonly kind = "resources";
+    /** Browse a resource's records as an operator (policies do not apply). Extra keys are passed as query parameters (`filter[field]`…). */
+    records(name: string, options?: {
+        limit?: number;
+        offset?: number;
+        filters?: Query;
+    }): Promise<Api>;
+    insert(name: string, values: Body): Promise<Api>;
+    updateRecord(name: string, recordId: string | number, values: Body): Promise<Api>;
+    deleteRecord(name: string, recordId: string | number): Promise<Api>;
+    /** Every record, for a file download. */
+    export(name: string, options?: {
+        format?: string;
+    }): Promise<Api>;
+    /** Add or update records from parsed rows: `{ created, updated, failed, errors }`. */
+    importRecords(name: string, rows: Body[], options?: {
+        key?: string;
+        mode?: string;
+        dryRun?: boolean;
+    }): Promise<Api>;
+    /** The resource's compiled routes. */
+    openapi(name: string): Promise<Api>;
+    /** Create the resource's table, or add what its definition gained. Returns the statements it ran. */
+    migrate(name: string): Promise<Api>;
+    /** What applying the definition would change. */
+    schemaPlan(name: string): Promise<Api>;
+    schemaApply(name: string, body?: Body): Promise<Api>;
+    /** Take the table as it is now as the starting point and put what changed in the definition. */
+    schemaAcknowledge(name: string, body?: Body): Promise<Api>;
+    /** Remove what migrations kept for a rollback. */
+    schemaPurge(name: string, body?: Body): Promise<Api>;
+    migrations(name: string): Promise<Api>;
+    rollbackMigration(name: string, migrationId: string): Promise<Api>;
+    /** A table's indexes: declared, field, hand-made and system. */
+    indexes(name: string): Promise<Api>;
+    /** Drop an index made outside Pawabase. */
+    dropIndex(name: string, index: string, body?: Body): Promise<Api>;
+}
+/** The whole database against its definitions. */
+export declare class Schema extends Service {
+    /** Every resource's table against its definition. */
+    overview(): Promise<Api>;
+    /** Tables in the database that no resource is defined for. */
+    unmappedTables(): Promise<Api>;
+}
+/** Named access policies (conditions) that resources, buckets, channels and functions refer to. */
+export declare class Policies extends Definitions {
+    protected readonly kind = "policies";
+}
+/** Reusable data shapes referred to by resource fields. */
+export declare class Schemas extends Definitions {
+    protected readonly kind = "schemas";
+}
+/** Transformers that reshape a field's value on the way out (hide, mask, format). */
+export declare class Transformers extends Definitions {
+    protected readonly kind = "transformers";
+}
+/** Custom HTTP routes under `/rest` that run a flow. */
+export declare class Routes extends Definitions {
+    protected readonly kind = "routes";
+}
+/** The environment's database: tables, rows and the SQL console (one statement at a time; reads are read-only in the database itself). */
+export declare class Database extends Service {
+    info(): Promise<Api>;
+    /** A table's columns, indexes and foreign keys. */
+    table(table: string): Promise<Api>;
+    rows(table: string, options?: {
+        limit?: number;
+        offset?: number;
+        sort?: string;
+        filters?: Query;
+    }): Promise<Api>;
+    /** Run one statement. A write needs `allowWrite`; it is audited and clears the environment's caches. */
+    query(sql: string, params?: unknown[], options?: {
+        allowWrite?: boolean;
+    }): Promise<Api>;
+}
+/** The runtime capabilities a function sees, called remotely (what `pawabase emulate` uses). */
+export declare class Runtime extends Service {
+    call(method: string, args?: unknown[], kwargs?: Body, options?: {
+        asUser?: Body;
+        branch?: string;
+    }): Promise<Api>;
+    /** `fetch`, `insert`, `execute`, `begin`, `commit`…, optionally inside a transaction (`tx`). */
+    sql(op: string, fields?: Body): Promise<Api>;
+    /** Who a user access token belongs to. */
+    identify(token: string | null): Promise<Api>;
+}
+//# sourceMappingURL=data.d.ts.map

package/dist/esm/manage/data.d.ts.map

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

package/dist/esm/manage/data.js

@@ -0,0 +1,130 @@
+import { Definitions, Service, seg } from "./base.js";
+/**
+ * Resources: the tables your API serves, with fields, relations, per-operation policies and indexes.
+ *
+ * ```ts
+ * await m.resources.create({ name: "posts", fields: [{ name: "title", type: "string", required: true }],
+ *                            operations: { list: { enabled: true, policy: "public" } } });
+ * await m.resources.migrate("posts");
+ * ```
+ */
+export class Resources extends Definitions {
+    kind = "resources";
+    /** Browse a resource's records as an operator (policies do not apply). Extra keys are passed as query parameters (`filter[field]`…). */
+    records(name, options = {}) {
+        return this.get(seg(this.kind, name, "records"), { limit: options.limit, offset: options.offset, ...options.filters });
+    }
+    insert(name, values) {
+        return this.post(seg(this.kind, name, "records"), values);
+    }
+    updateRecord(name, recordId, values) {
+        return this.patch(seg(this.kind, name, "records", recordId), values);
+    }
+    deleteRecord(name, recordId) {
+        return this.del(seg(this.kind, name, "records", recordId));
+    }
+    /** Every record, for a file download. */
+    export(name, options = {}) {
+        return this.get(seg(this.kind, name, "export"), { format: options.format });
+    }
+    /** Add or update records from parsed rows: `{ created, updated, failed, errors }`. */
+    importRecords(name, rows, options = {}) {
+        return this.post(seg(this.kind, name, "import"), { rows, key: options.key, mode: options.mode, dry_run: options.dryRun });
+    }
+    /** The resource's compiled routes. */
+    openapi(name) {
+        return this.get(seg(this.kind, name, "openapi"));
+    }
+    /** Create the resource's table, or add what its definition gained. Returns the statements it ran. */
+    migrate(name) {
+        return this.post(seg(this.kind, name, "migrate"));
+    }
+    /** What applying the definition would change. */
+    schemaPlan(name) {
+        return this.get(seg(this.kind, name, "schema"));
+    }
+    schemaApply(name, body = {}) {
+        return this.post(seg(this.kind, name, "schema", "apply"), body);
+    }
+    /** Take the table as it is now as the starting point and put what changed in the definition. */
+    schemaAcknowledge(name, body = {}) {
+        return this.post(seg(this.kind, name, "schema", "acknowledge"), body);
+    }
+    /** Remove what migrations kept for a rollback. */
+    schemaPurge(name, body = {}) {
+        return this.post(seg(this.kind, name, "schema", "purge"), body);
+    }
+    migrations(name) {
+        return this.get(seg(this.kind, name, "migrations"));
+    }
+    rollbackMigration(name, migrationId) {
+        return this.post(seg(this.kind, name, "migrations", migrationId, "rollback"));
+    }
+    /** A table's indexes: declared, field, hand-made and system. */
+    indexes(name) {
+        return this.get(seg(this.kind, name, "indexes"));
+    }
+    /** Drop an index made outside Pawabase. */
+    dropIndex(name, index, body = {}) {
+        return this.post(seg(this.kind, name, "indexes", index, "drop"), body);
+    }
+}
+/** The whole database against its definitions. */
+export class Schema extends Service {
+    /** Every resource's table against its definition. */
+    overview() {
+        return this.get("/schema");
+    }
+    /** Tables in the database that no resource is defined for. */
+    unmappedTables() {
+        return this.get("/schema/tables");
+    }
+}
+/** Named access policies (conditions) that resources, buckets, channels and functions refer to. */
+export class Policies extends Definitions {
+    kind = "policies";
+}
+/** Reusable data shapes referred to by resource fields. */
+export class Schemas extends Definitions {
+    kind = "schemas";
+}
+/** Transformers that reshape a field's value on the way out (hide, mask, format). */
+export class Transformers extends Definitions {
+    kind = "transformers";
+}
+/** Custom HTTP routes under `/rest` that run a flow. */
+export class Routes extends Definitions {
+    kind = "routes";
+}
+/** The environment's database: tables, rows and the SQL console (one statement at a time; reads are read-only in the database itself). */
+export class Database extends Service {
+    info() {
+        return this.get("/database");
+    }
+    /** A table's columns, indexes and foreign keys. */
+    table(table) {
+        return this.get(seg("database", "tables", table));
+    }
+    rows(table, options = {}) {
+        return this.get(seg("database", "tables", table, "rows"), { limit: options.limit, offset: options.offset, sort: options.sort, ...options.filters });
+    }
+    /** Run one statement. A write needs `allowWrite`; it is audited and clears the environment's caches. */
+    query(sql, params = [], options = {}) {
+        return this.post("/database/query", { sql, params, allow_write: options.allowWrite ?? false });
+    }
+}
+/** The runtime capabilities a function sees, called remotely (what `pawabase emulate` uses). */
+export class Runtime extends Service {
+    call(method, args = [], kwargs = {}, options = {}) {
+        return this.post("/runtime/call", { method, args, kwargs, as_user: options.asUser ?? null, branch: options.branch ?? null });
+    }
+    /** `fetch`, `insert`, `execute`, `begin`, `commit`…, optionally inside a transaction (`tx`). */
+    sql(op, fields = {}) {
+        return this.post("/runtime/db", { op, ...fields });
+    }
+    /** Who a user access token belongs to. */
+    identify(token) {
+        return this.post("/runtime/identify", { token });
+    }
+}
+//# sourceMappingURL=data.js.map

package/dist/esm/manage/data.js.map

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