dropsh 0.1.1 → 0.2.1

package/dist/src/core/auth/registry.js

@@ -7,3 +7,16 @@ export function loginCapableProviders(providers) {
 export function providerById(providers, id) {
     return providers.find((p) => p.id === id);
 }
+/**
+ * A session-less provider (e.g. static Basic) is the sole configured provider
+ * that declares no login capability: it carries credentials inline and needs no
+ * stored session. Used by both resolveAuth and authStatus.
+ */
+export function sessionlessProvider(providers) {
+    if (providers.length !== 1)
+        return undefined;
+    const only = providers[0];
+    if (!only)
+        return undefined;
+    return only.capabilities.login === false ? only : undefined;
+}

package/dist/src/core/jsonapi/client.js

@@ -1,3 +1,6 @@
+import { createCollection } from "./collection.js";
+import { toResource } from "./resource.js";
+import { resolveType } from "./types.js";
 function joinUrl(base, prefix, path) {
     const b = base.replace(/\/+$/, "");
     const p = prefix.startsWith("/") ? prefix : `/${prefix}`;
@@ -22,7 +25,7 @@ export function createJsonApiClient(opts) {
             return { ok: true };
         return JSON.parse(res.body);
     }
-    return {
+    const client = {
         async get(path, params) {
             const qs = params ? `?${params.getQueryString()}` : "";
             return send("GET", joinUrl(opts.baseUrl, opts.prefix, path) + qs);
@@ -42,5 +45,46 @@ export function createJsonApiClient(opts) {
                 "Content-Disposition": `file; filename="${filename}"`,
             });
         },
+        collection(type) {
+            return createCollection(client, type);
+        },
+        async resource(type, id) {
+            const { path } = resolveType(type);
+            const doc = (await client.get(`${path}/${id}`));
+            return toResource(doc.data);
+        },
+        async create(type, body) {
+            const { path, type: resourceType } = resolveType(type);
+            const doc = (await client.post(path, {
+                data: { type: resourceType, ...body },
+            }));
+            return toResource(doc.data);
+        },
+        async update(type, id, body) {
+            const { path, type: resourceType } = resolveType(type);
+            const doc = (await client.patch(`${path}/${id}`, {
+                data: { type: resourceType, id, ...body },
+            }));
+            return toResource(doc.data);
+        },
+        async upsert(type, match, body) {
+            const existing = await client.collection(type).where(match.path, "=", match.value).first();
+            if (existing)
+                return client.update(type, existing.id, body);
+            return client.create(type, body);
+        },
+        async me() {
+            const doc = (await client.get(""));
+            const me = doc?.meta?.links?.me;
+            if (me?.meta?.id)
+                return me.meta.id;
+            if (me?.href) {
+                const segment = me.href.split("/").filter(Boolean).pop();
+                if (segment)
+                    return segment;
+            }
+            throw new Error("Unable to resolve current user uuid from root document meta.links.me");
+        },
     };
+    return client;
 }

package/dist/src/core/jsonapi/collection.js

@@ -0,0 +1,49 @@
+import { DrupalJsonApiParams } from "drupal-jsonapi-params";
+import { toResource } from "./resource.js";
+import { resolveType } from "./types.js";
+export function createCollection(client, spec, params = new DrupalJsonApiParams()) {
+    const resolved = resolveType(spec);
+    const collection = {
+        where(path, op, value) {
+            if (op === "=")
+                params.addFilter(path, String(value));
+            else
+                params.addFilter(path, String(value), op);
+            return collection;
+        },
+        whereIn(path, values) {
+            params.addFilter(path, values.map(String), "IN");
+            return collection;
+        },
+        notExists(path) {
+            params.addFilter(path, null, "IS NULL");
+            return collection;
+        },
+        fields(names) {
+            params.addFields(resolved.type, names);
+            return collection;
+        },
+        sort(path, dir) {
+            params.addSort(path, dir);
+            return collection;
+        },
+        page(limit) {
+            params.addPageLimit(limit);
+            return collection;
+        },
+        async list() {
+            const doc = (await client.get(resolved.path, params));
+            const data = doc?.data ?? [];
+            return data.map(toResource);
+        },
+        async first() {
+            const results = await collection.page(1).list();
+            return results[0] ?? null;
+        },
+        async count() {
+            const results = await collection.fields([]).list();
+            return results.length;
+        },
+    };
+    return collection;
+}

package/dist/src/core/jsonapi/resource.js

@@ -0,0 +1,33 @@
+/**
+ * Ergonomic accessors over a raw JSON:API resource object.
+ *
+ * A {@link Resource} wraps the `data` member of a JSON:API document and exposes
+ * typed helpers for attributes and relationships so callers stop digging through
+ * nested `attributes`/`relationships` structures by hand.
+ */
+export function toResource(obj) {
+    return {
+        id: obj.id,
+        type: obj.type,
+        raw: obj,
+        attr(key) {
+            return obj.attributes?.[key];
+        },
+        rel(key) {
+            const data = obj.relationships?.[key]?.data;
+            if (data === undefined || data === null)
+                return null;
+            if (Array.isArray(data))
+                return data[0]?.id ?? null;
+            return data.id;
+        },
+        rels(key) {
+            const data = obj.relationships?.[key]?.data;
+            if (data === undefined || data === null)
+                return [];
+            if (Array.isArray(data))
+                return data.map((d) => d.id);
+            return [data.id];
+        },
+    };
+}

package/dist/src/core/jsonapi/types.js

@@ -0,0 +1,25 @@
+/**
+ * JSON:API resource type/path normalization.
+ *
+ * Drupal JSON:API addresses resources by a `entity/bundle` path (e.g.
+ * `node/article`) but identifies them in document envelopes by a `entity--bundle`
+ * type (e.g. `node--article`). This helper accepts either form plus a convenient
+ * single-segment shorthand and produces both representations.
+ */
+/**
+ * Resolve a loose type specifier into its `{ path, type }` pair.
+ *
+ * Accepted forms:
+ * - `'gaia_run'`        -> `{ path: 'gaia_run/gaia_run', type: 'gaia_run--gaia_run' }`
+ * - `'entity/bundle'`   -> `{ path: 'entity/bundle',     type: 'entity--bundle'      }`
+ * - `'entity--bundle'`  -> `{ path: 'entity/bundle',     type: 'entity--bundle'      }`
+ */
+export function resolveType(spec) {
+    if (spec.includes("--")) {
+        return { type: spec, path: spec.replace(/--/g, "/") };
+    }
+    if (spec.includes("/")) {
+        return { path: spec, type: spec.replace(/\//g, "--") };
+    }
+    return { path: `${spec}/${spec}`, type: `${spec}--${spec}` };
+}

package/dist/src/index.js

@@ -9,7 +9,7 @@ import { applyOperationSchemaPlugins, operationHookPluginIds, runSchema, SCHEMA_
 import { runSearch } from "./commands/search.js";
 import { runUpdate } from "./commands/update.js";
 import { runUploadFile } from "./commands/upload-file.js";
-import { collectProviders, providerById } from "./core/auth/registry.js";
+import { collectProviders, providerById, sessionlessProvider } from "./core/auth/registry.js";
 import { readSession, writeSession } from "./core/auth/session-store.js";
 import { createFileStore } from "./core/cache/file-store.js";
 import { createOutput } from "./core/cli/output.js";
@@ -25,10 +25,20 @@ function resolveConfigPath(override) {
     return override ?? process.env.DROPSH_CONFIG ?? "dropsh.config.js";
 }
 export async function resolveAuth(deps) {
+    const providers = collectProviders(deps.plugins);
     const rec = await readSession(deps.baseUrl, deps.stateDir);
-    if (!rec)
+    if (!rec) {
+        const sessionless = sessionlessProvider(providers);
+        if (sessionless) {
+            return sessionless.createAdapter(undefined, {
+                http: deps.http,
+                now: deps.now,
+                save: async () => { },
+            });
+        }
         throw new AuthError("Not authenticated. Run 'dropsh auth login'.");
-    const provider = providerById(collectProviders(deps.plugins), rec.activeProvider);
+    }
+    const provider = providerById(providers, rec.activeProvider);
     if (!provider)
         throw new ConfigError(`active provider '${rec.activeProvider}' is not configured`);
     return provider.createAdapter(rec.session, {
@@ -37,6 +47,20 @@ export async function resolveAuth(deps) {
         save: (session) => writeSession(deps.baseUrl, provider.id, session, deps.stateDir),
     });
 }
+export async function authStatus(deps) {
+    const providers = collectProviders(deps.plugins);
+    const rec = await readSession(deps.baseUrl, deps.stateDir);
+    if (!rec) {
+        const sessionless = sessionlessProvider(providers);
+        return sessionless
+            ? { loggedIn: true, provider: sessionless.id, sessionless: true }
+            : { loggedIn: false };
+    }
+    const provider = providerById(providers, rec.activeProvider);
+    if (!provider)
+        return { loggedIn: false };
+    return provider.status(rec.session);
+}
 async function defaultContext(configPath) {
     const cfg = await loadConfig(configPath);
     const http = createHttpClient({ timeoutMs: cfg.defaults.timeout_ms });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dropsh",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Entity-agnostic helper CLI for Drupal 11 JSON:API, used by the dropsh Claude skill for editorial publishing workflows.",
   "type": "module",
   "bin": {
@@ -17,6 +17,22 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc",
+    "build:packages": "pnpm --filter \"./packages/*\" run build",
+    "build:plugins": "pnpm --filter \"./plugins/*\" run build",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:integration": "pnpm run build && pnpm run build:packages && vitest run -c vitest.config.integration.ts",
+    "typecheck": "pnpm run build:packages && tsc --noEmit && pnpm -r run typecheck",
+    "lint": "biome check src/ packages/ plugins/ tests/integrations/helpers/ tests/integrations/schema/ tests/integrations/*.ts",
+    "lint:fix": "biome check --write src/ packages/ plugins/ tests/integrations/helpers/ tests/integrations/schema/ tests/integrations/*.ts",
+    "drupal:up": "bash tests/integrations/bin/drupal-up.sh",
+    "drupal:down": "bash tests/integrations/bin/drupal-down.sh",
+    "prepublishOnly": "pnpm run typecheck && pnpm run build",
+    "release": "node scripts/release.mjs"
+  },
   "keywords": [
     "drupal",
     "drupal11",
@@ -46,22 +62,19 @@
     "vite": "^6.4.3",
     "vitest": "^4.1.8"
   },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ],
+    "overrides": {
+      "fast-uri": "^3.1.2",
+      "qs": "^6.15.2",
+      "vite": "^6.4.2",
+      "esbuild": "^0.25.0"
+    }
+  },
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "build": "tsc",
-    "build:packages": "pnpm --filter \"./packages/*\" run build",
-    "build:plugins": "pnpm --filter \"./plugins/*\" run build",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest",
-    "test:integration": "pnpm run build && pnpm run build:packages && vitest run -c vitest.config.integration.ts",
-    "typecheck": "pnpm run build:packages && tsc --noEmit && pnpm -r run typecheck",
-    "lint": "biome check src/ packages/ plugins/ tests/integrations/helpers/ tests/integrations/schema/ tests/integrations/*.ts",
-    "lint:fix": "biome check --write src/ packages/ plugins/ tests/integrations/helpers/ tests/integrations/schema/ tests/integrations/*.ts",
-    "drupal:up": "bash tests/integrations/bin/drupal-up.sh",
-    "drupal:down": "bash tests/integrations/bin/drupal-down.sh",
-    "release": "pnpm -r --include-workspace-root publish --no-git-checks"
-  }
-}
+  "packageManager": "pnpm@10.29.1"
+}