@qmuse/cloud-client 0.0.1-dev.0

package/LEGAL.md

@@ -0,0 +1,7 @@
+Legal Disclaimer
+
+Within this source code, the comments in Chinese shall be the original, governing version. Any comment in other languages are for reference only. In the event of any conflict between the Chinese language version comments and other language version comments, the Chinese language version shall prevail.
+
+法律免责声明
+
+关于代码注释部分，中文注释为官方版本，其它语言注释仅做参考。中文注释可能与其它语言注释存在不一致，当中文注释与其它语言注释存在不一致时，请以中文注释为准。

package/README.md

@@ -0,0 +1,158 @@
+# @qmuse/cloud-client
+
+Unified Web/PC/mini-program client for QMuse Cloud services. Business APIs use
+the single `qmuse-cloud-api` AppBase Function. File policy uses that Function as
+its control plane while large file bytes use a platform-specific Storage data
+plane inside this package.
+
+The package intentionally does not expose AppBase clients, Functions, Storage,
+TablesDB, endpoint, project ID, database ID, bucket ID, or permissions to
+business modules. A QMuse host adapter supplies narrow execution, Session and
+file transport capabilities.
+
+```ts
+import { createQmuseCloudClient } from '@qmuse/cloud-client';
+
+export const cloudClient = createQmuseCloudClient({
+  execute: input => runtime.executeCloudFunction(input),
+});
+
+const result = await cloudClient.request<{ data: Order }>({
+  method: 'GET',
+  path: '/api/orders/order_1',
+});
+```
+
+Each generated application owns its own users, credentials, sessions, roles,
+and policies. It does not reuse the QMuse platform login. AppBase Auth is only
+an internal shadow transport identity used for Function runtime headers and
+Storage permissions.
+
+The host supplies an application credential store and the two narrow AppBase
+Account operations needed to establish/remove that shadow Session:
+
+```ts
+export const cloudClient = createQmuseCloudClient({
+  execute: input => runtime.executeCloudFunction(input),
+  auth: {
+    credentialStore: secureCredentialStore,
+    shadowSession: {
+      createSession: input => account.createSession(input),
+      deleteCurrentSession: () => account.deleteSession({ sessionId: 'current' }),
+    },
+  },
+});
+
+await cloudClient.auth.login({ email, password });
+const currentUser = await cloudClient.auth.getCurrentUser();
+await cloudClient.auth.logout();
+```
+
+`login/register/refresh` receive a one-time shadow Custom Token from Hono and
+exchange it internally. The token secret is never persisted in the application
+credential store. Refresh is single-flight, rotates application credentials,
+and replaces the current shadow Session. Hosts must back `credentialStore` with
+their platform's secure storage policy; this package does not default refresh
+tokens to `localStorage`.
+
+Business file operations use a logical resource, never a bucket ID:
+
+```ts
+const attachment = await cloudClient.files.upload({
+  resource: 'order-attachment',
+  file,
+  relation: { orderId },
+  onProgress: progress => console.log(progress.progress),
+});
+
+const preview = await cloudClient.files.createPreview({
+  fileId: attachment.id,
+  width: 640,
+});
+image.src = preview.url;
+preview.dispose();
+```
+
+The upload flow creates an intent through `qmuse-cloud-api`, uploads in 5 MiB
+chunks through the injected Web or mini-program data-plane transport, then
+completes the intent through the Function. Failures issue a best-effort cancel;
+the backend must also expire abandoned intents. Preview/download access is
+authorized by the Function and may return a short-lived File Token URL or an
+authenticated URL that the Web transport converts to a disposable Blob URL.
+
+Platform transports are separate package entry points:
+
+```ts
+import { createWebFileTransport } from '@qmuse/cloud-client/web';
+import { createMiniappFileTransport } from '@qmuse/cloud-client/miniapp';
+```
+
+They migrate the proven file mechanics from the legacy `@qmuse/appwrite`
+implementation: Web `File`/`Blob`, Taro-style local paths, 5 MiB chunks,
+`Content-Range`, `X-Appwrite-ID` continuation, progress, fallback Session
+headers and mini-program temporary-file cleanup. They do not migrate TablesDB
+CRUD or the legacy anonymous `Role.any()` update/delete permissions.
+
+For Web hosts, bind an initialized `Functions` instance without exposing it to
+business modules:
+
+```ts
+import { createAppBaseWebCloudClient } from '@qmuse/cloud-client';
+
+export const cloudClient = createAppBaseWebCloudClient(functions, {
+  refreshSession,
+});
+```
+
+The legacy portable adapter remains available during migration:
+
+```ts
+import { createPortableCloudClient } from '@qmuse/cloud-client';
+
+export const cloudClient = createPortableCloudClient(appwrite);
+```
+
+New applications should bind Function, Session and file capabilities directly
+at their host bootstrap and should not depend on `@qmuse/appwrite` or
+`@qmuse/appwrite-runtime-sdk`. The portable adapter only translates this
+package's `path` field to the legacy `xpath` field for staged migration.
+
+Only `/api` paths and an allowlist of business headers are accepted. The client
+uses synchronous Function execution, reads `responseStatusCode`, `responseBody`,
+and `responseHeaders`, and maps non-2xx responses to `QmuseCloudHttpError`.
+
+The client never replays a completed Function response, including a business
+401, because replaying a write could duplicate side effects. The host adapter is
+responsible for Session coordination and may retry `createExecution` once only
+when the execution API request itself fails with a transport-level 401.
+
+Direct Storage upload is an internal data-plane optimization, not a claim that
+the bucket ID is secret on the network or that the protocol can only reach the
+Function. Private buckets must be configured so client users can create files
+but cannot read/update/delete them directly; reads and deletion are authorized
+by the backend. The exact `fileSecurity` + File Token combination remains a
+real AppBase E2E gate before production use.
+
+## Development
+
+```bash
+npm install
+npm run ci
+npm pack --dry-run
+```
+
+## Publishing
+
+Set an unpublished semantic version in `package.json`, authenticate with the
+public npm registry, and run:
+
+```bash
+npm login --registry https://registry.npmjs.org/
+npm run publish:public
+```
+
+The script defaults to the `dev` dist-tag and also supports `latest`. Before
+publishing it checks the version, npm authentication, duplicate versions, the
+full CI command, and package contents, then requires explicit confirmation. It
+temporarily normalizes the public package name and registry and restores
+`package.json` when publishing finishes or fails.

package/dist/adapters.d.ts

@@ -0,0 +1,18 @@
+import type { CloudAuthOptions, CloudExecution, CloudExecutionInput, CloudFileTransport, QmuseCloudClient } from './types.js';
+export interface AppBaseFunctionsCapability {
+    createExecution(input: CloudExecutionInput): Promise<CloudExecution>;
+}
+export interface PortableExecutionInput extends Omit<CloudExecutionInput, 'path'> {
+    xpath: string;
+}
+export interface PortableAppwriteCapability {
+    executeFunction(input: PortableExecutionInput): Promise<CloudExecution>;
+}
+export interface HostAdapterOptions<FileSource = never> {
+    refreshSession?(): Promise<void>;
+    auth?: CloudAuthOptions;
+    fileTransport?: CloudFileTransport<FileSource>;
+}
+export declare function createAppBaseWebCloudClient<FileSource = never>(functions: AppBaseFunctionsCapability, options?: HostAdapterOptions<FileSource>): QmuseCloudClient<FileSource>;
+export declare function createPortableCloudClient<FileSource = never>(appwrite: PortableAppwriteCapability, options?: HostAdapterOptions<FileSource>): QmuseCloudClient<FileSource>;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,0BAA0B;IACzC,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAC/E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,kBAAkB,CAAC,UAAU,GAAG,KAAK;IACpD,cAAc,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,aAAa,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAChD;AAsBD,wBAAgB,2BAA2B,CAAC,UAAU,GAAG,KAAK,EAC5D,SAAS,EAAE,0BAA0B,EACrC,OAAO,GAAE,kBAAkB,CAAC,UAAU,CAAM,GAC3C,gBAAgB,CAAC,UAAU,CAAC,CAY9B;AAED,wBAAgB,yBAAyB,CAAC,UAAU,GAAG,KAAK,EAC1D,QAAQ,EAAE,0BAA0B,EACpC,OAAO,GAAE,kBAAkB,CAAC,UAAU,CAAM,GAC3C,gBAAgB,CAAC,UAAU,CAAC,CAe9B"}

package/dist/adapters.js

@@ -0,0 +1,43 @@
+import { createQmuseCloudClient } from './client.js';
+function isTransportUnauthorized(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const value = error;
+    return [value.code, value.status, value.statusCode, value.response?.status, value.response?.statusCode]
+        .some(code => Number(code) === 401);
+}
+async function withTransportRetry(operation, refreshSession) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        if (!refreshSession || !isTransportUnauthorized(error))
+            throw error;
+        await refreshSession();
+        return operation();
+    }
+}
+export function createAppBaseWebCloudClient(functions, options = {}) {
+    if (!functions || typeof functions.createExecution !== 'function') {
+        throw new TypeError('An AppBase Functions capability is required');
+    }
+    return createQmuseCloudClient({
+        execute: input => withTransportRetry(() => functions.createExecution(input), options.refreshSession),
+        ...(options.auth ? { auth: options.auth } : {}),
+        ...(options.fileTransport ? { fileTransport: options.fileTransport } : {}),
+    });
+}
+export function createPortableCloudClient(appwrite, options = {}) {
+    if (!appwrite || typeof appwrite.executeFunction !== 'function') {
+        throw new TypeError('A portable Appwrite execution capability is required');
+    }
+    return createQmuseCloudClient({
+        execute: input => {
+            const { path, ...portableInput } = input;
+            return withTransportRetry(() => appwrite.executeFunction({ ...portableInput, xpath: path }), options.refreshSession);
+        },
+        ...(options.auth ? { auth: options.auth } : {}),
+        ...(options.fileTransport ? { fileTransport: options.fileTransport } : {}),
+    });
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAqCrD,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,KAA2B,CAAC;IAC1C,OAAO,CAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAE;SACtG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,SAA2B,EAC3B,cAAoC;IAEpC,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,cAAc,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;QACpE,MAAM,cAAc,EAAE,CAAC;QACvB,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,SAAqC,EACrC,UAA0C,EAAE;IAE5C,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,sBAAsB,CAAC;QAC5B,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAClC,GAAG,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,EACtC,OAAO,CAAC,cAAc,CACvB;QACD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAoC,EACpC,UAA0C,EAAE;IAE5C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAChE,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,sBAAsB,CAAC;QAC5B,OAAO,EAAE,KAAK,CAAC,EAAE;YACf,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,EAAE,GAAG,KAAK,CAAC;YACzC,OAAO,kBAAkB,CACvB,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACjE,OAAO,CAAC,cAAc,CACvB,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;AACL,CAAC"}

package/dist/auth.d.ts

@@ -0,0 +1,9 @@
+import type { CloudAuthOptions, CloudRequest, CloudResponse, QmuseCloudAuth } from './types.js';
+type AuthRequest = <T>(request: CloudRequest, accessToken?: string) => Promise<CloudResponse<T>>;
+export type CloudAuthRuntime = QmuseCloudAuth & {
+    accessToken(): Promise<string | undefined>;
+};
+export declare function createUnavailableCloudAuth(): CloudAuthRuntime;
+export declare function createCloudAuth(options: CloudAuthOptions, request: AuthRequest): CloudAuthRuntime;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,gBAAgB,EAKhB,YAAY,EACZ,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,KAAK,WAAW,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjG,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG;IAAE,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAAE,CAAC;AAqC/F,wBAAgB,0BAA0B,IAAI,gBAAgB,CAa7D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,GAAG,gBAAgB,CA4GjG"}

package/dist/auth.js

@@ -0,0 +1,157 @@
+import { QmuseCloudError } from './errors.js';
+function validCredentials(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const item = value;
+    return typeof item.accessToken === 'string' && item.accessToken.length > 0 &&
+        typeof item.refreshToken === 'string' && item.refreshToken.length > 0 &&
+        typeof item.accessTokenExpiresAt === 'string' && item.accessTokenExpiresAt.length > 0 &&
+        !!item.user && typeof item.user === 'object' && typeof item.user.id === 'string' && item.user.id.length > 0;
+}
+function validSessionResult(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const item = value;
+    const shadow = item.shadowSession;
+    return validCredentials(item.credentials) && !!shadow && typeof shadow === 'object' &&
+        typeof shadow.userId === 'string' && shadow.userId === item.credentials.user.id &&
+        typeof shadow.secret === 'string' && shadow.secret.length > 0 &&
+        typeof shadow.expire === 'string' && shadow.expire.length > 0;
+}
+function sessionResult(response) {
+    const value = response.data?.data;
+    if (!validSessionResult(value)) {
+        throw new QmuseCloudError('Cloud API returned an invalid authentication response', 'AUTH_RESPONSE_INVALID');
+    }
+    return value;
+}
+export function createUnavailableCloudAuth() {
+    const unavailable = async () => {
+        throw new QmuseCloudError('Cloud Auth is not configured', 'AUTH_UNAVAILABLE');
+    };
+    return {
+        register: unavailable,
+        login: unavailable,
+        refresh: unavailable,
+        restore: async () => null,
+        logout: async () => undefined,
+        getCurrentUser: async () => null,
+        accessToken: async () => undefined,
+    };
+}
+export function createCloudAuth(options, request) {
+    if (!options || typeof options.credentialStore?.load !== 'function' ||
+        typeof options.credentialStore.save !== 'function' || typeof options.credentialStore.clear !== 'function') {
+        throw new TypeError('Cloud Auth requires a credential store');
+    }
+    if (typeof options.shadowSession?.createSession !== 'function' ||
+        typeof options.shadowSession.deleteCurrentSession !== 'function') {
+        throw new TypeError('Cloud Auth requires a shadow Session capability');
+    }
+    let loaded = false;
+    let credentials = null;
+    let refreshFlight = null;
+    const load = async () => {
+        if (loaded)
+            return credentials;
+        const stored = await options.credentialStore.load();
+        credentials = validCredentials(stored) ? stored : null;
+        loaded = true;
+        if (stored && !credentials)
+            await options.credentialStore.clear();
+        return credentials;
+    };
+    const clear = async () => {
+        credentials = null;
+        loaded = true;
+        await options.credentialStore.clear();
+    };
+    const establish = async (result) => {
+        await options.shadowSession.createSession({
+            userId: result.shadowSession.userId,
+            secret: result.shadowSession.secret,
+        });
+        try {
+            await options.credentialStore.save(result.credentials);
+            credentials = result.credentials;
+            loaded = true;
+            return result.credentials.user;
+        }
+        catch (error) {
+            await options.shadowSession.deleteCurrentSession().catch(() => undefined);
+            throw error;
+        }
+    };
+    const authenticate = async (path, body) => {
+        await options.shadowSession.deleteCurrentSession().catch(() => undefined);
+        return establish(sessionResult(await request({ method: 'POST', path, body })));
+    };
+    const refresh = async () => {
+        if (refreshFlight)
+            return refreshFlight;
+        refreshFlight = (async () => {
+            const current = await load();
+            if (!current)
+                throw new QmuseCloudError('No application session is available', 'AUTH_SESSION_MISSING');
+            await options.shadowSession.deleteCurrentSession().catch(() => undefined);
+            const response = await request({
+                method: 'POST',
+                path: '/api/auth/refresh',
+                body: { refreshToken: current.refreshToken },
+            });
+            return establish(sessionResult(response));
+        })();
+        try {
+            return await refreshFlight;
+        }
+        finally {
+            refreshFlight = null;
+        }
+    };
+    return {
+        register: input => authenticate('/api/auth/register', input),
+        login: input => authenticate('/api/auth/login', input),
+        refresh,
+        async restore() {
+            if (!await load())
+                return null;
+            try {
+                return await refresh();
+            }
+            catch (error) {
+                await clear();
+                await options.shadowSession.deleteCurrentSession().catch(() => undefined);
+                throw error;
+            }
+        },
+        async logout() {
+            const current = await load();
+            try {
+                if (current) {
+                    await request({ method: 'POST', path: '/api/auth/logout' }, current.accessToken);
+                }
+            }
+            finally {
+                await options.shadowSession.deleteCurrentSession().catch(() => undefined);
+                await clear();
+            }
+        },
+        async getCurrentUser() {
+            const current = await load();
+            if (!current)
+                return null;
+            const response = await request({ method: 'GET', path: '/api/auth/me' }, current.accessToken);
+            const user = response.data?.data;
+            if (!user || typeof user !== 'object' || typeof user.id !== 'string') {
+                throw new QmuseCloudError('Cloud API returned an invalid current user', 'AUTH_USER_INVALID');
+            }
+            credentials = { ...current, user };
+            await options.credentialStore.save(credentials);
+            return user;
+        },
+        async accessToken() {
+            return (await load())?.accessToken;
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,5 @@
+import type { QmuseCloudClient, QmuseCloudClientOptions, CloudFileTransport } from './types.js';
+export declare function createQmuseCloudClient<FileSource = never>(options: Omit<QmuseCloudClientOptions, 'fileTransport'> & {
+    fileTransport?: CloudFileTransport<FileSource>;
+}): QmuseCloudClient<FileSource>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAKV,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA+GpB,wBAAgB,sBAAsB,CAAC,UAAU,GAAG,KAAK,EACvD,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAA;CAAE,GAC3G,gBAAgB,CAAC,UAAU,CAAC,CA+C9B"}

package/dist/client.js

@@ -0,0 +1,157 @@
+import { QmuseCloudError, QmuseCloudHttpError } from './errors.js';
+import { createCloudAuth, createUnavailableCloudAuth } from './auth.js';
+import { createCloudFiles } from './files.js';
+const functionId = 'qmuse-cloud-api';
+const allowedHeaders = new Set([
+    'accept',
+    'content-type',
+    'idempotency-key',
+    'if-match',
+    'if-none-match',
+    'x-request-id',
+]);
+function encodeQueryValue(value) {
+    return value === null ? '' : String(value);
+}
+function buildPath(path, query) {
+    if (!path.startsWith('/api/') && path !== '/api') {
+        throw new TypeError('Cloud API path must be /api or start with /api/');
+    }
+    if (path.includes('?') || path.includes('#') || path.includes('://')) {
+        throw new TypeError('Cloud API path must not contain a query, fragment, or URL scheme');
+    }
+    if (!query)
+        return path;
+    const params = new URLSearchParams();
+    for (const key of Object.keys(query).sort()) {
+        const value = query[key];
+        if (value !== undefined)
+            params.append(key, encodeQueryValue(value));
+    }
+    const encoded = params.toString();
+    return encoded ? `${path}?${encoded}` : path;
+}
+function normalizeRequestHeaders(headers, hasBody, accessToken) {
+    const normalized = { accept: 'application/json' };
+    for (const [rawName, value] of Object.entries(headers ?? {})) {
+        const name = rawName.trim().toLowerCase();
+        if (!allowedHeaders.has(name)) {
+            throw new TypeError(`Cloud API header is not allowed: ${rawName}`);
+        }
+        normalized[name] = value;
+    }
+    if (hasBody && !normalized['content-type'])
+        normalized['content-type'] = 'application/json';
+    if (accessToken)
+        normalized.authorization = `Bearer ${accessToken}`;
+    return normalized;
+}
+function normalizeResponseHeaders(value) {
+    if (!value)
+        return {};
+    if (!Array.isArray(value)) {
+        return Object.fromEntries(Object.entries(value).map(([name, headerValue]) => [name.toLowerCase(), headerValue]));
+    }
+    const headers = {};
+    for (const header of value)
+        headers[header.name.toLowerCase()] = header.value;
+    return headers;
+}
+function parseBody(body) {
+    if (!body)
+        return null;
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        return body;
+    }
+}
+function readHttpError(status, payload) {
+    let code = `HTTP_${status}`;
+    let message = `Cloud API request failed with status ${status}`;
+    let details;
+    if (payload && typeof payload === 'object' && 'error' in payload) {
+        const error = payload.error;
+        if (error && typeof error === 'object') {
+            const record = error;
+            if (typeof record.code === 'string' && record.code)
+                code = record.code;
+            if (typeof record.message === 'string' && record.message)
+                message = record.message;
+            details = record.details;
+        }
+    }
+    return new QmuseCloudHttpError({ status, code, message, details });
+}
+function isTransportUnauthorized(error) {
+    if (error instanceof QmuseCloudHttpError || !error || typeof error !== 'object')
+        return false;
+    const value = error;
+    return [value.code, value.status, value.statusCode, value.response?.status, value.response?.statusCode]
+        .some(code => Number(code) === 401);
+}
+function serializeBody(request) {
+    if (request.method === 'GET' || request.method === 'DELETE') {
+        if (request.body !== undefined)
+            throw new TypeError(`${request.method} requests must not contain a body`);
+        return '';
+    }
+    if (request.body === undefined)
+        return '';
+    try {
+        return JSON.stringify(request.body);
+    }
+    catch (cause) {
+        throw new QmuseCloudError('Cloud API request body is not JSON serializable', 'BODY_NOT_SERIALIZABLE', { cause });
+    }
+}
+export function createQmuseCloudClient(options) {
+    if (!options || typeof options.execute !== 'function') {
+        throw new TypeError('A Cloud API execution capability is required');
+    }
+    const execute = async (request, accessToken) => {
+        const body = serializeBody(request);
+        const execution = await options.execute({
+            functionId,
+            body,
+            async: false,
+            path: buildPath(request.path, request.query),
+            method: request.method,
+            headers: normalizeRequestHeaders(request.headers, body.length > 0, accessToken),
+        });
+        if (execution.status !== 'completed') {
+            throw new QmuseCloudError('Cloud API Function execution did not complete', 'EXECUTION_NOT_COMPLETED');
+        }
+        const status = execution.responseStatusCode;
+        if (!Number.isInteger(status) || status < 100 || status > 599) {
+            throw new QmuseCloudError('Cloud API Function returned an invalid status', 'EXECUTION_STATUS_INVALID');
+        }
+        const data = parseBody(execution.responseBody);
+        if (status < 200 || status >= 300)
+            throw readHttpError(status, data);
+        return {
+            status,
+            headers: normalizeResponseHeaders(execution.responseHeaders),
+            data: data,
+        };
+    };
+    const auth = options.auth ? createCloudAuth(options.auth, execute) : createUnavailableCloudAuth();
+    const authenticatedExecute = async (request) => {
+        try {
+            return await execute(request, await auth.accessToken());
+        }
+        catch (error) {
+            if (!options.auth || !isTransportUnauthorized(error))
+                throw error;
+            await auth.restore();
+            return execute(request, await auth.accessToken());
+        }
+    };
+    return {
+        request: (request) => authenticatedExecute(request),
+        auth,
+        files: createCloudFiles(authenticatedExecute, options.fileTransport),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class QmuseCloudError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string, options?: ErrorOptions);
+}
+export declare class QmuseCloudHttpError extends QmuseCloudError {
+    readonly status: number;
+    readonly details: unknown;
+    constructor(input: {
+        status: number;
+        code: string;
+        message: string;
+        details?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKlE;AAED,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;CAMxF"}

package/dist/errors.js

@@ -0,0 +1,19 @@
+export class QmuseCloudError extends Error {
+    code;
+    constructor(message, code, options) {
+        super(message, options);
+        this.name = 'QmuseCloudError';
+        this.code = code;
+    }
+}
+export class QmuseCloudHttpError extends QmuseCloudError {
+    status;
+    details;
+    constructor(input) {
+        super(input.message, input.code);
+        this.name = 'QmuseCloudHttpError';
+        this.status = input.status;
+        this.details = input.details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAY,EAAE,OAAsB;QAC/D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IAC7C,MAAM,CAAS;IACf,OAAO,CAAU;IAE1B,YAAY,KAA2E;QACrF,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,CAAC;CACF"}

package/dist/files.d.ts

@@ -0,0 +1,5 @@
+import type { CloudFileTransport, CloudRequest, CloudResponse, QmuseCloudFiles } from './types.js';
+type RequestCloud = <T>(request: CloudRequest) => Promise<CloudResponse<T>>;
+export declare function createCloudFiles<FileSource>(request: RequestCloud, transport?: CloudFileTransport<FileSource>): QmuseCloudFiles<FileSource>;
+export {};
+//# sourceMappingURL=files.d.ts.map