phibelle-kit 1.0.4 → 1.0.7

package/src/convex/_generated/api.js

@@ -1,23 +0,0 @@
-/* eslint-disable */
-/**
- * Generated `api` utility.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import { anyApi, componentsGeneric } from "convex/server";
-
-/**
- * A utility for referencing Convex functions in your app's API.
- *
- * Usage:
- * ```js
- * const myFunctionReference = api.myModule.myFunction;
- * ```
- */
-export const api = anyApi;
-export const internal = anyApi;
-export const components = componentsGeneric();

package/src/convex/_generated/dataModel.d.ts

@@ -1,60 +0,0 @@
-/* eslint-disable */
-/**
- * Generated data model types.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import type {
-  DataModelFromSchemaDefinition,
-  DocumentByName,
-  TableNamesInDataModel,
-  SystemTableNames,
-} from "convex/server";
-import type { GenericId } from "convex/values";
-import schema from "../schema.js";
-
-/**
- * The names of all of your Convex tables.
- */
-export type TableNames = TableNamesInDataModel<DataModel>;
-
-/**
- * The type of a document stored in Convex.
- *
- * @typeParam TableName - A string literal type of the table name (like "users").
- */
-export type Doc<TableName extends TableNames> = DocumentByName<
-  DataModel,
-  TableName
->;
-
-/**
- * An identifier for a document in Convex.
- *
- * Convex documents are uniquely identified by their `Id`, which is accessible
- * on the `_id` field. To learn more, see [Document IDs](https://docs.convex.dev/using/document-ids).
- *
- * Documents can be loaded using `db.get(tableName, id)` in query and mutation functions.
- *
- * IDs are just strings at runtime, but this type can be used to distinguish them from other
- * strings when type checking.
- *
- * @typeParam TableName - A string literal type of the table name (like "users").
- */
-export type Id<TableName extends TableNames | SystemTableNames> =
-  GenericId<TableName>;
-
-/**
- * A type describing your Convex data model.
- *
- * This type includes information about what tables you have, the type of
- * documents stored in those tables, and the indexes defined on them.
- *
- * This type is used to parameterize methods like `queryGeneric` and
- * `mutationGeneric` to make them type-safe.
- */
-export type DataModel = DataModelFromSchemaDefinition<typeof schema>;

package/src/convex/_generated/server.d.ts

@@ -1,143 +0,0 @@
-/* eslint-disable */
-/**
- * Generated utilities for implementing server-side Convex query and mutation functions.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import {
-  ActionBuilder,
-  HttpActionBuilder,
-  MutationBuilder,
-  QueryBuilder,
-  GenericActionCtx,
-  GenericMutationCtx,
-  GenericQueryCtx,
-  GenericDatabaseReader,
-  GenericDatabaseWriter,
-} from "convex/server";
-import type { DataModel } from "./dataModel.js";
-
-/**
- * Define a query in this Convex app's public API.
- *
- * This function will be allowed to read your Convex database and will be accessible from the client.
- *
- * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
- * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
- */
-export declare const query: QueryBuilder<DataModel, "public">;
-
-/**
- * Define a query that is only accessible from other Convex functions (but not from the client).
- *
- * This function will be allowed to read from your Convex database. It will not be accessible from the client.
- *
- * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
- * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
- */
-export declare const internalQuery: QueryBuilder<DataModel, "internal">;
-
-/**
- * Define a mutation in this Convex app's public API.
- *
- * This function will be allowed to modify your Convex database and will be accessible from the client.
- *
- * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
- * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
- */
-export declare const mutation: MutationBuilder<DataModel, "public">;
-
-/**
- * Define a mutation that is only accessible from other Convex functions (but not from the client).
- *
- * This function will be allowed to modify your Convex database. It will not be accessible from the client.
- *
- * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
- * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
- */
-export declare const internalMutation: MutationBuilder<DataModel, "internal">;
-
-/**
- * Define an action in this Convex app's public API.
- *
- * An action is a function which can execute any JavaScript code, including non-deterministic
- * code and code with side-effects, like calling third-party services.
- * They can be run in Convex's JavaScript environment or in Node.js using the "use node" directive.
- * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.
- *
- * @param func - The action. It receives an {@link ActionCtx} as its first argument.
- * @returns The wrapped action. Include this as an `export` to name it and make it accessible.
- */
-export declare const action: ActionBuilder<DataModel, "public">;
-
-/**
- * Define an action that is only accessible from other Convex functions (but not from the client).
- *
- * @param func - The function. It receives an {@link ActionCtx} as its first argument.
- * @returns The wrapped function. Include this as an `export` to name it and make it accessible.
- */
-export declare const internalAction: ActionBuilder<DataModel, "internal">;
-
-/**
- * Define an HTTP action.
- *
- * The wrapped function will be used to respond to HTTP requests received
- * by a Convex deployment if the requests matches the path and method where
- * this action is routed. Be sure to route your httpAction in `convex/http.js`.
- *
- * @param func - The function. It receives an {@link ActionCtx} as its first argument
- * and a Fetch API `Request` object as its second.
- * @returns The wrapped function. Import this function from `convex/http.js` and route it to hook it up.
- */
-export declare const httpAction: HttpActionBuilder;
-
-/**
- * A set of services for use within Convex query functions.
- *
- * The query context is passed as the first argument to any Convex query
- * function run on the server.
- *
- * This differs from the {@link MutationCtx} because all of the services are
- * read-only.
- */
-export type QueryCtx = GenericQueryCtx<DataModel>;
-
-/**
- * A set of services for use within Convex mutation functions.
- *
- * The mutation context is passed as the first argument to any Convex mutation
- * function run on the server.
- */
-export type MutationCtx = GenericMutationCtx<DataModel>;
-
-/**
- * A set of services for use within Convex action functions.
- *
- * The action context is passed as the first argument to any Convex action
- * function run on the server.
- */
-export type ActionCtx = GenericActionCtx<DataModel>;
-
-/**
- * An interface to read from the database within Convex query functions.
- *
- * The two entry points are {@link DatabaseReader.get}, which fetches a single
- * document by its {@link Id}, or {@link DatabaseReader.query}, which starts
- * building a query.
- */
-export type DatabaseReader = GenericDatabaseReader<DataModel>;
-
-/**
- * An interface to read from and write to the database within Convex mutation
- * functions.
- *
- * Convex guarantees that all writes within a single mutation are
- * executed atomically, so you never have to worry about partial writes leaving
- * your data in an inconsistent state. See [the Convex Guide](https://docs.convex.dev/understanding/convex-fundamentals/functions#atomicity-and-optimistic-concurrency-control)
- * for the guarantees Convex provides your functions.
- */
-export type DatabaseWriter = GenericDatabaseWriter<DataModel>;

package/src/convex/_generated/server.js

@@ -1,93 +0,0 @@
-/* eslint-disable */
-/**
- * Generated utilities for implementing server-side Convex query and mutation functions.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import {
-  actionGeneric,
-  httpActionGeneric,
-  queryGeneric,
-  mutationGeneric,
-  internalActionGeneric,
-  internalMutationGeneric,
-  internalQueryGeneric,
-} from "convex/server";
-
-/**
- * Define a query in this Convex app's public API.
- *
- * This function will be allowed to read your Convex database and will be accessible from the client.
- *
- * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
- * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
- */
-export const query = queryGeneric;
-
-/**
- * Define a query that is only accessible from other Convex functions (but not from the client).
- *
- * This function will be allowed to read from your Convex database. It will not be accessible from the client.
- *
- * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
- * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
- */
-export const internalQuery = internalQueryGeneric;
-
-/**
- * Define a mutation in this Convex app's public API.
- *
- * This function will be allowed to modify your Convex database and will be accessible from the client.
- *
- * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
- * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
- */
-export const mutation = mutationGeneric;
-
-/**
- * Define a mutation that is only accessible from other Convex functions (but not from the client).
- *
- * This function will be allowed to modify your Convex database. It will not be accessible from the client.
- *
- * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
- * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
- */
-export const internalMutation = internalMutationGeneric;
-
-/**
- * Define an action in this Convex app's public API.
- *
- * An action is a function which can execute any JavaScript code, including non-deterministic
- * code and code with side-effects, like calling third-party services.
- * They can be run in Convex's JavaScript environment or in Node.js using the "use node" directive.
- * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.
- *
- * @param func - The action. It receives an {@link ActionCtx} as its first argument.
- * @returns The wrapped action. Include this as an `export` to name it and make it accessible.
- */
-export const action = actionGeneric;
-
-/**
- * Define an action that is only accessible from other Convex functions (but not from the client).
- *
- * @param func - The function. It receives an {@link ActionCtx} as its first argument.
- * @returns The wrapped function. Include this as an `export` to name it and make it accessible.
- */
-export const internalAction = internalActionGeneric;
-
-/**
- * Define an HTTP action.
- *
- * The wrapped function will be used to respond to HTTP requests received
- * by a Convex deployment if the requests matches the path and method where
- * this action is routed. Be sure to route your httpAction in `convex/http.js`.
- *
- * @param func - The function. It receives an {@link ActionCtx} as its first argument
- * and a Fetch API `Request` object as its second.
- * @returns The wrapped function. Import this function from `convex/http.js` and route it to hook it up.
- */
-export const httpAction = httpActionGeneric;

package/src/index.ts

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-
-import chalk from "chalk";
-import { watchSceneCommand } from "./commands/watch-scene.js";
-import { cloneSceneCommand } from "./commands/clone-scene.js";
-import { waitForToken } from "./lib/wait-for-token.js";
-
-const USAGE = "  Usage: phibelle-kit clone <sceneId> | phibelle-kit watch <sceneId>";
-
-async function main() {
-  const command = process.argv[2];
-  const sceneId = process.argv[3];
-
-  if (!command || !sceneId) {
-    console.log(chalk.red("  Command and scene ID are required"));
-    console.log(chalk.gray(USAGE));
-    process.exit(1);
-  }
-
-  await waitForToken();
-
-  if (command === "clone") {
-    await cloneSceneCommand(sceneId);
-    process.exit(0);
-  } else if (command === "watch") {
-    await watchSceneCommand(sceneId);
-  } else {
-    console.log(chalk.red(`  Unknown command: ${command}`));
-    console.log(chalk.gray(USAGE));
-    process.exit(1);
-  }
-}
-
-main().catch((error) => {
-  console.error(chalk.red("Error:"), error.message);
-  process.exit(1);
-});

package/src/lib/conf.ts

@@ -1,28 +0,0 @@
-import crypto from "crypto";
-import Conf from "conf";
-
-const CONFIG = new Conf({
-  projectName: "phibelle-kit",
-});
-
-export function setToken(token: string) {
-  CONFIG.set("authToken", token);
-}
-
-export function getStoredToken(): string | undefined {
-  return CONFIG.get("authToken") as string | undefined;
-}
-
-export function clearToken() {
-  CONFIG.delete("authToken");
-}
-
-/** Stable session ID for this CLI instance; used so we can skip re-unpack when we were the ones who saved. */
-export function getSessionId(): string {
-  let sessionId = CONFIG.get("sessionId") as string | undefined;
-  if (!sessionId) {
-    sessionId = crypto.randomUUID();
-    CONFIG.set("sessionId", sessionId);
-  }
-  return sessionId;
-}

package/src/lib/convex-client.ts

@@ -1,101 +0,0 @@
-import { ConvexClient } from "convex/browser";
-import { CONVEX_URL } from "./public-env.js";
-import { getStoredToken } from "./conf.js";
-
-if (!CONVEX_URL) {
-  throw new Error(
-    "Missing CONVEX_URL environment variable. " +
-    "Set it to your Convex deployment URL (e.g., from NEXT_PUBLIC_CONVEX_URL in your phibelle project)"
-  );
-}
-
-export function createConvexClient(): ConvexClient {
-  const token = getStoredToken();
-  
-  if (!token) {
-    throw new Error("Not authenticated. Please run 'phibelle login' first.");
-  }
-
-  const client = new ConvexClient(CONVEX_URL!);
-
-  client.setAuth(() => Promise.resolve(token));
-
-  return client;
-}
-
-/**
- * Helper function to subscribe to a Convex query.
- * 
- * @param query - The query function reference (e.g., api.scenes.getById)
- * @param args - Arguments to pass to the query
- * @param callback - Callback function that receives the query result whenever it updates
- * @returns Unsubscribe function that can be called to stop the subscription
- * 
- * @example
- * ```typescript
- * const unsubscribe = subscribeToQuery(
- *   api.scenes.getById,
- *   { id: "scene123" },
- *   (scene) => {
- *     console.log("Scene updated:", scene);
- *   }
- * );
- * 
- * // Later, to unsubscribe:
- * unsubscribe();
- * ```
- */
-export function subscribeToQuery<Args extends Record<string, any>, Result>(
-  query: any, // Query reference from api
-  args: Args,
-  callback: (result: Result) => void
-): () => void {
-  const client = createConvexClient();
-  
-  return client.onUpdate(query, args, callback);
-}
-
-/**
- * Helper function to run a Convex query once and return the result.
- * 
- * @param query - The query function reference (e.g., api.scenes.listMyScenes)
- * @param args - Arguments to pass to the query
- * @returns Promise that resolves with the query result
- * 
- * @example
- * ```typescript
- * const scenes = await queryOnce(api.scenes.listMyScenes, {});
- * ```
- */
-export async function queryOnce<Args extends Record<string, any>, Result>(
-  query: any,
-  args: Args
-): Promise<Result> {
-  const client = createConvexClient();
-  
-  try {
-    return await client.query(query, args);
-  } finally {
-    await client.close();
-  }
-}
-
-/**
- * Helper function to run a Convex mutation once and return the result.
- *
- * @param mutation - The mutation function reference (e.g. api.scenes.update)
- * @param args - Arguments to pass to the mutation
- * @returns Promise that resolves with the mutation result
- */
-export async function mutateOnce<Args extends Record<string, any>, Result>(
-  mutation: any,
-  args: Args
-): Promise<Result> {
-  const client = createConvexClient();
-
-  try {
-    return await client.mutation(mutation, args);
-  } finally {
-    await client.close();
-  }
-}

package/src/lib/file-system.ts

@@ -1,53 +0,0 @@
-import * as path from "node:path";
-import * as fs from "fs";
-
-export function folderExists(folderPath: string): boolean {
-  return fs.existsSync(folderPath);
-}
-
-export function createFolder(folderPath: string) {
-  if (!folderExists(folderPath)) {
-    fs.mkdirSync(folderPath, { recursive: true });
-  }
-}
-
-/** Scene name to folder name: lowercased, spaces to hyphens, safe for filesystem. */
-export function sceneNameToFolder(name: string): string {
-  return name
-    .toLowerCase()
-    .replace(/\s+/g, "-")
-    .replace(/[^a-z0-9-]/g, "")
-    .replace(/-+/g, "-")
-    .replace(/^-|-$/g, "") || "scene";
-}
-
-/** Find directory containing scene.json with _id === sceneId: check cwd first, then subdirs. */
-export function findSceneDirBySceneId(cwd: string, sceneId: string): string | null {
-  const scenePathInCwd = path.join(cwd, "scene.json");
-  try {
-    const raw = fs.readFileSync(scenePathInCwd, "utf8");
-    const data = JSON.parse(raw) as { _id?: string };
-    if (data._id === sceneId) return cwd;
-  } catch {
-    // cwd is not the scene dir
-  }
-
-  let entries: fs.Dirent[];
-  try {
-    entries = fs.readdirSync(cwd, { withFileTypes: true });
-  } catch {
-    return null;
-  }
-  for (const ent of entries) {
-    if (!ent.isDirectory()) continue;
-    const scenePath = path.join(cwd, ent.name, "scene.json");
-    try {
-      const raw = fs.readFileSync(scenePath, "utf8");
-      const data = JSON.parse(raw) as { _id?: string };
-      if (data._id === sceneId) return path.join(cwd, ent.name);
-    } catch {
-      // no scene.json or invalid
-    }
-  }
-  return null;
-}

package/src/lib/first-run-setup.ts

@@ -1,73 +0,0 @@
-import chalk from "chalk";
-import * as path from "path";
-import * as fs from "fs";
-import { BASE_URL } from "./public-env.js";
-import { createFolder } from "./file-system.js";
-import { unpackageScene } from "./scene-packaging.js";
-import { createScriptWatcher, type ScriptWatcher } from "./script-watcher.js";
-import { setupSceneDirectory, getInstallHint } from "../package/setup.js";
-import { toErrorMessage } from "./utils.js";
-import type { Scene } from "./types.js";
-
-export type WatchCallbacks = {
-  onPushed: (file: string) => void;
-  onNewEntity: (engineId: number) => void;
-  onError: (file: string, err: Error) => void;
-};
-
-const INSTALL_HINT_LABEL = "  ⚠ Install dependencies for types and intellisense:";
-
-/** Create scene dir, write scene.json, setup package.json/global.d.ts; log install hint if needed. */
-export function setupSceneFiles(scene: Scene, sceneDir: string, ignoreHint: boolean = false): void {
-  createFolder(sceneDir);
-  fs.writeFileSync(path.join(sceneDir, "scene.json"), JSON.stringify(scene));
-  const { shouldPromptInstall } = setupSceneDirectory(sceneDir, scene._id);
-  if (shouldPromptInstall && !ignoreHint) {
-    console.log(chalk.yellowBright.bold(INSTALL_HINT_LABEL));
-    console.log(chalk.cyan.bold("     " + getInstallHint(sceneDir)));
-    console.log();
-  }
-}
-
-/** Unpackage scene scripts; log success or hint on failure. */
-export async function unpackageWithLogging(
-  sceneId: string,
-  sceneDir: string,
-  failHint: string
-): Promise<void> {
-  try {
-    await unpackageScene(sceneId, sceneDir);
-    console.log(chalk.green("  ✓ Unpacked scene scripts (scene.tsx, entity-*.tsx, manifest.json)"));
-  } catch (e: unknown) {
-    console.log(chalk.yellow("  ⚠ Could not unpackage scene scripts: " + toErrorMessage(e)));
-    console.log(chalk.gray("    " + failHint));
-  }
-}
-
-export async function runFirstUpdateSetup(
-  scene: Scene,
-  sceneDir: string,
-  callbacks: WatchCallbacks
-): Promise<ScriptWatcher> {
-  setupSceneFiles(scene, sceneDir);
-
-  console.log(chalk.yellow("  Opening folder: " + sceneDir));
-  console.log();
-
-  await unpackageWithLogging(scene._id, sceneDir, "Edit in the app once to create a scene file, then run watch again.");
-
-  console.log(chalk.green("  ✓ Connected to scene"));
-  console.log(chalk.white(`    Name: ${scene.name}`));
-  console.log(chalk.white(`    Dir: ${sceneDir}`));
-  console.log(chalk.white(`    Last updated: ${new Date(scene.updatedAt).toLocaleString()}`));
-  console.log(chalk.white("    Scene Link: ") + chalk.cyan(`${BASE_URL}/editor?sceneId=${scene._id}`));
-  console.log();
-
-  return createScriptWatcher(
-    scene._id,
-    sceneDir,
-    callbacks.onPushed,
-    callbacks.onNewEntity,
-    callbacks.onError
-  );
-}

package/src/lib/public-env.ts

@@ -1,3 +0,0 @@
-export const isDev = process.env.NODE_ENV === "development";
-export const BASE_URL = isDev ? "http://localhost:3131" : "https://phibelle.studio";
-export const CONVEX_URL = isDev ? "https://mellow-toad-676.convex.cloud" : "https://keen-dove-500.convex.cloud";