@porulle/cli 0.1.0 → 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 unified-commerce-engine contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/commands/api-key.d.ts

@@ -13,6 +13,14 @@ export declare const apiKeyCreateCommand: import("citty").CommandDef<{
         type: "string";
         description: string;
     };
+    ttl: {
+        type: "string";
+        description: string;
+    };
+    user: {
+        type: "string";
+        description: string;
+    };
     "save-env": {
         type: "boolean";
         description: string;

package/dist/commands/api-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../../src/commands/api-key.ts"],"names":[],"mappings":"AAgGA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAyH9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;EA+B5B,CAAC;AAEH,eAAO,MAAM,aAAa,qDASxB,CAAC"}
+{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../../src/commands/api-key.ts"],"names":[],"mappings":"AAgGA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+J9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;EA+B5B,CAAC;AAEH,eAAO,MAAM,aAAa,qDASxB,CAAC"}

package/dist/commands/api-key.js

@@ -69,6 +69,14 @@ export const apiKeyCreateCommand = defineCommand({
             type: "string",
             description: "Key name (default: scope name)",
         },
+        ttl: {
+            type: "string",
+            description: "Time-to-live in seconds (Better Auth minExpiresIn is 1 day = 86400)",
+        },
+        user: {
+            type: "string",
+            description: "Bind the key to a specific user id (default: an ops admin user)",
+        },
         "save-env": {
             type: "boolean",
             description: "Save key to .env.local",
@@ -104,14 +112,29 @@ export const apiKeyCreateCommand = defineCommand({
             process.exit(1);
         }
         console.log(`Creating ${args.scope} API key...`);
-        // Find or create an admin user for key ownership
-        const userId = await findOrCreateAdminUser(app, config);
+        // Optional TTL — Better Auth enforces a 1-day minimum (minExpiresIn).
+        let expiresIn;
+        if (args.ttl) {
+            const ttl = Number(args.ttl);
+            if (!Number.isFinite(ttl) || ttl <= 0) {
+                console.error("--ttl must be a positive number of seconds.");
+                process.exit(1);
+            }
+            if (ttl < 86400) {
+                console.error("--ttl must be at least 86400 seconds (1 day) — Better Auth minExpiresIn.");
+                process.exit(1);
+            }
+            expiresIn = ttl;
+        }
+        // Bind to the requested user, or find/create an ops admin for ownership.
+        const userId = args.user ?? (await findOrCreateAdminUser(app, config));
         const result = await auth.api.createApiKey({
             body: {
                 configId: args.scope,
                 userId,
                 name: args.name ?? `${args.scope}-key`,
                 permissions: scopeDef.permissions,
+                ...(expiresIn ? { expiresIn } : {}),
                 ...(scopeDef.rateLimit
                     ? {
                         rateLimitEnabled: true,
@@ -155,8 +178,20 @@ export const apiKeyCreateCommand = defineCommand({
             }
             console.log(`  Saved to:    .env.local as ${varName}`);
         }
+        if (expiresIn) {
+            console.log(`  Expires in:  ${expiresIn}s`);
+        }
+        console.log(`  Owner:       ${userId}`);
+        console.log("");
+        console.log("  ── Use it ──────────────────────────────────────────────");
+        console.log(`  curl -H "x-api-key: ${result.key}" http://localhost:4000/api/health`);
+        console.log("  ── Revoke it ───────────────────────────────────────────");
+        console.log(`  curl -X DELETE -H "x-api-key: ${result.key}" \\`);
+        console.log(`    http://localhost:4000/api/api-keys/${result.id}`);
+        console.log("  ────────────────────────────────────────────────────────");
         console.log("");
-        console.log("This is the only time the full key is shown. Store it securely.");
+        console.log("This is the only time the full key is shown — Better Auth hashes it");
+        console.log("at rest. Copy it now; if you lose it, mint a new one.");
         process.exit(0);
     },
 });

package/dist/commands/import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAwJA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2KxB,CAAC"}
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAyKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuLxB,CAAC"}

package/dist/commands/import.js

@@ -2,12 +2,27 @@ import { readFile } from "node:fs/promises";
 import { extname, resolve } from "node:path";
 import { defineCommand } from "citty";
 import consola from "consola";
-// @ts-ignore — missing type declarations
-import { importFlat } from "@porulle/import-flat";
-// @ts-ignore — missing type declarations
-import { importShopifyCatalog } from "@porulle/import-shopify";
-// @ts-ignore — missing type declarations
-import { importWooCommerceCatalog } from "@porulle/import-woocommerce";
+/**
+ * The import adapters (`@porulle/import-flat`, `@porulle/import-shopify`,
+ * `@porulle/import-woocommerce`) are optional dependencies, loaded on demand
+ * only when the matching `import` source is invoked. This keeps the CLI
+ * installable and bootable even when the adapters aren't present, instead of
+ * the whole CLI failing to load when a single optional package is missing.
+ */
+async function loadImporter(pkg, named) {
+    let mod;
+    try {
+        mod = (await import(pkg));
+    }
+    catch {
+        throw new Error(`The "${pkg}" import adapter is not installed. Install it to use this importer:\n  bun add ${pkg}`);
+    }
+    const fn = mod[named];
+    if (typeof fn !== "function") {
+        throw new Error(`"${pkg}" did not export "${named}".`);
+    }
+    return fn;
+}
 function toBaseUrl(raw) {
     return (raw ?? "http://localhost:3000").replace(/\/$/, "");
 }
@@ -146,6 +161,7 @@ export const importCommand = defineCommand({
                     customers = parsed.customers;
                 }
             }
+            const importShopifyCatalog = await loadImporter("@porulle/import-shopify", "importShopifyCatalog");
             const imported = await importShopifyCatalog({
                 target,
                 ...(args.storeUrl ? { storeUrl: String(args.storeUrl) } : {}),
@@ -179,6 +195,7 @@ export const importCommand = defineCommand({
                     customers = parsed.customers;
                 }
             }
+            const importWooCommerceCatalog = await loadImporter("@porulle/import-woocommerce", "importWooCommerceCatalog");
             const imported = await importWooCommerceCatalog({
                 target,
                 ...(args.storeUrl ? { storeUrl: String(args.storeUrl) } : {}),
@@ -214,6 +231,7 @@ export const importCommand = defineCommand({
             const inputPath = resolve(process.cwd(), String(args.input));
             const raw = await readFile(inputPath, "utf8");
             const extension = extname(inputPath).toLowerCase();
+            const importFlat = await loadImporter("@porulle/import-flat", "importFlat");
             const imported = await importFlat({
                 mapping: mappingParsed,
                 target: {

package/dist/commands/init.d.ts

@@ -1,3 +1,9 @@
+interface PackageJsonShape {
+    name?: string;
+    version?: string;
+    [key: string]: unknown;
+}
+export declare function pinPorulleDependencies(pkg: PackageJsonShape, version: string): void;
 export declare const initCommand: import("citty").CommandDef<{
     projectName: {
         type: "positional";
@@ -9,4 +15,5 @@ export declare const initCommand: import("citty").CommandDef<{
         default: string;
     };
 }>;
+export {};
 //# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,WAAW;;;;;;;;;;EA+CtB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAUA,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAaD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,GACd,IAAI,CAWN;AASD,eAAO,MAAM,WAAW;;;;;;;;;;EAmDtB,CAAC"}

package/dist/commands/init.js

@@ -6,6 +6,33 @@ import consola from "consola";
 import { downloadTemplate } from "giget";
 import { copyDir, readJson, writeJson } from "../utils.js";
 const currentDir = fileURLToPath(new URL(".", import.meta.url));
+const DEP_SECTIONS = [
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+    "optionalDependencies",
+];
+// Scaffolded projects must pin @porulle/* to the version of the CLI that
+// created them: the packages are a fixed-version group, so the running CLI's
+// own version is the correct, coherent target. A literal range baked into the
+// template would go stale on every release.
+export function pinPorulleDependencies(pkg, version) {
+    for (const section of DEP_SECTIONS) {
+        const deps = pkg[section];
+        if (!deps || typeof deps !== "object")
+            continue;
+        const record = deps;
+        for (const name of Object.keys(record)) {
+            if (name.startsWith("@porulle/")) {
+                record[name] = `^${version}`;
+            }
+        }
+    }
+}
+async function readCliVersion() {
+    const pkg = await readJson(resolve(currentDir, "../../package.json"));
+    return pkg.version;
+}
 export const initCommand = defineCommand({
     meta: {
         name: "init",
@@ -41,6 +68,10 @@ export const initCommand = defineCommand({
         if (existsSync(packageJsonPath)) {
             const pkg = await readJson(packageJsonPath);
             pkg.name = projectName;
+            const cliVersion = await readCliVersion();
+            if (cliVersion) {
+                pinPorulleDependencies(pkg, cliVersion);
+            }
             await writeJson(packageJsonPath, pkg);
         }
         consola.success(`Project created at ${destination}`);

package/package.json

@@ -1,36 +1,32 @@
 {
   "name": "@porulle/cli",
-  "version": "0.1.0",
+  "version": "0.6.0",
   "license": "MIT",
   "type": "module",
   "bin": {
     "unifiedcommerce": "./dist/index.js"
   },
-  "scripts": {
-    "build": "rm -rf dist tsconfig.build.tsbuildinfo && tsc -p tsconfig.build.json",
-    "check-types": "tsc --noEmit",
-    "lint": "eslint . --max-warnings 1000",
-    "test": "vitest run"
-  },
   "dependencies": {
     "postgres": "^3.4.7",
-    "@porulle/import-flat": "workspace:*",
-    "@porulle/import-shopify": "workspace:*",
-    "@porulle/import-woocommerce": "workspace:*",
     "citty": "^0.1.6",
     "consola": "^3.4.2",
     "giget": "^2.0.0"
   },
+  "optionalDependencies": {
+    "@porulle/import-woocommerce": "0.6.0",
+    "@porulle/import-shopify": "0.6.0",
+    "@porulle/import-flat": "0.6.0"
+  },
   "devDependencies": {
     "@electric-sql/pglite": "0.4.5",
     "@electric-sql/pglite-socket": "^0.1.5",
-    "@repo/eslint-config": "*",
-    "@repo/typescript-config": "*",
     "@types/node": "^24.5.2",
     "drizzle-kit": "^0.31.9",
     "eslint": "^9.39.1",
     "typescript": "5.9.2",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@porulle/eslint-config": "0.1.0",
+    "@porulle/typescript-config": "0.1.0"
   },
   "publishConfig": {
     "access": "public"
@@ -49,5 +45,11 @@
     "url": "git+https://github.com/asyncdotengineering/porulle.git",
     "directory": "packages/cli"
   },
-  "author": "Porulle contributors"
-}
+  "author": "Porulle contributors",
+  "scripts": {
+    "build": "rm -rf dist tsconfig.build.tsbuildinfo && tsc -p tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 1000",
+    "test": "vitest run"
+  }
+}