ryuu-client 4.4.5 → 5.0.0-beta.1

package/README.md

@@ -1,46 +1,264 @@
-# Ryuu Client
+# ryuu-client
 
-The client (endpoint) repository used by Ryuu/Domo App Platform
+Node.js client for the Domo Apps platform. Used by [ryuu](https://www.npmjs.com/package/ryuu) (the Domo Apps CLI) and [ryuu-proxy](https://www.npmjs.com/package/@domoinc/ryuu-proxy) to authenticate with Domo, manage app designs, upload assets, and proxy local development sessions.
 
 [![npm version](https://img.shields.io/npm/v/ryuu-client.svg?style=flat-square)](https://www.npmjs.org/package/ryuu-client)
 [![install size](https://img.shields.io/badge/dynamic/json?url=https://packagephobia.com/v2/api.json?p=ryuu-client&query=$.install.pretty&label=install%20size&style=flat-square)](https://packagephobia.com/result?p=ryuu-client)
 [![npm downloads](https://img.shields.io/npm/dm/ryuu-client.svg?style=flat-square)](https://npm-stat.com/charts.html?package=ryuu-client)
-[![Known Vulnerabilities](https://snyk.io/test/npm/ryuu-client/badge.svg)](https://snyk.io/test/npm/ryuu-client)
 
-See the [developer docs](https://developer.domo.com/docs/dev-studio/dev-studio-overview) for instructions on how to install and use this library (almost solely as a dependancy of Ryuu/Ryuu-Proxy), as well as more information about the complete Domo App Platform.
+## Requirements
 
-## Building
+- **Node.js >= 22.0.0**
+- **pnpm** (package manager)
 
-To build ryuu-client, run
+## Install
 
 ```bash
-npm run build
+pnpm add ryuu-client
 ```
 
-All necessary files will be built/copied into the `lib` folder.
+## Usage
 
-## Contributing
+```typescript
+import { createClient, getHomeDir, getMostRecentLogin } from 'ryuu-client';
 
-Recommended Workflow:
+const client = createClient({
+  instance: 'mycompany.domo.com',
+  refreshToken: '...',
+  clientId: '...',
+  devToken: false,
+  proxy: { host: 'proxy.corp.com', port: 8080 }, // optional
+});
+```
+
+### Authentication
+
+```typescript
+// OAuth device-code flow (opens browser for authorization)
+const loginData = await client.login();
+console.log(`Welcome, ${loginData.displayName}`);
+
+// Tokens are cached automatically — subsequent API calls
+// skip redundant token exchanges until the cache expires.
+```
+
+### Designs
+
+```typescript
+// Create a new design
+const design = await client.designs.create(manifest);
+
+// Get a design by ID
+const design = await client.designs.get(designId, { parts: 'versions' });
+
+// List all designs
+const designs = await client.designs.list();
+
+// Delete / undelete
+await client.designs.delete(designId, true); // force=true
+await client.designs.undelete(designId);
+
+// Versions and releases
+const versions = await client.designs.getVersions(designId);
+await client.designs.release(designId, '2.0.0');
+```
+
+### Assets
+
+```typescript
+// Upload a single asset
+await client.assets.upload(designId, version, 'dist/app.js');
+
+// Upload all assets (reads files from cwd, respects manifest.ignore)
+const uploaded = await client.assets.uploadAll(manifest);
+
+// Download assets as a zip stream
+const response = await client.assets.download(designId, version);
+```
+
+### Apps
+
+```typescript
+// Create a temporary app instance (for local dev proxying)
+const { instance } = await client.apps.createInstance(designId);
 
-1. Create new branch (named "DOMO-XXXXXX")
-2. Make Changes
-3. Commit Changes
-4. Test changes (if necessary, version a alpha/beta/tagged version, then release it)
-5. Make pull request
-6. After pull request is merged to master, bump version, then release it to npm
+// Get the full dev environment (domoapps domain, user info, etc.)
+const env = await client.apps.getEnvironment(manifest, proxyId);
+```
+
+### Escape hatch
+
+For endpoints not covered by the namespaced API, use `client.request()` directly. Auth headers are injected automatically.
+
+```typescript
+const result = await client.request('/api/some/endpoint', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify(payload),
+});
+```
 
-## Versioning
+### Utilities
+
+```typescript
+import { getHomeDir, getMostRecentLogin, getContentType } from 'ryuu-client';
+
+// ~/.config/configstore path
+const configDir = getHomeDir();
+
+// Most recently modified login JSON
+const login = getMostRecentLogin();
+
+// Content-type lookup with octet-stream fallback
+getContentType('font.ttf');    // 'font/ttf'
+getContentType('data.bin');    // 'application/octet-stream'
+```
+
+### Error handling
+
+All errors are typed with `cause` chaining support:
+
+```typescript
+import { RyuuHttpError, RyuuAuthError, RyuuValidationError } from 'ryuu-client';
+
+try {
+  await client.designs.get('bad-id');
+} catch (err) {
+  if (err instanceof RyuuHttpError) {
+    console.error(err.statusCode, err.message, err.url);
+  }
+}
+```
+
+## Architecture
+
+```
+src/
+├── index.ts              # Public barrel export
+├── client.ts             # createClient() factory
+├── auth/                 # OAuth device-code flow, token caching
+├── http/                 # Native fetch wrapper, undici proxy, error classes
+├── api/                  # Namespaced API modules (designs, assets, apps, users)
+├── types/                # TypeScript interfaces and enums
+└── util/                 # Content-type map, endpoints, home-dir helpers
+```
 
-This project utilizes [standard-version](https://github.com/conventional-changelog/standard-version).
+### Key design decisions
 
-- `npm run bump` - Version bumps determined automatically via commits
-- `npm run bumpBeta` or `npm run bump -- --prerelease beta` - 4.0.x-beta.0 (if no current beta) or 4.0.0-beta.x (if current beta exists)
+- **Native `fetch`** — no axios. Proxy support via undici `ProxyAgent`.
+- **Token caching** — access tokens and SIDs are cached with TTL, reducing most requests from 2 extra roundtrips to 0.
+- **Scoped TLS bypass** — `domorig.io` instances use an undici `Agent` with `rejectUnauthorized: false` instead of the global `NODE_TLS_REJECT_UNAUTHORIZED=0`.
+- **Typed errors** — `RyuuHttpError`, `RyuuAuthError`, `RyuuValidationError` with `cause` chaining. No more `Promise<unknown>`.
+- **ESM only** — `"type": "module"`, targeting ES2023 with `NodeNext` module resolution.
 
-### Releasing
+### Dependencies
 
-Versions should be released on NPM and then updated in the ryuu-cli package.json
+| Runtime | Purpose |
+|---------|---------|
+| `open` | Launch browser for OAuth device-code flow |
+| `tinyglobby` | Lightweight glob for asset uploads |
+| `undici` | `ProxyAgent` for proxy support with native fetch |
 
-- `npm run release`
-- `npm run releaseAlpha`
-- `npm run releaseBeta`
+## Development
+
+```bash
+pnpm install
+pnpm build          # TypeScript compile to dist/
+pnpm test           # Run unit tests (vitest)
+pnpm test:watch     # Watch mode
+pnpm test:coverage  # Coverage report
+pnpm format         # Prettier
+```
+
+## v5 migration guide
+
+v5 is a ground-up rewrite. The default export class is replaced by a `createClient()` factory returning a namespaced API object.
+
+### Import changes
+
+```diff
+- import Domo from 'ryuu-client';
++ import { createClient, getHomeDir, type RyuuClient } from 'ryuu-client';
+```
+
+### Constructor
+
+```diff
+- const client = new Domo(instance, refreshToken, clientId, { host, port }, devToken);
++ const client = createClient({ instance, refreshToken, clientId, devToken, proxy: { host, port } });
+```
+
+### Getters
+
+```diff
+- client.getInstance()
++ client.instance
+
+- client.getRefreshToken()
++ client.refreshToken
+```
+
+### Static methods
+
+```diff
+- Domo.getHomeDir()
++ getHomeDir()
+
+- Domo.getMostRecentLogin()
++ getMostRecentLogin()
+```
+
+### API methods
+
+```diff
+- client.createDesign(manifest)
++ client.designs.create(manifest)
+
+- client.getDesign(id, params)
++ client.designs.get(id, params)
+
+- client.getDesigns(params)
++ client.designs.list(params)
+
+- client.deleteDesign(id, force)
++ client.designs.delete(id, force)
+
+- client.unDeleteDesign(id)
++ client.designs.undelete(id)
+
+- client.getVersions(id)
++ client.designs.getVersions(id)
+
+- client.release(id, version)
++ client.designs.release(id, version)
+
+- client.uploadAsset(designId, version, path, contents)
++ client.assets.upload(designId, version, path, contents)
+
+- client.uploadAllAssets(manifest)
++ client.assets.uploadAll(manifest)
+
+- client.download(designId, version)
++ client.assets.download(designId, version)
+
+- client.createApp(designId, proxyId)
++ client.apps.createInstance(designId, proxyId)
+
+- client.getDomoappsData(manifest, proxyId)
++ client.apps.getEnvironment(manifest, proxyId)
+
+- client.processRequest(options)
++ client.request(url, init)
+```
+
+### Error handling
+
+```diff
+- .catch(err => console.log(err.statusCode, err.message))
++ import { RyuuHttpError } from 'ryuu-client';
++ .catch(err => {
++   if (err instanceof RyuuHttpError) {
++     console.log(err.statusCode, err.message);
++   }
++ })
+```

package/dist/api/apps.d.ts

@@ -0,0 +1,12 @@
+import type { FetchClient } from '../http/fetch-client.js';
+import type { Authenticator } from '../auth/authenticator.js';
+import type { Environment, InstanceAndCards, Manifest } from '../types/index.js';
+export declare class AppsApi {
+    private readonly http;
+    private readonly auth;
+    private readonly instance;
+    constructor(http: FetchClient, auth: Authenticator, instance: string);
+    createInstance(designId: string, proxyId?: string): Promise<InstanceAndCards>;
+    getEnvironment(manifest: Manifest, proxyId?: string): Promise<Environment>;
+}
+//# sourceMappingURL=apps.d.ts.map

package/dist/api/apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../src/api/apps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAOjF,qBAAa,OAAO;IAEhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,MAAM;IAG7B,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC;IAoBtB,cAAc,CAClB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC;CA6BxB"}

package/dist/api/apps.js

@@ -0,0 +1,57 @@
+import { INSTANCES_URL, ENVIRONMENT_URL, } from '../util/endpoints.js';
+import { getEnv } from '../util/home-dir.js';
+export class AppsApi {
+    http;
+    auth;
+    instance;
+    constructor(http, auth, instance) {
+        this.http = http;
+        this.auth = auth;
+        this.instance = instance;
+    }
+    async createInstance(designId, proxyId) {
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            ...(await this.auth.getAuthHeader()),
+        };
+        return this.http.request(`${INSTANCES_URL}?temporary=true`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                designId,
+                id: proxyId ?? null,
+            }),
+        });
+    }
+    async getEnvironment(manifest, proxyId) {
+        let uuid;
+        if (proxyId) {
+            uuid = proxyId;
+        }
+        else {
+            const result = await this.createInstance(manifest.id);
+            uuid = result.instance.id;
+        }
+        const headers = {
+            ...(await this.auth.getAuthHeader()),
+        };
+        try {
+            const env = await this.http.request(ENVIRONMENT_URL, {
+                method: 'GET',
+                headers,
+            });
+            return {
+                ...env,
+                url: `https://${uuid}.${env.domoappsDomain}`,
+            };
+        }
+        catch {
+            // Fallback for rigs where domoappsDomain isn't accessible
+            return {
+                url: `https://${uuid}.domoapps.${getEnv(this.instance)}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=apps.js.map

package/dist/api/apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.js","sourceRoot":"","sources":["../../src/api/apps.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,OAAO,OAAO;IAEC;IACA;IACA;IAHnB,YACmB,IAAiB,EACjB,IAAmB,EACnB,QAAgB;QAFhB,SAAI,GAAJ,IAAI,CAAa;QACjB,SAAI,GAAJ,IAAI,CAAe;QACnB,aAAQ,GAAR,QAAQ,CAAQ;IAChC,CAAC;IAEJ,KAAK,CAAC,cAAc,CAClB,QAAgB,EAChB,OAAgB;QAEhB,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;YAC1B,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;SACrC,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,GAAG,aAAa,iBAAiB,EACjC;YACE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,QAAQ;gBACR,EAAE,EAAE,OAAO,IAAI,IAAI;aACpB,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,QAAkB,EAClB,OAAgB;QAEhB,IAAI,IAAY,CAAC;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,GAAG,OAAO,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAG,CAAC,CAAC;YACvD,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;SACrC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAc,eAAe,EAAE;gBAChE,MAAM,EAAE,KAAK;gBACb,OAAO;aACR,CAAC,CAAC;YACH,OAAO;gBACL,GAAG,GAAG;gBACN,GAAG,EAAE,WAAW,IAAI,IAAI,GAAG,CAAC,cAAc,EAAE;aAC7C,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;YAC1D,OAAO;gBACL,GAAG,EAAE,WAAW,IAAI,aAAa,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;aAC1C,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/api/assets.d.ts

@@ -0,0 +1,12 @@
+import type { FetchClient } from '../http/fetch-client.js';
+import type { Authenticator } from '../auth/authenticator.js';
+import type { Asset, Manifest } from '../types/index.js';
+export declare class AssetsApi {
+    private readonly http;
+    private readonly auth;
+    constructor(http: FetchClient, auth: Authenticator);
+    upload(designId: string, version: string, path: string, contents?: string | Buffer): Promise<Asset>;
+    uploadAll(manifest: Manifest): Promise<Asset[]>;
+    download(designId: string, version: string): Promise<Response>;
+}
+//# sourceMappingURL=assets.d.ts.map

package/dist/api/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/api/assets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAMzD,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,aAAa;IAGhC,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,OAAO,CAAC,KAAK,CAAC;IAoBX,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAmC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAUrE"}

package/dist/api/assets.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs';
+import { globSync } from 'tinyglobby';
+import { RyuuValidationError } from '../http/errors.js';
+import { DESIGNS_BASE_URL } from '../util/endpoints.js';
+import { getContentType } from '../util/content-types.js';
+const CHUNK_SIZE = 25;
+export class AssetsApi {
+    http;
+    auth;
+    constructor(http, auth) {
+        this.http = http;
+        this.auth = auth;
+    }
+    async upload(designId, version, path, contents) {
+        if (path.includes(' ')) {
+            throw new RyuuValidationError(`Spaces in file names not allowed. Please rename ${path}`);
+        }
+        const body = contents ?? fs.readFileSync(path);
+        const contentType = getContentType(path);
+        const headers = {
+            'Content-Type': contentType,
+            ...(await this.auth.getAuthHeader()),
+        };
+        return this.http.request(`${DESIGNS_BASE_URL}/${designId}/versions/${version}/assets?path=${path}`, { method: 'POST', headers, body: body });
+    }
+    async uploadAll(manifest) {
+        const designId = manifest.id;
+        const version = manifest.version;
+        // Upload manifest first
+        await this.upload(designId, version, 'manifest.json', JSON.stringify(manifest));
+        // Glob all files, respecting ignore patterns
+        const defaultIgnore = ['**/*/node_modules/**/*', 'node_modules/**/*'];
+        const combinedIgnore = manifest.ignore
+            ? defaultIgnore.concat(manifest.ignore)
+            : defaultIgnore;
+        const files = globSync('**/*', { ignore: combinedIgnore }).filter(file => !fs.statSync(file).isDirectory() && file !== 'manifest.json');
+        // Upload in chunks of 25
+        const results = [];
+        for (let i = 0; i < files.length; i += CHUNK_SIZE) {
+            const chunk = files.slice(i, i + CHUNK_SIZE);
+            const chunkResults = await Promise.all(chunk.map(file => this.upload(designId, version, file)));
+            results.push(...chunkResults);
+        }
+        return results;
+    }
+    async download(designId, version) {
+        const headers = {
+            ...(await this.auth.getAuthHeader()),
+        };
+        return this.http.request(`${DESIGNS_BASE_URL}/${designId}/versions/${version}/assets`, { method: 'GET', headers, rawResponse: true });
+    }
+}
+//# sourceMappingURL=assets.js.map

package/dist/api/assets.js.map

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

package/dist/api/designs.d.ts

@@ -0,0 +1,17 @@
+import type { FetchClient } from '../http/fetch-client.js';
+import type { Authenticator } from '../auth/authenticator.js';
+import type { Design, Manifest } from '../types/index.js';
+export declare class DesignsApi {
+    private readonly http;
+    private readonly auth;
+    constructor(http: FetchClient, auth: Authenticator);
+    create(manifest: Manifest): Promise<Design>;
+    get(id: string, params?: Record<string, string>): Promise<Design>;
+    list(params?: Record<string, string>): Promise<Design[]>;
+    delete(id: string, force?: boolean): Promise<unknown>;
+    undelete(id: string): Promise<unknown>;
+    getVersions(id: string): Promise<string[]>;
+    release(id: string, version: string): Promise<unknown>;
+    private request;
+}
+//# sourceMappingURL=designs.d.ts.map

package/dist/api/designs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designs.d.ts","sourceRoot":"","sources":["../../src/api/designs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG1D,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,aAAa;IAGhC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ3C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO1C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAO9C,OAAO;CAgBtB"}

package/dist/api/designs.js

@@ -0,0 +1,45 @@
+import { DESIGNS_BASE_URL } from '../util/endpoints.js';
+export class DesignsApi {
+    http;
+    auth;
+    constructor(http, auth) {
+        this.http = http;
+        this.auth = auth;
+    }
+    async create(manifest) {
+        return this.request(`${DESIGNS_BASE_URL}?path=manifest.json`, 'POST', manifest);
+    }
+    async get(id, params) {
+        const query = params ? '?' + new URLSearchParams(params).toString() : '';
+        return this.request(`${DESIGNS_BASE_URL}/${id}${query}`, 'GET');
+    }
+    async list(params) {
+        const query = params ? '?' + new URLSearchParams(params).toString() : '';
+        return this.request(`${DESIGNS_BASE_URL}/${query}`, 'GET');
+    }
+    async delete(id, force = false) {
+        return this.request(`${DESIGNS_BASE_URL}/${id}?force=${force}`, 'DELETE');
+    }
+    async undelete(id) {
+        return this.request(`${DESIGNS_BASE_URL}/${id}/undelete`, 'PUT');
+    }
+    async getVersions(id) {
+        return this.request(`${DESIGNS_BASE_URL}/${id}/versions`, 'GET');
+    }
+    async release(id, version) {
+        return this.request(`${DESIGNS_BASE_URL}/${id}/versions/${version}/release`, 'PUT');
+    }
+    async request(path, method, body) {
+        const headers = {
+            Accept: 'application/json',
+            ...(await this.auth.getAuthHeader()),
+        };
+        const init = { method, headers };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            init.body = JSON.stringify(body);
+        }
+        return this.http.request(path, init);
+    }
+}
+//# sourceMappingURL=designs.js.map

package/dist/api/designs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"designs.js","sourceRoot":"","sources":["../../src/api/designs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,OAAO,UAAU;IAEF;IACA;IAFnB,YACmB,IAAiB,EACjB,IAAmB;QADnB,SAAI,GAAJ,IAAI,CAAa;QACjB,SAAI,GAAJ,IAAI,CAAe;IACnC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,QAAkB;QAC7B,OAAO,IAAI,CAAC,OAAO,CACjB,GAAG,gBAAgB,qBAAqB,EACxC,MAAM,EACN,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,MAA+B;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC,OAAO,CAAS,GAAG,gBAAgB,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA+B;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC,OAAO,CAAW,GAAG,gBAAgB,IAAI,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,KAAK,GAAG,KAAK;QACpC,OAAO,IAAI,CAAC,OAAO,CACjB,GAAG,gBAAgB,IAAI,EAAE,UAAU,KAAK,EAAE,EAC1C,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,gBAAgB,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,OAAO,CACjB,GAAG,gBAAgB,IAAI,EAAE,WAAW,EACpC,KAAK,CACN,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,OAAe;QACvC,OAAO,IAAI,CAAC,OAAO,CACjB,GAAG,gBAAgB,IAAI,EAAE,aAAa,OAAO,UAAU,EACvD,KAAK,CACN,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,IAAY,EACZ,MAAc,EACd,IAAc;QAEd,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;YAC1B,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;SACrC,CAAC;QACF,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAI,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/api/index.d.ts

@@ -0,0 +1,5 @@
+export { DesignsApi } from './designs.js';
+export { AssetsApi } from './assets.js';
+export { AppsApi } from './apps.js';
+export { UsersApi } from './users.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,5 @@
+export { DesignsApi } from './designs.js';
+export { AssetsApi } from './assets.js';
+export { AppsApi } from './apps.js';
+export { UsersApi } from './users.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/api/users.d.ts

@@ -0,0 +1,10 @@
+import type { FetchClient } from '../http/fetch-client.js';
+import type { Authenticator } from '../auth/authenticator.js';
+import type { LoginData } from '../types/auth.js';
+export declare class UsersApi {
+    private readonly http;
+    private readonly auth;
+    constructor(http: FetchClient, auth: Authenticator);
+    getUserInfo(): Promise<LoginData>;
+}
+//# sourceMappingURL=users.d.ts.map

package/dist/api/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/api/users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,aAAa;IAGhC,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;CAUxC"}

package/dist/api/users.js

@@ -0,0 +1,19 @@
+import { USERS_ME_URL } from '../util/endpoints.js';
+export class UsersApi {
+    http;
+    auth;
+    constructor(http, auth) {
+        this.http = http;
+        this.auth = auth;
+    }
+    async getUserInfo() {
+        const headers = {
+            ...(await this.auth.getAuthHeader()),
+        };
+        return this.http.request(USERS_ME_URL, {
+            method: 'GET',
+            headers,
+        });
+    }
+}
+//# sourceMappingURL=users.js.map

package/dist/api/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/api/users.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,OAAO,QAAQ;IAEA;IACA;IAFnB,YACmB,IAAiB,EACjB,IAAmB;QADnB,SAAI,GAAJ,IAAI,CAAa;QACjB,SAAI,GAAJ,IAAI,CAAe;IACnC,CAAC;IAEJ,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAA2B;YACtC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;SACrC,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAY,YAAY,EAAE;YAChD,MAAM,EAAE,KAAK;YACb,OAAO;SACR,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/auth/authenticator.d.ts

@@ -0,0 +1,17 @@
+import type { FetchClient } from '../http/fetch-client.js';
+import type { AuthHeader, LoginData } from '../types/auth.js';
+export declare class Authenticator {
+    private readonly http;
+    private readonly clientId;
+    private refreshToken;
+    private readonly devToken;
+    private readonly cache;
+    constructor(http: FetchClient, clientId: string, refreshToken: string, devToken: boolean);
+    getRefreshToken(): string;
+    setRefreshToken(token: string): void;
+    getAuthHeader(): Promise<AuthHeader>;
+    login(): Promise<LoginData>;
+    private getLoginUser;
+    private getNewAuthorization;
+}
+//# sourceMappingURL=authenticator.d.ts.map

package/dist/auth/authenticator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticator.d.ts","sourceRoot":"","sources":["../../src/auth/authenticator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAe9D,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAGxC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO;IAQnB,eAAe,IAAI,MAAM;IAIzB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IA4BpC,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;YAanB,YAAY;YAUZ,mBAAmB;CAwBlC"}