@aglyn/plugins-commerce 1.0.0-beta.229 → 1.0.0-beta.231

package/src/lib/testing/memory-firestore.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/testing/memory-firestore.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * A small in-memory stand-in for the firebase-admin Firestore surface the\n * print queue uses (AGL-3619), for specs. Transactions are OPTIMISTIC, as\n * Firestore's server SDK effectively is under contention: every read records\n * the version it saw, the commit re-checks them (and re-runs any query read\n * in the transaction), and a conflict retries the whole function. Each read\n * yields to the event loop, so two transactions started together really do\n * interleave, which is what a race spec needs.\n *\n * Supports: `collection().doc()`, `get`, `set` (with `merge`), `create`,\n * `update`, `delete`; queries with `==` and `in`, `orderBy`, `limit`;\n * `runTransaction` with `get` (document or query), `set`, `update`;\n * `batch()`. Field paths are top-level only.\n */\n\ninterface Stored {\n  data: Record<string, any>\n  version: number\n}\n\nconst tick = () => new Promise<void>((resolve) => setTimeout(resolve, 0))\n\nexport class MemoryFirestore {\n  readonly docs = new Map<string, Stored>()\n  private autoId = 0\n  private clock = 0\n  /** Committed transactions that had to retry, for specs that assert contention happened. */\n  retries = 0\n\n  collection(path: string): MemoryCollection {\n    return new MemoryCollection(this, path)\n  }\n\n  /** The document at a slash path, for assertions. */\n  read(path: string): Record<string, any> | undefined {\n    const stored = this.docs.get(path)\n    return stored ? { ...stored.data } : undefined\n  }\n\n  nextId(): string {\n    this.autoId += 1\n    return `auto${String(this.autoId).padStart(4, '0')}`\n  }\n\n  write(path: string, data: Record<string, any> | null): void {\n    this.clock += 1\n    if (data === null) this.docs.delete(path)\n    else this.docs.set(path, { data: { ...data }, version: this.clock })\n  }\n\n  version(path: string): number {\n    return this.docs.get(path)?.version ?? 0\n  }\n\n  batch() {\n    const ops: Array<() => void> = []\n    return {\n      set: (ref: MemoryDoc, data: any, options?: { merge?: boolean }) =>\n        ops.push(() => ref.applySet(data, options)),\n      update: (ref: MemoryDoc, data: any) => ops.push(() => ref.applyUpdate(data)),\n      delete: (ref: MemoryDoc) => ops.push(() => this.write(ref.path, null)),\n      commit: async () => {\n        await tick()\n        for (const op of ops) op()\n      },\n    }\n  }\n\n  async runTransaction<T>(fn: (transaction: any) => Promise<T>): Promise<T> {\n    for (let attempt = 0; attempt < 10; attempt += 1) {\n      const seen = new Map<string, number>()\n      const queries: Array<{ query: MemoryQuery; snapshot: string }> = []\n      const writes: Array<() => void> = []\n      const transaction = {\n        get: async (target: MemoryDoc | MemoryQuery) => {\n          await tick()\n          if (target instanceof MemoryDoc) {\n            seen.set(target.path, this.version(target.path))\n            return target.snapshot()\n          }\n          const result = target.run()\n          queries.push({ query: target, snapshot: target.signature() })\n          for (const doc of result.docs) seen.set(doc.ref.path, this.version(doc.ref.path))\n          return result\n        },\n        set: (ref: MemoryDoc, data: any, options?: { merge?: boolean }) => {\n          writes.push(() => ref.applySet(data, options))\n          return transaction\n        },\n        update: (ref: MemoryDoc, data: any) => {\n          writes.push(() => ref.applyUpdate(data))\n          return transaction\n        },\n        create: (ref: MemoryDoc, data: any) => {\n          writes.push(() => ref.applyCreate(data))\n          return transaction\n        },\n      }\n      const result = await fn(transaction)\n      await tick()\n      const conflicted =\n        [...seen].some(([path, version]) => this.version(path) !== version) ||\n        queries.some(({ query, snapshot }) => query.signature() !== snapshot)\n      if (conflicted) {\n        this.retries += 1\n        continue\n      }\n      for (const write of writes) write()\n      return result\n    }\n    throw new Error('transaction contention: too many retries')\n  }\n}\n\nexport class MemoryCollection {\n  constructor(\n    readonly store: MemoryFirestore,\n    readonly path: string,\n  ) {}\n\n  doc(id?: string): MemoryDoc {\n    return new MemoryDoc(this.store, `${this.path}/${id ?? this.store.nextId()}`)\n  }\n\n  where(field: string, op: '==' | 'in', value: unknown): MemoryQuery {\n    return new MemoryQuery(this.store, this.path).where(field, op, value)\n  }\n\n  orderBy(field: string, direction: 'asc' | 'desc' = 'asc'): MemoryQuery {\n    return new MemoryQuery(this.store, this.path).orderBy(field, direction)\n  }\n\n  limit(count: number): MemoryQuery {\n    return new MemoryQuery(this.store, this.path).limit(count)\n  }\n\n  get() {\n    return Promise.resolve(new MemoryQuery(this.store, this.path).run())\n  }\n}\n\n/** What a {@link MemoryDoc} read returns, shaped like a Firestore snapshot. */\nexport interface MemoryDocSnapshot {\n  id: string\n  ref: MemoryDoc\n  exists: boolean\n  data: () => Record<string, any> | undefined\n  get: (field: string) => unknown\n}\n\nexport class MemoryDoc {\n  constructor(\n    readonly store: MemoryFirestore,\n    readonly path: string,\n  ) {}\n\n  get id(): string {\n    return this.path.split('/').pop() ?? ''\n  }\n\n  collection(name: string): MemoryCollection {\n    return new MemoryCollection(this.store, `${this.path}/${name}`)\n  }\n\n  snapshot(): MemoryDocSnapshot {\n    const stored = this.store.docs.get(this.path)\n    const data = stored ? { ...stored.data } : undefined\n    return {\n      id: this.id,\n      ref: this,\n      exists: Boolean(stored),\n      data: () => (data ? { ...data } : undefined),\n      get: (field: string) => data?.[field],\n    }\n  }\n\n  async get(): Promise<MemoryDocSnapshot> {\n    await tick()\n    return this.snapshot()\n  }\n\n  applySet(data: Record<string, any>, options?: { merge?: boolean }): void {\n    const previous = this.store.docs.get(this.path)?.data\n    this.store.write(this.path, options?.merge && previous ? { ...previous, ...data } : data)\n  }\n\n  applyUpdate(data: Record<string, any>): void {\n    const previous = this.store.docs.get(this.path)?.data\n    if (!previous) throw Object.assign(new Error('NOT_FOUND'), { code: 5 })\n    this.store.write(this.path, { ...previous, ...data })\n  }\n\n  applyCreate(data: Record<string, any>): void {\n    if (this.store.docs.has(this.path)) {\n      throw Object.assign(new Error('Document already exists'), { code: 6 })\n    }\n    this.store.write(this.path, data)\n  }\n\n  async set(data: Record<string, any>, options?: { merge?: boolean }): Promise<void> {\n    await tick()\n    this.applySet(data, options)\n  }\n\n  async create(data: Record<string, any>): Promise<void> {\n    await tick()\n    this.applyCreate(data)\n  }\n\n  async update(data: Record<string, any>): Promise<void> {\n    await tick()\n    this.applyUpdate(data)\n  }\n\n  async delete(): Promise<void> {\n    await tick()\n    this.store.write(this.path, null)\n  }\n}\n\nexport class MemoryQuery {\n  private filters: Array<{ field: string; op: '==' | 'in'; value: unknown }> = []\n  private order: { field: string; direction: 'asc' | 'desc' } | null = null\n  private max = Infinity\n\n  constructor(\n    readonly store: MemoryFirestore,\n    readonly path: string,\n  ) {}\n\n  private clone(): MemoryQuery {\n    const next = new MemoryQuery(this.store, this.path)\n    next.filters = [...this.filters]\n    next.order = this.order\n    next.max = this.max\n    return next\n  }\n\n  where(field: string, op: '==' | 'in', value: unknown): MemoryQuery {\n    const next = this.clone()\n    next.filters.push({ field, op, value })\n    return next\n  }\n\n  orderBy(field: string, direction: 'asc' | 'desc' = 'asc'): MemoryQuery {\n    const next = this.clone()\n    next.order = { field, direction }\n    return next\n  }\n\n  limit(count: number): MemoryQuery {\n    const next = this.clone()\n    next.max = count\n    return next\n  }\n\n  run() {\n    const prefix = `${this.path}/`\n    let rows = [...this.store.docs.entries()]\n      .filter(([path]) => path.startsWith(prefix) && !path.slice(prefix.length).includes('/'))\n      .filter(([, stored]) =>\n        this.filters.every(({ field, op, value }) =>\n          op === 'in'\n            ? (value as unknown[]).includes(stored.data[field])\n            : stored.data[field] === value,\n        ),\n      )\n    if (this.order) {\n      const { field, direction } = this.order\n      rows = rows.sort(([, a], [, b]) => {\n        const delta = a.data[field] < b.data[field] ? -1 : a.data[field] > b.data[field] ? 1 : 0\n        return direction === 'asc' ? delta : -delta\n      })\n    }\n    const docs = rows\n      .slice(0, this.max)\n      .map(([path]) => new MemoryDoc(this.store, path).snapshot())\n    return { docs, size: docs.length, empty: docs.length === 0 }\n  }\n\n  /** The paths and versions this query matches now, to detect a changed result. */\n  signature(): string {\n    return this.run()\n      .docs.map((doc) => `${doc.ref.path}@${this.store.version(doc.ref.path)}`)\n      .join('|')\n  }\n\n  get() {\n    return tick().then(() => this.run())\n  }\n}\n"],"names":["tick","Promise","resolve","setTimeout","MemoryFirestore","collection","path","MemoryCollection","read","stored","docs","get","data","undefined","nextId","autoId","String","padStart","write","clock","delete","set","version","batch","ops","ref","options","push","applySet","update","applyUpdate","commit","op","runTransaction","fn","attempt","seen","Map","queries","writes","transaction","target","MemoryDoc","snapshot","result","run","query","signature","doc","create","applyCreate","conflicted","some","retries","Error","id","store","where","field","value","MemoryQuery","orderBy","direction","limit","count","split","pop","name","exists","Boolean","previous","merge","Object","assign","code","has","clone","next","filters","order","max","prefix","rows","entries","filter","startsWith","slice","length","includes","every","sort","a","b","delta","map","size","empty","join","then","Infinity"],"mappings":"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"}

package/src/lib/testing/pos-ops-harness.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginApiRequest } from '@aglyn/aglyn/server';
+import type { PosOpsDeps, PosOpsMembership } from '../server/pos-ops-gate';
+import { type MemoryFirestore } from './pos-ops-memory-firestore';
+export interface PosOpsHarness {
+    memory: MemoryFirestore;
+    deps: PosOpsDeps;
+    /** The clock every route reads; move it to expire an assertion or a lockout. */
+    clock: {
+        now: number;
+    };
+    /** Per-uid membership; edit to revoke `managePos` or demote someone. */
+    memberships: Record<string, PosOpsMembership>;
+    config: Record<string, unknown>;
+    entitled: {
+        pos: boolean;
+    };
+    stripeCalls: Array<{
+        url: string;
+        body: URLSearchParams;
+        idempotencyKey: string | null;
+    }>;
+    /** What the next Stripe call answers; a queue, then `ok` with a fresh id. */
+    stripeReplies: Array<{
+        status: number;
+        body: Record<string, unknown>;
+    }>;
+    /** Every drawer kick and report print the routes queued, in order. */
+    printed: Array<{
+        kind: 'drawer' | 'report';
+        input: Record<string, any>;
+    }>;
+    request(uid: string | null, body: Record<string, unknown>, headers?: Record<string, string>): PluginApiRequest;
+}
+export declare function posOpsHarness(): PosOpsHarness;

package/src/lib/testing/pos-ops-harness.js

@@ -0,0 +1,184 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { memoryFirestore } from "./pos-ops-memory-firestore.js";
+export function posOpsHarness() {
+    const clock = {
+        now: 1800000000000
+    };
+    const memory = memoryFirestore(()=>clock.now);
+    const memberships = {
+        owner: {
+            orgWide: true,
+            hostRole: 'admin',
+            permissions: {
+                managePos: true
+            }
+        },
+        cashier: {
+            orgWide: false,
+            hostRole: 'editor',
+            permissions: {
+                managePos: true
+            }
+        },
+        cashier2: {
+            orgWide: false,
+            hostRole: 'editor',
+            permissions: {
+                managePos: true
+            }
+        },
+        viewer: {
+            orgWide: false,
+            hostRole: 'viewer',
+            permissions: {
+                managePos: false
+            }
+        }
+    };
+    const config = {};
+    const entitled = {
+        pos: true
+    };
+    const stripeCalls = [];
+    const stripeReplies = [];
+    let refundSeq = 0;
+    const printed = [];
+    memory.seed('hosts/shop', {
+        memberRoles: {
+            owner: 'admin',
+            cashier: 'editor',
+            cashier2: 'editor',
+            viewer: 'viewer'
+        }
+    });
+    memory.seed('hosts/other', {
+        memberRoles: {
+            owner: 'admin'
+        }
+    });
+    memory.seed('hosts/shop/registers/front', {
+        name: 'Front',
+        locationId: 'loc-1'
+    });
+    memory.seed('hosts/shop/registers/back', {
+        name: 'Back'
+    });
+    memory.seed('hosts/other/registers/theirs', {
+        name: 'Theirs'
+    });
+    const fetchDouble = async (url, init)=>{
+        var _ref, _ref1, _headers_IdempotencyKey, _stripeReplies_shift;
+        const headers = (_ref = init == null ? void 0 : init.headers) != null ? _ref : {};
+        stripeCalls.push({
+            url: String(url),
+            body: new URLSearchParams(String((_ref1 = init == null ? void 0 : init.body) != null ? _ref1 : '')),
+            idempotencyKey: (_headers_IdempotencyKey = headers['Idempotency-Key']) != null ? _headers_IdempotencyKey : null
+        });
+        const reply = (_stripeReplies_shift = stripeReplies.shift()) != null ? _stripeReplies_shift : {
+            status: 200,
+            body: {
+                id: `re_${++refundSeq}`
+            }
+        };
+        return {
+            ok: reply.status >= 200 && reply.status < 300,
+            status: reply.status,
+            json: async ()=>reply.body
+        };
+    };
+    const deps = {
+        firestore: ()=>memory.firestore,
+        verifyIdToken: async (token)=>{
+            if (!token.startsWith('token-')) throw new Error('bad token');
+            return {
+                uid: token.slice('token-'.length)
+            };
+        },
+        membership: async (uid)=>{
+            var _memberships_uid;
+            return (_memberships_uid = memberships[uid]) != null ? _memberships_uid : {
+                orgWide: false,
+                hostRole: null,
+                permissions: {}
+            };
+        },
+        orgForHost: async ()=>({
+                orgId: 'org-1',
+                org: {
+                    id: 'org-1'
+                }
+            }),
+        pluginConfig: async ()=>config,
+        posEntitled: ()=>entitled.pos,
+        signingSecret: ()=>'test-signing-secret',
+        memberName: async (uid)=>{
+            var _uid;
+            return (_uid = ({
+                owner: 'Olive Owner',
+                cashier: 'Cal Cashier'
+            })[uid]) != null ? _uid : uid;
+        },
+        now: ()=>clock.now,
+        fetch: fetchDouble,
+        printer: {
+            kickDrawer: async (input)=>{
+                printed.push({
+                    kind: 'drawer',
+                    input
+                });
+                return {
+                    jobIds: [
+                        `job-${printed.length}`
+                    ]
+                };
+            },
+            printReport: async (input)=>{
+                printed.push({
+                    kind: 'report',
+                    input
+                });
+                return {
+                    jobIds: [
+                        `job-${printed.length}`
+                    ]
+                };
+            }
+        }
+    };
+    return {
+        memory,
+        deps,
+        clock,
+        memberships,
+        config,
+        entitled,
+        stripeCalls,
+        stripeReplies,
+        printed,
+        request: (uid, body, headers = {})=>({
+                method: 'POST',
+                headers: _extends({}, uid ? {
+                    authorization: `Bearer token-${uid}`
+                } : {}, headers),
+                body,
+                query: {}
+            })
+    };
+}
+
+//# sourceMappingURL=pos-ops-harness.js.map

package/src/lib/testing/pos-ops-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/testing/pos-ops-harness.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PluginApiRequest } from '@aglyn/aglyn/server'\nimport type { PosOpsDeps, PosOpsMembership } from '../server/pos-ops-gate'\nimport { memoryFirestore, type MemoryFirestore } from './pos-ops-memory-firestore'\n\n/*==========================================\n * THE REGISTER'S ROUTES UNDER TEST (AGL-3609).\n *\n * One in-memory site — `hosts/shop`, owned by `org-1` on a plan with POS —\n * with three people: `owner` (a workspace admin), `cashier` (an editor with\n * `managePos`) and `viewer`. A token is the uid it signs in as. Stripe is a\n * counted fetch that answers what the spec tells it to, and nothing here can\n * reach the network.\n *=========================================*/\n\nexport interface PosOpsHarness {\n  memory: MemoryFirestore\n  deps: PosOpsDeps\n  /** The clock every route reads; move it to expire an assertion or a lockout. */\n  clock: { now: number }\n  /** Per-uid membership; edit to revoke `managePos` or demote someone. */\n  memberships: Record<string, PosOpsMembership>\n  config: Record<string, unknown>\n  entitled: { pos: boolean }\n  stripeCalls: Array<{ url: string; body: URLSearchParams; idempotencyKey: string | null }>\n  /** What the next Stripe call answers; a queue, then `ok` with a fresh id. */\n  stripeReplies: Array<{ status: number; body: Record<string, unknown> }>\n  /** Every drawer kick and report print the routes queued, in order. */\n  printed: Array<{ kind: 'drawer' | 'report'; input: Record<string, any> }>\n  request(uid: string | null, body: Record<string, unknown>, headers?: Record<string, string>): PluginApiRequest\n}\n\nexport function posOpsHarness(): PosOpsHarness {\n  const clock = { now: 1_800_000_000_000 }\n  const memory = memoryFirestore(() => clock.now)\n  const memberships: Record<string, PosOpsMembership> = {\n    owner: { orgWide: true, hostRole: 'admin', permissions: { managePos: true } },\n    cashier: { orgWide: false, hostRole: 'editor', permissions: { managePos: true } },\n    cashier2: { orgWide: false, hostRole: 'editor', permissions: { managePos: true } },\n    viewer: { orgWide: false, hostRole: 'viewer', permissions: { managePos: false } },\n  }\n  const config: Record<string, unknown> = {}\n  const entitled = { pos: true }\n  const stripeCalls: PosOpsHarness['stripeCalls'] = []\n  const stripeReplies: PosOpsHarness['stripeReplies'] = []\n  let refundSeq = 0\n  const printed: PosOpsHarness['printed'] = []\n  memory.seed('hosts/shop', {\n    memberRoles: { owner: 'admin', cashier: 'editor', cashier2: 'editor', viewer: 'viewer' },\n  })\n  memory.seed('hosts/other', { memberRoles: { owner: 'admin' } })\n  memory.seed('hosts/shop/registers/front', { name: 'Front', locationId: 'loc-1' })\n  memory.seed('hosts/shop/registers/back', { name: 'Back' })\n  memory.seed('hosts/other/registers/theirs', { name: 'Theirs' })\n  const fetchDouble = (async (url: string, init?: RequestInit) => {\n    const headers = (init?.headers ?? {}) as Record<string, string>\n    stripeCalls.push({\n      url: String(url),\n      body: new URLSearchParams(String(init?.body ?? '')),\n      idempotencyKey: headers['Idempotency-Key'] ?? null,\n    })\n    const reply = stripeReplies.shift() ?? { status: 200, body: { id: `re_${++refundSeq}` } }\n    return {\n      ok: reply.status >= 200 && reply.status < 300,\n      status: reply.status,\n      json: async () => reply.body,\n    } as unknown as Response\n  }) as unknown as typeof fetch\n  const deps: PosOpsDeps = {\n    firestore: () => memory.firestore,\n    verifyIdToken: async (token) => {\n      if (!token.startsWith('token-')) throw new Error('bad token')\n      return { uid: token.slice('token-'.length) }\n    },\n    membership: async (uid) =>\n      memberships[uid] ?? { orgWide: false, hostRole: null, permissions: {} },\n    orgForHost: async () => ({ orgId: 'org-1', org: { id: 'org-1' } }),\n    pluginConfig: async () => config,\n    posEntitled: () => entitled.pos,\n    signingSecret: () => 'test-signing-secret',\n    memberName: async (uid) => ({ owner: 'Olive Owner', cashier: 'Cal Cashier' } as Record<string, string>)[uid] ?? uid,\n    now: () => clock.now,\n    fetch: fetchDouble,\n    printer: {\n      kickDrawer: async (input) => {\n        printed.push({ kind: 'drawer', input })\n        return { jobIds: [`job-${printed.length}`] }\n      },\n      printReport: async (input) => {\n        printed.push({ kind: 'report', input })\n        return { jobIds: [`job-${printed.length}`] }\n      },\n    },\n  }\n  return {\n    memory,\n    deps,\n    clock,\n    memberships,\n    config,\n    entitled,\n    stripeCalls,\n    stripeReplies,\n    printed,\n    request: (uid, body, headers = {}) =>\n      ({\n        method: 'POST',\n        headers: { ...(uid ? { authorization: `Bearer token-${uid}` } : {}), ...headers },\n        body,\n        query: {},\n      }) as unknown as PluginApiRequest,\n  }\n}\n"],"names":["memoryFirestore","posOpsHarness","clock","now","memory","memberships","owner","orgWide","hostRole","permissions","managePos","cashier","cashier2","viewer","config","entitled","pos","stripeCalls","stripeReplies","refundSeq","printed","seed","memberRoles","name","locationId","fetchDouble","url","init","headers","push","String","body","URLSearchParams","idempotencyKey","reply","shift","status","id","ok","json","deps","firestore","verifyIdToken","token","startsWith","Error","uid","slice","length","membership","orgForHost","orgId","org","pluginConfig","posEntitled","signingSecret","memberName","fetch","printer","kickDrawer","input","kind","jobIds","printReport","request","method","authorization","query"],"mappings":"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"}

package/src/lib/testing/pos-ops-memory-firestore.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+type Data = Record<string, unknown>;
+interface Sentinel {
+    __sentinel: 'delete' | 'serverTimestamp' | 'arrayUnion' | 'arrayRemove' | 'increment';
+    values?: unknown[];
+    by?: number;
+}
+/** What a spec hands `jest.mock('firebase-admin/firestore', …)`. */
+export declare const memoryFirestoreModule: {
+    __esModule: boolean;
+    FieldValue: {
+        delete: () => Sentinel;
+        serverTimestamp: () => Sentinel;
+        arrayUnion: (...values: unknown[]) => Sentinel;
+        arrayRemove: (...values: unknown[]) => Sentinel;
+        increment: (by: number) => Sentinel;
+    };
+    FieldPath: {
+        documentId: () => {
+            __documentId: boolean;
+        };
+    };
+    Timestamp: {
+        fromDate: (date: Date) => number;
+    };
+};
+export interface MemoryFirestore {
+    /** Every document, by full path. */
+    docs: Map<string, Data>;
+    /** The clock `serverTimestamp` writes. */
+    now: () => number;
+    firestore: FirebaseFirestore.Firestore;
+    /** Seeds one document at its full path. */
+    seed: (path: string, data: Data) => void;
+    /** A document's data, or `undefined`. */
+    read: (path: string) => Data | undefined;
+}
+/** A fresh in-memory Firestore. */
+export declare function memoryFirestore(clock?: () => number): MemoryFirestore;
+export {};