@tier0/sdk-v2 0.0.0-stage → 0.1.0

package/dist/cjs/data/collection.js

@@ -0,0 +1,441 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Collection = exports.Cursor = exports.MAX_ATOMIC_ITEMS = exports.MAX_PAGE_SIZE = void 0;
+exports.assertAtomicBatch = assertAtomicBatch;
+exports.toDoc = toDoc;
+const error_js_1 = require("./error.js");
+const schema_js_1 = require("./schema.js");
+const sort_js_1 = require("./sort.js");
+/** UNS page limit for find / aggregate / distinct. */
+exports.MAX_PAGE_SIZE = 200;
+/**
+ * UNS commits at most 200 items in one synchronous atomic batch
+ * (insertMany, bulkWrite, data.transact).
+ */
+exports.MAX_ATOMIC_ITEMS = 200;
+/** Rejects batches UNS would refuse, before anything is sent. */
+function assertAtomicBatch(operation, count) {
+    if (count > exports.MAX_ATOMIC_ITEMS) {
+        throw new error_js_1.DataError({
+            message: `${operation} commits at most ${exports.MAX_ATOMIC_ITEMS} items atomically; got ${count}. ` +
+                `Split the input into chunks of ${exports.MAX_ATOMIC_ITEMS} (each chunk commits on its own; give each chunk a stable ` +
+                'idempotencyKey or fixed _ids so a retry is safe), or keep all-or-nothing work within one batch.',
+            status: 400,
+            code: 'BATCH_LIMIT_EXCEEDED',
+        });
+    }
+}
+function toDoc(record) {
+    return {
+        ...record.data,
+        _id: record.id,
+        _meta: { revision: record.revision, createdAt: record.createdAt, updatedAt: record.updatedAt },
+    };
+}
+/**
+ * Async-iterable result set. Pages hold at most 200 items; the page source
+ * decides whether the next page is reached by cursor or by offset page number.
+ */
+class Cursor {
+    fetchPage;
+    sortSpec;
+    limitCount;
+    projection;
+    started = false;
+    constructor(fetchPage, options = {}) {
+        this.fetchPage = fetchPage;
+        this.sortSpec = options.sort;
+        this.limitCount = options.limit;
+        this.projection = options.projection;
+    }
+    assertNotStarted() {
+        if (this.started)
+            throw new Error('Cursor options must be set before iteration starts.');
+    }
+    sort(sort) {
+        this.assertNotStarted();
+        this.sortSpec = sort;
+        return this;
+    }
+    /** Total number of documents to return (pages are fetched ≤200 at a time). */
+    limit(count) {
+        this.assertNotStarted();
+        this.limitCount = count;
+        return this;
+    }
+    project(projection) {
+        this.assertNotStarted();
+        this.projection = projection;
+        return this;
+    }
+    async *[Symbol.asyncIterator]() {
+        this.started = true;
+        const sort = (0, sort_js_1.toSortPairs)(this.sortSpec);
+        let remaining = this.limitCount ?? Number.POSITIVE_INFINITY;
+        // One page size for the whole iteration: offset pages are only stable when it never changes.
+        const size = Math.min(exports.MAX_PAGE_SIZE, remaining);
+        let token = null;
+        while (remaining > 0) {
+            const page = await this.fetchPage({ token, size, sort, projection: this.projection });
+            for (const item of page.items.slice(0, remaining))
+                yield item;
+            remaining -= page.items.length;
+            if (page.next === null || page.items.length === 0)
+                return;
+            token = page.next;
+        }
+    }
+    async toArray() {
+        const out = [];
+        for await (const item of this)
+            out.push(item);
+        return out;
+    }
+}
+exports.Cursor = Cursor;
+/** Pipelines made only of `$match` / `$sort` page by cursor; UNS requires offset paging for any other stage. */
+function isDirectPipeline(stages) {
+    return stages.every((stage) => Object.keys(stage).every((key) => key === '$match' || key === '$sort'));
+}
+function compact(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+function idsInOrder(ids) {
+    return Object.entries(ids ?? {})
+        .sort(([a], [b]) => Number(a) - Number(b))
+        .map(([, id]) => id);
+}
+function assertNoWriteErrors(result, operation, committed = {}) {
+    if (result.writeErrors && result.writeErrors.length > 0) {
+        const counts = Object.entries(committed).map(([name, value]) => `${name}=${value}`).join(', ');
+        throw new error_js_1.DataError({
+            message: `${operation} stopped on ${result.writeErrors.length} write error(s)${counts ? `; already committed: ${counts}` : ''}.`,
+            status: 409,
+            code: 'WRITE_ERRORS',
+            details: { writeErrors: result.writeErrors, committed },
+        });
+    }
+}
+class Collection {
+    definition;
+    runtime;
+    constructor(definition, runtime) {
+        this.definition = definition;
+        this.runtime = runtime;
+    }
+    get alias() {
+        return this.definition.alias;
+    }
+    /**
+     * One call with stale-ID recovery. A call continuing a cursor or
+     * resumeAfter token of the old collection is not retried: the token means
+     * nothing to a recreated collection.
+     */
+    post(operation, body, options = {}) {
+        const page = body.page;
+        const continues = typeof body.cursor === 'string' || typeof body.resumeAfter === 'string' || typeof page?.cursor === 'string';
+        return this.runtime.recover(() => this.send(operation, body, options), { retry: !continues });
+    }
+    async send(operation, body, options = {}) {
+        const collectionId = await this.runtime.resolve(this.definition);
+        return this.runtime.call(operation, { collectionId, ...compact(body) }, { dataSubject: this.runtime.subject(), ...options });
+    }
+    /* ---------------------------------- reads --------------------------------- */
+    find(filter = {}, options = {}) {
+        return new Cursor(async ({ token, size, sort, projection }) => {
+            const result = await this.post('recordFind', {
+                filter: Object.keys(filter).length > 0 ? filter : undefined,
+                sort,
+                projection,
+                limit: size,
+                cursor: typeof token === 'string' ? token : undefined,
+            });
+            return {
+                items: result.items.map((record) => toDoc(record)),
+                next: result.pageInfo.hasMore && result.pageInfo.nextCursor ? result.pageInfo.nextCursor : null,
+            };
+        }, options);
+    }
+    async findOne(filter = {}, options = {}) {
+        const [first] = await this.find(filter, { ...options, limit: 1 }).toArray();
+        return first ?? null;
+    }
+    /**
+     * One numbered page plus the total match count, for paged list screens.
+     * Uses `recordAggregatePipeline` offset paging.
+     */
+    async findPage(filter = {}, options = {}) {
+        const page = Math.max(1, Math.trunc(options.page ?? 1));
+        const pageSize = Math.min(exports.MAX_PAGE_SIZE, Math.max(1, Math.trunc(options.pageSize ?? 20)));
+        const pipeline = [];
+        if (Object.keys(filter).length > 0)
+            pipeline.push({ $match: filter });
+        const sort = (0, sort_js_1.toSortPairs)(options.sort);
+        if (sort)
+            pipeline.push({ $sort: sort });
+        if (options.projection)
+            pipeline.push({ $project: options.projection });
+        const [rows, total] = await Promise.all([
+            this.post('recordAggregatePipeline', { pipeline, page: { mode: 'offset', page, size: pageSize } }),
+            this.countDocuments(filter),
+        ]);
+        return { items: rows.items, total, page, pageSize };
+    }
+    async countDocuments(filter = {}) {
+        const result = await this.post('recordCount', {
+            filter: Object.keys(filter).length > 0 ? filter : undefined,
+        });
+        return result.count;
+    }
+    /** Distinct values of a field (every page). */
+    async distinct(field, filter = {}) {
+        const values = [];
+        for (let page = 1;; page += 1) {
+            const result = await this.post('recordDistinct', {
+                field,
+                filter: Object.keys(filter).length > 0 ? filter : undefined,
+                page: { mode: 'offset', page, size: exports.MAX_PAGE_SIZE },
+            });
+            values.push(...result.values);
+            if (!result.pageInfo.hasMore)
+                return values;
+        }
+    }
+    /**
+     * Runs a pipeline (`$match`, `$sort`, `$group`, `$project`, `$set`,
+     * `$lookup`, `$unwind`, `$skip`, `$limit`, `$count`). `$sort` accepts
+     * `{ field: 1 | -1 }`; `$lookup` takes `from` (a declared collection or
+     * alias of this App) instead of a collection ID. Rows are whatever the
+     * pipeline outputs, not wrapped records.
+     *
+     * Pipelines of only `$match` / `$sort` page by cursor; any other stage pages
+     * by offset (UNS rejects cursors for transformed results). The `$exists`,
+     * `$distinct` and `$frequencies` stages are listed in the UNS schema but not
+     * executed by the record pipeline; use `countDocuments`, `distinct` or `$group`.
+     */
+    aggregate(pipeline) {
+        // Recovery wraps stage preparation too, so a retry re-resolves `$lookup` IDs.
+        return new Cursor(({ token, size }) => this.runtime.recover(() => this.aggregatePage(pipeline, token, size), { retry: typeof token !== 'string' }));
+    }
+    async aggregatePage(pipeline, token, size) {
+        const stages = await this.prepareStages(pipeline);
+        const last = stages[stages.length - 1];
+        if (last !== undefined && '$count' in last) {
+            // A final $count returns one row and forbids an explicit page.
+            const result = await this.send('recordAggregatePipeline', { pipeline: stages });
+            return { items: result.items, next: null };
+        }
+        if (isDirectPipeline(stages)) {
+            const result = await this.send('recordAggregatePipeline', {
+                pipeline: stages,
+                page: { mode: 'cursor', size, ...(typeof token === 'string' ? { cursor: token } : {}) },
+            });
+            return { items: result.items, next: result.pageInfo.hasMore && result.pageInfo.nextCursor ? result.pageInfo.nextCursor : null };
+        }
+        const page = typeof token === 'number' ? token : 1;
+        const result = await this.send('recordAggregatePipeline', {
+            pipeline: stages,
+            page: { mode: 'offset', page, size },
+        });
+        return {
+            items: result.items,
+            next: result.pageInfo.hasMore ? (result.pageInfo.nextPage ?? page + 1) : null,
+        };
+    }
+    /** Converts Mongo-style `$sort` objects and resolves `$lookup.from`, recursively. */
+    async prepareStages(pipeline) {
+        return Promise.all(pipeline.map(async (stage) => {
+            if ('$sort' in stage && !Array.isArray(stage.$sort)) {
+                return { ...stage, $sort: (0, sort_js_1.toSortPairs)(stage.$sort) };
+            }
+            if ('$lookup' in stage && stage.$lookup && typeof stage.$lookup === 'object') {
+                const { from, pipeline: inner, ...lookup } = stage.$lookup;
+                const resolved = { ...lookup };
+                if (from !== undefined)
+                    resolved.collectionId = await this.runtime.resolve(from);
+                if (Array.isArray(inner))
+                    resolved.pipeline = await this.prepareStages(inner);
+                return { ...stage, $lookup: resolved };
+            }
+            return stage;
+        }));
+    }
+    /* --------------------------------- writes --------------------------------- */
+    async insertOne(document, options = {}) {
+        const { id, data } = (0, schema_js_1.validateDocument)(this.definition, document);
+        const result = await this.post('recordInsertOne', { id, data, idempotencyKey: options.idempotencyKey });
+        return { insertedId: result.insertedId };
+    }
+    /** Inserts up to 200 documents atomically (all or none). */
+    async insertMany(documents, options = {}) {
+        if (documents.length === 0)
+            return { insertedCount: 0, insertedIds: [] };
+        assertAtomicBatch('insertMany', documents.length);
+        const prepared = documents.map((document) => (0, schema_js_1.validateDocument)(this.definition, document));
+        const result = await this.post('recordInsertMany', {
+            documents: prepared.map(({ id, data }) => compact({ id, data })),
+            ordered: true,
+            atomic: true,
+            idempotencyKey: options.idempotencyKey,
+        });
+        assertNoWriteErrors(result, 'insertMany');
+        return { insertedCount: result.insertedCount ?? 0, insertedIds: idsInOrder(result.insertedIds) };
+    }
+    async updateOne(filter, update, options = {}) {
+        const result = await this.post('recordUpdateOne', {
+            filter,
+            update: (0, schema_js_1.validateUpdate)(this.definition, update),
+            upsert: options.upsert,
+            expectedRevision: options.expectedRevision,
+            sort: (0, sort_js_1.toSortPairs)(options.sort),
+            arrayFilters: options.arrayFilters,
+            idempotencyKey: options.idempotencyKey,
+        });
+        return { matchedCount: result.matchedCount ?? 0, modifiedCount: result.modifiedCount ?? 0, upsertedId: result.upsertedId ?? null };
+    }
+    /**
+     * Updates every match like Mongo's updateMany: documents commit one by one
+     * (not atomically), following `resumeAfter` until every match is processed.
+     * A failure stops the run and reports the counts already committed. For
+     * all-or-nothing multi-document changes use `data.transact` (≤200 items).
+     */
+    async updateMany(filter, update, options = {}) {
+        const validated = (0, schema_js_1.validateUpdate)(this.definition, update);
+        let matchedCount = 0;
+        let modifiedCount = 0;
+        let resumeAfter;
+        do {
+            const result = await this.post('recordUpdateMany', {
+                filter,
+                update: validated,
+                arrayFilters: options.arrayFilters,
+                atomic: false,
+                resumeAfter,
+            });
+            matchedCount += result.matchedCount ?? 0;
+            modifiedCount += result.modifiedCount ?? 0;
+            assertNoWriteErrors(result, 'updateMany', { matchedCount, modifiedCount });
+            resumeAfter = result.hasMore && result.resumeAfter ? result.resumeAfter : undefined;
+        } while (resumeAfter);
+        return { matchedCount, modifiedCount };
+    }
+    /**
+     * Replaces the whole body. Fields written by another App version and not in
+     * this declaration are lost — prefer `updateOne` with `$set`.
+     */
+    async replaceOne(filter, replacement, options = {}) {
+        const { data } = (0, schema_js_1.validateDocument)(this.definition, replacement);
+        const result = await this.post('recordReplaceOne', {
+            filter,
+            replacement: data,
+            upsert: options.upsert,
+            expectedRevision: options.expectedRevision,
+            sort: (0, sort_js_1.toSortPairs)(options.sort),
+            idempotencyKey: options.idempotencyKey,
+        });
+        return { matchedCount: result.matchedCount ?? 0, modifiedCount: result.modifiedCount ?? 0, upsertedId: result.upsertedId ?? null };
+    }
+    /** Soft-deletes one record; requires `uns.delete` on the App key. */
+    async deleteOne(filter, options = {}) {
+        const result = await this.post('recordDeleteOne', { filter, expectedRevision: options.expectedRevision, sort: (0, sort_js_1.toSortPairs)(options.sort), idempotencyKey: options.idempotencyKey });
+        return { deletedCount: result.deletedCount ?? 0 };
+    }
+    /**
+     * Soft-deletes every match, one document at a time like Mongo's deleteMany
+     * (not atomic), following `resumeAfter`; requires `uns.delete` on the App key.
+     */
+    async deleteMany(filter) {
+        let deletedCount = 0;
+        let resumeAfter;
+        do {
+            const result = await this.post('recordDeleteMany', { filter, atomic: false, resumeAfter });
+            deletedCount += result.deletedCount ?? 0;
+            assertNoWriteErrors(result, 'deleteMany', { deletedCount });
+            resumeAfter = result.hasMore && result.resumeAfter ? result.resumeAfter : undefined;
+        } while (resumeAfter);
+        return { deletedCount };
+    }
+    /**
+     * Atomic read-modify-write. A state transition puts the expected state in
+     * the filter: `findOneAndUpdate({ _id, status: "DRAFT" }, { $set: { status: "SUBMITTED" } })`
+     * returns null when another request moved the record first.
+     */
+    async findOneAndUpdate(filter, update, options = {}) {
+        const result = await this.post('recordFindOneAndUpdate', {
+            filter,
+            update: (0, schema_js_1.validateUpdate)(this.definition, update),
+            upsert: options.upsert,
+            expectedRevision: options.expectedRevision,
+            sort: (0, sort_js_1.toSortPairs)(options.sort),
+            arrayFilters: options.arrayFilters,
+            returnDocument: options.returnDocument ?? 'after',
+            projection: options.projection,
+            idempotencyKey: options.idempotencyKey,
+        });
+        return result.value ? toDoc(result.value) : null;
+    }
+    async findOneAndReplace(filter, replacement, options = {}) {
+        const { data } = (0, schema_js_1.validateDocument)(this.definition, replacement);
+        const result = await this.post('recordFindOneAndReplace', {
+            filter,
+            replacement: data,
+            upsert: options.upsert,
+            expectedRevision: options.expectedRevision,
+            sort: (0, sort_js_1.toSortPairs)(options.sort),
+            returnDocument: options.returnDocument ?? 'after',
+            projection: options.projection,
+            idempotencyKey: options.idempotencyKey,
+        });
+        return result.value ? toDoc(result.value) : null;
+    }
+    async findOneAndDelete(filter, options = {}) {
+        const result = await this.post('recordFindOneAndDelete', {
+            filter,
+            expectedRevision: options.expectedRevision,
+            sort: (0, sort_js_1.toSortPairs)(options.sort),
+            projection: options.projection,
+            idempotencyKey: options.idempotencyKey,
+        });
+        return result.value ? toDoc(result.value) : null;
+    }
+    /** Up to 200 mixed single-record writes in one atomic call (insertOne / updateOne / replaceOne / deleteOne). */
+    async bulkWrite(operations, options = {}) {
+        assertAtomicBatch('bulkWrite', operations.length);
+        const mapped = operations.map((operation) => {
+            if ('insertOne' in operation) {
+                const { id, data } = (0, schema_js_1.validateDocument)(this.definition, operation.insertOne.document);
+                return { insertOne: compact({ id, data }) };
+            }
+            if ('updateOne' in operation) {
+                const { filter, update, upsert, sort } = operation.updateOne;
+                return { updateOne: compact({ filter, update: (0, schema_js_1.validateUpdate)(this.definition, update), upsert, sort: (0, sort_js_1.toSortPairs)(sort) }) };
+            }
+            if ('replaceOne' in operation) {
+                const { filter, replacement, upsert, sort } = operation.replaceOne;
+                const { data } = (0, schema_js_1.validateDocument)(this.definition, replacement);
+                return { replaceOne: compact({ filter, replacement: data, upsert, sort: (0, sort_js_1.toSortPairs)(sort) }) };
+            }
+            if ('deleteOne' in operation) {
+                return { deleteOne: compact({ filter: operation.deleteOne.filter, sort: (0, sort_js_1.toSortPairs)(operation.deleteOne.sort) }) };
+            }
+            throw new Error(`Unsupported bulkWrite operation ${Object.keys(operation).join(', ')}; use updateMany() / deleteMany() or data.transact().`);
+        });
+        if (mapped.length === 0) {
+            return { insertedCount: 0, matchedCount: 0, modifiedCount: 0, deletedCount: 0, upsertedCount: 0, insertedIds: {}, upsertedIds: {} };
+        }
+        const result = await this.post('recordBulkWrite', { operations: mapped, ordered: true, atomic: true, idempotencyKey: options.idempotencyKey });
+        assertNoWriteErrors(result, 'bulkWrite');
+        const numericKeys = (ids) => Object.fromEntries(Object.entries(ids ?? {}).map(([index, id]) => [Number(index), id]));
+        return {
+            insertedCount: result.insertedCount ?? 0,
+            matchedCount: result.matchedCount ?? 0,
+            modifiedCount: result.modifiedCount ?? 0,
+            deletedCount: result.deletedCount ?? 0,
+            upsertedCount: result.upsertedCount ?? 0,
+            insertedIds: numericKeys(result.insertedIds),
+            upsertedIds: numericKeys(result.upsertedIds),
+        };
+    }
+}
+exports.Collection = Collection;
+//# sourceMappingURL=collection.js.map

package/dist/cjs/data/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../../src/data/collection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mongo-driver-style collection handle over the UNS record operations\n * (`recordFind`, `recordInsertMany`, ...).\n *\n * Stored records `{ id, data, revision, createdAt, updatedAt }` are exposed as\n * flat documents `{ _id, ...data, _meta: { revision, createdAt, updatedAt } }`;\n * filters, sorts and projections use the same paths (`status`,\n * `customer.id`, `_id`, `_meta.updatedAt`).\n */\nimport type { UnsV2OperationName } from '../uns-v2/generated.js';\nimport type { CallOptions, DataCall } from './call.js';\nimport type { CollectionDefinition, RecordMeta } from './define.js';\nimport { DataError } from './error.js';\nimport { validateDocument, validateUpdate } from './schema.js';\nimport { toSortPairs, type Filter, type Sort, type SortPairs } from './sort.js';\n\n/** UNS page limit for find / aggregate / distinct. */\nexport const MAX_PAGE_SIZE = 200;\n\n/**\n * UNS commits at most 200 items in one synchronous atomic batch\n * (insertMany, bulkWrite, data.transact).\n */\nexport const MAX_ATOMIC_ITEMS = 200;\n\nexport type WithMeta<T> = T & { _id: string; _meta: RecordMeta };\nexport type Projection = Record<string, 0 | 1 | boolean>;\nexport type Update = Record<string, unknown>;\n\nexport interface UnsRecord {\n  id: string;\n  data: Record<string, unknown>;\n  revision: number;\n  createdAt: number;\n  updatedAt: number;\n}\n\ninterface PageInfo {\n  hasMore: boolean;\n  nextCursor?: string | null;\n  nextPage?: number | null;\n}\n\n/** Position of the next page: an opaque cursor or a 1-based offset page number. */\ntype PageToken = string | number;\n\ninterface Page<T> {\n  items: T[];\n  /** Token of the following page; null when this was the last one. */\n  next: PageToken | null;\n}\n\ninterface WriteResult {\n  matchedCount?: number;\n  modifiedCount?: number;\n  deletedCount?: number;\n  insertedCount?: number;\n  upsertedId?: string | null;\n  insertedIds?: Record<string, string>;\n  upsertedIds?: Record<string, string>;\n  upsertedCount?: number;\n  writeErrors?: unknown[];\n  hasMore?: boolean;\n  resumeAfter?: string | null;\n}\n\n/** Runtime services a collection handle needs from its client. */\nexport interface CollectionRuntime {\n  call: DataCall;\n  /** Collection ID of a declaration or declared alias, ensuring all declarations first. */\n  resolve(target: CollectionDefinition | string): Promise<string>;\n  /** Runs a call, re-ensuring and retrying once when its collection ID went stale (see bootstrap). */\n  recover<R>(fn: () => Promise<R>, options?: { retry?: boolean }): Promise<R>;\n  /** Data subject of the request being served. */\n  subject(): string | undefined;\n}\n\n/** Rejects batches UNS would refuse, before anything is sent. */\nexport function assertAtomicBatch(operation: string, count: number) {\n  if (count > MAX_ATOMIC_ITEMS) {\n    throw new DataError({\n      message:\n        `${operation} commits at most ${MAX_ATOMIC_ITEMS} items atomically; got ${count}. ` +\n        `Split the input into chunks of ${MAX_ATOMIC_ITEMS} (each chunk commits on its own; give each chunk a stable ` +\n        'idempotencyKey or fixed _ids so a retry is safe), or keep all-or-nothing work within one batch.',\n      status: 400,\n      code: 'BATCH_LIMIT_EXCEEDED',\n    });\n  }\n}\n\nexport function toDoc<T>(record: UnsRecord): WithMeta<T> {\n  return {\n    ...(record.data as T),\n    _id: record.id,\n    _meta: { revision: record.revision, createdAt: record.createdAt, updatedAt: record.updatedAt },\n  };\n}\n\n/**\n * Async-iterable result set. Pages hold at most 200 items; the page source\n * decides whether the next page is reached by cursor or by offset page number.\n */\nexport class Cursor<T> implements AsyncIterable<T> {\n  private sortSpec?: Sort;\n  private limitCount?: number;\n  private projection?: Projection;\n  private started = false;\n\n  constructor(\n    private readonly fetchPage: (state: {\n      token: PageToken | null;\n      size: number;\n      sort?: SortPairs;\n      projection?: Projection;\n    }) => Promise<Page<T>>,\n    options: { sort?: Sort; limit?: number; projection?: Projection } = {},\n  ) {\n    this.sortSpec = options.sort;\n    this.limitCount = options.limit;\n    this.projection = options.projection;\n  }\n\n  private assertNotStarted() {\n    if (this.started) throw new Error('Cursor options must be set before iteration starts.');\n  }\n\n  sort(sort: Sort): this {\n    this.assertNotStarted();\n    this.sortSpec = sort;\n    return this;\n  }\n\n  /** Total number of documents to return (pages are fetched ≤200 at a time). */\n  limit(count: number): this {\n    this.assertNotStarted();\n    this.limitCount = count;\n    return this;\n  }\n\n  project(projection: Projection): this {\n    this.assertNotStarted();\n    this.projection = projection;\n    return this;\n  }\n\n  async *[Symbol.asyncIterator](): AsyncIterator<T> {\n    this.started = true;\n    const sort = toSortPairs(this.sortSpec);\n    let remaining = this.limitCount ?? Number.POSITIVE_INFINITY;\n    // One page size for the whole iteration: offset pages are only stable when it never changes.\n    const size = Math.min(MAX_PAGE_SIZE, remaining);\n    let token: PageToken | null = null;\n    while (remaining > 0) {\n      const page = await this.fetchPage({ token, size, sort, projection: this.projection });\n      for (const item of page.items.slice(0, remaining)) yield item;\n      remaining -= page.items.length;\n      if (page.next === null || page.items.length === 0) return;\n      token = page.next;\n    }\n  }\n\n  async toArray(): Promise<T[]> {\n    const out: T[] = [];\n    for await (const item of this) out.push(item);\n    return out;\n  }\n}\n\n/** Pipelines made only of `$match` / `$sort` page by cursor; UNS requires offset paging for any other stage. */\nfunction isDirectPipeline(stages: readonly Record<string, unknown>[]): boolean {\n  return stages.every((stage) => Object.keys(stage).every((key) => key === '$match' || key === '$sort'));\n}\n\nexport interface FindOptions {\n  sort?: Sort;\n  limit?: number;\n  projection?: Projection;\n}\n\nexport interface FindPageOptions {\n  sort?: Sort;\n  /** 1-based page number. */\n  page?: number;\n  /** At most 200. */\n  pageSize?: number;\n  projection?: Projection;\n}\n\nexport interface UpdateOptions {\n  upsert?: boolean;\n  /** Reject the write with VERSION_CONFLICT unless the record is at this revision. */\n  expectedRevision?: number;\n  sort?: Sort;\n  arrayFilters?: Record<string, unknown>[];\n  idempotencyKey?: string;\n}\n\nexport interface FindOneAndOptions extends UpdateOptions {\n  returnDocument?: 'before' | 'after';\n  projection?: Projection;\n}\n\nexport type BulkOperation =\n  | { insertOne: { document: Record<string, unknown> } }\n  | { updateOne: { filter: Filter; update: Update; upsert?: boolean; sort?: Sort } }\n  | { replaceOne: { filter: Filter; replacement: Record<string, unknown>; upsert?: boolean; sort?: Sort } }\n  | { deleteOne: { filter: Filter; sort?: Sort } };\n\nfunction compact<T extends Record<string, unknown>>(value: T): T {\n  return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined)) as T;\n}\n\nfunction idsInOrder(ids: Record<string, string> | undefined): string[] {\n  return Object.entries(ids ?? {})\n    .sort(([a], [b]) => Number(a) - Number(b))\n    .map(([, id]) => id);\n}\n\nfunction assertNoWriteErrors(result: WriteResult, operation: string, committed: Record<string, number> = {}) {\n  if (result.writeErrors && result.writeErrors.length > 0) {\n    const counts = Object.entries(committed).map(([name, value]) => `${name}=${value}`).join(', ');\n    throw new DataError({\n      message: `${operation} stopped on ${result.writeErrors.length} write error(s)${counts ? `; already committed: ${counts}` : ''}.`,\n      status: 409,\n      code: 'WRITE_ERRORS',\n      details: { writeErrors: result.writeErrors, committed },\n    });\n  }\n}\n\nexport class Collection<T extends object = Record<string, unknown>, TInput extends object = T> {\n  constructor(\n    readonly definition: CollectionDefinition,\n    private readonly runtime: CollectionRuntime,\n  ) {}\n\n  get alias(): string {\n    return this.definition.alias;\n  }\n\n  /**\n   * One call with stale-ID recovery. A call continuing a cursor or\n   * resumeAfter token of the old collection is not retried: the token means\n   * nothing to a recreated collection.\n   */\n  private post<R>(operation: UnsV2OperationName, body: Record<string, unknown>, options: CallOptions = {}): Promise<R> {\n    const page = body.page as { cursor?: unknown } | undefined;\n    const continues = typeof body.cursor === 'string' || typeof body.resumeAfter === 'string' || typeof page?.cursor === 'string';\n    return this.runtime.recover(() => this.send<R>(operation, body, options), { retry: !continues });\n  }\n\n  private async send<R>(operation: UnsV2OperationName, body: Record<string, unknown>, options: CallOptions = {}): Promise<R> {\n    const collectionId = await this.runtime.resolve(this.definition);\n    return this.runtime.call<R>(operation, { collectionId, ...compact(body) }, { dataSubject: this.runtime.subject(), ...options });\n  }\n\n  /* ---------------------------------- reads --------------------------------- */\n\n  find(filter: Filter = {}, options: FindOptions = {}): Cursor<WithMeta<T>> {\n    return new Cursor<WithMeta<T>>(async ({ token, size, sort, projection }) => {\n      const result = await this.post<{ items: UnsRecord[]; pageInfo: PageInfo }>('recordFind', {\n        filter: Object.keys(filter).length > 0 ? filter : undefined,\n        sort,\n        projection,\n        limit: size,\n        cursor: typeof token === 'string' ? token : undefined,\n      });\n      return {\n        items: result.items.map((record) => toDoc<T>(record)),\n        next: result.pageInfo.hasMore && result.pageInfo.nextCursor ? result.pageInfo.nextCursor : null,\n      };\n    }, options);\n  }\n\n  async findOne(filter: Filter = {}, options: Omit<FindOptions, 'limit'> = {}): Promise<WithMeta<T> | null> {\n    const [first] = await this.find(filter, { ...options, limit: 1 }).toArray();\n    return first ?? null;\n  }\n\n  /**\n   * One numbered page plus the total match count, for paged list screens.\n   * Uses `recordAggregatePipeline` offset paging.\n   */\n  async findPage(\n    filter: Filter = {},\n    options: FindPageOptions = {},\n  ): Promise<{ items: WithMeta<T>[]; total: number; page: number; pageSize: number }> {\n    const page = Math.max(1, Math.trunc(options.page ?? 1));\n    const pageSize = Math.min(MAX_PAGE_SIZE, Math.max(1, Math.trunc(options.pageSize ?? 20)));\n    const pipeline: Record<string, unknown>[] = [];\n    if (Object.keys(filter).length > 0) pipeline.push({ $match: filter });\n    const sort = toSortPairs(options.sort);\n    if (sort) pipeline.push({ $sort: sort });\n    if (options.projection) pipeline.push({ $project: options.projection });\n    const [rows, total] = await Promise.all([\n      this.post<{ items: WithMeta<T>[] }>('recordAggregatePipeline', { pipeline, page: { mode: 'offset', page, size: pageSize } }),\n      this.countDocuments(filter),\n    ]);\n    return { items: rows.items, total, page, pageSize };\n  }\n\n  async countDocuments(filter: Filter = {}): Promise<number> {\n    const result = await this.post<{ count: number }>('recordCount', {\n      filter: Object.keys(filter).length > 0 ? filter : undefined,\n    });\n    return result.count;\n  }\n\n  /** Distinct values of a field (every page). */\n  async distinct(field: string, filter: Filter = {}): Promise<unknown[]> {\n    const values: unknown[] = [];\n    for (let page = 1; ; page += 1) {\n      const result = await this.post<{ values: unknown[]; pageInfo: PageInfo }>('recordDistinct', {\n        field,\n        filter: Object.keys(filter).length > 0 ? filter : undefined,\n        page: { mode: 'offset', page, size: MAX_PAGE_SIZE },\n      });\n      values.push(...result.values);\n      if (!result.pageInfo.hasMore) return values;\n    }\n  }\n\n  /**\n   * Runs a pipeline (`$match`, `$sort`, `$group`, `$project`, `$set`,\n   * `$lookup`, `$unwind`, `$skip`, `$limit`, `$count`). `$sort` accepts\n   * `{ field: 1 | -1 }`; `$lookup` takes `from` (a declared collection or\n   * alias of this App) instead of a collection ID. Rows are whatever the\n   * pipeline outputs, not wrapped records.\n   *\n   * Pipelines of only `$match` / `$sort` page by cursor; any other stage pages\n   * by offset (UNS rejects cursors for transformed results). The `$exists`,\n   * `$distinct` and `$frequencies` stages are listed in the UNS schema but not\n   * executed by the record pipeline; use `countDocuments`, `distinct` or `$group`.\n   */\n  aggregate<R = Record<string, unknown>>(pipeline: Record<string, unknown>[]): Cursor<R> {\n    // Recovery wraps stage preparation too, so a retry re-resolves `$lookup` IDs.\n    return new Cursor<R>(({ token, size }) => this.runtime.recover(() => this.aggregatePage<R>(pipeline, token, size), { retry: typeof token !== 'string' }));\n  }\n\n  private async aggregatePage<R>(\n    pipeline: Record<string, unknown>[],\n    token: PageToken | null,\n    size: number,\n  ): Promise<Page<R>> {\n    const stages = await this.prepareStages(pipeline);\n    const last = stages[stages.length - 1];\n    if (last !== undefined && '$count' in last) {\n      // A final $count returns one row and forbids an explicit page.\n      const result = await this.send<{ items: R[] }>('recordAggregatePipeline', { pipeline: stages });\n      return { items: result.items, next: null };\n    }\n    if (isDirectPipeline(stages)) {\n      const result = await this.send<{ items: R[]; pageInfo: PageInfo }>('recordAggregatePipeline', {\n        pipeline: stages,\n        page: { mode: 'cursor', size, ...(typeof token === 'string' ? { cursor: token } : {}) },\n      });\n      return { items: result.items, next: result.pageInfo.hasMore && result.pageInfo.nextCursor ? result.pageInfo.nextCursor : null };\n    }\n    const page = typeof token === 'number' ? token : 1;\n    const result = await this.send<{ items: R[]; pageInfo: PageInfo }>('recordAggregatePipeline', {\n      pipeline: stages,\n      page: { mode: 'offset', page, size },\n    });\n    return {\n      items: result.items,\n      next: result.pageInfo.hasMore ? (result.pageInfo.nextPage ?? page + 1) : null,\n    };\n  }\n\n  /** Converts Mongo-style `$sort` objects and resolves `$lookup.from`, recursively. */\n  private async prepareStages(pipeline: readonly Record<string, unknown>[]): Promise<Record<string, unknown>[]> {\n    return Promise.all(\n      pipeline.map(async (stage) => {\n        if ('$sort' in stage && !Array.isArray(stage.$sort)) {\n          return { ...stage, $sort: toSortPairs(stage.$sort as Sort) };\n        }\n        if ('$lookup' in stage && stage.$lookup && typeof stage.$lookup === 'object') {\n          const { from, pipeline: inner, ...lookup } = stage.$lookup as Record<string, unknown>;\n          const resolved: Record<string, unknown> = { ...lookup };\n          if (from !== undefined) resolved.collectionId = await this.runtime.resolve(from as CollectionDefinition | string);\n          if (Array.isArray(inner)) resolved.pipeline = await this.prepareStages(inner as Record<string, unknown>[]);\n          return { ...stage, $lookup: resolved };\n        }\n        return stage;\n      }),\n    );\n  }\n\n  /* --------------------------------- writes --------------------------------- */\n\n  async insertOne(document: TInput & { _id?: string }, options: { idempotencyKey?: string } = {}): Promise<{ insertedId: string }> {\n    const { id, data } = validateDocument(this.definition, document as Record<string, unknown>);\n    const result = await this.post<{ insertedId: string }>('recordInsertOne', { id, data, idempotencyKey: options.idempotencyKey });\n    return { insertedId: result.insertedId };\n  }\n\n  /** Inserts up to 200 documents atomically (all or none). */\n  async insertMany(\n    documents: readonly (TInput & { _id?: string })[],\n    options: { idempotencyKey?: string } = {},\n  ): Promise<{ insertedCount: number; insertedIds: string[] }> {\n    if (documents.length === 0) return { insertedCount: 0, insertedIds: [] };\n    assertAtomicBatch('insertMany', documents.length);\n    const prepared = documents.map((document) => validateDocument(this.definition, document as Record<string, unknown>));\n    const result = await this.post<WriteResult>('recordInsertMany', {\n      documents: prepared.map(({ id, data }) => compact({ id, data })),\n      ordered: true,\n      atomic: true,\n      idempotencyKey: options.idempotencyKey,\n    });\n    assertNoWriteErrors(result, 'insertMany');\n    return { insertedCount: result.insertedCount ?? 0, insertedIds: idsInOrder(result.insertedIds) };\n  }\n\n  async updateOne(\n    filter: Filter,\n    update: Update,\n    options: UpdateOptions = {},\n  ): Promise<{ matchedCount: number; modifiedCount: number; upsertedId: string | null }> {\n    const result = await this.post<WriteResult>('recordUpdateOne', {\n      filter,\n      update: validateUpdate(this.definition, update),\n      upsert: options.upsert,\n      expectedRevision: options.expectedRevision,\n      sort: toSortPairs(options.sort),\n      arrayFilters: options.arrayFilters,\n      idempotencyKey: options.idempotencyKey,\n    });\n    return { matchedCount: result.matchedCount ?? 0, modifiedCount: result.modifiedCount ?? 0, upsertedId: result.upsertedId ?? null };\n  }\n\n  /**\n   * Updates every match like Mongo's updateMany: documents commit one by one\n   * (not atomically), following `resumeAfter` until every match is processed.\n   * A failure stops the run and reports the counts already committed. For\n   * all-or-nothing multi-document changes use `data.transact` (≤200 items).\n   */\n  async updateMany(\n    filter: Filter,\n    update: Update,\n    options: Pick<UpdateOptions, 'arrayFilters'> = {},\n  ): Promise<{ matchedCount: number; modifiedCount: number }> {\n    const validated = validateUpdate(this.definition, update);\n    let matchedCount = 0;\n    let modifiedCount = 0;\n    let resumeAfter: string | undefined;\n    do {\n      const result: WriteResult = await this.post<WriteResult>('recordUpdateMany', {\n        filter,\n        update: validated,\n        arrayFilters: options.arrayFilters,\n        atomic: false,\n        resumeAfter,\n      });\n      matchedCount += result.matchedCount ?? 0;\n      modifiedCount += result.modifiedCount ?? 0;\n      assertNoWriteErrors(result, 'updateMany', { matchedCount, modifiedCount });\n      resumeAfter = result.hasMore && result.resumeAfter ? result.resumeAfter : undefined;\n    } while (resumeAfter);\n    return { matchedCount, modifiedCount };\n  }\n\n  /**\n   * Replaces the whole body. Fields written by another App version and not in\n   * this declaration are lost — prefer `updateOne` with `$set`.\n   */\n  async replaceOne(\n    filter: Filter,\n    replacement: TInput,\n    options: Omit<UpdateOptions, 'arrayFilters'> = {},\n  ): Promise<{ matchedCount: number; modifiedCount: number; upsertedId: string | null }> {\n    const { data } = validateDocument(this.definition, replacement as Record<string, unknown>);\n    const result = await this.post<WriteResult>('recordReplaceOne', {\n      filter,\n      replacement: data,\n      upsert: options.upsert,\n      expectedRevision: options.expectedRevision,\n      sort: toSortPairs(options.sort),\n      idempotencyKey: options.idempotencyKey,\n    });\n    return { matchedCount: result.matchedCount ?? 0, modifiedCount: result.modifiedCount ?? 0, upsertedId: result.upsertedId ?? null };\n  }\n\n  /** Soft-deletes one record; requires `uns.delete` on the App key. */\n  async deleteOne(filter: Filter, options: Pick<UpdateOptions, 'expectedRevision' | 'sort' | 'idempotencyKey'> = {}): Promise<{ deletedCount: number }> {\n    const result = await this.post<WriteResult>(\n      'recordDeleteOne',\n      { filter, expectedRevision: options.expectedRevision, sort: toSortPairs(options.sort), idempotencyKey: options.idempotencyKey },\n    );\n    return { deletedCount: result.deletedCount ?? 0 };\n  }\n\n  /**\n   * Soft-deletes every match, one document at a time like Mongo's deleteMany\n   * (not atomic), following `resumeAfter`; requires `uns.delete` on the App key.\n   */\n  async deleteMany(filter: Filter): Promise<{ deletedCount: number }> {\n    let deletedCount = 0;\n    let resumeAfter: string | undefined;\n    do {\n      const result: WriteResult = await this.post<WriteResult>('recordDeleteMany', { filter, atomic: false, resumeAfter });\n      deletedCount += result.deletedCount ?? 0;\n      assertNoWriteErrors(result, 'deleteMany', { deletedCount });\n      resumeAfter = result.hasMore && result.resumeAfter ? result.resumeAfter : undefined;\n    } while (resumeAfter);\n    return { deletedCount };\n  }\n\n  /**\n   * Atomic read-modify-write. A state transition puts the expected state in\n   * the filter: `findOneAndUpdate({ _id, status: \"DRAFT\" }, { $set: { status: \"SUBMITTED\" } })`\n   * returns null when another request moved the record first.\n   */\n  async findOneAndUpdate(filter: Filter, update: Update, options: FindOneAndOptions = {}): Promise<WithMeta<T> | null> {\n    const result = await this.post<{ value: UnsRecord | null }>('recordFindOneAndUpdate', {\n      filter,\n      update: validateUpdate(this.definition, update),\n      upsert: options.upsert,\n      expectedRevision: options.expectedRevision,\n      sort: toSortPairs(options.sort),\n      arrayFilters: options.arrayFilters,\n      returnDocument: options.returnDocument ?? 'after',\n      projection: options.projection,\n      idempotencyKey: options.idempotencyKey,\n    });\n    return result.value ? toDoc<T>(result.value) : null;\n  }\n\n  async findOneAndReplace(\n    filter: Filter,\n    replacement: TInput,\n    options: Omit<FindOneAndOptions, 'arrayFilters'> = {},\n  ): Promise<WithMeta<T> | null> {\n    const { data } = validateDocument(this.definition, replacement as Record<string, unknown>);\n    const result = await this.post<{ value: UnsRecord | null }>('recordFindOneAndReplace', {\n      filter,\n      replacement: data,\n      upsert: options.upsert,\n      expectedRevision: options.expectedRevision,\n      sort: toSortPairs(options.sort),\n      returnDocument: options.returnDocument ?? 'after',\n      projection: options.projection,\n      idempotencyKey: options.idempotencyKey,\n    });\n    return result.value ? toDoc<T>(result.value) : null;\n  }\n\n  async findOneAndDelete(\n    filter: Filter,\n    options: Pick<FindOneAndOptions, 'expectedRevision' | 'sort' | 'projection' | 'idempotencyKey'> = {},\n  ): Promise<WithMeta<T> | null> {\n    const result = await this.post<{ value: UnsRecord | null }>(\n      'recordFindOneAndDelete',\n      {\n        filter,\n        expectedRevision: options.expectedRevision,\n        sort: toSortPairs(options.sort),\n        projection: options.projection,\n        idempotencyKey: options.idempotencyKey,\n      },\n    );\n    return result.value ? toDoc<T>(result.value) : null;\n  }\n\n  /** Up to 200 mixed single-record writes in one atomic call (insertOne / updateOne / replaceOne / deleteOne). */\n  async bulkWrite(\n    operations: readonly BulkOperation[],\n    options: { idempotencyKey?: string } = {},\n  ): Promise<{\n    insertedCount: number;\n    matchedCount: number;\n    modifiedCount: number;\n    deletedCount: number;\n    upsertedCount: number;\n    insertedIds: Record<number, string>;\n    upsertedIds: Record<number, string>;\n  }> {\n    assertAtomicBatch('bulkWrite', operations.length);\n    const mapped = operations.map((operation) => {\n      if ('insertOne' in operation) {\n        const { id, data } = validateDocument(this.definition, operation.insertOne.document);\n        return { insertOne: compact({ id, data }) };\n      }\n      if ('updateOne' in operation) {\n        const { filter, update, upsert, sort } = operation.updateOne;\n        return { updateOne: compact({ filter, update: validateUpdate(this.definition, update), upsert, sort: toSortPairs(sort) }) };\n      }\n      if ('replaceOne' in operation) {\n        const { filter, replacement, upsert, sort } = operation.replaceOne;\n        const { data } = validateDocument(this.definition, replacement);\n        return { replaceOne: compact({ filter, replacement: data, upsert, sort: toSortPairs(sort) }) };\n      }\n      if ('deleteOne' in operation) {\n        return { deleteOne: compact({ filter: operation.deleteOne.filter, sort: toSortPairs(operation.deleteOne.sort) }) };\n      }\n      throw new Error(\n        `Unsupported bulkWrite operation ${Object.keys(operation).join(', ')}; use updateMany() / deleteMany() or data.transact().`,\n      );\n    });\n    if (mapped.length === 0) {\n      return { insertedCount: 0, matchedCount: 0, modifiedCount: 0, deletedCount: 0, upsertedCount: 0, insertedIds: {}, upsertedIds: {} };\n    }\n    const result = await this.post<WriteResult>(\n      'recordBulkWrite',\n      { operations: mapped, ordered: true, atomic: true, idempotencyKey: options.idempotencyKey },\n    );\n    assertNoWriteErrors(result, 'bulkWrite');\n    const numericKeys = (ids: Record<string, string> | undefined) =>\n      Object.fromEntries(Object.entries(ids ?? {}).map(([index, id]) => [Number(index), id]));\n    return {\n      insertedCount: result.insertedCount ?? 0,\n      matchedCount: result.matchedCount ?? 0,\n      modifiedCount: result.modifiedCount ?? 0,\n      deletedCount: result.deletedCount ?? 0,\n      upsertedCount: result.upsertedCount ?? 0,\n      insertedIds: numericKeys(result.insertedIds),\n      upsertedIds: numericKeys(result.upsertedIds),\n    };\n  }\n}\n"]}

package/dist/cjs/data/context.d.ts

@@ -0,0 +1,10 @@
+/** Runs `fn` as part of the business request whose headers are given. */
+export declare function runWithRequestContext<T>(headers: Headers, fn: () => T): T;
+/**
+ * Runs `fn` as the App itself, outside any employee's request: use it for
+ * work that outlives or is detached from the request (timers, queues, fire-
+ * and-forget follow-ups). Its data calls carry no data subject.
+ */
+export declare function runAsApp<T>(fn: () => T): T;
+/** The data subject of the request being served, if any. */
+export declare function currentDataSubject(): string | undefined;

package/dist/cjs/data/context.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runWithRequestContext = runWithRequestContext;
+exports.runAsApp = runAsApp;
+exports.currentDataSubject = currentDataSubject;
+/**
+ * Request context for the data layer.
+ *
+ * The Tier0 App Gateway signs the current employee into
+ * `X-Tier0-App-Data-Subject` on each business request. UNS uses it to narrow
+ * App-key access to that employee (data rules, record leases). The data layer
+ * forwards it only while serving that request: the App's request entry point
+ * opens the context with `runWithRequestContext`, and ensure, seed writes and
+ * `runAsApp(...)` background work never carry it.
+ */
+const node_async_hooks_1 = require("node:async_hooks");
+const cloud_transport_js_1 = require("../cloud-transport.js");
+// One store per process, shared across dev-server module reloads.
+const STORAGE_KEY = Symbol.for('tier0.sdk-v2.data.request-context');
+const globalStore = globalThis;
+const storage = (globalStore[STORAGE_KEY] ??= new node_async_hooks_1.AsyncLocalStorage());
+/** Runs `fn` as part of the business request whose headers are given. */
+function runWithRequestContext(headers, fn) {
+    const dataSubject = headers.get(cloud_transport_js_1.UNS_V2_APP_DATA_SUBJECT_HEADER)?.trim() || undefined;
+    return storage.run(dataSubject ? { dataSubject } : {}, fn);
+}
+/**
+ * Runs `fn` as the App itself, outside any employee's request: use it for
+ * work that outlives or is detached from the request (timers, queues, fire-
+ * and-forget follow-ups). Its data calls carry no data subject.
+ */
+function runAsApp(fn) {
+    return storage.run(null, fn);
+}
+/** The data subject of the request being served, if any. */
+function currentDataSubject() {
+    return storage.getStore()?.dataSubject;
+}
+//# sourceMappingURL=context.js.map

package/dist/cjs/data/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/data/context.ts"],"names":[],"mappings":";;AAyBA,sDAGC;AAOD,4BAEC;AAGD,gDAEC;AA1CD;;;;;;;;;GASG;AACH,uDAAqD;AACrD,8DAAuE;AAMvE,kEAAkE;AAClE,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AACpE,MAAM,WAAW,GAAG,UAEnB,CAAC;AACF,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,IAAI,oCAAiB,EAAyB,CAAC,CAAC;AAE9F,yEAAyE;AACzE,SAAgB,qBAAqB,CAAI,OAAgB,EAAE,EAAW;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mDAA8B,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACrF,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CAAI,EAAW;IACrC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,4DAA4D;AAC5D,SAAgB,kBAAkB;IAChC,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC;AACzC,CAAC","sourcesContent":["/**\n * Request context for the data layer.\n *\n * The Tier0 App Gateway signs the current employee into\n * `X-Tier0-App-Data-Subject` on each business request. UNS uses it to narrow\n * App-key access to that employee (data rules, record leases). The data layer\n * forwards it only while serving that request: the App's request entry point\n * opens the context with `runWithRequestContext`, and ensure, seed writes and\n * `runAsApp(...)` background work never carry it.\n */\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport { UNS_V2_APP_DATA_SUBJECT_HEADER } from '../cloud-transport.js';\n\ninterface RequestContext {\n  dataSubject?: string;\n}\n\n// One store per process, shared across dev-server module reloads.\nconst STORAGE_KEY = Symbol.for('tier0.sdk-v2.data.request-context');\nconst globalStore = globalThis as typeof globalThis & {\n  [STORAGE_KEY]?: AsyncLocalStorage<RequestContext | null>;\n};\nconst storage = (globalStore[STORAGE_KEY] ??= new AsyncLocalStorage<RequestContext | null>());\n\n/** Runs `fn` as part of the business request whose headers are given. */\nexport function runWithRequestContext<T>(headers: Headers, fn: () => T): T {\n  const dataSubject = headers.get(UNS_V2_APP_DATA_SUBJECT_HEADER)?.trim() || undefined;\n  return storage.run(dataSubject ? { dataSubject } : {}, fn);\n}\n\n/**\n * Runs `fn` as the App itself, outside any employee's request: use it for\n * work that outlives or is detached from the request (timers, queues, fire-\n * and-forget follow-ups). Its data calls carry no data subject.\n */\nexport function runAsApp<T>(fn: () => T): T {\n  return storage.run(null, fn);\n}\n\n/** The data subject of the request being served, if any. */\nexport function currentDataSubject(): string | undefined {\n  return storage.getStore()?.dataSubject;\n}\n"]}

package/dist/cjs/data/declarations.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@tier0/sdk-v2/data/define` — collection declarations, their types and the
+ * schema compiler, without the runtime client. Safe for browser bundles: it
+ * loads no Node built-ins, transport, request context or bootstrap, so
+ * components and routes can import declarations and `Doc` types from here
+ * while data reads and writes stay on the server (`@tier0/sdk-v2/data`).
+ */
+export { defineCollection, MAX_COLLECTIONS } from './define.js';
+export type { CollectionDefinition, CollectionSchema, Doc, IndexSpec, NewDoc, RecordMeta, SeedDoc } from './define.js';
+export { CollectionSchemaError, compileCollection, validateDocument } from './schema.js';
+export type { CompiledCollection, NormalizedIndex, RecordSchema, SchemaIssue } from './schema.js';

package/dist/cjs/data/declarations.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDocument = exports.compileCollection = exports.CollectionSchemaError = exports.MAX_COLLECTIONS = exports.defineCollection = void 0;
+/**
+ * `@tier0/sdk-v2/data/define` — collection declarations, their types and the
+ * schema compiler, without the runtime client. Safe for browser bundles: it
+ * loads no Node built-ins, transport, request context or bootstrap, so
+ * components and routes can import declarations and `Doc` types from here
+ * while data reads and writes stay on the server (`@tier0/sdk-v2/data`).
+ */
+var define_js_1 = require("./define.js");
+Object.defineProperty(exports, "defineCollection", { enumerable: true, get: function () { return define_js_1.defineCollection; } });
+Object.defineProperty(exports, "MAX_COLLECTIONS", { enumerable: true, get: function () { return define_js_1.MAX_COLLECTIONS; } });
+var schema_js_1 = require("./schema.js");
+Object.defineProperty(exports, "CollectionSchemaError", { enumerable: true, get: function () { return schema_js_1.CollectionSchemaError; } });
+Object.defineProperty(exports, "compileCollection", { enumerable: true, get: function () { return schema_js_1.compileCollection; } });
+Object.defineProperty(exports, "validateDocument", { enumerable: true, get: function () { return schema_js_1.validateDocument; } });
+//# sourceMappingURL=declarations.js.map

package/dist/cjs/data/declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.js","sourceRoot":"","sources":["../../../src/data/declarations.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,yCAAgE;AAAvD,6GAAA,gBAAgB,OAAA;AAAE,4GAAA,eAAe,OAAA;AAE1C,yCAAyF;AAAhF,kHAAA,qBAAqB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,6GAAA,gBAAgB,OAAA","sourcesContent":["/**\n * `@tier0/sdk-v2/data/define` — collection declarations, their types and the\n * schema compiler, without the runtime client. Safe for browser bundles: it\n * loads no Node built-ins, transport, request context or bootstrap, so\n * components and routes can import declarations and `Doc` types from here\n * while data reads and writes stay on the server (`@tier0/sdk-v2/data`).\n */\nexport { defineCollection, MAX_COLLECTIONS } from './define.js';\nexport type { CollectionDefinition, CollectionSchema, Doc, IndexSpec, NewDoc, RecordMeta, SeedDoc } from './define.js';\nexport { CollectionSchemaError, compileCollection, validateDocument } from './schema.js';\nexport type { CompiledCollection, NormalizedIndex, RecordSchema, SchemaIssue } from './schema.js';\n"]}