@api-emulator/adp 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @api-emulator/adp
+
+ADP provides Human Capital Management APIs for workers, payroll events, organizations, time, and pay data.
+
+Part of [api-emulator](https://github.com/jsj/api-emulator) — local drop-in replacement services for CI and no-network sandboxes.
+
+## Install
+
+```bash
+npm install @api-emulator/adp
+```
+
+## Run
+
+```bash
+npx -p api-emulator api --plugin ./@adp/api-emulator.mjs --service adp
+```
+
+## Endpoints
+
+- `GET /hr/v2/workers`
+- `GET /hr/v2/workers/:associateOid`
+- `POST /events/hr/v1/worker.hire`
+- `POST /payroll/v1/pay-data-input`
+- `GET /inspect/contract`
+- `GET /inspect/state`
+
+## Auth
+
+No production credentials are required. Use fake local credentials in client tests.
+
+## Seed Configuration
+
+```yaml
+adp:
+  # Add provider-specific seed state here.
+```
+
+## Links
+
+- [Official API docs](https://developers.adp.com/)
+- [api-emulator](https://github.com/jsj/api-emulator)

package/api-emulator.mjs

@@ -0,0 +1,113 @@
+// @adp/api-emulator.mjs
+function initialState(config = {}) {
+  return {
+    ...{
+      workers: [
+        {
+          associateOID: "aoid_1",
+          workerID: {
+            idValue: "E0001"
+          },
+          person: {
+            legalName: {
+              givenName: "Ada",
+              familyName1: "Lovelace"
+            },
+            communication: {
+              emails: [
+                {
+                  emailUri: "ada@example.com"
+                }
+              ]
+            }
+          },
+          workerStatus: {
+            statusCode: {
+              codeValue: "Active"
+            }
+          }
+        }
+      ],
+      payDataInputs: [],
+      nextId: 2
+    },
+    ...config
+  };
+}
+function state(store) {
+  const current = store.getData?.("adp:state");
+  if (current)
+    return current;
+  const next = initialState();
+  store.setData?.("adp:state", next);
+  return next;
+}
+function saveState(store, next) {
+  store.setData?.("adp:state", next);
+}
+async function json(c) {
+  return c.req.json().catch(() => ({}));
+}
+async function createPlain(c, store, key, prefix) {
+  const s = state(store);
+  const body = await json(c);
+  const row = { id: body.id ?? s.nextId++, created_at: new Date().toISOString(), ...body };
+  s[key].push(row);
+  saveState(store, s);
+  return row;
+}
+async function createKeyed(c, store, key, prefix) {
+  const row = await createPlain(c, store, key, prefix);
+  row.id ??= `${prefix}_${state(store).nextId}`;
+  return c.json(row, 201);
+}
+function adpError(message) {
+  return { confirmMessage: { confirmMessageID: { idValue: "emulator-error" }, createDateTime: new Date().toISOString(), requestStatusCode: { codeValue: "failed" }, resourceMessages: [{ processMessages: [{ messageTypeCode: { codeValue: "error" }, userMessage: { messageTxt: message } }] }] } };
+}
+var contract = {
+  provider: "adp",
+  source: "ADP official API documentation-informed REST subset",
+  docs: "https://developers.adp.com/",
+  baseUrl: "https://api.adp.com",
+  scope: ["workers", "worker-read", "worker-hire-event", "pay-data-input"],
+  fidelity: "stateful-rest-emulator"
+};
+var plugin = {
+  name: "adp",
+  register(app, store) {
+    app.get("/hr/v2/workers", (c) => c.json({ workers: state(store).workers }));
+    app.get("/hr/v2/workers/:associateOid", (c) => {
+      const row = state(store).workers.find((w) => w.associateOID === c.req.param("associateOid"));
+      return row ? c.json(row) : c.json(adpError("Worker not found"), 404);
+    });
+    app.post("/events/hr/v1/worker.hire", async (c) => {
+      const s = state(store);
+      const body = await json(c);
+      const row = { associateOID: body.associateOID ?? `aoid_${s.nextId++}`, workerID: { idValue: body.workerID?.idValue ?? `E${String(s.nextId).padStart(4, "0")}` }, person: body.person ?? {}, workerStatus: { statusCode: { codeValue: "Active" } } };
+      s.workers.push(row);
+      saveState(store, s);
+      return c.json({ eventStatusCode: { codeValue: "complete" }, worker: row }, 201);
+    });
+    app.post("/payroll/v1/pay-data-input", async (c) => createKeyed(c, store, "payDataInputs", "payDataInput"));
+    app.get("/inspect/contract", (c) => c.json(contract));
+    app.get("/inspect/state", (c) => c.json(state(store)));
+  }
+};
+function seedFromConfig(store, _baseUrl, config = {}) {
+  saveState(store, initialState(config));
+}
+var label = "ADP API emulator";
+var endpoints = contract.scope.join(", ");
+var capabilities = contract.scope;
+var initConfig = { adp: initialState() };
+var api_emulator_default = plugin;
+export {
+  seedFromConfig,
+  plugin,
+  label,
+  initConfig,
+  endpoints,
+  api_emulator_default as default,
+  contract,
+  capabilities
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@api-emulator/adp",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "./api-emulator.mjs",
+  "exports": {
+    ".": "./api-emulator.mjs"
+  },
+  "files": [
+    "api-emulator.mjs",
+    "README.md"
+  ],
+  "homepage": "https://api-emulator.jsj.sh",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jsj/api-emulator-registry.git",
+    "directory": "@adp"
+  },
+  "bugs": {
+    "url": "https://github.com/jsj/api-emulator/issues"
+  },
+  "peerDependencies": {
+    "api-emulator": ">=0.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}