@beignet/core/dist/ports/id-generator.js

Core framework primitives for Beignet

/**
 * Create an ID generator backed by `globalThis.crypto.randomUUID()`.
 *
 * The factory itself does not read from `crypto`; the returned generator's
 * `nextId()` method throws if the current runtime does not expose
 * `globalThis.crypto.randomUUID()`.
 *
 * @returns An ID generator that returns UUID strings from `nextId()`.
 */
export function createUuidIdGenerator() {
    return {
        nextId: () => {
            if (typeof globalThis.crypto?.randomUUID !== "function") {
                throw new Error("createUuidIdGenerator requires globalThis.crypto.randomUUID(). Provide a custom IdGeneratorPort in this runtime.");
            }
            return globalThis.crypto.randomUUID();
        },
    };
}
/**
 * Create a deterministic sequence ID generator for tests and examples.
 *
 * @example
 * ```ts
 * const ids = createSequenceIdGenerator({ prefix: "post", start: 10 });
 * ids.nextId(); // "post_10"
 * ids.nextId(); // "post_11"
 * ```
 *
 * @param options - Optional ID prefix and starting sequence number.
 * @returns A mutable sequence ID generator.
 */
export function createSequenceIdGenerator(options = {}) {
    const prefix = options.prefix ?? "id";
    const start = options.start ?? 1;
    let next = start;
    return {
        nextId: () => `${prefix}_${next++}`,
        reset: (value = start) => {
            next = value;
        },
    };
}
//# sourceMappingURL=id-generator.js.map