@somewhere-cloud/sdk 0.0.0-stage → 0.13.0

package/dist/esm/client.js

@@ -0,0 +1,388 @@
+import { SomewhereError } from './errors.js';
+import { QueryCache } from './query-cache.js';
+const DEFAULT_BASE_URL = 'https://api.somewhere.cloud/v1';
+function isBinaryBody(body) {
+    if (typeof FormData !== 'undefined' && body instanceof FormData)
+        return true;
+    if (typeof Blob !== 'undefined' && body instanceof Blob)
+        return true;
+    if (typeof ArrayBuffer !== 'undefined' && body instanceof ArrayBuffer)
+        return true;
+    if (ArrayBuffer.isView(body))
+        return true;
+    if (typeof ReadableStream !== 'undefined' && body instanceof ReadableStream)
+        return true;
+    return false;
+}
+/**
+ * Internal HTTP client. Not exported from the SDK surface — the
+ * `Somewhere` facade owns a single Client instance and passes it to
+ * every resource. Handles auth mode resolution, envelope unwrapping,
+ * typed error materialization, binary round-trips, and the `safeCall`
+ * helper that converts `call` into a `Result<T>` envelope for the
+ * result-envelope surfaces.
+ */
+export class Client {
+    constructor(opts) {
+        /**
+         * Set by `auth.signInWithPassword` / `auth.signUp` on success.
+         * Cleared by `auth.signOut`. Used by `dual` and `session` auth modes;
+         * NEVER overrides `developer` mode (developer-only endpoints always
+         * use the initial `smt_` key — the server rejects JWTs on them).
+         */
+        this.sessionAuthHeader = null;
+        /** Surfaces already warned about. Direct browser database and file API calls are disabled;
+         * each surface warns once. */
+        this.browserDataWarnings = new Set();
+        if (opts.key && opts.token) {
+            throw new Error('Somewhere: pass `key` OR `token`, not both.');
+        }
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.authMode =
+            opts.authMode ?? (typeof document !== 'undefined' ? 'cookie' : 'header');
+        if (!opts.key && !opts.token && this.authMode !== 'cookie') {
+            throw new Error('Somewhere: bearer mode requires either `key` (smt_...) or `token` (app-user JWT).');
+        }
+        this.authPath = (opts.authPath ?? '/api/auth').replace(/\/$/, '');
+        this.functionsUrl = opts.functionsUrl
+            ? opts.functionsUrl.replace(/\/$/, '').replace(/\/v1$/, '')
+            : undefined;
+        this.defaultProjectId = opts.projectId;
+        const initialCredential = opts.key ?? opts.token;
+        this.initialAuthHeader = initialCredential ? `Bearer ${initialCredential}` : null;
+        this.initialAuthKind = opts.key ? 'key' : opts.token ? 'token' : 'none';
+        this.extraHeaders = opts.headers ?? {};
+        const f = opts.fetch ?? globalThis.fetch;
+        if (!f) {
+            throw new Error('Somewhere: no fetch implementation found. Pass `fetch` explicitly.');
+        }
+        this.fetchImpl = f;
+        const cacheOpt = opts.cache;
+        this.cache =
+            cacheOpt === false
+                ? null
+                : new QueryCache(cacheOpt === true || cacheOpt === undefined ? {} : cacheOpt);
+    }
+    /**
+     * Drop cached `from().select()` reads for a table. Invoked automatically
+     * after a write to the table (read-your-own-writes); also the public seam
+     * for event-driven invalidation. No-op when the cache is disabled.
+     */
+    invalidateTable(table) {
+        this.cache?.invalidate(table);
+    }
+    /** True when the client was constructed with a developer `smt_` key. */
+    get hasDeveloperKey() {
+        return this.initialAuthKind === 'key';
+    }
+    /** True when a user session is currently active. */
+    get hasSession() {
+        return this.sessionAuthHeader !== null;
+    }
+    resolveProjectId(explicit) {
+        return explicit ?? this.defaultProjectId;
+    }
+    requireProjectId(explicit, what = 'this call') {
+        const pid = this.resolveProjectId(explicit);
+        if (!pid) {
+            throw new Error(`Somewhere: ${what} requires a projectId (pass one in the constructor).`);
+        }
+        return pid;
+    }
+    setSessionToken(accessToken) {
+        const header = `Bearer ${accessToken}`;
+        if (header !== this.sessionAuthHeader)
+            this.cache?.clear();
+        this.sessionAuthHeader = header;
+    }
+    clearSession() {
+        this.cache?.clear();
+        this.sessionAuthHeader = null;
+    }
+    /**
+     * The `Authorization` value a project-function call should carry: the
+     * active user session if signed in, else the construction key/token.
+     * Same precedence as `dual` mode.
+     */
+    get sessionOrInitialBearer() {
+        const header = this.sessionAuthHeader ?? this.initialAuthHeader;
+        if (!header) {
+            throw new SomewhereError({
+                code: 'BROWSER_SERVER_FUNCTION_REQUIRED',
+                message: 'This browser cookie client has no bearer credential. Call a same-origin server function ' +
+                    'with `functions.invoke`; use sw.auth.fromRequest and sw.* inside that function.',
+                statusCode: 400,
+                retry: false,
+                retryAfterMs: null,
+            });
+        }
+        return header;
+    }
+    /** Low-level fetch passthrough for absolute URLs (project function hosts). */
+    rawFetch(url, init) {
+        return this.fetchImpl(url, init);
+    }
+    authHeader(mode = 'dual') {
+        if (mode === 'developer') {
+            if (this.initialAuthKind !== 'key') {
+                throw new SomewhereError({
+                    code: 'INVALID_API_KEY',
+                    message: 'This call requires a developer `smt_` API key. ' +
+                        'Create the client with `{ key: "smt_..." }` (server-side only).',
+                    statusCode: 401,
+                    retry: false,
+                    retryAfterMs: null,
+                });
+            }
+            return this.initialAuthHeader;
+        }
+        if (mode === 'session') {
+            if (!this.sessionAuthHeader) {
+                throw new SomewhereError({
+                    code: 'AUTH_INVALID_CREDS',
+                    message: 'This call requires an active user session. Sign in with ' +
+                        '`sw.auth.signInWithPassword({ email, password })` first.',
+                    statusCode: 401,
+                    retry: false,
+                    retryAfterMs: null,
+                });
+            }
+            return this.sessionAuthHeader;
+        }
+        // dual
+        const header = this.sessionAuthHeader ?? this.initialAuthHeader;
+        if (!header) {
+            throw new SomewhereError({
+                code: 'BROWSER_SERVER_FUNCTION_REQUIRED',
+                message: 'This browser cookie client has no bearer credential. Move the operation into a ' +
+                    'same-origin server function and call it with `functions.invoke`.',
+                statusCode: 400,
+                retry: false,
+                retryAfterMs: null,
+            });
+        }
+        return header;
+    }
+    /** JSON request → JSON response. Unwraps `{ok, data}` → `data`, throws on error. */
+    async call(method, path, opts = {}) {
+        if (opts.sessionBearer !== undefined && opts.auth !== 'session') {
+            throw new Error('A per-request session bearer requires session auth.');
+        }
+        this.warnOnDirectBrowserDataAccess(path);
+        const url = this.buildUrl(path, opts.query);
+        const headers = {
+            Authorization: opts.sessionBearer === undefined ? this.authHeader(opts.auth ?? 'dual') : `Bearer ${opts.sessionBearer}`,
+            Accept: 'application/json',
+            ...this.extraHeaders,
+        };
+        let body;
+        if (opts.body !== undefined) {
+            if (isBinaryBody(opts.body)) {
+                body = opts.body;
+            }
+            else {
+                headers['Content-Type'] = 'application/json';
+                body = JSON.stringify(opts.body);
+            }
+        }
+        let res;
+        try {
+            res = await this.fetchImpl(url, { method, headers, body, ...(opts.signal ? { signal: opts.signal } : {}) });
+        }
+        catch (err) {
+            throw new SomewhereError({
+                code: 'NETWORK_ERROR',
+                message: err instanceof Error ? err.message : 'Network error reaching the platform.',
+                statusCode: 0,
+                retry: true,
+                retryAfterMs: null,
+            });
+        }
+        const parsed = await this.parseJson(res);
+        return this.unwrap(parsed, res.status);
+    }
+    /**
+     * Same as `call` but never throws — always returns a `Result<T>`.
+     * Used by result-envelope surfaces where the caller branches
+     * on `.error` instead of catching.
+     */
+    async safeCall(method, path, opts = {}) {
+        try {
+            const data = await this.call(method, path, opts);
+            return { data, error: null, status: 200 };
+        }
+        catch (err) {
+            if (err instanceof SomewhereError) {
+                return { data: null, error: err, status: err.statusCode };
+            }
+            throw err;
+        }
+    }
+    /** Raw binary download. */
+    async getBytes(path, query, auth = 'dual') {
+        this.warnOnDirectBrowserDataAccess(path);
+        const url = this.buildUrl(path, query);
+        let res;
+        try {
+            res = await this.fetchImpl(url, {
+                method: 'GET',
+                headers: { Authorization: this.authHeader(auth), ...this.extraHeaders },
+            });
+        }
+        catch (err) {
+            throw new SomewhereError({
+                code: 'NETWORK_ERROR',
+                message: err instanceof Error ? err.message : 'Network error reaching the platform.',
+                statusCode: 0,
+                retry: true,
+                retryAfterMs: null,
+            });
+        }
+        if (!res.ok) {
+            const parsed = await this.parseJson(res).catch(() => null);
+            throw this.toError(parsed, res.status);
+        }
+        return {
+            body: await res.arrayBuffer(),
+            contentType: res.headers.get('content-type') ?? 'application/octet-stream',
+        };
+    }
+    /** Raw binary upload. */
+    async putBytes(path, body, contentType, auth = 'dual') {
+        this.warnOnDirectBrowserDataAccess(path);
+        const url = this.buildUrl(path);
+        let res;
+        try {
+            res = await this.fetchImpl(url, {
+                method: 'PUT',
+                headers: {
+                    Authorization: this.authHeader(auth),
+                    'Content-Type': contentType,
+                    Accept: 'application/json',
+                    ...this.extraHeaders,
+                },
+                body,
+            });
+        }
+        catch (err) {
+            throw new SomewhereError({
+                code: 'NETWORK_ERROR',
+                message: err instanceof Error ? err.message : 'Network error reaching the platform.',
+                statusCode: 0,
+                retry: true,
+                retryAfterMs: null,
+            });
+        }
+        const parsed = await this.parseJson(res);
+        return this.unwrap(parsed, res.status);
+    }
+    /**
+     * Direct browser calls to the platform's database and file APIs are
+     * disabled; browser code uses declared data/file collections or a server
+     * function. This one-time warning says so. It does not block or alter the
+     * request: the server decides, and the caller gets that answer as a normal
+     * Result. Server-side use of these APIs is unaffected.
+     */
+    warnOnDirectBrowserDataAccess(path) {
+        if (typeof document === 'undefined')
+            return;
+        const surface = path === '/db' || path.startsWith('/db/')
+            ? 'database'
+            : path === '/fs' || path.startsWith('/fs/') || path === '/storage' || path.startsWith('/storage/')
+                ? 'files'
+                : null;
+        if (!surface || this.browserDataWarnings.has(surface))
+            return;
+        this.browserDataWarnings.add(surface);
+        globalThis.console?.warn?.(surface === 'database'
+            ? '[@somewhere-cloud/sdk] Direct browser database API calls are disabled. ' +
+                'Use the generated somewhere:data client for operations allowed by your declared data rules, ' +
+                'or call a server function that uses sw.db.'
+            : '[@somewhere-cloud/sdk] Direct browser file API calls are disabled. ' +
+                'Use a declared somewhere:files collection, or call a server function that uses sw.fs.');
+    }
+    buildUrl(path, query) {
+        const suffix = path.startsWith('/') ? path : `/${path}`;
+        const base = `${this.baseUrl}${suffix}`;
+        if (!query)
+            return base;
+        const params = new URLSearchParams();
+        for (const [k, v] of Object.entries(query)) {
+            if (v === undefined || v === null)
+                continue;
+            params.append(k, String(v));
+        }
+        const qs = params.toString();
+        return qs ? `${base}?${qs}` : base;
+    }
+    async parseJson(res) {
+        const text = await res.text();
+        if (!text)
+            return null;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            // Non-JSON body (typically an HTML error page from a 5xx upstream
+            // or a CF-level block). Turn it into a typed error rather than
+            // letting the raw JSON.parse fault bubble up.
+            if (res.ok) {
+                throw new SomewhereError({
+                    code: 'INVALID_RESPONSE',
+                    message: `The platform returned a non-JSON response (HTTP ${res.status}), so the operation's result could not be confirmed. ` +
+                        'Inspect the resulting state before repeating a write.',
+                    statusCode: res.status,
+                    retry: false,
+                    retryAfterMs: null,
+                });
+            }
+            throw new SomewhereError({
+                code: 'INVALID_RESPONSE',
+                message: `Non-JSON response (status ${res.status}): ${text.slice(0, 200)}`,
+                statusCode: res.status,
+                retry: res.status >= 500,
+                retryAfterMs: null,
+            });
+        }
+    }
+    unwrap(parsed, statusCode) {
+        // Empty-body success (204 No Content, or a proxy returning an empty
+        // body with a 200). Treat as `{data: null}` instead of throwing.
+        if (parsed === null && statusCode >= 200 && statusCode < 300) {
+            return null;
+        }
+        if (parsed && typeof parsed === 'object' && 'ok' in parsed) {
+            const envelope = parsed;
+            if (envelope.ok === true) {
+                return envelope.data;
+            }
+        }
+        throw this.toError(parsed, statusCode);
+    }
+    toError(parsed, statusCode) {
+        if (parsed &&
+            typeof parsed === 'object' &&
+            'ok' in parsed &&
+            parsed.ok === false) {
+            const body = parsed;
+            const retryAfterMs = typeof body.retry_after_ms === 'number' ? body.retry_after_ms : null;
+            return new SomewhereError({
+                code: body.error ?? 'UNKNOWN_ERROR',
+                message: body.message ?? 'Unknown error',
+                statusCode,
+                retry: body.retry === true,
+                retryAfterMs,
+                body,
+            });
+        }
+        return new SomewhereError({
+            code: 'INVALID_RESPONSE',
+            message: `Unexpected response shape (status ${statusCode})`,
+            statusCode,
+            retry: statusCode >= 500,
+            retryAfterMs: null,
+            body: parsed,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/errors.js

@@ -0,0 +1,12 @@
+export class SomewhereError extends Error {
+    constructor(init) {
+        super(init.message);
+        this.name = 'SomewhereError';
+        this.code = init.code;
+        this.statusCode = init.statusCode;
+        this.retry = init.retry;
+        this.retryAfterMs = init.retryAfterMs;
+        this.body = init.body;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAOvC,YAAY,IAAwB;QAClC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF"}

package/dist/esm/index.js

@@ -0,0 +1,188 @@
+import { Client } from './client.js';
+import { AuthClient } from './resources/auth.js';
+import { CallsClient } from './resources/calls.js';
+import { ChatClient } from './resources/chat.js';
+import { DbClient } from './resources/db.js';
+import { EmailsClient } from './resources/emails.js';
+import { FsClient } from './resources/fs.js';
+import { FunctionsClient } from './resources/functions.js';
+import { InboxClient } from './resources/inbox.js';
+import { PaymentsClient } from './resources/payments.js';
+import { SomewhereQueryBuilder, } from './resources/postgrest.js';
+import { StorageClient } from './resources/storage.js';
+import { TasksClient } from './resources/tasks.js';
+import { ProjectsClient } from './resources/projects.js';
+import { VideoClient } from './resources/video.js';
+export { SomewhereError } from './errors.js';
+export { PostgrestFilterBuilder, SomewhereQueryBuilder } from './resources/postgrest.js';
+export { QueryCache } from './query-cache.js';
+export { StorageClient, StorageFileApi } from './resources/storage.js';
+export { AuthClient } from './resources/auth.js';
+export { DbClient } from './resources/db.js';
+export { EmailsClient } from './resources/emails.js';
+export { FsClient } from './resources/fs.js';
+export { FunctionsClient } from './resources/functions.js';
+export { ChatClient, ChatCompletionsClient } from './resources/chat.js';
+export { PaymentsClient } from './resources/payments.js';
+export { VideoClient } from './resources/video.js';
+export { InboxClient, InboxAddressesClient, InboxMessagesClient } from './resources/inbox.js';
+export { CallsClient } from './resources/calls.js';
+export { TasksClient } from './resources/tasks.js';
+export { ProjectsClient } from './resources/projects.js';
+/**
+ * The somewhere.tech client for explicit server and non-browser access, plus
+ * browser auth and application-function conveniences:
+ *
+ *   - `sw.db.query(sql, params)`     — raw SQL
+ *   - `sw.db.from(table)` / `sw.from(table)` — fluent query builder
+ *   - `sw.fs.read(path)` / `sw.fs.write(path, body)` — raw filesystem
+ *   - `sw.storage.from(bucket)`      — prefix-oriented file API
+ *   - `sw.auth`                      — application auth
+ *   - `sw.emails.send(...)`          — Resend email
+ *   - `sw.inbox.messages.list(...)`  — inbound email
+ *   - `sw.chat.completions.create()` — OpenAI chat completions
+ *   - `sw.payments.checkout(...)`    — Stripe Connect (zero platform fee)
+ *   - `sw.video.createUploadUrl()`   — direct-upload video pipeline
+ *   - `sw.calls.createSession()`     — WebRTC SFU sessions
+ *   - `sw.tasks.create(...)`         — per-project ticketing
+ *
+ *     import { Somewhere } from '@somewhere-cloud/sdk'
+ *     const sw = new Somewhere({ key: process.env.SOMEWHERE_API_KEY, projectId: 'booking-app' })
+ *
+ *     const { data } = await sw.from('users').select('*').eq('id', 1)
+ */
+export class Somewhere {
+    constructor(opts) {
+        this.client = new Client(opts);
+        this.auth = new AuthClient(this.client);
+        this.db = new DbClient(this.client);
+        this.fs = new FsClient(this.client);
+        this.storage = new StorageClient(this.client);
+        this.emails = new EmailsClient(this.client);
+        this.inbox = new InboxClient(this.client);
+        this.chat = new ChatClient(this.client);
+        this.payments = new PaymentsClient(this.client);
+        this.functions = new FunctionsClient(this.client);
+        this.video = new VideoClient(this.client);
+        this.calls = new CallsClient(this.client);
+        this.tasks = new TasksClient(this.client);
+        this.projects = new ProjectsClient(this.client);
+    }
+    /** Fluent query builder entry point. Alias of `sw.db.from(table)`. */
+    from(table) {
+        return new SomewhereQueryBuilder(this.client, table);
+    }
+    /**
+     * Warm the client cache for a query ahead of need — hover-prefetch, route
+     * preload, "load the next page while they read this one". Just runs the
+     * query (populating the instance cache); a later identical `.select()`
+     * within the staleTime window is then served instantly from cache.
+     *
+     *     sw.prefetch(sw.from('posts').select('*').eq('id', hoveredId))
+     *     // …on click, this is a cache hit, no network round-trip:
+     *     const { data } = await sw.from('posts').select('*').eq('id', hoveredId)
+     *
+     * No-op for cache effects when the client was created with `{ cache: false }`.
+     */
+    prefetch(query) {
+        return Promise.resolve(query);
+    }
+    /**
+     * Drop cached `from().select()` reads for a table. Read-your-own-writes is
+     * already automatic (writes self-invalidate); reach for this to invalidate
+     * by hand — e.g. from whatever tells your app a row changed:
+     *
+     *     onRowChanged('posts', () => sw.invalidate('posts'))
+     */
+    invalidate(table) {
+        this.client.invalidateTable(table);
+    }
+    /**
+     * `rpc(name, args)` convenience method. On somewhere there are no SQL stored
+     * procedures — a "database function" is one of your deployed `api/<name>`
+     * functions. `rpc('foo', args)` therefore calls `POST {projectUrl}/api/foo`
+     * with `args` as the JSON body and returns `{ data, error }`. Identical to
+     * `functions.invoke(name, { body: args })`; provided so existing `rpc(...)`
+     * call sites port unchanged.
+     */
+    rpc(name, args) {
+        return this.functions.invoke(name, args === undefined ? {} : { body: args });
+    }
+}
+export default Somewhere;
+/* ─── createClient factory ───────────────────────────────────── */
+/**
+ * Derive the project id from a legacy `*.somewhere.tech` application URL's
+ * subdomain. Current `*.somewhere.site` URLs, custom domains, API hosts, and
+ * bare hosts return `undefined`; pass `projectId` explicitly for project
+ * resources. The seam is loud: an unresolved project id surfaces as a clear
+ * error on the first call that needs one.
+ */
+export function projectIdFromUrl(url) {
+    let host;
+    try {
+        host = new URL(url).hostname;
+    }
+    catch {
+        return undefined;
+    }
+    if (!host.endsWith('.somewhere.tech'))
+        return undefined;
+    const sub = host.slice(0, -'.somewhere.tech'.length);
+    // `api.somewhere.tech`, `www.`, or a deeper path aren't project subdomains.
+    if (!sub || sub.includes('.') || sub === 'api' || sub === 'www')
+        return undefined;
+    return sub;
+}
+/**
+ * Create a somewhere.tech client from an application URL:
+ *
+ *     import { createClient } from '@somewhere-cloud/sdk'
+ *     const client = createClient('https://booking-app.somewhere.site', undefined, {
+ *       projectId: 'booking-app',
+ *     })
+ *
+ *     await client.auth.signInWithPassword({ email, password })
+ *     await client.functions.invoke('checkout', { body: { plan: 'pro' } })
+ *
+ * - `somewhereUrl` — your application's URL. Used as the `functions.invoke`
+ *   host. Pass `{ projectId }` for current `*.somewhere.site` URLs and custom
+ *   domains; automatic inference is retained for legacy `*.somewhere.tech`
+ *   application URLs only.
+ * - `somewhereKey` — omit in a browser cookie app. For non-browser use, pass
+ *   an app-user JWT or a developer `smt_` key
+ *   (server-only). Detected by the `smt_` prefix.
+ *
+ * Database / auth / storage calls go to the platform REST base
+ * (`https://api.somewhere.cloud/v1`, override with `options.apiUrl`).
+ */
+export function createClient(somewhereUrl, somewhereKey, options = {}) {
+    const projectId = options.projectId ?? projectIdFromUrl(somewhereUrl);
+    const isDeveloperKey = somewhereKey?.startsWith('smt_') ?? false;
+    const functionsUrl = options.functionsUrl ?? (isLikelyHttpUrl(somewhereUrl) ? somewhereUrl : undefined);
+    return new Somewhere({
+        ...(somewhereKey
+            ? isDeveloperKey
+                ? { key: somewhereKey }
+                : { token: somewhereKey }
+            : {}),
+        projectId,
+        baseUrl: options.apiUrl,
+        functionsUrl,
+        fetch: options.fetch,
+        headers: options.headers,
+        authMode: options.authMode,
+        authPath: options.authPath,
+        cache: options.cache,
+    });
+}
+function isLikelyHttpUrl(value) {
+    try {
+        const u = new URL(value);
+        return u.protocol === 'http:' || u.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}