feat(sql): implement TypeID specification 0.3.0 in typeid-sql

[joschi]

Summary

Implement TypeID specification 0.3.0 in typeid-sql.

Note

PLEASE tag the repository with the specification and provide a changelog. 🙏

How was it tested?

yarn install
yarn test

Community Contribution License

All community contributions in this pull request are licensed to the project maintainers under the terms of the Apache 2 License.

By creating this pull request I represent that I have the right to license the contributions to the project maintainers under the Apache 2 License as stated in the Community Contribution License.

[joschi]

This would supersede #363 and #467.

[Copilot]

Pull Request Overview

This PR implements TypeID specification 0.3.0 in the typeid-sql project, updating the prefix validation rules to allow underscores within prefixes while maintaining proper formatting constraints.

• Updates prefix regex from [a-z]{0,63} to ^([a-z]([a-z_]{0,61}[a-z])?)?$ to allow underscores
• Adds comprehensive test coverage for underscore handling in prefixes
• Includes testing infrastructure and documentation improvements

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
typeid/typeid-sql/sql/03_typeid.sql	Updates core TypeID functions with new prefix validation regex and improves parsing logic
typeid/typeid-sql/supabase/tests/03_typeid.test.sql	Adds tests for underscore handling and updates error message expectations
typeid/typeid-sql/supabase/tests/03_typed_text.test.sql	Adds underscore-specific test cases and updates validation error messages
typeid/typeid-sql/package.json	Adds npm scripts for test automation
typeid/typeid-sql/README.md	Documents testing procedures and requirements

Comments suppressed due to low confidence (2)

typeid/typeid-sql/supabase/tests/03_typeid.test.sql:128

• The test description 'Print valid: valid-alphabet-underscores' is inconsistent with the test name 'valid-prefix-underscores'. Consider using 'Print valid: valid-prefix-underscores' for consistency.

  'Print valid: valid-alphabet-underscores'

typeid/typeid-sql/supabase/tests/03_typeid.test.sql:133

• The test description 'Print valid: valid-alphabet-underscores' should be more specific since this test uses 'pre_____fix' with multiple consecutive underscores. Consider 'Print valid: valid-prefix-multiple-underscores'.

  'Print valid: valid-alphabet-underscores'

[Copilot]

The regex ^(.*)_(.*)$ uses greedy matching which could be inefficient for strings with multiple underscores. Consider using ^(.*?)_(.*)$ with non-greedy matching or ^([^_]+)_(.*)$ to match only the first underscore more efficiently.

Suggested change

	matches = regexp_match(typeid_str, '^(.*)_(.*)$');
	matches = regexp_match(typeid_str, '^([^_]+)_(.*)$');

[joschi]

@loreto WDYT? We could already match the correct regular expression here (prefix + suffix) but would lose fidelity in the error messages afterwards.

[loreto]

Apologies for the delay. I'll take a look at this PR today.

[loreto]

LGTM