dropsh 0.1.0 → 0.2.0

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/plugin-api.js

@@ -1,4 +1,5 @@
 export { basicAuthPlugin, basicAuthProvider } from "./core/auth/basic.js";
 export { loadConfig } from "./core/config.js";
 export { createHttpClient } from "./core/http.js";
+export { createJsonApiClient } from "./core/jsonapi/client.js";
 export { AuthError, ConfigError, HttpError } from "./errors.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dropsh",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Entity-agnostic helper CLI for Drupal 11 JSON:API, used by the dropsh Claude skill for editorial publishing workflows.",
   "type": "module",
   "bin": {
@@ -62,6 +62,6 @@
     "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"
+    "release": "node scripts/release.mjs"
   }
 }