@apso/cli 0.7.4 → 0.8.2

package/dist/lib/api/types.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Platform API Types
+ *
+ * TypeScript interfaces for platform API responses and requests.
+ */
+/**
+ * API error response structure
+ */
+export interface ApiError {
+    statusCode: number;
+    message: string;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Paginated response wrapper
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    meta: {
+        total: number;
+        page: number;
+        pageSize: number;
+        totalPages: number;
+    };
+}
+/**
+ * Workspace from platform API
+ */
+export interface Workspace {
+    id: string;
+    slug: string;
+    name: string;
+    type: "personal" | "company";
+    description?: string;
+    avatarUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+    membersCount?: number;
+    servicesCount?: number;
+    githubConnected?: boolean;
+}
+/**
+ * Service from platform API
+ */
+export interface Service {
+    id: string;
+    workspaceId: string;
+    slug: string;
+    name: string;
+    description?: string;
+    status: "active" | "building" | "error" | "archived";
+    createdAt: string;
+    updatedAt: string;
+    lastDeployedAt?: string;
+    githubRepo?: string;
+    githubBranch?: string;
+    endpoint?: string;
+}
+/**
+ * Service schema from platform API
+ * This represents the platform's ServiceSchema format
+ */
+export interface ServiceSchema {
+    id: string;
+    serviceId: string;
+    version: number;
+    entities: SchemaEntity[];
+    createdAt: string;
+    updatedAt: string;
+    hash?: string;
+}
+/**
+ * Entity in a service schema
+ */
+export interface SchemaEntity {
+    name: string;
+    tableName?: string;
+    fields: SchemaField[];
+    relationships?: SchemaRelationship[];
+    auth?: EntityAuth;
+    scopeBy?: string[];
+}
+/**
+ * Field in a schema entity
+ */
+export interface SchemaField {
+    name: string;
+    type: string;
+    nullable?: boolean;
+    unique?: boolean;
+    default?: unknown;
+    primaryKey?: boolean;
+    index?: boolean;
+    constraints?: Record<string, unknown>;
+}
+/**
+ * Relationship in a schema entity
+ */
+export interface SchemaRelationship {
+    name: string;
+    type: "one-to-one" | "one-to-many" | "many-to-one" | "many-to-many";
+    target: string;
+    inverseSide?: string;
+    cascade?: boolean;
+    nullable?: boolean;
+}
+/**
+ * Authentication configuration for an entity
+ */
+export interface EntityAuth {
+    protected?: boolean;
+    roles?: string[];
+    owner?: string;
+}
+/**
+ * GitHub repository from platform API
+ */
+export interface GitHubRepo {
+    id: number;
+    fullName: string;
+    name: string;
+    owner: string;
+    private: boolean;
+    defaultBranch: string;
+    url: string;
+}
+/**
+ * GitHub connection status
+ */
+export interface GitHubConnection {
+    connected: boolean;
+    installationId?: number;
+    login?: string;
+    avatarUrl?: string;
+}
+/**
+ * Build status from platform API
+ */
+export interface BuildStatus {
+    id: string;
+    serviceId: string;
+    status: "pending" | "building" | "success" | "failed";
+    startedAt: string;
+    completedAt?: string;
+    logs?: string;
+    error?: string;
+}
+/**
+ * User profile from platform API
+ */
+export interface UserProfile {
+    id: string;
+    email: string;
+    name?: string;
+    avatarUrl?: string;
+    createdAt: string;
+    defaultWorkspaceId?: string;
+    workspaces: Workspace[];
+}
+/**
+ * OAuth token exchange response
+ */
+export interface TokenExchangeResponse {
+    accessToken: string;
+    refreshToken: string;
+    expiresIn: number;
+    tokenType: string;
+    user: {
+        id: string;
+        email: string;
+        name?: string;
+        avatarUrl?: string;
+    };
+}
+/**
+ * Token refresh response
+ */
+export interface TokenRefreshResponse {
+    accessToken: string;
+    expiresIn: number;
+    tokenType: string;
+}
+/**
+ * Request options for API calls
+ */
+export interface ApiRequestOptions {
+    /**
+     * HTTP method
+     */
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    /**
+     * Request body (will be JSON stringified)
+     */
+    body?: unknown;
+    /**
+     * Query parameters
+     */
+    params?: Record<string, string | number | boolean | undefined>;
+    /**
+     * Additional headers
+     */
+    headers?: Record<string, string>;
+    /**
+     * Request timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Skip authentication (for public endpoints)
+     */
+    skipAuth?: boolean;
+}

package/dist/lib/api/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Platform API Types
+ *
+ * TypeScript interfaces for platform API responses and requests.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/apsorc-parser.d.ts

@@ -1,6 +1,7 @@
 import { Entity } from "./types/entity";
 import { ApsorcRelationship, RelationshipMap } from "./types/relationship";
 import { AuthConfig } from "./types/auth";
+import { TargetLanguage } from "./types/generator";
 export declare enum ApiType {
     Graphql = "graphql",
     Rest = "rest"
@@ -12,6 +13,7 @@ export type ApsorcType = {
     apiType: ApiType;
     relationships: ApsorcRelationship[];
     auth?: AuthConfig;
+    language?: TargetLanguage;
 };
 type ParsedApsorcData = {
     entities: Entity[];
@@ -23,6 +25,7 @@ type ParsedApsorc = {
     entities: Entity[];
     relationshipMap: RelationshipMap;
     auth?: AuthConfig;
+    language?: TargetLanguage;
 };
 export declare const parseApsorcV1: (apsorc: ApsorcType) => ParsedApsorcData;
 export declare const parseApsorcV2: (apsorc: ApsorcType) => ParsedApsorcData;

package/dist/lib/apsorc-parser.js

@@ -35,6 +35,7 @@ const parseRc = () => {
     const entities = apsoConfig.entities || [];
     const relationships = apsoConfig.relationships || [];
     const auth = apsoConfig.auth;
+    const language = apsoConfig.language;
     return {
         rootFolder,
         apiType,
@@ -42,6 +43,7 @@ const parseRc = () => {
         entities,
         relationships,
         auth,
+        language,
     };
 };
 const parseApsorc = () => {
@@ -60,6 +62,7 @@ const parseApsorc = () => {
                     rootFolder: apsoConfig.rootFolder,
                     apiType: apsoConfig.apiType,
                     auth: apsoConfig.auth,
+                    language: apsoConfig.language,
                     ...(0, exports.parseApsorcV1)(apsoConfig),
                 };
                 if (debug) {
@@ -75,6 +78,7 @@ const parseApsorc = () => {
                     rootFolder: apsoConfig.rootFolder,
                     apiType: apsoConfig.apiType,
                     auth: apsoConfig.auth,
+                    language: apsoConfig.language,
                     ...(() => {
                         const relStart = perf_hooks_1.performance.now();
                         const parsed = (0, exports.parseApsorcV2)(apsoConfig);

package/dist/lib/config/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Platform CLI Configuration Module
+ *
+ * Exports configuration types, paths, and managers.
+ */
+export * from "./types";
+export * from "./paths";
+export { globalConfig, credentials, projectLink, syncQueue, createBackup, } from "./manager";

package/dist/lib/config/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Platform CLI Configuration Module
+ *
+ * Exports configuration types, paths, and managers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBackup = exports.syncQueue = exports.projectLink = exports.credentials = exports.globalConfig = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./paths"), exports);
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "globalConfig", { enumerable: true, get: function () { return manager_1.globalConfig; } });
+Object.defineProperty(exports, "credentials", { enumerable: true, get: function () { return manager_1.credentials; } });
+Object.defineProperty(exports, "projectLink", { enumerable: true, get: function () { return manager_1.projectLink; } });
+Object.defineProperty(exports, "syncQueue", { enumerable: true, get: function () { return manager_1.syncQueue; } });
+Object.defineProperty(exports, "createBackup", { enumerable: true, get: function () { return manager_1.createBackup; } });

package/dist/lib/config/manager.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Configuration Manager
+ *
+ * Handles reading/writing configuration and credentials files
+ * with proper security measures.
+ */
+import { CredentialsFile, GlobalConfigFile, ProjectLinkFile, SyncQueueFile, SyncQueueItem } from "./types";
+/**
+ * Global Configuration Manager
+ */
+export declare const globalConfig: {
+    /**
+     * Read global configuration, merging defaults and environment variables
+     */
+    read(): GlobalConfigFile;
+    /**
+     * Write global configuration
+     */
+    write(config: Partial<GlobalConfigFile>): void;
+    /**
+     * Get a specific configuration value
+     */
+    get<K extends keyof GlobalConfigFile>(key: K): GlobalConfigFile[K];
+    /**
+     * Set a specific configuration value
+     */
+    set<K_1 extends keyof GlobalConfigFile>(key: K_1, value: GlobalConfigFile[K_1]): void;
+    /**
+     * Reset configuration to defaults
+     */
+    reset(): void;
+};
+/**
+ * Credentials Manager
+ */
+export declare const credentials: {
+    /**
+     * Read stored credentials
+     */
+    read(): CredentialsFile | null;
+    /**
+     * Write credentials (with secure file permissions)
+     */
+    write(creds: Omit<CredentialsFile, "updatedAt" | "cliVersion">): void;
+    /**
+     * Clear stored credentials
+     */
+    clear(): void;
+    /**
+     * Check if credentials exist and are not expired
+     */
+    isValid(): boolean;
+    /**
+     * Check if credentials exist (may be expired)
+     */
+    exists(): boolean;
+    /**
+     * Check if token needs refresh (expires within 5 minutes)
+     */
+    needsRefresh(): boolean;
+};
+/**
+ * Project Link Manager
+ */
+export declare const projectLink: {
+    /**
+     * Read project link configuration
+     */
+    read(projectDir?: string): ProjectLinkFile | null;
+    /**
+     * Write project link configuration
+     */
+    write(link: ProjectLinkFile, projectDir?: string): void;
+    /**
+     * Remove project link
+     */
+    remove(projectDir?: string): void;
+    /**
+     * Check if project is linked
+     */
+    exists(projectDir?: string): boolean;
+    /**
+     * Update sync metadata after successful sync
+     */
+    updateSyncMetadata(metadata: {
+        lastSyncedAt: string;
+        localSchemaHash: string;
+        remoteSchemaHash: string;
+    }, projectDir?: string): void;
+};
+/**
+ * Sync Queue Manager
+ */
+export declare const syncQueue: {
+    /**
+     * Read sync queue
+     */
+    read(projectDir?: string): SyncQueueFile;
+    /**
+     * Write sync queue
+     */
+    write(queue: SyncQueueFile, projectDir?: string): void;
+    /**
+     * Add operation to queue
+     */
+    add(operation: Omit<SyncQueueItem, "id" | "queuedAt" | "retryCount">, projectDir?: string): string;
+    /**
+     * Remove operation from queue
+     */
+    remove(id: string, projectDir?: string): void;
+    /**
+     * Get pending operations count
+     */
+    count(projectDir?: string): number;
+    /**
+     * Clear all operations
+     */
+    clear(projectDir?: string): void;
+    /**
+     * Update operation retry count and error
+     */
+    updateRetry(id: string, error: string, projectDir?: string): void;
+};
+/**
+ * Create a backup of a file
+ */
+export declare function createBackup(filePath: string, projectDir?: string): string;