@auxx/sdk 0.0.1-experimental.1

package/README.md

@@ -0,0 +1,95 @@
+# @auxx/sdk
+
+> ⚠️ This package is experimental and not yet ready for production use.
+
+CLI tool and SDK for creating Auxx apps. Build custom integrations, workflows, and UI extensions for the Auxx platform.
+
+## Installation
+
+```bash
+# Install globally
+npm install -g @auxx/sdk
+
+# Or use with npx
+npx @auxx/sdk
+```
+
+## Quick Start
+
+```bash
+# Create a new app
+auxx init my-app
+
+# Start development mode
+cd my-app
+auxx dev
+
+# Build for production
+auxx build
+```
+
+## Commands
+
+### `auxx init <app-slug>`
+Initialize a new Auxx app project with the specified slug.
+
+### `auxx dev [--workspace <slug>]`
+Start development mode with hot reload. Optionally specify a workspace for testing.
+
+### `auxx build`
+Build your app for production deployment.
+
+### `auxx login`
+Authenticate with your Auxx developer account.
+
+### `auxx logout`
+Log out and remove stored credentials.
+
+### `auxx whoami`
+Display information about the currently authenticated user.
+
+### `auxx logs`
+Stream real-time logs from your running app.
+
+### `auxx version`
+Manage app version lifecycle (create, promote, etc.).
+
+## Package Exports
+
+The SDK provides multiple entry points for different use cases:
+
+```typescript
+// Client-side SDK (React components, hooks)
+import { useWorkflow, Form, Button } from '@auxx/sdk/client';
+
+// Server-side SDK (workflow execution, API access)
+import { WorkflowContext } from '@auxx/sdk/server';
+
+// Type definitions
+import type { AppManifest } from '@auxx/sdk/global';
+```
+
+## Development
+
+This package is part of the Auxx monorepo and uses pnpm workspaces.
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the SDK
+pnpm --filter @auxx/sdk run build
+
+# Watch mode for development
+pnpm --filter @auxx/sdk run dev
+
+# Run tests
+pnpm --filter @auxx/sdk run test
+
+# Lint code
+pnpm --filter @auxx/sdk run lint
+```
+
+## License
+
+MIT

package/client.d.ts

@@ -0,0 +1,2 @@
+// packages/sdk/client.d.ts
+export * from './lib/client'

package/global.d.ts

@@ -0,0 +1,69 @@
+// packages/sdk/global.d.ts
+
+/**
+ * Global runtime SDK types injected by the Auxx platform
+ */
+
+declare global {
+  interface Window {
+    /**
+     * Client SDK implementation provided by the Auxx platform
+     */
+    AUXX_CLIENT_EXTENSION_SDK: {
+      // Dialogs
+      showDialog: (options: any) => Promise<void>
+      closeDialog: () => Promise<void>
+
+      // Alerts
+      alert: (options: any) => Promise<void>
+      confirm: (options: any) => Promise<boolean>
+
+      // Toasts
+      showToast: (options: any) => void
+
+      // Navigation
+      navigateTo: (path: string) => void
+      openRecord: (recordId: string) => void
+      openUrl: (url: string, newTab?: boolean) => void
+    }
+
+    /**
+     * Root SDK (if needed for runtime type checking)
+     */
+    AUXX_ROOT_SDK: Record<string, any>
+
+    /**
+     * React library made available globally
+     */
+    React: typeof import('react')
+  }
+
+  namespace NodeJS {
+    interface Global {
+      /**
+       * Server SDK implementation provided by the Auxx platform
+       */
+      AUXX_SERVER_SDK: {
+        // Database
+        query: (options: any) => Promise<any[]>
+        queryOne: (options: any) => Promise<any | null>
+
+        // External API
+        fetch: (options: any) => Promise<any>
+
+        // Auth
+        getCurrentUser: () => Promise<any>
+        getApiToken: () => Promise<string>
+
+        // Storage
+        storage: {
+          get: (key: string) => Promise<string | null>
+          set: (key: string, value: string) => Promise<void>
+          delete: (key: string) => Promise<void>
+        }
+      }
+    }
+  }
+}
+
+export {}

package/lib/api/api.d.ts

@@ -0,0 +1,250 @@
+import { type FetcherError } from '../errors.js';
+import type { Result } from '../types/result.js';
+import type { DotenvParseOutput } from 'dotenv';
+export type ApiError = {
+    code: 'WHOAMI_ERROR';
+    error: FetcherError;
+} | {
+    code: 'FETCH_APPS_ERROR';
+    error: FetcherError;
+} | {
+    code: 'FETCH_APP_INFO_ERROR';
+    error: FetcherError;
+} | {
+    code: 'CREATE_VERSION_ERROR';
+    error: FetcherError;
+} | {
+    code: 'CREATE_DEV_VERSION_ERROR';
+    error: FetcherError;
+} | {
+    code: 'COMPLETE_BUNDLE_UPLOAD_ERROR';
+    error: FetcherError;
+} | {
+    code: 'COMPLETE_PROD_BUNDLE_UPLOAD_ERROR';
+    error: FetcherError;
+} | {
+    code: 'FETCH_VERSIONS_ERROR';
+    error: FetcherError;
+} | {
+    code: 'FETCH_INSTALLATION_ERROR';
+    error: FetcherError;
+} | {
+    code: 'GET_TOKEN_ERROR';
+    error: FetcherError;
+} | {
+    code: 'REFRESH_TOKEN_ERROR';
+    error: FetcherError;
+} | {
+    code: 'FETCH_ORGANIZATIONS_ERROR';
+    error: FetcherError;
+} | {
+    code: 'FETCH_APP_LOGS_ERROR';
+    error: FetcherError;
+};
+declare class ApiImpl {
+    private fetcher;
+    constructor();
+    whoami(): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<{
+        userId: string;
+        userEmail: string;
+        userName: string | null;
+        userFirstName?: string | null | undefined;
+        userLastName?: string | null | undefined;
+        userImage?: string | null | undefined;
+    }>>;
+    fetchApps(): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<{
+        id: string;
+        slug: string;
+        title: string;
+        developerAccountId: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        description?: string | null | undefined;
+        avatarId?: string | null | undefined;
+        avatarUrl?: string | null | undefined;
+        category?: string | null | undefined;
+    }[]>>;
+    fetchAppInfo(appSlug: string): Promise<import("../errors.js").Complete<{
+        id: string;
+        slug: string;
+        title: string;
+        developerAccountId: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        description?: string | null | undefined;
+        avatarId?: string | null | undefined;
+        avatarUrl?: string | null | undefined;
+        category?: string | null | undefined;
+    }> | import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }>>;
+    exchangeToken({ code, codeVerifier, redirectUri, clientId, }: {
+        code: string;
+        codeVerifier: string;
+        redirectUri: string;
+        clientId: string;
+    }): Promise<Result<any, ApiError>>;
+    refreshToken({ refreshToken, clientId }: {
+        refreshToken: string;
+        clientId: string;
+    }): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<{
+        access_token: string;
+        refresh_token: string;
+        token_type: string;
+        expires_in: number;
+    }>>;
+    getUserInfo(): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<{
+        sub: string;
+        email: string;
+        name?: string | null | undefined;
+        given_name?: string | null | undefined;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        email_verified?: boolean | undefined;
+    }>>;
+    fetchOrganizations(): Promise<import("../errors.js").Complete<{
+        name: string;
+        id: string;
+        handle: string;
+        logoUrl: string | null;
+    }[]> | import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }>>;
+    createVersion({ appId, major, cliVersion, }: {
+        appId: string;
+        major: number;
+        cliVersion: string;
+    }): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: Error;
+    }> | import("../errors.js").Complete<{
+        major: number;
+        minor: number;
+        versionId: string;
+        appId: string;
+        bundle: {
+            id: string;
+            clientBundleUploadUrl: string;
+            serverBundleUploadUrl: string;
+            bundleSha?: string | undefined;
+        };
+    }>>;
+    completeBundleUpload({ appId, versionId, bundleId, bundleSha, settingsSchema, }: {
+        appId: string;
+        versionId: string;
+        bundleId: string;
+        bundleSha: string;
+        settingsSchema?: {
+            organization?: Record<string, unknown>;
+            user?: Record<string, unknown>;
+        };
+    }): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<undefined>>;
+    completeProdBundleUpload({ appId, versionId, bundleId, bundleSha, settingsSchema, }: {
+        appId: string;
+        versionId: string;
+        bundleId: string;
+        bundleSha: string;
+        settingsSchema?: {
+            organization?: Record<string, unknown>;
+            user?: Record<string, unknown>;
+        };
+    }): Promise<import("../errors.js").Complete<undefined> | import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }>>;
+    createDevVersion({ appId, cliVersion, targetOrganizationId, environmentVariables, }: {
+        appId: string;
+        cliVersion: string;
+        targetOrganizationId: string;
+        environmentVariables: DotenvParseOutput;
+    }): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<{
+        major: number;
+        minor: number;
+        versionId: string;
+        appId: string;
+        bundle: {
+            id: string;
+            clientBundleUploadUrl: string;
+            serverBundleUploadUrl: string;
+            bundleSha?: string | undefined;
+        };
+    }>>;
+    fetchInstallation({ appId, organizationId }: {
+        appId: string;
+        organizationId: string;
+    }): Promise<import("../errors.js").Complete<null> | import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<{
+        success: true;
+        value: {
+            appId: string;
+            organizationId: string;
+        };
+    }>>;
+    fetchVersions(appId: string): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<{
+        created_at: string;
+        major: number;
+        minor: number;
+        is_published: boolean;
+        num_installations: number;
+        publication_status: "private" | "in-review" | "published" | "rejected" | "unpublished";
+        released_at?: string | null | undefined;
+    }[]>>;
+    fetchAppLogs({ organizationHandle, appSlug, cursor, limit, }: {
+        organizationHandle: string;
+        appSlug: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<import("../errors.js").Errored<{
+        code: string;
+        error: FetcherError;
+    }> | import("../errors.js").Complete<{
+        logs: {
+            message: string;
+            id: string;
+            severity: "INFO" | "WARNING" | "ERROR" | "DEBUG";
+            timestamp: string;
+            metadata: {
+                userId: string | null;
+                eventId: string;
+                eventType: string;
+                appVersionId: string | null;
+                requestMethod: string | null;
+                requestPath: string | null;
+                responseStatus: number | null;
+                durationMs: number | null;
+                consoleLogIndex: number;
+            };
+        }[];
+        hasMore: boolean;
+        newestTimestamp: string | null;
+        nextCursor?: string | undefined;
+    }>>;
+}
+export declare const api: ApiImpl;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/lib/api/api.d.ts.map

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

package/lib/api/api.js

@@ -0,0 +1,202 @@
+import { complete, errored } from '../errors.js';
+import { Fetcher } from './fetcher.js';
+import { AUTH_API } from '../env.js';
+import { appInfoSchema, completeBundleUploadSchema, createDevVersionSchema, createVersionSchema, fetchAppLogsResponseSchema, installationSchema, listAppsResponseSchema, listDevOrganizationsResponseSchema, oidcUserInfoSchema, TEST_APP_INFO, TEST_ORGANIZATIONS, tokenResponseSchema, versionsSchema, whoamiSchema, } from './schemas.js';
+class ApiImpl {
+    fetcher;
+    constructor() {
+        this.fetcher = new Fetcher();
+    }
+    async whoami() {
+        const result = await this.fetcher.get({
+            path: `${AUTH_API}/session`,
+            schema: whoamiSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'WHOAMI_ERROR', error: result.error });
+        }
+        return complete(result.value.session);
+    }
+    async fetchApps() {
+        const result = await this.fetcher.get({
+            path: '/api/v1/apps',
+            schema: listAppsResponseSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'FETCH_APPS_ERROR', error: result.error });
+        }
+        return complete(result.value.data.apps);
+    }
+    async fetchAppInfo(appSlug) {
+        if (process.env.NODE_ENV === 'test') {
+            return complete(TEST_APP_INFO.data.app);
+        }
+        const result = await this.fetcher.get({
+            path: `/api/v1/apps/by-slug/${appSlug}`,
+            schema: appInfoSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'FETCH_APP_INFO_ERROR', error: result.error });
+        }
+        return complete(result.value.data.app);
+    }
+    async exchangeToken({ code, codeVerifier, redirectUri, clientId, }) {
+        const params = new URLSearchParams();
+        params.append('grant_type', 'authorization_code');
+        params.append('code', code);
+        params.append('client_id', clientId);
+        params.append('redirect_uri', redirectUri);
+        params.append('code_verifier', codeVerifier);
+        const result = await this.fetcher.post({
+            path: `${AUTH_API}/oauth2/token`,
+            body: params,
+            schema: tokenResponseSchema,
+            authenticated: 'Not Authenticated',
+        });
+        if (!result.success) {
+            return {
+                success: false,
+                error: { code: 'GET_TOKEN_ERROR', error: result.error },
+            };
+        }
+        return result;
+    }
+    async refreshToken({ refreshToken, clientId }) {
+        const params = new URLSearchParams();
+        params.append('grant_type', 'refresh_token');
+        params.append('refresh_token', refreshToken);
+        params.append('client_id', clientId);
+        const result = await this.fetcher.post({
+            path: `${AUTH_API}/oauth2/token`,
+            body: params,
+            schema: tokenResponseSchema,
+            authenticated: 'Not Authenticated',
+        });
+        if (!result.success) {
+            return errored({ code: 'REFRESH_TOKEN_ERROR', error: result.error });
+        }
+        return complete(result.value);
+    }
+    async getUserInfo() {
+        const result = await this.fetcher.get({
+            path: `${AUTH_API}/oauth2/userinfo`,
+            schema: oidcUserInfoSchema,
+            authenticated: 'Authenticated',
+        });
+        if (!result.success) {
+            return errored({ code: 'WHOAMI_ERROR', error: result.error });
+        }
+        return complete(result.value);
+    }
+    async fetchOrganizations() {
+        if (process.env.NODE_ENV === 'test') {
+            return complete(TEST_ORGANIZATIONS);
+        }
+        const result = await this.fetcher.get({
+            path: '/api/v1/developers/dev-organizations',
+            schema: listDevOrganizationsResponseSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'FETCH_ORGANIZATIONS_ERROR', error: result.error });
+        }
+        return complete(result.value.organizations);
+    }
+    async createVersion({ appId, major, cliVersion, }) {
+        const result = await this.fetcher.post({
+            path: `/api/v1/apps/${appId}/prod-versions`,
+            body: {
+                major,
+                cli_version: cliVersion,
+            },
+            schema: createVersionSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'CREATE_VERSION_ERROR', error: result.error });
+        }
+        return complete(result.value);
+    }
+    async completeBundleUpload({ appId, versionId, bundleId, bundleSha, settingsSchema, }) {
+        const result = await this.fetcher.post({
+            path: `/api/v1/apps/${appId}/dev-versions/${versionId}/bundles/${bundleId}/complete`,
+            body: {
+                bundle_sha: bundleSha,
+                settings_schema: settingsSchema,
+            },
+            schema: completeBundleUploadSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'COMPLETE_BUNDLE_UPLOAD_ERROR', error: result.error });
+        }
+        return complete(undefined);
+    }
+    async completeProdBundleUpload({ appId, versionId, bundleId, bundleSha, settingsSchema, }) {
+        const result = await this.fetcher.post({
+            path: `/api/v1/apps/${appId}/prod-versions/${versionId}/bundles/${bundleId}/complete`,
+            body: {
+                bundle_sha: bundleSha,
+                settings_schema: settingsSchema,
+            },
+            schema: completeBundleUploadSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'COMPLETE_PROD_BUNDLE_UPLOAD_ERROR', error: result.error });
+        }
+        return complete(undefined);
+    }
+    async createDevVersion({ appId, cliVersion, targetOrganizationId, environmentVariables, }) {
+        const result = await this.fetcher.post({
+            path: `/api/v1/apps/${appId}/dev-versions`,
+            body: {
+                target_organization_id: targetOrganizationId,
+                environment_variables: environmentVariables,
+                cli_version: cliVersion,
+            },
+            schema: createDevVersionSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'CREATE_DEV_VERSION_ERROR', error: result.error });
+        }
+        return complete(result.value);
+    }
+    async fetchInstallation({ appId, organizationId }) {
+        const result = await this.fetcher.get({
+            path: `/api/v1/apps/${appId}/organization/${organizationId}/dev-installation`,
+            schema: installationSchema,
+        });
+        if (!result.success) {
+            if (result.error.code === 'HTTP_ERROR' && result.error.status === 404) {
+                return complete(null);
+            }
+            return errored({ code: 'FETCH_INSTALLATION_ERROR', error: result.error });
+        }
+        return complete(result);
+    }
+    async fetchVersions(appId) {
+        const result = await this.fetcher.get({
+            path: `/api/v1/apps/${appId}/prod-versions`,
+            schema: versionsSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'FETCH_VERSIONS_ERROR', error: result.error });
+        }
+        return complete(result.value.app_prod_versions);
+    }
+    async fetchAppLogs({ organizationHandle, appSlug, cursor, limit = 100, }) {
+        const params = new URLSearchParams();
+        if (cursor)
+            params.append('cursor', cursor);
+        if (limit)
+            params.append('limit', limit.toString());
+        const queryString = params.toString();
+        const path = `/api/v1/organizations/${organizationHandle}/apps/${appSlug}/logs${queryString ? `?${queryString}` : ''}`;
+        const result = await this.fetcher.get({
+            path,
+            schema: fetchAppLogsResponseSchema,
+        });
+        if (!result.success) {
+            return errored({ code: 'FETCH_APP_LOGS_ERROR', error: result.error });
+        }
+        return complete(result.value.data);
+    }
+}
+export const api = new ApiImpl();

package/lib/api/api.js.map

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

package/lib/api/fetcher.d.ts

@@ -0,0 +1,21 @@
+import type { z } from 'zod';
+import type { FetcherError } from '../errors.js';
+import type { Result } from '../types/result.js';
+interface FetchOptions<T> {
+    path: string;
+    schema: z.ZodSchema<T>;
+    authenticated?: 'Authenticated' | 'Not Authenticated';
+    headers?: Record<string, string>;
+}
+interface GetOptions<T> extends FetchOptions<T> {
+}
+interface PostOptions<T> extends FetchOptions<T> {
+    body: any;
+}
+export declare class Fetcher {
+    get<T>(options: GetOptions<T>): Promise<Result<T, FetcherError>>;
+    post<T>(options: PostOptions<T>): Promise<Result<T, FetcherError>>;
+    private fetch;
+}
+export {};
+//# sourceMappingURL=fetcher.d.ts.map

package/lib/api/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/api/fetcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAG5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGhD,UAAU,YAAY,CAAC,CAAC;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;IACtB,aAAa,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAAA;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,UAAU,UAAU,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;CAAG;AAElD,UAAU,WAAW,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IAC9C,IAAI,EAAE,GAAG,CAAA;CACV;AAKD,qBAAa,OAAO;IAIZ,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAWhE,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAc1D,KAAK;CA4IpB"}