@somewhere-cloud/sdk 0.0.0-stage → 0.13.0

package/dist/cjs/resources/postgrest.js

@@ -0,0 +1,391 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgrestFilterBuilder = exports.SomewhereQueryBuilder = void 0;
+const errors_js_1 = require("../errors.js");
+function invalidResult(err) {
+    return { data: null, error: err, count: null, status: err.statusCode };
+}
+/** Split on top-level commas only — commas inside `(...)` (an `in` list) stay. */
+function splitTopLevel(s) {
+    const out = [];
+    let depth = 0;
+    let start = 0;
+    for (let i = 0; i < s.length; i++) {
+        const ch = s[i];
+        if (ch === '(')
+            depth++;
+        else if (ch === ')')
+            depth = Math.max(0, depth - 1);
+        else if (ch === ',' && depth === 0) {
+            out.push(s.slice(start, i));
+            start = i + 1;
+        }
+    }
+    out.push(s.slice(start));
+    return out;
+}
+/** Coerce an `.or()` string value to its JSON type (number / bool / null / string). */
+function coerceFilterValue(raw) {
+    if (raw === 'null')
+        return null;
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    if (/^-?\d+$/.test(raw))
+        return Number.parseInt(raw, 10);
+    if (/^-?\d*\.\d+$/.test(raw))
+        return Number.parseFloat(raw);
+    return raw;
+}
+/** What `.from(...)` returns — pre-action chain. */
+class SomewhereQueryBuilder {
+    constructor(client, table) {
+        this.client = client;
+        this.table = table;
+    }
+    /**
+     * Select rows. Pass embeds in the column string for foreign-key joins
+     * (`select('*, profile(*)')`), and `{ count, head }` for counts:
+     *
+     *     // total rows matching the filters, alongside the page of data
+     *     const { data, count } = await sw.from('todos')
+     *       .select('*', { count: 'exact' }).eq('done', false).limit(20)
+     *
+     *     // just the count, no rows fetched
+     *     const { count } = await sw.from('todos')
+     *       .select('*', { count: 'exact', head: true }).eq('done', false)
+     */
+    select(columns = '*', options = {}) {
+        return new PostgrestFilterBuilder(this.client, this.table, 'select', {
+            columns,
+            count: options.count,
+            head: options.head,
+        });
+    }
+    insert(values) {
+        return new PostgrestFilterBuilder(this.client, this.table, 'insert', {
+            insertValues: Array.isArray(values) ? values : [values],
+        });
+    }
+    upsert(values, options = {}) {
+        return new PostgrestFilterBuilder(this.client, this.table, 'upsert', {
+            insertValues: Array.isArray(values) ? values : [values],
+            conflictKey: options.onConflict ?? 'id',
+        });
+    }
+    update(values) {
+        return new PostgrestFilterBuilder(this.client, this.table, 'update', {
+            updateValues: values,
+        });
+    }
+    delete() {
+        return new PostgrestFilterBuilder(this.client, this.table, 'delete', {});
+    }
+}
+exports.SomewhereQueryBuilder = SomewhereQueryBuilder;
+/**
+ * Fluent filter / modifier / resolver chain. Implements `then` so `await`
+ * on a builder executes the query.
+ */
+class PostgrestFilterBuilder {
+    constructor(client, table, action, state) {
+        this.client = client;
+        this.table = table;
+        this.action = action;
+        this.state = state;
+        this.filters = [];
+        this.orderClause = null;
+        this.limitN = null;
+        this.offsetN = null;
+        this.resolveType = 'many';
+        /** When true, this read bypasses the client cache and always hits the network. */
+        this.freshOnly = false;
+        this.countMode = state.count ?? null;
+        this.headOnly = state.head ?? false;
+    }
+    /* ─── Filters ──────────────────────────────────────────────── */
+    eq(column, value) {
+        this.filters.push({ column, op: 'eq', value });
+        return this;
+    }
+    neq(column, value) {
+        this.filters.push({ column, op: 'neq', value });
+        return this;
+    }
+    gt(column, value) {
+        this.filters.push({ column, op: 'gt', value });
+        return this;
+    }
+    gte(column, value) {
+        this.filters.push({ column, op: 'gte', value });
+        return this;
+    }
+    lt(column, value) {
+        this.filters.push({ column, op: 'lt', value });
+        return this;
+    }
+    lte(column, value) {
+        this.filters.push({ column, op: 'lte', value });
+        return this;
+    }
+    /** Case-sensitive pattern match. Use `%` as the wildcard. */
+    like(column, pattern) {
+        this.filters.push({ column, op: 'like', value: pattern });
+        return this;
+    }
+    /** Case-insensitive pattern match. */
+    ilike(column, pattern) {
+        this.filters.push({ column, op: 'ilike', value: pattern });
+        return this;
+    }
+    in(column, values) {
+        this.filters.push({ column, op: 'in', value: values });
+        return this;
+    }
+    /** `.is('col', null)` → IS NULL. `.is('col', true/false)` for booleans. */
+    is(column, value) {
+        this.filters.push({ column, op: 'is', value });
+        return this;
+    }
+    /** Negate a filter: `.not('status', 'eq', 'archived')`. */
+    not(column, op, value) {
+        this.filters.push({ column, op: 'not', value: { op, value } });
+        return this;
+    }
+    /** Shorthand for stacking `.eq` filters from an object. */
+    match(criteria) {
+        for (const [k, v] of Object.entries(criteria)) {
+            this.eq(k, v);
+        }
+        return this;
+    }
+    /**
+     * OR a set of conditions (filter syntax). `.or('status.eq.active,age.gt.18')`
+     * → `(status = 'active' OR age > 18)`, AND-ed with any other filters.
+     * Each term is `column.operator.value`; `in` uses `col.in.(a,b,c)`. Numeric /
+     * `true` / `false` / `null` values are coerced to their JSON types.
+     */
+    or(filters) {
+        const subs = [];
+        for (const raw of splitTopLevel(filters)) {
+            const term = raw.trim();
+            if (!term)
+                continue;
+            // `in` values contain commas inside (...), so detect+consume them first.
+            const inMatch = /^([A-Za-z_][A-Za-z0-9_]*)\.in\.\((.*)\)$/.exec(term);
+            if (inMatch) {
+                subs.push({
+                    column: inMatch[1],
+                    op: 'in',
+                    value: inMatch[2].split(',').map((v) => coerceFilterValue(v.trim())),
+                });
+                continue;
+            }
+            const firstDot = term.indexOf('.');
+            const secondDot = term.indexOf('.', firstDot + 1);
+            if (firstDot < 0 || secondDot < 0)
+                continue; // malformed term — skip
+            subs.push({
+                column: term.slice(0, firstDot),
+                op: term.slice(firstDot + 1, secondDot),
+                value: coerceFilterValue(term.slice(secondDot + 1)),
+            });
+        }
+        this.filters.push({ column: '', op: 'or', value: subs });
+        return this;
+    }
+    /* ─── Modifiers ────────────────────────────────────────────── */
+    order(column, options = {}) {
+        this.orderClause = { column, ascending: options.ascending ?? true };
+        return this;
+    }
+    limit(n) {
+        this.limitN = n;
+        return this;
+    }
+    /** `[from, to]` inclusive range — equivalent to `LIMIT to-from+1 OFFSET from`. */
+    range(from, to) {
+        this.offsetN = from;
+        this.limitN = to - from + 1;
+        return this;
+    }
+    /** Require exactly one row; error on 0 or >1. */
+    single() {
+        this.resolveType = 'single';
+        return this;
+    }
+    /** Allow 0 or 1 rows; 0 rows → `data: null`. */
+    maybeSingle() {
+        this.resolveType = 'maybeSingle';
+        return this;
+    }
+    /**
+     * Opt this read out of the client cache: always hit the network, ignoring
+     * any cached value (it still refreshes the cache for the next normal read).
+     * The per-query escape hatch for the rare always-fresh need;
+     * `createClient(url, key, { cache: false })` is the global one.
+     */
+    fresh() {
+        this.freshOnly = true;
+        return this;
+    }
+    /* ─── Execution ────────────────────────────────────────────── */
+    /**
+     * Thenable so `await builder` executes the query. This is the same
+     * thenable pattern — the chain doesn't hit the network until
+     * you `await` (or `.then()`) it.
+     */
+    then(onFulfilled, onRejected) {
+        return this.execute().then(onFulfilled, onRejected);
+    }
+    async execute() {
+        const projectId = this.client.resolveProjectId();
+        const cache = this.client.cache;
+        // Writes are never cached. On success they invalidate the table's cached
+        // reads so the next read is fresh (read-your-own-writes correctness).
+        if (this.action !== 'select') {
+            const result = await this.doFetch(projectId);
+            if (cache && result.error === null) {
+                cache.invalidate(this.table);
+            }
+            return result;
+        }
+        if (!cache)
+            return this.doFetch(projectId);
+        // Forced reads always fetch, but use the same generation fence as cached
+        // reads so an overlapping write/session change cannot warm stale data.
+        return cache.read(this.cacheKey(projectId), this.table, () => this.doFetch(projectId), this.freshOnly);
+    }
+    /** The actual network round-trip — no cache involvement. */
+    async doFetch(projectId) {
+        const body = this.buildBody(projectId);
+        try {
+            const result = await this.client.call('POST', '/db/query', { body });
+            const serverCount = typeof result?.count === 'number' ? result.count : null;
+            // head:true → the count only, no rows (count-only semantics).
+            if (this.headOnly) {
+                return { data: null, error: null, count: serverCount, status: 200 };
+            }
+            // Rows come back already shaped by the server, with any foreign-key
+            // embeds nested in place — we just apply the one-row/null resolution.
+            const rows = result?.data ?? [];
+            return this.shapeRows(rows, serverCount);
+        }
+        catch (err) {
+            if (err instanceof errors_js_1.SomewhereError) {
+                return invalidResult(err);
+            }
+            throw err;
+        }
+    }
+    /**
+     * Cache key for this select: every input that changes the result set —
+     * project + table + columns + filters + order + limit/offset + resolveType
+     * + count/head options, including inputs that change only the result shape.
+     */
+    cacheKey(projectId) {
+        return JSON.stringify({
+            p: projectId,
+            t: this.table,
+            c: this.state.columns ?? '*',
+            f: this.filters,
+            o: this.orderClause,
+            l: this.limitN,
+            x: this.offsetN,
+            r: this.resolveType,
+            count: this.countMode,
+            head: this.headOnly,
+        });
+    }
+    buildBody(projectId) {
+        const base = {
+            project_id: projectId,
+            table: this.table,
+        };
+        if (this.filters.length > 0) {
+            base.filters = this.filters;
+        }
+        switch (this.action) {
+            case 'select': {
+                // Send the select verbatim — including any `table(cols)` embeds,
+                // which the server resolves and returns nested (foreign-key joins).
+                base.select = this.state.columns ?? '*';
+                if (this.orderClause) {
+                    base.order = this.orderClause;
+                }
+                if (this.limitN != null) {
+                    base.limit = this.limitN;
+                }
+                if (this.offsetN != null) {
+                    base.offset = this.offsetN;
+                }
+                if (this.countMode) {
+                    base.count = this.countMode;
+                }
+                if (this.headOnly) {
+                    base.head = true;
+                }
+                // single()/maybeSingle(): hint the server to cap the fetch (LIMIT 2)
+                // so it never pulls a full result set just to detect the >1 case.
+                // The final one-row / null / error shaping still happens here.
+                if (this.resolveType !== 'many') {
+                    base.single = true;
+                }
+                break;
+            }
+            case 'insert': {
+                const rows = this.state.insertValues ?? [];
+                base.insert = rows.length === 1 ? rows[0] : rows;
+                break;
+            }
+            case 'upsert': {
+                const rows = this.state.insertValues ?? [];
+                base.upsert = rows.length === 1 ? rows[0] : rows;
+                base.onConflict = this.state.conflictKey ?? 'id';
+                break;
+            }
+            case 'update': {
+                base.update = this.state.updateValues ?? {};
+                break;
+            }
+            case 'delete': {
+                base.delete = true;
+                break;
+            }
+        }
+        return base;
+    }
+    shapeRows(rows, serverCount) {
+        if (this.resolveType === 'single') {
+            if (rows.length === 0) {
+                return invalidResult(new errors_js_1.SomewhereError({
+                    code: 'PGRST116',
+                    message: 'Single-row query returned 0 rows.',
+                    statusCode: 406,
+                    retry: false,
+                    retryAfterMs: null,
+                }));
+            }
+            if (rows.length > 1) {
+                return invalidResult(new errors_js_1.SomewhereError({
+                    code: 'PGRST116',
+                    message: `Single-row query returned ${rows.length} rows.`,
+                    statusCode: 406,
+                    retry: false,
+                    retryAfterMs: null,
+                }));
+            }
+            return { data: rows[0], error: null, count: serverCount ?? 1, status: 200 };
+        }
+        if (this.resolveType === 'maybeSingle') {
+            if (rows.length === 0) {
+                return { data: null, error: null, count: serverCount ?? 0, status: 200 };
+            }
+            return { data: rows[0], error: null, count: serverCount ?? 1, status: 200 };
+        }
+        return { data: rows, error: null, count: serverCount ?? rows.length, status: 200 };
+    }
+}
+exports.PostgrestFilterBuilder = PostgrestFilterBuilder;
+//# sourceMappingURL=postgrest.js.map

package/dist/cjs/resources/postgrest.js.map

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

package/dist/cjs/resources/projects.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectsClient = void 0;
+const errors_js_1 = require("../errors.js");
+class ProjectsClient {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Update the optional analytics consent policy; the platform validates policy and editor access. */
+    async update(settings, projectId) {
+        const id = this.client.requireProjectId(projectId, 'projects.update');
+        try {
+            const result = await this.client.call('PATCH', `/projects/${encodeURIComponent(id)}`, { body: settings, auth: 'developer' });
+            return { data: result, error: null, status: 200 };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    /** Inspect deployed homepage files and configured SEO defaults; live rendering and indexing remain unverified. */
+    async seoCheck(projectId) {
+        const id = this.client.requireProjectId(projectId, 'projects.seoCheck');
+        try {
+            const result = await this.client.call('GET', `/projects/${encodeURIComponent(id)}/seo`, { auth: 'developer' });
+            return { data: result, error: null, status: 200 };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    /** Read a project's exact cross-origin allowlist (CORS allowed_origins). */
+    async getAllowedOrigins(projectId) {
+        const id = this.client.requireProjectId(projectId, 'projects.getAllowedOrigins');
+        try {
+            const result = await this.client.call('GET', `/projects/${encodeURIComponent(id)}/allowed-origins`, { auth: 'developer' });
+            return { data: result, error: null, status: 200 };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    /**
+     * Replace a project's cross-origin allowlist with these exact origins.
+     * Owner-or-platform-admin only, and audited server-side. Each entry must be
+     * an exact origin (scheme + host + optional port, no path or wildcards); the
+     * platform validates and normalizes them — no client-side munging. Pass `[]`
+     * to clear the allowlist.
+     */
+    async setAllowedOrigins(allowedOrigins, projectId) {
+        const id = this.client.requireProjectId(projectId, 'projects.setAllowedOrigins');
+        try {
+            const result = await this.client.call('PUT', `/projects/${encodeURIComponent(id)}/allowed-origins`, { body: { allowed_origins: allowedOrigins }, auth: 'developer' });
+            return { data: result, error: null, status: 200 };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    /** Remove all configured cross-origin origins (owner/admin only). */
+    clearAllowedOrigins(projectId) {
+        return this.setAllowedOrigins([], projectId);
+    }
+}
+exports.ProjectsClient = ProjectsClient;
+function toResultError(err) {
+    if (err instanceof errors_js_1.SomewhereError) {
+        return { data: null, error: err, status: err.statusCode };
+    }
+    throw err;
+}
+//# sourceMappingURL=projects.js.map

package/dist/cjs/resources/projects.js.map

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

package/dist/cjs/resources/storage.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageFileApi = exports.StorageClient = void 0;
+const errors_js_1 = require("../errors.js");
+/**
+ * Prefix-oriented file API.
+ *
+ * Routes through `/v1/fs/*` (the platform's structured filesystem).
+ * "Buckets" are prefix directories under the project's file namespace:
+ * `sw.storage.from('avatars').upload('a.png', ...)` writes to
+ * `/v1/fs/{project_id}/avatars/a.png`.
+ *
+ * For browser uploads with per-user or per-team rules, declare a file
+ * collection in db/schema.ts and use the generated `somewhere:files` client
+ * instead: docs({ topic: 'declared-files' }).
+ */
+class StorageClient {
+    constructor(client) {
+        this.client = client;
+    }
+    from(bucket) {
+        return new StorageFileApi(this.client, bucket);
+    }
+}
+exports.StorageClient = StorageClient;
+class StorageFileApi {
+    constructor(client, bucket) {
+        this.client = client;
+        this.bucket = bucket;
+    }
+    async upload(path, fileBody, options = {}) {
+        const projectId = this.requireProjectId('upload');
+        const fullPath = this.fullKey(path);
+        try {
+            const result = await this.client.putBytes(`/fs/${enc(projectId)}/${encKey(fullPath)}`, fileBody, options.contentType ?? inferContentType(fileBody) ?? 'application/octet-stream');
+            return {
+                data: {
+                    path,
+                    fullPath: result.path ?? fullPath,
+                    id: result.path ?? fullPath,
+                },
+                error: null,
+                status: 200,
+            };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    async download(path) {
+        const projectId = this.requireProjectId('download');
+        const fullPath = this.fullKey(path);
+        try {
+            const result = await this.client.getBytes(`/fs/${enc(projectId)}/${encKey(fullPath)}`);
+            return { data: result, error: null, status: 200 };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    /**
+     * List files in this bucket (or a sub-prefix).
+     * Routes to `GET /v1/fs/{pid}/{bucket}/{prefix}` which returns
+     * a directory listing when the path is a directory.
+     */
+    async list(prefix = '', _options = {}) {
+        const projectId = this.requireProjectId('list');
+        const dirPath = prefix ? this.fullKey(prefix) : this.bucket;
+        try {
+            const result = await this.client.getBytes(`/fs/${enc(projectId)}/${encKey(dirPath)}`);
+            if (result.contentType.includes('application/json')) {
+                const text = new TextDecoder().decode(result.body);
+                const parsed = JSON.parse(text);
+                const data = parsed?.ok ? parsed.data : parsed;
+                if (data?.type === 'directory' && Array.isArray(data.entries)) {
+                    const objects = data.entries.map((e) => ({
+                        name: e.name,
+                        size: e.size_bytes ?? 0,
+                        content_type: e.content_type,
+                        updated_at: e.updated_at,
+                    }));
+                    return { data: objects, error: null, status: 200 };
+                }
+            }
+            return { data: [], error: null, status: 200 };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    async remove(paths) {
+        const projectId = this.requireProjectId('remove');
+        const removed = [];
+        for (const p of paths) {
+            const fullPath = this.fullKey(p);
+            try {
+                await this.client.call('DELETE', `/fs/${enc(projectId)}/${encKey(fullPath)}`);
+                removed.push({ name: p, size: 0 });
+            }
+            catch (err) {
+                return toResultError(err);
+            }
+        }
+        return { data: removed, error: null, status: 200 };
+    }
+    getPublicUrl(path) {
+        const projectId = this.requireProjectId('getPublicUrl');
+        const fullPath = this.fullKey(path);
+        const publicUrl = `${this.client.baseUrl}/fs/${enc(projectId)}/${encKey(fullPath)}`;
+        return { data: { publicUrl } };
+    }
+    async signedUrl(path, options = {}) {
+        const projectId = this.requireProjectId('signedUrl');
+        const fullPath = this.fullKey(path);
+        try {
+            const body = { path: '/' + fullPath };
+            if (typeof options.expiresIn === 'number')
+                body.expires_in = options.expiresIn;
+            const res = await this.client.call('POST', `/fs/${enc(projectId)}/sign`, body);
+            return { data: res, error: null, status: 200 };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    /**
+     * Alias of `signedUrl`. `createSignedUrl(path, expiresIn)` resolves to
+     * `{ data: { signedUrl, ...meta }, error }`.
+     */
+    async createSignedUrl(path, expiresIn) {
+        const res = await this.signedUrl(path, { expiresIn });
+        if (res.error || !res.data) {
+            return { data: null, error: res.error, status: res.status };
+        }
+        return {
+            data: { ...res.data, signedUrl: res.data.url },
+            error: null,
+            status: res.status,
+        };
+    }
+    async integrityCheck(options = {}) {
+        const projectId = this.requireProjectId('integrityCheck');
+        try {
+            const body = {};
+            if (options.autoClean === true)
+                body.auto_clean = true;
+            if (typeof options.limit === 'number')
+                body.limit = options.limit;
+            if (typeof options.cursor === 'string')
+                body.cursor = options.cursor;
+            const res = await this.client.call('POST', `/fs/${enc(projectId)}/integrity-check`, body);
+            return { data: res, error: null, status: 200 };
+        }
+        catch (err) {
+            return toResultError(err);
+        }
+    }
+    fullKey(path) {
+        const trimmed = path.startsWith('/') ? path.slice(1) : path;
+        return `${this.bucket}/${trimmed}`;
+    }
+    requireProjectId(method) {
+        return this.client.requireProjectId(undefined, `storage.from('${this.bucket}').${method}`);
+    }
+}
+exports.StorageFileApi = StorageFileApi;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+function encKey(key) {
+    return key
+        .split('/')
+        .map(encodeURIComponent)
+        .join('/');
+}
+function inferContentType(body) {
+    if (typeof Blob !== 'undefined' && body instanceof Blob && body.type) {
+        return body.type;
+    }
+    if (typeof body === 'string') {
+        return 'text/plain; charset=utf-8';
+    }
+    return null;
+}
+function toResultError(err) {
+    if (err instanceof errors_js_1.SomewhereError) {
+        return { data: null, error: err, status: err.statusCode };
+    }
+    throw err;
+}
+//# sourceMappingURL=storage.js.map